互動模式

​

快捷鍵

​

一般控制

​

文字編輯

​

編輯快捷鍵中的單字邊界

​

主題和顯示

​

多行輸入

​

快速命令

​

文字記錄檢視器

​

語音輸入

​

指令

​

在提示中途完成指令

• 在 全螢幕呈現 中：當您輸入時，符合項會以清單形式開啟，沒有反白的列，因此 Enter 仍會按輸入的方式傳送您的提示。按 Tab 以插入最上面的符合項，或使用方向鍵和 Enter 選擇一列。
• 在全螢幕外：最上面符合項的其餘部分會在您的游標處顯示為幽靈文字，當有更多指令符合時會顯示計數（例如 +2）。按 Tab 以插入唯一的符合項，或在有多個符合項時開啟清單，然後使用方向鍵和 Enter 選擇一列。

​

Vim 編輯器模式

​

模式切換

​

重新對應 INSERT 模式快捷鍵序列

{
  "editorMode": "vim",
  "vimInsertModeRemaps": { "jj": "<Esc>" }
}

​

導覽（NORMAL 模式）

​

編輯（NORMAL 模式）

​

文字物件（NORMAL 模式）

​

視覺模式

​

命令歷史

• 輸入歷史按工作目錄儲存
• 執行 /clear 會開始新的工作階段：回憶時會先列出新工作階段的提示詞，然後是較早工作階段的提示詞。前一個工作階段的對話會被保留，可以繼續進行。
• 連續提交相同的提示詞兩次只會記錄一個歷史項目，因此按向上箭頭會跳到前一個不同的提示詞
• 當您回憶包含貼上文字的提示詞時，Claude Code 會在您重新提交時再次傳送完整的貼上內容。如果內容已被自動清理，Claude Code 不會傳送字面上的 [Pasted text #N] 字串；請參閱貼上大型內容以了解提示詞會發生什麼情況
• 使用 ! 的歷史展開預設為停用

​

使用 Ctrl+R 進行反向搜尋

1. 開始搜尋：按 Ctrl+R 啟動反向歷史搜尋
2. 輸入查詢：輸入要在先前命令中搜尋的文字。搜尋詞在符合結果中會被反白顯示
3. 導覽符合項目：再次按 Ctrl+R 循環瀏覽較舊的符合項目
4. 搜尋範圍：內嵌搜尋始終搜尋來自所有專案的提示詞
5. 接受符合項目：
   • 按 Tab 或 Esc 接受目前的符合項目並繼續編輯
   • 按 Enter 接受並立即執行命令
6. 取消搜尋：
   • 按 Ctrl+C 取消並還原您的原始輸入
   • 在空搜尋上按 Backspace 取消

​

背景 Bash 命令

​

背景執行的運作方式

• 提示 Claude Code 在背景執行命令
• 按 Ctrl+B 將一般 Bash 工具叫用移至背景。Tmux 使用者必須按 Ctrl+B 兩次，因為 tmux 的前置鍵。

• 輸出會寫入檔案，Claude 可以使用 Read 工具擷取它
• 背景工作具有唯一的 ID，用於追蹤和輸出擷取
• 當 Claude Code 結束時，背景工作會自動清理。在 macOS 和 Linux 上，當您從 /tasks 停止背景工作或 Claude Code 在結束時停止它時，從工作的 shell 分離的程序（例如在 setsid 或 timeout 下啟動的程序）也會停止
• 如果您將工作階段放在背景而不是結束它，您的背景工作會繼續在背景工作階段中執行。請參閱將執行中的工作階段放在背景
• 背景工作如果輸出超過 5GB，會自動終止，stderr 中會有說明原因的備註
• 在 macOS 和 Linux 上，當作業系統發出記憶體壓力信號時，Claude Code 會終止執行中的背景工作，前提是工作階段已閒置至少 30 分鐘且沒有執行任何轉向或子代理。需要 Claude Code v2.1.193 或更新版本
  • 偵錯日誌會說明為什麼工作被停止，或為什麼壓力事件讓它們繼續執行
  • 將 CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP 設定為 1 以關閉記憶體壓力停止
• 背景 Bash 和 PowerShell 命令有時間限制，從命令進入背景的時刻開始計算：30 分鐘，或 Claude 在啟動背景命令時要求的 timeout，最多 2 小時。使用 Ctrl+B 等方式在執行時移至背景的命令，從移動時起獲得 30 分鐘。當命令達到其限制時，Claude Code 會停止它並告訴 Claude 原因，Claude 可以使用更長的 timeout 重新啟動它（如果工作仍需要的話）。若要延長限制，請參閱工具參考中的提高背景命令的時間限制
• 由前景子代理啟動的背景命令在該子代理的執行結束時結束，無論是完成、失敗或被中斷；請參閱工具參考中的背景命令停止時

• 建置工具（webpack、vite、make）
• 套件管理員（npm、yarn、pnpm）
• 測試執行器（jest、pytest）
• 開發伺服器
• 長時間執行的程序（docker、terraform）

​

使用 ! 前置詞的 Shell 模式

! npm test
! git status
! ls -la

• 將命令及其輸出新增至對話內容
• 顯示即時進度和輸出
• 支援相同的 Ctrl+B 背景執行，用於長時間執行的命令
• 不需要 Claude 解釋或核准命令
• 支援歷史記錄型自動完成：輸入部分命令並按 Tab 以從目前專案中的先前 ! 命令完成
• 自 v2.1.193 起在所有平台上支援即時檔案路徑自動完成：輸入包含正斜線的權杖（例如 ./src/ 或 ~/）以查看相符檔案和目錄的下拉式清單，然後按 Tab 以接受。在 Windows 上也使用正斜線；下拉式清單由 / 觸發，而不是 \
• 在空提示上按 Escape、Backspace 或 Ctrl+U 結束
• 將以 ! 開頭的文字貼到空提示中會自動進入 shell 模式，符合輸入的 ! 行為

​

在 Claude 工作時排隊傳送訊息

​

Claude Code 何時傳送您排隊的內容

• 訊息：如果您在 Claude 執行工具呼叫時排隊訊息，Claude Code 會在這些工具呼叫完成後立即將其傳遞給 Claude，在同一輪次內。當輪次結束時仍有訊息排隊，它們會在沒有另一次按鍵的情況下按照您輸入的順序傳出
• 命令和 shell 命令：Claude Code 會保留它們直到輪次結束，然後逐個執行，保持您排隊的順序

• 執行 shell 命令、子代理或其他可以移至 背景的工作：該工作會移至背景並繼續執行，Claude 會在同一輪次中讀取您的訊息
• 僅寫入回應，或執行無法移至背景的操作：Claude Code 會中斷輪次並在下一步傳送您的訊息。在 v2.1.281 之前，該快捷鍵在兩種情況下都會中斷輪次

• /model：一旦您確認 cache warning（如果 Claude Code 顯示的話），Claude Code 會將您的變更應用於該輪次中它進行的下一個請求
• /effort：一旦您確認 cache warning（如果 Claude Code 顯示的話），Claude Code 會將您的變更應用於該輪次中它進行的下一個請求
• /fast：Claude Code 保留輪次開始時活躍的快速模式設定，因此您的速度變更從您的下一輪次開始應用。如果您目前的模型不支援快速模式，開啟它也會 切換您的模型，Claude Code 會從該輪次中的下一個請求使用新模型

​

取回您排隊的內容

​

提示建議

• 按 Tab 或 Right arrow 將建議放入提示輸入中，然後按 Enter 提交
• 開始輸入以關閉它

​

當 Claude Code 跳過建議時

• 提示快取為冷狀態，以避免不必要的成本
• 在對話的第一輪之後，在某些工作階段中
• 前一個回應以錯誤結束
• 當您處於 Plan Mode 時
• 您的帳戶接近或已達到使用限制。若要在達到限制之前保持建議開啟，請將 CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION 設定為 true。在 v2.1.238 之前，即使將變數設定為 true，Claude Code 也會在接近限制時跳過建議
• 在代理團隊中，預設情況下在隊友的工作階段中。主導者的工作階段會顯示建議

​

關閉提示建議

• 在 /config 中關閉 Prompt suggestions
• 在您的設定檔中將 promptSuggestionEnabled 設定為 false
• 將 CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION 環境變數設定為 false，其優先於設定：
  export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false
  

​

Emoji 快捷代碼

• 輸入完整的快捷代碼，例如 :heart:，Claude Code 會在您輸入結尾的 : 時立即將其替換為 ❤️
• 輸入 : 加上至少兩個字元的名稱，例如 :hea，以開啟建議彈出視窗，然後按 Tab 或 Enter 以插入突出顯示的 emoji

​

在輸入時檢查拼寫

​

先決條件

• 安裝 aspell、hunspell 或 ispell，並確保它在您的 PATH 上。Claude Code 在每個平台上執行它找到的前三個中的第一個，包括套件管理員在 Windows 上安裝的 .cmd shim。
• 若要檢查程式是否在您的 PATH 上，請在您的終端機中執行 aspell --version、hunspell --version 或 ispell -v。「command not found」錯誤表示它還不在您的 PATH 上。

​

開啟或關閉拼寫檢查

{
  "spellcheck": { "enabled": true }
}

{
  "spellcheck": { "enabled": true }
}

claude --settings spellcheck.json

{
  "spellcheck": { "enabled": true }
}

• checker：aspell、hunspell 或 ispell。Claude Code 不會從您命名的檢查器回退，並將任何其他值視為 auto。
• language：您的檢查器形式中的字典名稱，例如 en_GB。Claude Code 忽略任何不是純字典名稱的值，例如路徑或包含空格的名稱，檢查器使用其預設字典。
• color：顏色名稱，例如 yellow，或 #rrggbb、#rgb、rgb(r,g,b)、ansi256(n) 或 ansi:<name> 值。Claude Code 預設使用您主題的錯誤顏色，對於任何它無法識別的值也是如此。

{
  "spellcheck": {
    "enabled": true,
    "checker": "hunspell",
    "language": "en_GB",
    "color": "yellow"
  }
}

​

Claude Code 加底線的內容

• 命令，例如 /help、@ 提及、URL、檔案路徑和旗標，例如 --verbose
• 包含數字、底線或第一個字母後大寫字母的單詞，以及反引號中的文字

​

當 Claude Code 不加任何底線時

• 未安裝檢查器，或您在 checker 中命名的檢查器遺失
• 檢查器在啟動時或工作階段稍後連續失敗兩次。Claude Code 在第一次失敗後重新啟動它，在第二次失敗後停止檢查，直到您重新啟動 Claude Code
• 檢查器花費超過 15 秒來回答三次。每次，Claude Code 都會將它等待的單詞保留為未標記；在第三次之後，它停止檢查，直到您重新啟動 Claude Code

​

提示中的隱形字元

​

使用 /diff 檢視變更

​

差異面板

• 全螢幕渲染
• 一個 git 儲存庫
• 寬度至少為 110 欄的終端機
• Claude Code v2.1.260 或更新版本

• 跳至檔案：按一下列表中的其列。使用滑鼠滾輪捲動面板。當檔案列表本身太長而無法容納時，使用 Alt+Up 和 Alt+Down 或 Ctrl+Up 和 Ctrl+Down 捲動它。
• 詢問 Claude 有關特定行的問題：在面板中使用滑鼠選取它們。Claude Code 會將選取項目附加到您的下一個提示，並在您傳送提示之前在輸入旁邊顯示行數。
  • 若要在不包含選取項目的情況下傳送提示，請將游標移至行數指示器之後，然後按 Backspace 將其刪除。需要 Claude Code v2.1.271 或更新版本。
• 顯示面板遺漏的檔案：列表會跳過測試檔案和產生的檔案，並將此工作階段之前的變更摺疊為底部的一行。按一下任一計數行以展開它。
• 變更面板比較的對象：按 Ctrl+X B 以在此工作階段的變更、您的未提交變更作為一個列表，以及自您的分支從預設分支分割以來的所有內容之間循環。Claude Code 會記住每個專案的選擇。

​

差異檢視器

• 左和右：在「目前」和轉換檢視之間移動。
• 上和下：選取檔案。
• Enter：開啟所選檔案的差異。使用上和下或 PageUp 和 PageDown 捲動它。
• Esc：從檔案的差異返回到列表，或從列表關閉檢視器。

​

使用 /btw 提出附帶問題

/btw what was the name of that config file again?

• Claude 工作時可用：即使 Claude 正在處理回應時，您也可以執行 /btw。附帶問題會獨立執行，不會中斷主要回合。它會看到目前為止對話中的所有內容，除了 Claude 仍在撰寫的回覆。
• 無工具存取：附帶問題只能根據已在內容中的內容來回答。Claude 在回答附帶問題時無法讀取檔案、執行命令或搜尋。如果 Claude 無論如何都將工具呼叫寫成文字，答案會以一個說明沒有任何內容被執行的備註結尾。
• 單一回應：覆蓋層中沒有後續回合。若要繼續執行緒，請提出另一個 /btw 問題。若要在本機工作階段中繼續使用完整工具存取，請按 f 將此問題和答案分支到背景子代理。
• 低成本：當對話的提示快取處於熱狀態時，附帶問題的成本只是答案本身之外的少量成本。

​

工作清單

• 按 Ctrl+T 切換工作清單檢視。顯示一次最多五個工作。當 Claude 尚未建立任何檢查清單項目時，切換沒有可見效果，因為沒有任何內容可顯示
• 如果您保持清單展開，Claude Code 會在下次啟動仍有工作的工作階段時（例如使用 --resume 或 --continue）還原展開檢視。當工作清單為空時，Claude Code 會以摺疊狀態啟動它
• 若要查看所有工作或清除它們，直接詢問 Claude：「show me all tasks」或「clear all tasks」
• 工作在內容壓縮過程中保持不變，幫助 Claude 在較大的專案上保持組織
• 若要在工作階段之間共享工作清單，請設定 CLAUDE_CODE_TASK_LIST_ID 以使用 ~/.claude/tasks/ 中的具名目錄：CLAUDE_CODE_TASK_LIST_ID=my-project claude

​

工作階段摘要

​

等待使用量限制重設

Usage limit reached · limit resets 3:45pm
Continuing automatically at 3:45pm · esc to cancel

• 在重設時：第二行會變為 Continuing shortly · esc to cancel。接著對話中會出現 Usage limit reset · continuing automatically，Claude Code 會提示 Claude 從停止的地方接續任務。它不會重新傳送您的最後一條訊息。
• 在您的電腦睡眠後：如果睡眠超過約 30 分鐘，且上限在睡眠期間重設，第一行會顯示 Your usage limit has reset，第二行會顯示 Press enter to continue。按 Enter 繼續。若睡眠時間較短，或睡眠在重設前就已結束，Claude Code 會自動繼續。
• 提前：當您使用 /usage-credits 完成新增 使用額度、在 /upgrade 後重新登入，或在等待期間使用 /model 切換模型時，Claude Code 會檢查使用量是否再次可用，如果可用則立即繼續。它不會在您在瀏覽器中自行進行的升級或購買後檢查。在 opusplan 和其他在不同模型上執行計畫模式的模型設定下，Claude Code 會改為等待重設。

​

取消等待

• 您傳送提示詞：Claude Code 會傳送您的提示詞而不是等待。如果您的提示詞也達到上限，它會保留在對話中，且 Claude Code 會再次開始等待。
• 您退出 Claude Code：當您繼續工作階段時，等待不會重新啟動。
• 對話轉手：您使用 /login 切換帳戶、清除或倒帶對話、/resume 另一個工作階段、使用 /teleport 拉取一個、使用 /tui 重新啟動，或將工作階段交給 Claude Desktop、背景工作階段或雲端。
• 設定關閉，或重設超過 24 小時：這只會結束 Claude Code 自行啟動的等待。您從 /rate-limit-options 選擇的等待會繼續倒數。
• 繼續被阻止：一個 UserPromptSubmit hook 阻止繼續提示，或在到達模型之前失敗，會結束等待。Claude Code 會告訴您繼續未執行。傳送提示以繼續。

​

自行啟動等待

• 遠端控制和代理團隊隊友工作階段：該終端上的人仍然可以啟動一個。
• 重設超過 24 小時：每週限制可能在數天後重設。
• 您執行該系列外的模型時的 Opus 或 Sonnet 限制：您的下一回合可能不會達到該限制。opusplan 和其他在受限系列上執行計畫模式的模型設定不會獲得此例外。

• 背景工作階段和 -p 執行：菜單列不可用。
• API 金鑰、雲端提供者和按使用量計費：那裡的使用量按請求計量，因此沒有重設可等待。
• 沒有已儲存 claude.ai 登入的 LLM 閘道：Claude Code 只在已儲存的 claude.ai 登入是作用中認證時提供等待。

​

關閉自動繼續

​

PR 審查狀態

• 綠色：已批准
• 黃色：待審查
• 紅色：要求變更
• 灰色：草稿

​

GitLab 合併請求

• 綠色：GitLab 報告合併請求可合併
• 黃色：任何其他開放狀態
• 灰色：草稿

• Claude Code v2.1.234 或更新版本
• 指向您的 GitLab 主機的儲存庫遠端，可以是 gitlab.com 或自管理執行個體
• 您 PATH 上的 glab CLI，已使用 glab auth login 進行驗證

​

問題參考連結

• 單獨的 #123
• 巢狀的 GitLab 路徑，例如 group/subgroup/project#123
• 程式碼跨度或程式碼區塊內的任何參考

​

另請參閱

• Skills - 自訂提示和工作流程
• Checkpointing - 回溯 Claude 的編輯並恢復先前的狀態
• CLI 參考 - 命令列旗標和選項
• 設定 - 配置選項
• 記憶體管理 - 管理 CLAUDE.md 檔案