開發工具

Claude Code 設定與 Statusline 實作紀錄

Claude Code 設定與 Statusline 實作紀錄

Claude Code 是什麼?

Claude Code 是 Anthropic 推出的 CLI 開發工具,可以直接在終端機中與 Claude AI 互動,協助你完成程式開發、除錯、重構等工作。


安裝方式

請參考官方文件:Claude Code 開始使用


基礎設定
1. 登入

首次啟動時會引導你登入 Anthropic 帳號,登入後即可開始使用。

2. CLAUDE.md

在專案根目錄建立 CLAUDE.md,可以提供專案的背景資訊給 Claude,例如:

  • 專案的建置與執行指令
  • 程式碼架構說明
  • 開發慣例與注意事項

Claude 會自動讀取這個檔案,讓回答更貼合你的專案。


常用斜線指令

基本操作

指令 說明
claude 啟動互動模式
/help 查看說明
/clear 清除對話紀錄(別名:/reset/new

會話管理

指令 說明
/resume 恢復先前的對話
/compact 壓縮對話內容以節省 token
/context 可視化目前語境使用情況
/copy 複製最後一個回應到剪貼簿

模型與模式

指令 說明
/model 選擇或更改 AI 模型
/plan 進入計畫模式,先規劃再執行
/effort 設定模型努力等級(low / medium / high)

設定與界面

指令 說明
/statusline 配置狀態列顯示內容
/theme 改變色彩主題
/init 用 CLAUDE.md 初始化專案
/usage 顯示計畫使用限制與速率限制狀態
/stats 顯示當前會話的統計資訊
/memory 編輯 CLAUDE.md 記憶檔案

程式碼與 Git

指令 說明
/diff 開啟互動式 diff 檢視器

Statusline 實際操作

Claude Code 的 /statusline 指令可以自訂終端機底部的狀態列,即時顯示模型、用量、Git 分支等資訊。

設定方式
  1. 在 Claude Code 中輸入 /statusline,選擇自動配置或手動設定
  2. 設定會寫入 ~/.claude/settings.json,例如:
{
  "statusLine": {
    "type": "command",
    "command": "bash C:/Users/USER/.claude/statusline-command.sh"
  }
}
  1. 對應的腳本放在 ~/.claude/statusline-command.sh
我的 statusline 腳本

這個腳本會顯示三行資訊:

  • 第一行:模型名稱 | 語境使用量 | 專案目錄(Git 分支)
  • 第二行:5 小時用量進度條 + 重置時間
  • 第三行:7 天用量進度條 + 重置時間

進度條以圓點呈現,並依用量百分比變色:

  • 綠色(< 60%)→ 黃色(60~80%)→ 紅色(> 80%)

腳本透過 jq 解析 Claude Code 傳入的 JSON 資料,擷取模型名稱、語境視窗使用率、速率限制等欄位,再組合成格式化的輸出。

顯示效果範例
Claude 4 Opus | 📝 45% | myproject (main*)
current ●●●●○○○○○○ 40%  ○ 14:30
weekly  ●●○○○○○○○○ 20%  ○ 04/07 09:00

分支名稱後面的 * 表示有未提交的變更。


實用技巧
  1. 直接描述需求 — 不需要告訴 Claude 該看哪個檔案,它會自己搜尋
  2. 提供截圖 — 可以貼上截圖路徑,Claude 能讀取圖片內容
  3. 善用 CLAUDE.md — 把專案特有的知識寫進去,減少重複說明
  4. 檔案編輯 — Claude 可以直接幫你修改程式碼,修改前會先讀取原始內容

小結

Claude Code 讓 AI 真正融入開發流程,從搜尋程式碼、修改檔案到執行指令,都能在終端機中一站完成。適合用來加速日常開發、快速理解陌生的 codebase,或是處理繁瑣的重構任務。


參考資料