跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
鍵盤快捷鍵

鍵盤快捷鍵可能因平台和終端而異。在全螢幕渲染中，在文字記錄檢視器中按 ? 以查看可用的快捷鍵。macOS 使用者：Option/Alt 鍵快捷鍵（Alt+B、Alt+F、Alt+Y、Alt+M、Alt+P）需要在終端中將 Option 配置為 Meta：
  • iTerm2：設定 → Profiles → Keys → General → 將 Left/Right Option 鍵設定為「Esc+」
  • Apple Terminal：設定 → Profiles → Keyboard → 勾選「Use Option as Meta Key」
  • VS Code：在 VS Code 設定中設定 "terminal.integrated.macOptionIsMeta": true
詳見終端配置。

​
一般控制

快捷鍵說明上下文
Ctrl+C取消目前輸入或生成標準中斷
Ctrl+X Ctrl+K終止此會話中所有執行中的背景子代理。在 3 秒內按兩次以確認子代理控制
Ctrl+D退出 Claude Code 會話EOF 信號
Ctrl+G 或 Ctrl+X Ctrl+E在預設文字編輯器中開啟在預設文字編輯器中編輯您的提示或自訂回應。Ctrl+X Ctrl+E 是 readline 原生繫結。在 /config 中開啟「在外部編輯器中顯示最後回應」，以在您的提示上方將 Claude 的先前回覆作為 # 註解上下文預先加入；當您儲存時，註解區塊會被移除
Ctrl+L重繪螢幕強制完整終端重繪。輸入和對話歷史會保留。如果顯示變得混亂或部分空白，請使用此選項恢復
Ctrl+O切換文字記錄檢視器顯示詳細的工具使用和執行情況。也會展開 MCP 呼叫，預設情況下會摺疊為單行，例如「Called slack 3 times」
Ctrl+R反向搜尋命令歷史以互動方式搜尋先前的命令
Ctrl+V 或 Cmd+V（iTerm2）或 Alt+V（Windows）從剪貼簿貼上影像在游標處插入 [Image #N] 晶片，以便您可以在提示中按位置參考它
Ctrl+B背景執行工作將 bash 命令和代理放在背景執行。Tmux 使用者按兩次
Ctrl+T切換工作清單在終端狀態區域中顯示或隱藏工作清單
Left/Right arrows在對話框標籤之間循環在權限對話框和選單中的標籤之間導航
Up/Down arrows 或 Ctrl+P/Ctrl+N移動游標或導航命令歷史在多行輸入中，首先在提示內移動游標。一旦游標已在頂部或底部邊緣，再次按下會導航命令歷史
Esc中斷 Claude停止目前回應或工具呼叫中途，以便您可以重新導向。Claude 會保留迄今為止完成的工作
Esc + Esc回溯或摘要將程式碼和/或對話恢復到先前的點，或從選定的訊息進行摘要
Shift+Tab 或 Alt+M（某些配置）循環權限模式在 default、acceptEdits、plan 和您啟用的任何模式（例如 auto 或 bypassPermissions）之間循環。詳見權限模式。
Option+P（macOS）或 Alt+P（Windows/Linux）切換模型在不清除提示的情況下切換模型
Option+T（macOS）或 Alt+T（Windows/Linux）切換擴展思考啟用或停用擴展思考模式。自 v2.1.132 起，此快捷鍵在 macOS 上無需配置 Option 為 Meta 即可運作
Option+O（macOS）或 Alt+O（Windows/Linux）切換快速模式啟用或停用快速模式

​
文字編輯

快捷鍵說明上下文
Ctrl+A將游標移至目前行的開始在多行輸入中，移至目前邏輯行的開始
Ctrl+E將游標移至目前行的結尾在多行輸入中，移至目前邏輯行的結尾
Ctrl+K刪除到行尾儲存已刪除的文字以供貼上
Ctrl+U從游標刪除到行首儲存已刪除的文字以供貼上。重複以清除多行輸入中的行。在 macOS 上，終端模擬器（包括 iTerm2 和 Terminal.app）將 Cmd+Backspace 對應到此快捷鍵
Ctrl+W刪除上一個單字儲存已刪除的文字以供貼上。在 Windows 上，Ctrl+Backspace 也會刪除上一個單字
Ctrl+Y貼上已刪除的文字貼上使用 Ctrl+K、Ctrl+U 或 Ctrl+W 刪除的文字
Alt+Y（在 Ctrl+Y 之後）循環貼上歷史貼上後，循環瀏覽先前刪除的文字。在 macOS 上需要將 Option 設定為 Meta
Alt+B將游標向後移動一個單字單字導航。在 macOS 上需要將 Option 設定為 Meta
Alt+F將游標向前移動一個單字單字導航。在 macOS 上需要將 Option 設定為 Meta

​
主題和顯示

快捷鍵說明上下文
Ctrl+T切換程式碼區塊的語法醒目提示僅在 /theme 選擇器選單內有效。控制 Claude 回應中的程式碼是否使用語法著色

​
多行輸入

方法快捷鍵上下文
快速逃脫\ + Enter適用於所有終端
Option 鍵Option+Enter在 macOS 上啟用將 Option 設定為 Meta後
Shift+EnterShift+Enter在 iTerm2、WezTerm、Ghostty、Kitty、Warp、Apple Terminal、Windows Terminal 中開箱即用
控制序列Ctrl+J在任何終端中無需配置即可使用
貼上模式直接貼上適用於程式碼區塊、日誌
Shift+Enter 在 iTerm2、WezTerm、Ghostty、Kitty、Warp、Apple Terminal 和 Windows Terminal 中無需配置即可使用。對於 VS Code、Cursor、Windsurf、Alacritty 和 Zed，執行 /terminal-setup 以安裝繫結。

​
快速命令

快捷鍵說明備註
/ 在開始命令或 skill詳見命令和 skills
! 在開始Bash 模式直接執行命令並將執行輸出新增到會話
@檔案路徑提及觸發檔案路徑自動完成

​
文字記錄檢視器

當文字記錄檢視器開啟時（使用 Ctrl+O 切換），這些快捷鍵可用。在全螢幕渲染中，按 ? 以在檢視器內顯示完整的快捷鍵參考面板。Ctrl+E 可以透過 transcript:toggleShowAll 重新繫結。
快捷鍵說明
?切換鍵盤快捷鍵說明面板。需要全螢幕渲染
{ / }跳至上一個或下一個使用者提示，類似 vim 段落動作。需要全螢幕渲染
Ctrl+E切換顯示所有內容
[將完整對話寫入終端的原生滾動回溯，以便 Cmd+F、tmux 複製模式和其他原生工具可以搜尋它。需要全螢幕渲染
v將對話寫入臨時檔案並在 $VISUAL 或 $EDITOR 中開啟它。需要全螢幕渲染
q、Ctrl+C、Esc退出文字記錄檢視。所有三個都可以透過 transcript:exit 重新繫結

​
語音輸入

快捷鍵說明備註
按住或點擊 Space語音聽寫需要啟用語音聽寫。按住以錄製，或執行 /voice tap 以進行點擊切換。可重新繫結

​
命令

在 Claude Code 中輸入 / 以查看所有可用命令，或輸入 / 後跟任何字母以篩選。/ 選單顯示您可以呼叫的所有內容：內建命令、捆綁和使用者撰寫的 skills，以及由 plugins 和 MCP servers 貢獻的命令。並非所有內建命令對每個使用者都可見，因為某些命令取決於您的平台或計畫。 詳見命令參考以取得 Claude Code 中包含的命令的完整清單。

​
Vim 編輯器模式

透過 /config → Editor mode 啟用 vim 風格編輯。

​
模式切換

命令動作來自模式
Esc進入 NORMAL 模式INSERT、VISUAL
i在游標前插入NORMAL
I在行首插入NORMAL
a在游標後插入NORMAL
A在行尾插入NORMAL
o在下方開啟行NORMAL
O在上方開啟行NORMAL
v開始字元式視覺選擇NORMAL
V開始行式視覺選擇NORMAL

​
導航（NORMAL 模式）

命令動作
h/j/k/l向左/向下/向上/向右移動
Space向右移動
w下一個單字
e單字結尾
b上一個單字
0行首
$行尾
^第一個非空白字元
gg輸入開始
G輸入結尾
f{char}跳到下一個字元出現位置
F{char}跳到上一個字元出現位置
t{char}跳到下一個字元出現位置之前
T{char}跳到上一個字元出現位置之後
;重複上一個 f/F/t/T 動作
,反向重複上一個 f/F/t/T 動作
在 vim 正常模式中，如果游標位於輸入的開始或結尾且無法進一步移動，j/k 和箭頭鍵將導航命令歷史。

​
編輯（NORMAL 模式）

命令動作
x刪除字元
dd刪除行
D刪除到行尾
dw/de/db刪除單字/到結尾/向後
cc變更行
C變更到行尾
cw/ce/cb變更單字/到結尾/向後
yy/Y複製行
yw/ye/yb複製單字/到結尾/向後
p在游標後貼上
P在游標前貼上
>>縮排行
<<取消縮排行
J合併行
u復原
.重複上一個變更

​
文字物件（NORMAL 模式）

文字物件與運算子（如 d、c 和 y）搭配使用：
命令動作
iw/aw內部/周圍單字
iW/aW內部/周圍 WORD（以空白分隔）
i"/a"內部/周圍雙引號
i'/a'內部/周圍單引號
i(/a(內部/周圍括號
i[/a[內部/周圍方括號
i{/a{內部/周圍大括號

​
視覺模式

按 v 進行字元式選擇或按 V 進行行式選擇。動作會擴展選擇，運算子直接作用於選擇。
命令動作
d/x刪除選擇
y複製選擇
c/s變更選擇
p用暫存器內容取代選擇
r{char}將每個選定的字元取代為 {char}
~/u/U切換、小寫或大寫選擇
>/<縮排或取消縮排選定的行
J合併選定的行
o交換游標和錨點
iw/aw/i"/…選擇文字物件
v/V在字元式和行式之間切換，或退出
不支援使用 Ctrl+V 的區塊式視覺模式。

​
命令歷史

Claude Code 維護目前會話的命令歷史：
  • 輸入歷史按工作目錄儲存
  • 當您執行 /clear 以開始新會話時，輸入歷史會重設。先前會話的對話會被保留，可以繼續進行。
  • 使用向上/向下箭頭導航（請參閱上面的快捷鍵）
  • 注意：歷史擴展（!）預設停用

​
使用 Ctrl+R 進行反向搜尋

按 Ctrl+R 以互動方式搜尋您的命令歷史：
  1. 開始搜尋：按 Ctrl+R 啟動反向歷史搜尋
  2. 輸入查詢：輸入文字以在先前的命令中搜尋。搜尋詞在匹配結果中醒目提示
  3. 導航匹配項：再次按 Ctrl+R 以循環瀏覽較舊的匹配項
  4. 變更範圍：搜尋預設為所有專案的提示。按 Ctrl+S 以在此會話、此專案和所有專案之間循環範圍
  5. 接受匹配項：
    • 按 Tab 或 Esc 以接受目前匹配項並繼續編輯
    • 按 Enter 以接受並立即執行命令
  6. 取消搜尋：
    • 按 Ctrl+C 以取消並恢復您的原始輸入
    • 在空搜尋上按 Backspace 以取消
搜尋顯示匹配的命令，搜尋詞醒目提示，因此您可以找到並重複使用先前的輸入。

​
背景 bash 命令

Claude Code 支援在背景執行 bash 命令，允許您在長時間執行的程序執行時繼續工作。

​
背景執行的工作原理

當 Claude Code 在背景執行命令時，它會非同步執行命令並立即傳回背景工作 ID。Claude Code 可以在命令在背景繼續執行時回應新提示。 若要在背景執行命令，您可以：
  • 提示 Claude Code 在背景執行命令
  • 按 Ctrl+B 將常規 Bash 工具呼叫移到背景。（Tmux 使用者必須按 Ctrl+B 兩次，因為 tmux 的前綴鍵。）
主要功能：
  • 輸出被寫入檔案，Claude 可以使用 Read 工具檢索它
  • 背景工作有唯一的 ID 用於追蹤和輸出檢索
  • 背景工作在 Claude Code 退出時會自動清理
  • 如果輸出超過 5GB，背景工作會自動終止，stderr 中會有說明原因的備註
若要停用所有背景工作功能，請將 CLAUDE_CODE_DISABLE_BACKGROUND_TASKS 環境變數設定為 1。詳見環境變數。 常見的背景執行命令：
  • 建置工具（webpack、vite、make）
  • 套件管理器（npm、yarn、pnpm）
  • 測試執行器（jest、pytest）
  • 開發伺服器
  • 長時間執行的程序（docker、terraform）

​
使用 ! 前綴的 Bash 模式

透過在輸入前加上 ! 直接執行 bash 命令，無需透過 Claude： 
! npm test
! git status
! ls -la
Bash 模式：
  • 將命令及其輸出新增到對話上下文
  • 顯示即時進度和輸出
  • 支援相同的 Ctrl+B 背景執行，用於長時間執行的命令
  • 不需要 Claude 解釋或批准命令
  • 支援基於歷史的自動完成：輸入部分命令並按 Tab 以從目前專案中的先前 ! 命令完成
  • 使用 Escape、Backspace 或在空提示上使用 Ctrl+U 退出
  • 將以 ! 開頭的貼上文字貼到空提示中會自動進入 bash 模式，符合輸入的 ! 行為
這對於快速 shell 操作同時維護對話上下文很有用。

​
提示建議

當您首次開啟會話時，提示輸入中會出現灰色的範例命令以幫助您開始。Claude Code 從您的專案的 git 歷史中選擇此項，因此它反映您最近一直在處理的檔案。 Claude 回應後，建議會根據您的對話歷史繼續出現，例如多部分請求的後續步驟或工作流程的自然延續。
  • 按 Tab 或 Right arrow 以將建議放入提示輸入中，然後按 Enter 以提交
  • 開始輸入以關閉它
建議作為背景請求執行，該請求重複使用父對話的提示快取，因此額外成本最少。當快取冷時，Claude Code 會跳過建議生成以避免不必要的成本。 在對話的第一輪之後、在非互動模式中以及在 Plan Mode 中，建議會自動跳過。 若要完全停用提示建議，請設定環境變數或在 /config 中切換設定： 
export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false

​
使用 /btw 的側面問題

使用 /btw 詢問有關您目前工作的快速問題，而不將其新增到對話歷史。當您想要快速答案但不想雜亂主要上下文或使 Claude 偏離長時間執行的工作時，這很有用。 
/btw what was the name of that config file again?
側面問題可以完全看到目前對話，因此您可以詢問 Claude 已經讀過的程式碼、它之前做出的決定或會話中的任何其他內容。問題和答案是短暫的：它們出現在可關閉的覆蓋層中，永遠不會進入對話歷史。
  • Claude 工作時可用：即使 Claude 正在處理回應時，您也可以執行 /btw。側面問題獨立執行，不會中斷主要輪次。
  • 無工具存取：側面問題僅從已在上下文中的內容回答。Claude 在回答側面問題時無法讀取檔案、執行命令或搜尋。
  • 單一回應：沒有後續輪次。如果您需要來回往返，請改用正常提示。
  • 低成本：側面問題重複使用父對話的提示快取，因此額外成本最少。
按 Space、Enter 或 Escape 以關閉答案並返回提示。 /btw 是 subagent 的反面：它看到您的完整對話但沒有工具，而 subagent 有完整工具但以空上下文開始。使用 /btw 詢問 Claude 從此會話已知的內容；使用 subagent 去發現新的東西。

​
工作清單

在處理複雜的多步驟工作時，Claude 會建立工作清單以追蹤進度。工作出現在終端的狀態區域中，指示器顯示待處理、進行中或完成的內容。
  • 按 Ctrl+T 以切換工作清單檢視。顯示一次最多 5 個工作
  • 若要查看所有工作或清除它們，直接詢問 Claude：「show me all tasks」或「clear all tasks」
  • 工作在上下文壓縮中持續存在，幫助 Claude 在較大的專案上保持組織
  • 若要在會話之間共享工作清單，請設定 CLAUDE_CODE_TASK_LIST_ID 以使用 ~/.claude/tasks/ 中的命名目錄：CLAUDE_CODE_TASK_LIST_ID=my-project claude

​
會話摘要

當您在離開終端後返回時，Claude Code 會顯示到目前為止會話中發生的情況的單行摘要。摘要在背景中生成，一旦自上次完成的輪次以來至少已過三分鐘且終端未聚焦，就會準備好。摘要僅在會話至少有三個輪次後出現，且永遠不會連續出現兩次。 執行 /recap 以按需生成摘要。若要關閉自動摘要，請開啟 /config 並停用會話摘要。 會話摘要在每個計畫和提供者上預設開啟。摘要在非互動模式中始終被跳過。

​
PR 審查狀態

在處理具有開啟拉取請求的分支時，Claude Code 在頁尾顯示可點擊的 PR 連結（例如「PR #446」）。連結有一個彩色底線，指示審查狀態：
  • 綠色：已批准
  • 黃色：待審查
  • 紅色：要求變更
  • 灰色：草稿
  • 紫色：已合併
Cmd+click（Mac）或 Ctrl+click（Windows/Linux）連結以在瀏覽器中開啟拉取請求。狀態每 60 秒自動更新。
PR 狀態需要安裝並驗證 gh CLI（gh auth login）。

​
另請參閱