為 Claude Code 設定您的終端機

修正 Shift+Enter 以插入新行、在 Claude 完成時取得終端機鈴聲、設定 tmux、符合色彩主題，以及在 Claude Code CLI 中啟用 Vim 模式。

Claude Code 可在任何終端機中無需設定即可運作。此頁面適用於當某些特定功能的行為不符合您的預期時。在下方找到您的症狀。如果一切已經感覺正確，您不需要此頁面。

• Shift+Enter 提交而非插入新行
• macOS 上的 Option 鍵快捷鍵無法運作
• Claude 完成時沒有聲音或警示
• 您在 tmux 內執行 Claude Code
• Windows 上的 Backspace 刪除整個單字
• 顯示閃爍或回捲跳躍
• 您想在提示中使用 Vim 快捷鍵

此頁面是關於讓您的終端機向 Claude Code 傳送正確的訊號。若要變更 Claude Code 本身回應的快捷鍵，請改為參閱 快捷鍵。

輸入多行提示

按 Enter 鍵提交您的訊息。若要在不提交的情況下新增換行符，請按 Ctrl+J，或輸入 \ 然後按 Enter。兩種方法在每個終端機上都可以使用，無需設定。

在大多數終端機中，您也可以按 Shift+Enter，但支援情況因終端機模擬器而異：

對於 VS Code、Cursor、Devin Desktop、Alacritty 0.16 之前的版本和 Zed，/terminal-setup 會將 Shift+Enter 快捷鍵寫入終端機的設定檔。在首次執行時，您會看到確認訊息，例如 Installed VSCode terminal Shift+Enter key binding。現有的快捷鍵設定會保留；如果您看到類似 VSCode terminal Shift+Enter key binding already configured 的訊息，表示未進行任何變更。請直接在主機終端機中執行 /terminal-setup，而不是在 tmux 或 screen 內執行，因為它需要寫入主機終端機的設定。

在 VS Code、Cursor 和 Devin Desktop 中，/terminal-setup 也會更新兩個編輯器設定：它將 terminal.integrated.gpuAcceleration 設定為 "off" 以防止整合終端機中的文字亂碼，並設定 terminal.integrated.mouseWheelScrollSensitivity 以在全螢幕模式中實現更平順的捲動。若要復原 GPU 加速變更，請將其設回 "auto" 並重新載入編輯器視窗。

在 Zed 中，/terminal-setup 會就地更新您的 keymap.json：

• 如果 keymap 已有快捷鍵設定，且其中沒有 Terminal shift-enter，Claude Code 會先將其備份到同一目錄中的副本（例如 keymap.json.1a2b3c4d.bak），然後將 Shift+Enter 快捷鍵合併到您的 keymap 中，保留您的其他快捷鍵和註解
• 如果 Claude Code 無法讀取或解析 keymap、無法備份，或無法驗證合併結果，它會保持檔案不變並列印快捷鍵區塊供您自行新增

如果您在 tmux 內執行，即使外部終端機支援，Shift+Enter 也需要下方的 tmux 設定。

若要將換行符綁定到不同的按鍵，或交換行為使 Enter 插入換行符而 Shift+Enter 提交，請在您的快捷鍵檔案中對應 chat:newline 和 chat:submit 動作。

在 macOS 上啟用 Option 鍵快捷鍵

某些 Claude Code 快捷鍵使用 Option 鍵，例如 Option+Enter 用於換行或 Option+P 用於切換模型。在 macOS 上，大多數終端機預設不會將 Option 作為修飾鍵發送，因此這些快捷鍵在啟用之前不會執行任何操作。終端機的此設定通常標記為「使用 Option 作為 Meta 鍵」；Meta 是現在標記為 Option 或 Alt 的鍵的歷史 Unix 名稱。

對於 Ghostty、Kitty 和其他終端機，請在終端機的設定檔中尋找 Option-as-Alt 或 Option-as-Meta 設定。

取得終端機鈴聲或通知

當 Claude 完成任務或暫停以等待權限提示，且您似乎不在終端機前時，它會觸發通知事件。請參閱各通知類型何時觸發以了解確切的時機。將此顯示為終端機鈴聲或桌面通知可讓您在長時間任務執行時切換到其他工作。

根據預設，Claude Code 僅在 Ghostty、Kitty 和 iTerm2 中傳送桌面通知。在其他終端機中，將 preferredNotifChannel 設定為 "terminal_bell" 以改為響起終端機鈴聲，或設定通知 hook 以取得自訂音效或命令。下列設定項目會開啟終端機鈴聲：

{
  "preferredNotifChannel": "terminal_bell"
}

桌面通知透過 SSH 到達您的本機，因此遠端工作階段仍可提醒您。Ghostty 和 Kitty 會將其轉發到您的作業系統通知中心，無需進一步設定。iTerm2 需要您啟用轉發：

如果通知仍未出現，請確認您的終端機應用程式在作業系統設定中具有通知權限，且如果您在 tmux 內執行，請啟用傳遞。

使用通知 hook 播放音效

在任何終端機中，您可以設定通知 hook 以在 Claude 需要您注意時播放音效或執行自訂命令。Hook 與內建通知一起執行，而不是取代它，因此不會收到桌面通知的終端機（例如 Warp 或 VS Code 整合終端機）可以使用 hook 或改為將 preferredNotifChannel 設定為 "terminal_bell"。

下列範例在 macOS 上播放系統音效。連結的指南包含 macOS、Linux 和 Windows 的桌面通知命令。

{
  "hooks": {
    "Notification": [
      {
        "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }]
      }
    ]
  }
}

設定 tmux

當 Claude Code 在 tmux 內執行時，預設會發生兩個問題：Shift+Enter 會提交而不是插入新行，且桌面通知和進度列永遠無法到達外層終端。將這些行新增到 ~/.tmux.conf，然後執行 tmux source-file ~/.tmux.conf 以將其套用到執行中的伺服器：

set -g allow-passthrough on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'

allow-passthrough 行讓通知和進度更新到達外層終端，而不是被 tmux 吞沒。extended-keys 行讓 tmux 區分 Shift+Enter 和純 Enter，以便換行快捷鍵能夠運作。

修復 Windows 上 Backspace 刪除整個單詞的問題

在 Windows 上，Claude Code 將到達的 Backspace 讀取為 ^H 時會將其解釋為 Ctrl+Backspace，這會刪除前一個單詞，除非 TERM_PROGRAM 是 mintty 或 TERM 是 cygwin。在 macOS 和 Linux 上，Claude Code 將其讀取為純 Backspace。

如果每次按下 Backspace 都會刪除整個單詞，表示您的終端機為純 Backspace 發送 ^H。設定 CLAUDE_CODE_BS_AS_CTRL_BACKSPACE=0。Backspace 和 Ctrl+H 隨後將各刪除一個字元。如果在 macOS 或 Linux 上 Ctrl+Backspace 只刪除一個字元，因為您的終端機為其發送 ^H，請改為將變數設定為 1。

配對色彩主題

使用 /theme 指令，或在 /config 中的主題選擇器，選擇與您的終端機相符的 Claude Code 主題。選擇自動選項會偵測您終端機的淺色或深色背景，因此主題會在您的終端機跟隨作業系統外觀變更時隨之改變。Claude Code 不會控制終端機本身的色彩配置，該配置由終端機應用程式設定。

若要自訂介面底部顯示的內容，請設定一個自訂狀態列，顯示目前的模型、工作目錄、Git 分支或其他內容。

建立自訂主題

除了內建預設值外，/theme 會列出您已定義的任何自訂主題，以及由已安裝的外掛程式貢獻的任何主題。選擇清單末尾的**新增自訂主題…**以互動方式建立一個：您命名主題，然後選擇要覆寫的個別色彩權杖。當自訂主題被反白顯示時，按 Ctrl+E 以編輯它。

每個自訂主題都是 ~/.claude/themes/ 中的 JSON 檔案。不含 .json 副檔名的檔案名稱是主題的 slug，選擇主題會將 custom:<slug> 儲存為您的主題偏好設定。該檔案有三個選用欄位：

色彩值接受 #rrggbb、#rgb、rgb(r,g,b)、ansi256(n) 或 ansi:<name>，其中 <name> 是 16 個標準 ANSI 色彩名稱之一，例如 red 或 cyanBright。未知的權杖和無效的色彩值會被忽略，因此打字錯誤無法破壞轉譯。

以下範例定義了一個保留深色預設值但重新著色提示符號重點、錯誤文字和成功文字的主題：

{
  "name": "Dracula",
  "base": "dark",
  "overrides": {
    "claude": "#bd93f9",
    "error": "#ff5555",
    "success": "#50fa7b"
  }
}

Claude Code 監視 ~/.claude/themes/ 並在檔案被新增或變更時重新載入，因此在您的編輯器中所做的編輯會在執行中的工作階段中套用，無需重新啟動。如果 Claude Code 啟動時 ~/.claude/themes/ 資料夾本身不存在，請在建立第一個主題檔案後重新啟動一次。之後，變更會在無需重新啟動的情況下套用。

下面的參考涵蓋了您可以在 overrides 中設定的權杖。/theme 中的互動式編輯器顯示相同的權杖，並提供即時預覽，加上一些單一用途的重點，例如此處省略的上線畫面色彩。

{
"name": "Midnight",
"base": "dark",
"overrides": {
"claude": "#a78bfa",
"planMode": "#38bdf8",
"diffAdded": "#14532d",
"diffRemoved": "#7f1d1d",
"userMessageBackground": "#1e1b4b"
}
}

切換至全螢幕渲染

在螢幕閱讀器模式中，本節不適用。Claude Code 始終呈現為純文字滾動，除非在附加的背景工作階段中，如果您在任何其他工作階段中執行 /tui fullscreen，Claude Code 會列印說明而不是切換。

如果顯示閃爍或在 Claude 工作時捲動位置跳動，請切換至全螢幕渲染模式。在此模式中，您可以使用滑鼠或 PageUp 在 Claude Code 內捲動，而不是使用終端機的原生捲回；請參閱全螢幕頁面以了解如何搜尋和複製。

如果閃爍是唯一的問題，且您的終端機支援同步輸出但未被自動偵測，例如 Emacs eat，請設定 CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 以停止閃爍而不改變渲染器。

執行 /tui fullscreen 以切換並儲存偏好設定。您的對話會完整重新啟動，未來的工作階段將以全螢幕啟動，除非全螢幕啟動失敗。您也可以在啟動 Claude Code 之前設定 CLAUDE_CODE_NO_FLICKER 環境變數：

CLAUDE_CODE_NO_FLICKER=1 claude

$env:CLAUDE_CODE_NO_FLICKER = "1"; claude

{
"env": {
"CLAUDE_CODE_NO_FLICKER": "1"
}
}

貼上大型內容

當您貼上超過 800 個字元或超過三行的內容到提示時，Claude Code 會將輸入摺疊為預留位置，例如 [Pasted text #1 +120 lines]，以保持輸入框可用，並在您提交時仍會傳送完整內容。對於非常大的輸入（例如整個檔案或長日誌），請將內容寫入檔案並要求 Claude 讀取它，而不是貼上。對話記錄保持可讀，Claude 可以在稍後的回合中按路徑參考該檔案。VS Code 整合終端也可能在非常大的貼上到達 Claude Code 之前從中丟棄字元，因此在那裡使用檔案。

如果貼上的內容包含隱形 Unicode 字元，Claude Code 會在您按下 Enter 時移除它們，並將清理後的提示放回輸入框供您以另一個 Enter 傳送。

Claude 如何處理貼上的文字

當您提交時，Claude 會看到每個 [Pasted text #N] 預留位置後面的內容，標記為您從其他地方貼上而非輸入的文字。Claude 被告知貼上可能包含您未撰寫的指示，並且只在您輸入的訊息要求時才遵循其中的指示。在不擷取功能旗標的工作階段中，貼上不會被標記。

刪除並復原摺疊的貼上

當您使用字詞或行快捷鍵（例如 Ctrl+W 或 Ctrl+K）刪除，或透過 f/t 動作（例如 df]）使用 vim 刪除，且刪除範圍到達 [Pasted text #N] 預留位置內部時，Claude Code 會完全移除預留位置。若要復原它，請在字詞或行快捷鍵後使用 Ctrl+Y 貼上刪除的內容，或在 vim 刪除後使用 p 在 NORMAL 模式中。

回想包含貼上文字的提示

Claude Code 將每個 [Pasted text #N] 預留位置後面的內容保留在 ~/.claude/paste-cache/ 下，因此當您從命令歷史回想提示並重新提交時，完整的貼上內容會再次傳送，包括在稍後的工作階段中。

早於 cleanupPeriodDays 的快取檔案會根據保留掃描規則被刪除，因此回想的提示可能參考不再存在的貼上文字。當您提交這樣的提示時，Claude Code 永遠不會傳送字面上的 [Pasted text #N] 字串，並顯示通知命名遺失的貼上：

• 在有剩餘文字的純提示中，Claude Code 移除預留位置並傳送剩餘文字。
• 在殼層模式命令或 / 命令中，移除會改變執行的內容，以及在任何提示中移除留下空白時，Claude Code 取消提交並在輸入中保留原始文字，預留位置仍在其中。刪除預留位置或編輯命令，然後重新提交。

使用 Vim 快捷鍵編輯提示詞

Claude Code 包含用於提示詞輸入的 Vim 風格編輯模式。透過 /config → Editor mode 啟用它，或在 ~/.claude/settings.json 中將 editorMode 設定為 "vim"。將 Editor mode 設回 normal 以關閉它。

Vim 模式支援 NORMAL 和 VISUAL 模式動作和運算子的子集，例如 hjkl 導航、v/V 選擇，以及 d/c/y 搭配文字物件。請參閱 Vim 編輯器模式參考 以取得完整的快捷鍵表。

Vim 動作無法透過快捷鍵檔案重新對應。若要將兩個按鍵的 INSERT 模式序列（例如 jj）對應到 Escape，請在使用者設定中設定 vimInsertModeRemaps。

在 INSERT 模式中按 Enter 仍會提交您的提示詞，不同於標準 Vim。在 NORMAL 模式中使用 o 或 O，或按 Ctrl+J，以插入新行。

相關資源

• 互動模式：完整鍵盤快捷鍵參考和 Vim 快捷鍵表
• 快捷鍵：重新對應任何 Claude Code 快捷鍵，包括 Enter 和 Shift+Enter
• 全螢幕渲染：全螢幕模式中捲動、搜尋和複製的詳細資訊
• Hooks 指南：Linux 和 Windows 的更多通知 hook 範例
• 疑難排解：終端機配置外部問題的修復