---
title: "Claude Code 指令大全"
description: "收錄 321 個 Claude Code CLI 指令、斜線命令、快捷鍵與設定檔參考"
source: https://aiterms.tw/cheatsheet/claude-code
version: "2.0.0"
lastUpdated: "2026-10-31"
---

# Claude Code 指令大全

> 收錄 321 個 CLI 指令、斜線命令、快捷鍵與設定檔參考。
> 版本：2.0.0 | 更新：2026-10-31

## 🚀 CLI 啟動與子指令（CLI Launch & Subcommands）

啟動 Claude Code、接續與恢復 session、背景代理、登入與安裝等終端機指令

### `claude` : 啟動互動模式（基礎）

在目前資料夾啟動 Claude Code 互動 session

### `claude "query"` : 帶著第一句話啟動（基礎）

啟動互動 session 並直接送出第一個提示

```
claude "說明這個專案的資料夾結構"
```

### `claude -p "query"` : 非互動執行（print 模式）（基礎）

執行一次查詢後輸出結果並結束，適合腳本與 CI

```
claude -p "解釋這個錯誤訊息"
```

### `cat file | claude -p "query"` : 用管線餵資料（進階）

把檔案或其他指令的輸出經由 stdin 交給 Claude 處理

```
cat error.log | claude -p "找出錯誤根因"
```

### `claude -c` : 接續最近的對話（基礎）

載入目前資料夾最近一次對話，包含已經結束的背景 session

### `claude -c -p "query"` : 接續對話並非互動執行（進階）

接著最近一次對話，用 print 模式送出一個提示後結束

### `claude -r "<session>" "query"` : 依 ID 或名稱恢復 session（進階）

恢復指定的 session，不帶 ID 時開啟選單挑選

```
claude -r "auth-refactor" "繼續做完測試"
```

### `claude -w` : 在獨立 git worktree 啟動（進階）

在 <repo>/.claude/worktrees/<name> 建立隔離工作區再啟動，不給名稱會自動產生，也可以傳 PR 編號或網址

```
claude -w feature-auth
```

### `claude -w name --tmux` : worktree 搭配 tmux（進階）

為 worktree 建立 tmux session，需要同時使用 --worktree，iTerm2 可用時改用原生分割窗格

### `claude --bg "task"` : 以背景代理啟動（進階）

把 session 當成背景代理啟動並立即返回，印出 session ID 與管理指令

```
claude --bg "幫我補齊 utils 的單元測試"
```

### `claude agents` : 開啟 agent view（進階）

監看與派送平行執行的背景 session，可加 --json 輸出給腳本使用

### `claude attach <id|name>` : 接回背景 session（進階）

在這個終端機接上一個背景 session

```
claude attach 7c5dcf5d
```

### `claude logs <id|name>` : 查看背景 session 輸出（進階）

印出背景 session 最近的輸出內容

### `claude stop <id>` : 停止背景 session（進階）

停止指定的背景 session，也接受 claude kill

### `claude --cloud "task"` : 建立雲端 session（進階）

用一段任務描述在雲端建立新 session，舊的 --remote 是已淘汰的別名

```
claude --cloud "修正登入頁的 CI 失敗"
```

### `claude --teleport` : 把雲端 session 接回本機（進階）

在本機終端機恢復一個雲端 session

### `claude remote-control` : 啟動 Remote Control 伺服器（進階）

以伺服器模式執行，讓你從 claude.ai 或 Claude App 操作這台電腦上的 Claude Code

```
claude remote-control --name "My Project"
```

### `claude update` : 更新到最新版（基礎）

手動更新 Claude Code

### `claude install [version]` : 安裝或重裝原生執行檔（進階）

可指定版本號，或 stable、latest

```
claude install stable
```

### `claude -v` : 查看版本（基礎）

輸出目前版本號，等同 --version

### `claude doctor` : 終端機直接做安裝診斷（基礎）

不啟動 session，印出安裝狀態與設定檔驗證等唯讀診斷

### `claude auth login` : 登入 Anthropic 帳號（基礎）

可加 --email 預填信箱、--sso 強制 SSO、--console 改用 Console（API 計費）登入

### `claude auth logout` : 登出帳號（基礎）

登出目前的 Anthropic 帳號

### `claude auth status` : 查看登入狀態（進階）

以 JSON 顯示驗證狀態，加 --text 改成一般文字，已登入時結束碼為 0

### `claude setup-token` : 產生長效 OAuth token（進階）

給 CI 與腳本使用的 token，只印在終端機不會存檔，需要 Claude 訂閱方案

### `claude mcp add --transport http <name> <url>` : 新增 MCP 伺服器（基礎）

從終端機新增遠端 HTTP MCP 伺服器，本機伺服器也用 claude mcp 管理

```
claude mcp add --transport http notion https://mcp.notion.com/mcp
```

### `claude mcp login <name>` : MCP OAuth 登入（進階）

不開 /mcp 面板，直接跑指定 MCP 伺服器的 OAuth 流程，登出用 claude mcp logout

### `claude plugin` : 管理外掛（進階）

在終端機管理 Claude Code 外掛，別名 claude plugins

### `claude import [source]` : 匯入其他 coding agent 設定（進階）

啟動互動 session 執行 /import，把 Codex、Gemini CLI 或 Cursor 的設定帶進來

### `claude ultrareview [target]` : 非互動執行 ultrareview（進階）

在終端機直接跑雲端多代理程式碼審查，結果輸出到 stdout

### `claude auto-mode defaults` : 查看 auto mode 內建規則（隱藏）

把 auto mode 分類器的內建規則以 JSON 印出，還原預設用 claude auto-mode reset

### `claude purge [path]` : 清除專案的本機資料（隱藏）

刪除某個專案的對話紀錄、任務清單、除錯紀錄與編輯歷史，可先加 --dry-run 預覽

刪除後無法復原，先用 --dry-run 確認範圍。

```
claude purge ~/work/repo --dry-run
```

## 🏳️ CLI 旗標與參數（CLI Flags）

控制模型、權限、輸出格式、設定來源與 print 模式的啟動旗標

### `--model <alias|name>` : 指定模型（基礎）

用別名（sonnet、opus、haiku、fable）或完整模型名稱設定這個 session 的模型

```
claude --model opus
```

### `--effort <level>` : 設定推理強度（進階）

可選 low、medium、high、xhigh、max 或 ultracode，實際可用等級依模型而定，只對這個 session 有效

```
claude --effort high
```

### `--permission-mode <mode>` : 指定起始權限模式（進階）

可用 default、acceptEdits、plan、auto、dontAsk、bypassPermissions，manual 是 default 的別名

```
claude --permission-mode plan
```

### `--dangerously-skip-permissions` : 略過所有權限確認（進階）

等同 --permission-mode bypassPermissions，只適合完全隔離的環境

會讓 Claude 不經確認就執行指令與改檔，不要在有正式資料或金鑰的機器上使用。

### `--allow-dangerously-skip-permissions` : 把 bypass 加入切換循環（隱藏）

不以 bypassPermissions 開始，但讓 Shift+Tab 可以切到它

### `--allowedTools "Bash(git *)" "Read"` : 免確認的工具清單（進階）

列出不需要詢問就能執行的工具與規則，也可寫成 --allowed-tools

### `--disallowedTools "Edit"` : 禁止的工具（進階）

拒絕規則，寫工具名稱會把該工具從 Claude 可用清單移除，"mcp__*" 可移除所有 MCP 工具

### `--tools "Bash,Edit,Read"` : 限制內建工具（進階）

只開放指定的內建工具，"" 全部關閉，"default" 為預設組合，不影響 MCP 工具

### `--system-prompt "..."` : 取代系統提示（進階）

用自訂文字取代整個預設系統提示

### `--system-prompt-file path` : 用檔案取代系統提示（進階）

讀取檔案內容取代預設系統提示

### `--append-system-prompt "..."` : 附加系統提示（進階）

在預設系統提示最後面加上一段文字，保留內建行為

### `--append-system-prompt-file path` : 用檔案附加系統提示（進階）

讀取檔案內容接在預設系統提示後面

### `--output-format json` : print 模式輸出格式（進階）

可選 text、json、stream-json，只在 -p 模式有效

```
claude -p "query" --output-format json
```

### `--input-format stream-json` : print 模式輸入格式（隱藏）

可選 text 或 stream-json

### `--include-partial-messages` : 輸出串流中的部分訊息（隱藏）

需要搭配 --print 與 --output-format stream-json

### `--json-schema '{...}'` : 結構化 JSON 輸出（進階）

代理流程結束後回傳符合 JSON Schema 的結果，只在 print 模式有效

### `--max-turns 3` : 限制代理回合數（進階）

超過回合數就以錯誤結束，預設不限制，只在 print 模式有效

### `--max-budget-usd 5.00` : 花費上限（進階）

預估的 API 花費達到上限就停止，只在 print 模式有效

### `--add-dir ../lib` : 加入額外工作目錄（進階）

讓 Claude 可以讀寫其他資料夾，該資料夾大部分的 .claude/ 設定不會被自動載入

### `--settings ./settings.json` : 載入設定檔（進階）

指定設定 JSON 檔或直接傳 JSON 字串，覆蓋同名設定，只對這個 session 有效

### `--setting-sources user,project` : 指定設定來源（隱藏）

只載入列出的設定來源（user、project、local）

### `--name "my-session" / -n` : 替 session 命名（基礎）

名稱會顯示在 /resume 與終端機標題，之後可用 claude --resume <name> 恢復

### `--agent <name>` : 指定這個 session 用的 agent（進階）

覆蓋 agent 設定，讓主 session 以指定的 agent 身分執行

### `--agents '{...}'` : 用 JSON 臨時定義 subagents（隱藏）

在啟動時以 JSON 動態定義自訂 subagents

### `--chrome / --no-chrome` : Chrome 瀏覽器整合（進階）

開啟或關閉這個 session 的 Chrome 整合，用於網頁測試與自動化

### `--mcp-config ./mcp.json` : 載入 MCP 設定（進階）

從 JSON 檔或字串載入 MCP 伺服器，多個用空白分隔

### `--strict-mcp-config` : 只用指定的 MCP 設定（隱藏）

忽略其他所有 MCP 設定，只用 --mcp-config 給的伺服器

### `--permission-prompt-tool mcp__<server>__<tool>` : 用 MCP 工具處理權限詢問（隱藏）

非互動模式下，把權限詢問交給指定的 MCP 工具決定

### `--plugin-dir ./my-plugin` : 載入本機外掛（進階）

從資料夾或 .zip 載入外掛，只對這個 session 有效

### `--debug='mcp,startup'` : 除錯模式（進階）

開啟除錯並可用等號形式過濾類別，例如 --debug='!mcp' 排除 MCP

過濾條件只在 = 的寫法生效，用空白分隔只會開啟除錯、不會過濾。

### `--debug-file /tmp/debug.log` : 除錯紀錄寫到檔案（進階）

把除錯紀錄寫到指定檔案，同時自動開啟除錯模式

### `--verbose` : 詳細輸出（進階）

顯示完整的逐回合輸出

### `--bare` : 最小模式（進階）

略過 hooks、skills、外掛、MCP、自動記憶與 CLAUDE.md 的自動載入，腳本呼叫啟動更快

```
claude --bare -p "query"
```

### `--safe-mode` : 安全模式排錯（進階）

關閉所有自訂內容（CLAUDE.md、skills、外掛、hooks、MCP 等）啟動，用來排查壞掉的設定

### `--init` : 執行 Setup hooks（init）（隱藏）

在 print 模式開始前執行 matcher 為 init 的 Setup hooks

### `--init-only` : 只跑 Setup hooks 後結束（隱藏）

執行 Setup 與 SessionStart hooks 後直接結束，不開始對話

### `--no-session-persistence` : 不儲存 session（隱藏）

session 不寫入磁碟、之後也無法恢復，只在 print 模式有效

### `--from-pr 123` : 依 PR 找 session（進階）

開啟只列出與指定 PR 相關 session 的選單，支援 GitHub、GitLab、Bitbucket 網址

### `--fork-session` : 恢復時另開新 session（隱藏）

搭配 --resume 或 --continue 使用，產生新的 session ID 而不覆寫原本的

### `--session-id "uuid"` : 指定 session ID（隱藏）

用指定的 UUID 當作這次對話的 session ID

### `--fallback-model sonnet,haiku` : 備援模型鏈（進階）

主要模型過載或無法使用時，依序改用清單中的模型

### `--ide` : 啟動時自動連 IDE（進階）

剛好只有一個可用 IDE 時自動連上

### `--betas <header>` : 附加 beta header（隱藏）

在 API 請求加上 beta header，只適用 API 金鑰使用者

### `--teammate-mode auto` : agent team 隊友顯示方式（隱藏）

可選 in-process（預設）、auto、tmux、iterm2

### `--disable-slash-commands` : 停用 skills 與指令（隱藏）

這個 session 停用所有 skills 與斜線指令

### `--remote-control / --rc` : 開啟 Remote Control 的互動 session（進階）

啟動互動 session，同時讓你可以從 claude.ai 或 Claude App 接手

```
claude --remote-control "My Project"
```

### `--exclude-dynamic-system-prompt-sections` : 把個人化內容移出系統提示（隱藏）

把自動記憶位置等個人化內容移到第一則使用者訊息，提高跨使用者的快取重用

### `--desktop` : 改在桌面版開啟（進階）

在 Claude 桌面 App 開啟目前資料夾並結束終端機

### `--advisor <model>` : 開啟 advisor 工具（隱藏）

這個 session 啟用伺服器端 advisor，在關鍵時刻諮詢第二個模型

### `--autocompact <auto|tokens>` : 設定自動壓縮門檻（隱藏）

指定 context 用到多少時自動壓縮，auto 回到依模型調整的預設值

## ⌨️ 斜線指令（Slash Commands）

在互動 session 輸入 / 開頭的內建指令與內附 skill，依官方 Commands 參考整理

### `/help` : 說明與指令清單（基礎）

顯示說明與目前可用的指令

### `/init` : 建立 CLAUDE.md（基礎）

分析專案並產生 CLAUDE.md，設定 CLAUDE_CODE_NEW_INIT=1 可改成互動流程，一併處理 skills 與 hooks

### `/memory` : 編輯記憶檔（基礎）

編輯 CLAUDE.md、開關自動記憶並查看自動記憶內容

### `/clear [name]` : 清空對話重新開始（基礎）

以空白 context 開始新對話，專案記憶保留，別名 /reset、/new

### `/compact [instructions]` : 壓縮對話騰出 context（基礎）

把目前對話摘要以釋放 context，可附上摘要重點

```
/compact 保留 API 設計決策與待辦
```

### `/context [all]` : 查看 context 用量（基礎）

用彩色格狀圖顯示 context 使用狀況與最佳化建議

### `/autocompact [auto|<tokens>]` : 設定自動壓縮門檻（進階）

設定 context 滿到多少時自動壓縮，例如 500k，auto 回到預設

### `/model [model]` : 切換模型（基礎）

切換模型並存成新 session 的預設值，選單中按 s 只切換目前 session，左右鍵可調推理強度

### `/effort [level|auto|status]` : 調整推理強度（進階）

設定 low 到 xhigh、max 或 auto，status 顯示目前等級，ultracode on/off 開關 ultracode

### `/fast [on|off]` : 開關 fast mode（進階）

切換 fast mode，回應中執行也會立即切換，但進行中的回合維持原速度

### `/advisor [model|off]` : 開關 advisor 工具（隱藏）

讓 Claude 在關鍵時刻諮詢第二個模型，可指定 fable、opus、sonnet 或完整模型 ID

### `/plan [description]` : 進入 plan mode（基礎）

直接進入規劃模式，可順便帶上任務，例如 /plan fix the auth bug

### `/goal [condition|clear]` : 設定目標條件（進階）

Claude 會跨回合持續工作直到條件達成，clear、stop 等可提前取消

```
/goal 所有單元測試通過且 lint 沒有錯誤
```

### `/permissions` : 管理權限規則（基礎）

檢視與增刪 allow、ask、deny 規則，也能查看 auto mode 最近拒絕的動作

### `/config [key=value ...]` : 開啟設定（基礎）

開啟設定介面，也可直接設定，例如 /config theme=dark

### `/status` : 查看狀態（基礎）

顯示版本、模型、帳號與連線狀態，回應中也能執行

### `/usage` : 查看用量與花費（基礎）

顯示 session 花費、方案用量上限與活動統計，/cost 與 /stats 是別名

舊的 /cost 仍可用，會開啟同一個畫面。

### `/usage-credits` : 設定用量點數（進階）

碰到用量上限時設定或向管理員申請 usage credits

### `/rate-limit-options` : 碰到用量上限的選項（進階）

顯示等額度重置自動繼續、加購點數等繼續工作的方式

### `/upgrade` : 升級方案（基礎）

在瀏覽器開啟升級方案頁面

### `/diff` : 檢視變更（基礎）

查看工作目錄的變更，包含 Claude 目前做的修改

### `/code-review [effort] [--fix] [target]` : 程式碼審查找 bug（基礎）

內附 skill：審查目前 diff、PR 編號、分支或路徑的正確性問題，--fix 直接套用修正，ultra 改在雲端跑多代理審查

/review 是別名，/ultrareview 等同 /code-review ultra。

```
/code-review high 1234
```

### `/security-review` : 安全性審查（進階）

分析目前分支相對 origin 預設分支的變更，找出注入、驗證與資料外洩等風險

### `/ultrareview [PR or branch]` : 雲端深度審查（進階）

在雲端沙盒跑多代理深度程式碼審查，可指定 PR 或比較基準分支，官方建議改用 /code-review ultra，/ultrareview 是別名

依官方說明，Pro、Max、Ultra 方案含 3 次免費執行，之後需要 usage credits。

### `/simplify [target]` : 精簡程式碼（進階）

內附 skill：四個審查代理平行檢查重用、簡化、效率與抽象層級並套用修正，不負責找 bug

### `/verify` : 實際跑起來驗證（進階）

內附 skill：建置並執行專案 App 觀察結果，確認修改真的有效

### `/run` : 啟動並操作 App（進階）

內附 skill：把專案 App 跑起來並實際操作，看到修改的效果

### `/run-skill-generator` : 產生專案的 run skill（隱藏）

內附 skill：寫一個專案專用 skill，教 /run 與 /verify 如何從乾淨環境建置與操作 App

### `/batch <instruction>` : 大規模平行修改（進階）

內附 skill：研究程式碼後拆成 5 到 30 個獨立單元，核准後每個單元在獨立 worktree 由背景 subagent 實作

### `/loop [interval] [prompt]` : 重複執行提示（進階）

內附 skill：session 開著時定時重複執行，例如 /loop 5m check if the deploy finished，別名 /proactive

### `/schedule [description]` : 雲端排程任務（進階）

建立、更新、列出或執行雲端排程任務（舊稱 routines），別名 /routines

### `/tasks` : 查看背景工作（進階）

檢視與管理這個 session 的背景工作，包含已完成的 subagents，別名 /bashes

### `/subtask <task>` : 派出分叉 subagent（進階）

背景 subagent 繼承完整對話處理任務，完成後結果回到目前對話

### `/fork [prompt]` : 複製對話到背景 session（進階）

把目前對話複製成新的背景 session，自己繼續在這裡工作

### `/branch [name]` : 分支目前對話（進階）

在這個時間點分出一條對話嘗試其他方向，原本的對話可用 /resume 回去

### `/background [prompt]` : 把 session 轉到背景（進階）

讓目前 session 變成背景代理繼續跑並釋放終端機，用 claude agents 監看

### `/stop` : 停止背景 session（進階）

停止目前接上的背景 session，對話紀錄與 worktree 會保留

### `/list-agents` : 列出可傳訊息的代理（隱藏）

列出 Claude 可以傳訊息的 subagents、agent team 隊友與其他 session

### `/agents` : 管理 subagents（進階）

目前版本會提示你請 Claude 建立或管理 subagents，或直接編輯 .claude/agents/ 資料夾

### `/btw [question]` : 問旁支問題（進階）

針對目前 session 問一個問題，但不加入對話紀錄

### `/recap` : 一句話摘要 session（基礎）

隨時產生目前 session 的一行摘要

### `/resume [session]` : 恢復其他對話（基礎）

依 ID 或名稱恢復對話，或開啟選單，背景 session 會標上 bg

### `/rename [name]` : 重新命名 session（基礎）

替目前 session 命名並顯示在提示列，不給名稱會自動產生

### `/rewind` : 倒回對話或程式碼（基礎）

把對話及程式碼回到先前的檢查點，或從某則訊息開始摘要，別名 /checkpoint、/undo

### `/export [filename]` : 匯出對話（基礎）

把目前對話匯出成純文字，給檔名會直接寫入檔案

### `/copy [N]` : 複製回應（基礎）

複製最後一則回應，/copy 2 複製倒數第二則，有程式碼區塊時可挑選，按 w 改寫入檔案

### `/add-dir <path>` : 新增工作目錄（進階）

這個 session 多加一個可讀寫的資料夾，輸入部分路徑可用 Tab 補完

### `/cd <path>` : 移動到新工作目錄（進階）

保留對話，把 session 移到另一個資料夾

### `/mcp` : 管理 MCP 連線（進階）

開啟 MCP 伺服器清單處理連線與 OAuth，也可直接用 reconnect、enable、disable

```
/mcp reconnect all
```

### `/hooks` : 查看 hooks 設定（進階）

檢視目前的 hook 設定

### `/skills` : 列出 skills（進階）

列出可用 skills，可依名稱或來源篩選，按 t 依 token 數排序

### `/skill-doctor` : 檢查 skills 成本（隱藏）

顯示每個 skill 佔用的 context 與使用頻率，找出可以關掉的 skill

### `/reload-skills` : 重新掃描 skills（進階）

不用重啟就載入新增或修改過的 skills 與指令檔

### `/plugin [subcommand]` : 管理外掛（進階）

開啟外掛選單，或直接用 list、install、enable、disable

### `/reload-plugins` : 重新載入外掛（進階）

不用重啟就套用外掛變更，並列出載入錯誤

### `/plugin-authoring` : 寫 mod 的參考（隱藏）

載入 Claude 寫 mod 時依據的參考資料

### `/workflows` : 查看工作流進度（隱藏）

開啟動態 workflow 進度畫面，可暫停、恢復或儲存

### `/workflow-authoring` : 寫 workflow 腳本的參考（隱藏）

內附 skill：載入動態 workflow 腳本的 API 與範例

### `/deep-research <question>` : 深度研究（進階）

內附 workflow：平行搜尋網路、交叉比對來源後寫出有引用的報告

### `/output-style [style]` : 切換輸出風格（進階）

列出或切換輸出風格，例如 /output-style concise

### `/statusline` : 設定狀態列（進階）

描述想要的狀態列內容，或不帶參數從 shell 提示自動設定

### `/theme` : 切換配色主題（基礎）

包含自動、淺色、深色、色盲友善與自訂主題

### `/color [color|default]` : 提示列顏色（隱藏）

設定這個 session 的提示列顏色，default 還原

### `/tui [default|fullscreen]` : 切換畫面渲染方式（進階）

fullscreen 改用不閃爍的全螢幕渲染，切換時保留對話

### `/focus` : 專注檢視（隱藏）

只顯示最後的提示、工具摘要與最終回應，限全螢幕渲染

### `/scroll-speed` : 調整捲動速度（隱藏）

互動調整滑鼠滾輪捲動速度，限全螢幕渲染

### `/keybindings` : 自訂快捷鍵（進階）

開啟 ~/.claude/keybindings.json 設定檔

### `/terminal-setup` : 設定 Shift+Enter 換行（基礎）

在 VS Code、Cursor、Alacritty、Zed 等終端機安裝 Shift+Enter 換行，Apple Terminal 改設定 Option+Enter

### `/voice [hold|tap|off]` : 語音輸入（進階）

開關語音聽寫或指定按住、點按模式，需要 Claude.ai 帳號

### `/ide` : 管理 IDE 整合（進階）

管理 IDE 連線並顯示狀態

### `/chrome` : Claude in Chrome 設定（進階）

設定 Chrome 瀏覽器整合

### `/claude-in-chrome [task]` : 在瀏覽器執行任務（進階）

內附 skill：透過 Claude in Chrome 測試頁面、填表或讀 console

### `/desktop` : 移到桌面版繼續（進階）

在 Claude Code 桌面 App 接續目前 session，需要 macOS 或 x64 Windows，別名 /app

### `/mobile` : 下載手機 App（基礎）

顯示下載 Claude 手機 App 的 QR code，別名 /ios、/android

### `/remote-control` : 開放 Remote Control（進階）

讓這個 session 可以從 claude.ai 接手，需要 claude.ai 訂閱，別名 /rc

### `/teleport` : 拉回雲端 session（進階）

把雲端 session 的分支與對話拉到這個終端機，別名 /tp

### `/remote-env` : 選雲端環境（隱藏）

選擇從 CLI 啟動雲端 session 時的預設環境

### `/web-setup` : 連結 GitHub 給雲端 session（進階）

用本機 gh CLI 憑證連結 GitHub 帳號

### `/autofix-pr [prompt]` : 自動修 PR（進階）

建立雲端 session 盯著目前分支的 PR，CI 失敗或有審查意見時推送修正

### `/install-github-app` : 安裝 Claude GitHub App（進階）

替 repo 安裝 GitHub App，可順便設定 GitHub Actions 與 secrets

### `/install-slack-app` : 安裝 Claude Slack App（進階）

開啟瀏覽器完成 Slack OAuth

### `/import [codex|gemini|cursor]` : 匯入其他工具設定（進階）

把 Codex、Gemini CLI 或 Cursor 的指示檔、MCP、指令與 skills 帶進 Claude Code，--dry-run 先預覽

### `/doctor` : 安裝與設定健檢（基礎）

內附 skill：診斷安裝、設定、擴充與 CLAUDE.md 問題，確認後代為修正，別名 /checkup

### `/debug [description]` : 開除錯紀錄並排查（進階）

內附 skill：從現在開始記錄除錯資訊並讀取紀錄找問題

### `/heapdump` : 記憶體快照（隱藏）

輸出 JavaScript heap snapshot 與記憶體分析，診斷記憶體用量過高，選單中不會顯示

### `/feedback [report]` : 回報問題或意見（基礎）

開啟回報對話框，送出前可選擇附上多少 session 紀錄，/bug 直接開同一個對話框

### `/release-notes` : 查看更新紀錄（基礎）

用版本選單查看 changelog，不會進入對話內容

### `/restart` : 重啟套用更新（進階）

重新啟動並恢復這個 session 以套用已安裝的更新

### `/insights` : 使用習慣報告（進階）

分析這台電腦最近的 sessions，產生 HTML 報告

### `/team-onboarding` : 產生團隊上手指南（進階）

分析過去 30 天的使用紀錄，產生給隊友的上手文件

### `/powerup` : 互動功能教學（基礎）

用短課程與動畫認識 Claude Code 功能

### `/fewer-permission-prompts` : 減少權限詢問（進階）

內附 skill：掃描過去的唯讀 Bash 與 MCP 呼叫，建議加進專案 allowlist

### `/auto-mode-setup` : 草擬 auto mode 環境設定（隱藏）

依專案與最近 sessions 草擬 autoMode.environment 設定並存到使用者設定

### `/update-config [request]` : 用描述改設定（進階）

內附 skill：描述想改的設定（允許指令、環境變數、hook），Claude 改對應的 settings.json

### `/sandbox` : 開關沙盒模式（進階）

切換沙盒模式，限支援的平台

### `/privacy-settings` : 隱私設定（基礎）

查看與更新隱私設定，限 Pro、Max、Ultra 訂閱

### `/login` : 登入（基礎）

登入 Anthropic 帳號

### `/logout` : 登出（基礎）

登出 Anthropic 帳號

### `/exit` : 結束 CLI（基礎）

結束 Claude Code，在背景 session 中則是離開但不停止，別名 /quit

### `/setup-bedrock` : 設定 Amazon Bedrock（隱藏）

用互動精靈設定 Bedrock 驗證、區域與模型

### `/setup-vertex` : 設定 Google Cloud（隱藏）

用互動精靈設定 Google Cloud Agent Platform 的驗證、專案與模型

### `/claude-api` : Claude API 專案助手（進階）

內附 skill：載入 Claude API 參考，處理遷移、升級、成本最佳化等任務

### `/artifacts` : 找回 artifacts（進階）

列出自己擁有或別人分享的 artifacts，附加到 session、在瀏覽器開啟或複製連結

### `/artifact-capabilities` : artifact 能力參考（隱藏）

內附 skill：載入發布後 artifact 可用的執行期能力說明

### `/artifact-diagramming` : artifact 畫圖指引（隱藏）

內附 skill：artifact 中什麼時候畫圖、畫什麼與怎麼寫

### `/dataviz [request]` : 圖表設計指引（進階）

內附 skill：依資料選圖表形式、配色與色盲安全檢查

### `/slides [brief]` : 做簡報（進階）

內附 skill：依需求做一份 Claude Slides 簡報 artifact

### `/design [brief]` : 畫 UI 草稿（進階）

內附 skill：把 UI 草稿、畫面流程或海報畫在同一張畫布，發布成 Claude Design artifact

### `/design consent` : 授權 Claude Design（隱藏）

授權 Claude 存取 Claude Design，撤回用 /design revoke

### `/design-login` : 登入 Claude Design（隱藏）

替 /design-sync 用 claude.ai 帳號授權設計系統存取

### `/design-sync [hint]` : 同步設計系統（隱藏）

內附 skill：把 repo 的 React 設計系統轉換上傳到 Claude Design

### `/passes` : 分享免費試用（隱藏）

把一週免費的 Claude Code 分享給朋友，帳號符合資格才看得到

### `/radio` : Lo-fi 電台（隱藏）

在瀏覽器開啟 Claude FM lo-fi 電台

### `/stickers` : 訂購貼紙（隱藏）

訂購 Claude Code 貼紙

## ⌥ 鍵盤快捷鍵（Keyboard Shortcuts）

一般操作、文字編輯、多行輸入、快速前綴與逐字稿檢視器的快捷鍵

### `Ctrl+C` : 中斷或清空輸入（基礎）

中斷目前動作，或清空輸入框

### `Ctrl+D` : 結束 session（基礎）

離開 Claude Code

### `Esc` : 中斷 Claude 或關閉對話框（基礎）

停止 Claude 目前的回應，或關掉開啟中的對話框

### `Esc + Esc` : 清除草稿或倒回（基礎）

連按兩次 Esc 清除輸入草稿，或開啟倒回（rewind）選單

### `Shift+Tab` : 切換權限模式（基礎）

依序切換 default、acceptEdits、plan 等模式，部分 Windows 環境改用 Alt+M

### `Option+P / Alt+P` : 切換模型（基礎）

macOS 按 Option+P，Windows 與 Linux 按 Alt+P

### `Option+T / Alt+T` : 切換延伸思考（進階）

開關 extended thinking，對一律使用延伸思考的模型沒有作用

### `Option+O / Alt+O` : 切換 fast mode（進階）

macOS 按 Option+O，Windows 與 Linux 按 Alt+O

### `Ctrl+G / Ctrl+X Ctrl+E` : 用編輯器寫提示（進階）

在預設文字編輯器開啟目前輸入，適合寫長提示

### `Ctrl+L` : 重繪畫面（基礎）

重新繪製終端機畫面

### `Ctrl+O` : 逐字稿檢視器（進階）

開關完整的逐字稿（transcript）檢視

### `Ctrl+R` : 搜尋輸入歷史（基礎）

反向搜尋先前輸入過的提示

### `Ctrl+V / Cmd+V（iTerm2）/ Alt+V（Windows）` : 貼上圖片（基礎）

把剪貼簿的圖片貼進提示

### `Ctrl+B` : 把執行中的工作移到背景（進階）

讓正在跑的工作轉到背景繼續

### `Ctrl+T` : 顯示任務清單（進階）

開關 Claude 的任務清單

### `Ctrl+S` : 暫存或還原提示（進階）

把寫到一半的提示先收起來，之後再還原

### `Ctrl+Z` : 暫停 Claude Code（進階）

把程式暫停到背景（終端機的 suspend）

### `Ctrl+X Ctrl+K` : 停止所有背景 subagents（進階）

停止這個 session 所有執行中的背景 subagents

### `Ctrl+Enter / Ctrl+X Ctrl+S` : 立即送出排隊訊息（進階）

Claude 還在工作時，把排隊中的訊息馬上送出

### `Tab` : 接受自動完成（基礎）

接受自動完成建議，或在權限詢問時附上說明

### `← / →` : 切換對話框分頁（基礎）

在對話框的分頁之間切換

### `↑ / ↓ 或 Ctrl+P / Ctrl+N` : 移動游標或瀏覽歷史（基礎）

在輸入框移動游標，或往前往後翻輸入歷史

### `Ctrl+A` : 移到行首（基礎）

游標移到目前這一行的開頭

### `Ctrl+E` : 移到行尾（基礎）

游標移到目前這一行的結尾

### `Ctrl+K` : 刪到行尾（進階）

刪除游標到行尾的內容

### `Ctrl+U` : 刪到行首（進階）

刪除游標到行首的內容

### `Ctrl+W` : 往前刪一個字（進階）

刪除到前一個空白為止

### `Ctrl+Y` : 貼回剛刪掉的文字（進階）

貼上用 Ctrl+K、Ctrl+U 等刪掉的內容，接著按 Alt+Y 可輪替更早的內容

### `Alt+B` : 往回跳一個字（進階）

游標往回移一個單字

### `Alt+F` : 往前跳一個字（進階）

游標往前移一個單字

### `Alt+D` : 刪到字尾（進階）

刪除游標到單字結尾

### `Ctrl+_ / Ctrl+Shift+-` : 復原輸入（進階）

復原上一次輸入框裡的編輯

### `Ctrl+J` : 換行（任何終端機）（基礎）

不用設定就能在任何終端機換行

### `\ + Enter` : 換行（反斜線）（基礎）

行尾打反斜線再按 Enter 換行，所有終端機都能用

### `Shift+Enter` : 換行（原生支援的終端機）（基礎）

iTerm2、WezTerm、Ghostty、Kitty、Warp、Apple Terminal、Windows Terminal 原生支援，其他終端機用 /terminal-setup

### `Option+Enter` : 換行（macOS）（進階）

在 macOS 開啟「Option 當 Meta 鍵」後可用

### `Enter` : 送出訊息（基礎）

送出目前輸入的提示

### `/（開頭）` : 開啟指令選單（基礎）

在開頭輸入 / 叫出指令與 skills

### `!（開頭）` : Shell 模式（基礎）

在開頭輸入 ! 直接執行 shell 指令

### `@` : 提及檔案路徑（基礎）

輸入 @ 選擇要附上的檔案

### `?（空白輸入時）` : 快捷鍵說明面板（基礎）

輸入框是空的時候按 ? 開關快捷鍵說明

### `Space（按住或點按）` : 語音聽寫（進階）

開啟語音聽寫後，按住空白鍵錄音，或用 /voice tap 改成點一下開關

### `{ / }` : 逐字稿跳到上下一則提示（隱藏）

在逐字稿檢視器跳到前一則或下一則你的提示，需要全螢幕渲染

### `v` : 逐字稿用編輯器開啟（隱藏）

在逐字稿檢視器把對話寫到暫存檔並用 $EDITOR 開啟，需要全螢幕渲染

## 📁 設定檔與記憶檔（Configuration Files）

CLAUDE.md、settings.json、MCP、skills、subagents 與快捷鍵設定檔的位置

### `CLAUDE.md` : 專案指示檔（基礎）

放在 ./CLAUDE.md 或 ./.claude/CLAUDE.md，寫團隊共用的專案規範、架構與常用指令

### `~/.claude/CLAUDE.md` : 個人全域指示（基礎）

只對你自己、所有專案生效的個人偏好

### `CLAUDE.local.md` : 個人專案指示（進階）

只給自己用的專案設定，例如測試網址，記得加進 .gitignore

### `AGENTS.md` : 沿用 AGENTS.md（進階）

Claude Code 可以讀 repo 既有的 AGENTS.md 當作專案指示

### `.claude/rules/*.md` : 依檔案類型套用的規則（進階）

把規則拆成多個檔案，限定套用在特定檔案類型

### `.claude/settings.json` : 專案設定（團隊共用）（基礎）

提交到 git，讓所有人共用權限、hooks 與外掛設定

### `.claude/settings.local.json` : 專案個人設定（進階）

只對自己、這個專案生效，Claude Code 自動建立時會排除在 git 之外

### `~/.claude/settings.json` : 使用者設定（基礎）

對自己所有專案生效，例如主題、預設模型與個人權限規則

### `managed-settings.json` : 組織管理設定（隱藏）

由組織派送給所有人，優先順序最高

### `.mcp.json` : 專案 MCP 設定（進階）

專案層級的 MCP 伺服器設定，可提交給團隊共用

### `~/.claude.json` : Claude Code 自己維護的檔案（隱藏）

存放帳號、MCP 伺服器等狀態，由 Claude Code 寫入，一般不需要手動編輯

### `~/.claude/keybindings.json` : 自訂快捷鍵（進階）

用 /keybindings 建立或開啟，重新綁定快捷鍵

### `.claude/skills/<name>/SKILL.md` : 自訂 skill（進階）

建立後可用 /<name> 呼叫，Claude 也會在相關時自動使用

### `.claude/commands/<name>.md` : 自訂指令（已併入 skills）（進階）

舊的自訂指令檔仍可用，和 .claude/skills/<name>/SKILL.md 一樣會產生 /<name>

### `.claude/agents/<name>.md` : 自訂 subagent（進階）

每個 subagent 一個 Markdown 檔，個人版放在 ~/.claude/agents/

## 🔬 進階功能（Advanced Features）

延伸思考、權限模式、subagents、MCP、hooks、背景代理與雲端 session

### `ultrathink` : 單次加深推理（進階）

在提示任何位置寫 ultrathink，該回合要求更深的推理，不改 session 的 effort 設定

官方說明只認 ultrathink 這個關鍵字，think、think hard 等寫法只會被當成一般文字。要整個 session 調整請用 /effort。

### `default / acceptEdits / plan / auto / dontAsk / bypassPermissions` : 六種權限模式（進階）

從每次都問到全部放行的權限模式，用 Shift+Tab 或 --permission-mode 切換

plan 只分析不改檔，auto 由分類器判斷是否放行，dontAsk 遇到需要確認的動作直接拒絕，bypassPermissions 全部放行。

### `/plan 或 Shift+Tab` : Plan mode 先規劃再動手（基礎）

只讀取與分析，提出計畫給你核准後才開始改

### `Explore / Plan / general-purpose` : 內建 subagents（進階）

Claude 會把探索、規劃等支線任務交給 subagent，保持主對話 context 乾淨

### `.claude/skills/<name>/SKILL.md` : Skills 封裝工作流程（進階）

把重複的流程寫成 SKILL.md，Claude 會在相關時使用，也能用 /<name> 直接呼叫

### `MCP（Model Context Protocol）` : 用 MCP 串外部工具（進階）

透過 MCP 連接資料庫、API、Notion、GitHub 等外部服務

```
claude mcp add --transport http notion https://mcp.notion.com/mcp
```

### `ENABLE_TOOL_SEARCH` : MCP 工具延後載入（隱藏）

MCP tool search 預設會延後載入工具定義，需要時才搜尋，可用 auto 或 auto:N 設門檻

### `PreToolUse / PostToolUse / Stop ...` : Hooks 生命週期事件（進階）

在工具執行前後、回應結束、session 開始等時間點自動跑你的指令，PreToolUse 可以擋下工具呼叫

### `/plugin install` : 外掛與 marketplace（進階）

把 skills、agents、hooks、MCP 打包成外掛安裝與分享

### `claude -w feature-name` : Worktree 平行開發（進階）

每個任務一個 git worktree，多個 session 同時改不互相干擾

### `/batch` : 大規模平行改動（進階）

把大改動拆成多個單元，各自在 worktree 由背景 subagent 完成

### `/loop` : 定時重複執行（進階）

session 開著時定時執行同一個提示，例如盯部署狀態

### `claude agents / --bg / /background` : 背景代理與 agent view（進階）

把 session 丟到背景跑，在 agent view 一次監看多個

### `claude --cloud / /teleport` : 雲端 session（進階）

在雲端跑任務，之後再用 --teleport 或 /teleport 接回本機

### `claude --remote-control` : Remote Control 手機接手（進階）

讓本機 session 可以從 claude.ai 或 Claude App 繼續操作

### `/voice + Space` : 語音聽寫（進階）

開啟語音聽寫後，按住空白鍵說話

### `--chrome` : Chrome 瀏覽器整合（進階）

連上 Chrome 測試網頁、看 console、填表與擷取資料

### `/goal` : 目標驅動的長任務（進階）

設定完成條件，Claude 跨回合持續工作直到達成

### `/config → Editor mode` : Vim 編輯模式（隱藏）

在設定把編輯模式切成 Vim，支援 NORMAL、INSERT、VISUAL 等常用操作

舊的 /vim 指令已移除，改從 /config 切換。

### `opus / sonnet / haiku / fable / opusplan` : 模型別名（進階）

用別名選模型，opusplan 在 plan mode 用 opus、執行時改用 sonnet

別名會隨官方更新指向的版本，要固定版本就寫完整模型名稱。

## 🌐 環境變數（Environment Variables）

驗證、模型、思考預算、逾時與更新相關的常用環境變數

### `ANTHROPIC_API_KEY` : API 金鑰（基礎）

設定後改用這把金鑰，即使已登入訂閱帳號也會優先使用

### `ANTHROPIC_AUTH_TOKEN` : 自訂 Authorization header（進階）

會在值前面加上 Bearer 後送出

### `CLAUDE_CODE_OAUTH_TOKEN` : OAuth token（自動化用）（進階）

給 SDK 與自動化環境用的 claude.ai OAuth token，可用 claude setup-token 產生

### `ANTHROPIC_BASE_URL` : 自訂 API 端點（進階）

透過代理或閘道送出請求

### `ANTHROPIC_MODEL` : 預設模型（進階）

指定要使用的模型設定

### `CLAUDE_CODE_EFFORT_LEVEL` : 推理強度（進階）

可設 low、medium、high、xhigh、max，優先於 --effort 與 /effort

### `MAX_THINKING_TOKENS` : 思考 token 預算（隱藏）

設定延伸思考的固定 token 預算

### `CLAUDE_CODE_MAX_OUTPUT_TOKENS` : 最大輸出 token（隱藏）

設定多數請求的輸出上限，超過模型上限時會被調降

### `CLAUDE_CODE_USE_BEDROCK` : 改用 Amazon Bedrock（進階）

透過 Amazon Bedrock 呼叫模型

### `CLAUDE_CODE_USE_VERTEX` : 改用 Google Cloud（進階）

透過 Google Cloud Agent Platform 呼叫模型

### `CLAUDE_CODE_SIMPLE` : 最小系統提示模式（隱藏）

只保留 Bash、讀檔與改檔工具並停用自動載入，--bare 會設定這個變數

### `CLAUDE_CODE_DEBUG_LOGS_DIR` : 除錯紀錄檔路徑（隱藏）

指定除錯紀錄的檔案路徑（雖然名稱是 DIR，實際是檔案路徑），要另外開啟除錯模式

### `CLAUDE_CODE_USE_POWERSHELL_TOOL` : PowerShell 工具開關（隱藏）

控制 Windows 上的 PowerShell 工具，設 0 關閉

### `CLAUDE_CODE_FORK_SUBAGENT` : Fork 模式開關（隱藏）

fork 模式預設開啟，讓 Claude 自行開分叉，設 0 關閉

### `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` : Remote Control 名稱前綴（隱藏）

沒指定名稱時自動產生的 session 名稱前綴，預設是電腦名稱

### `ENABLE_PROMPT_CACHING_1H` : 1 小時 prompt cache（隱藏）

把 prompt cache 存活時間從預設 5 分鐘改成 1 小時，主要給 API 金鑰與雲端供應商使用者

### `ENABLE_TOOL_SEARCH` : MCP tool search（隱藏）

控制 MCP 工具是否延後載入，可設 auto 或 auto:N 調整門檻

### `BASH_MAX_OUTPUT_LENGTH` : Bash 輸出長度上限（隱藏）

讀回 bash 輸出的字元上限，預設 30000、最大 150000

### `BASH_DEFAULT_TIMEOUT_MS` : Bash 預設逾時（隱藏）

前景 Bash 或 PowerShell 指令的預設逾時，預設 120000 毫秒

### `MCP_TIMEOUT` : MCP 啟動逾時（隱藏）

MCP 伺服器啟動的逾時毫秒數，預設 30000

### `SLASH_COMMAND_TOOL_CHAR_BUDGET` : Skill 描述字元預算（隱藏）

覆蓋提供給 Skill 工具的 skill 描述字元預算，預設約為 context 的 1%

### `CLAUDE_CODE_DISABLE_AUTO_MEMORY` : 關閉自動記憶（進階）

設 1 停用自動記憶，設 0 強制開啟

### `CLAUDE_CODE_NEW_INIT` : /init 互動流程（進階）

設 1 讓 /init 先問要產生哪些檔案（CLAUDE.md、skills、hooks）

### `DISABLE_AUTOUPDATER` : 關閉自動更新（進階）

設 1 停止背景自動更新，手動 claude update 仍可用

### `DISABLE_TELEMETRY` : 關閉遙測（進階）

設任何非空值關閉遙測，注意設 0 或 false 也算關閉，要恢復需移除變數

### `HTTPS_PROXY` : HTTPS 代理（進階）

指定網路連線用的 HTTPS 代理伺服器

## 💡 實用技巧（Practical Tips）

官方文件有寫、但容易被忽略的用法

### `Auto mode` : Auto mode 讓分類器把關（進階）

auto 模式由分類器判斷工具呼叫能否放行，用 claude auto-mode defaults 查看內建規則

### `cat file | claude -p "query"` : 把任何輸出交給 Claude（進階）

用管線把 log、diff、測試結果交給 Claude 分析

```
git diff | claude -p "幫我寫 commit message"
```

### `claude -p --output-format json "query" | jq .result` : 串進自動化管線（進階）

用 JSON 輸出接 jq 等工具，寫成腳本或 CI 步驟

### `Ctrl+S` : 暫存寫到一半的提示（進階）

臨時要問別的事時先收起草稿，之後再按 Ctrl+S 還原

### `Esc + Esc 或 /rewind` : 改壞了就倒回（基礎）

對話與程式碼都可以回到先前的檢查點，比手動 git revert 快

### `ultrathink（寫在 SKILL.md）` : 讓 skill 執行時加深推理（隱藏）

在 skill 內容寫 ultrathink，這個 skill 執行時就會要求更深的推理

### `--max-budget-usd` : 自動化先設花費上限（進階）

print 模式跑排程或 CI 時設定花費上限，避免失控

### `/tui fullscreen` : 全螢幕渲染（進階）

改用不閃爍的全螢幕渲染，逐字稿檢視器也多了跳轉與搜尋功能

### `/btw` : 不打斷主線的旁支問題（進階）

想確認小事但不想汙染對話紀錄時用 /btw

### `Claude 工作中直接打字` : 排隊下一則訊息（進階）

Claude 還在跑時輸入的訊息會排隊，Ctrl+Enter 可立即送出

### `! npm test` : Shell 模式直接跑指令（基礎）

開頭加 ! 直接執行 shell 指令，輸出會留在對話給 Claude 參考

### `@src/app.ts` : 用 @ 附上檔案（基礎）

直接指定檔案，Claude 讀原始內容而不是你的描述

### `/skill-a /skill-b do XYZ` : 一次疊多個 skills（隱藏）

在終端機一則訊息開頭連續寫多個 skill，後面的文字會傳給每一個，最多 6 個

### `/import codex` : 從其他 coding agent 搬家（進階）

用 /import 一次把 Codex、Gemini CLI 或 Cursor 的設定帶過來

## 📝 提示詞範本（Prompt Templates）

依官方 Prompt library 的六個寫法整理成可直接改用的提示詞

### `幫公開 API 加上流量限制，並確認既有測試全部通過` : 描述結果，不寫步驟（基礎）

說清楚要的結果，讓 Claude 自己找相關檔案，不用列路徑

官方 Prompt library 的第一個寫法：Describe the outcome, not the steps。

### `寫好 migration 後在開發資料庫執行，確認 schema 和預期一致` : 給它自我檢查的方法（基礎）

同一個提示裡要求執行、測試或比對，Claude 會反覆修到通過

官方寫法：Give it a way to check its own work。要看實際 App 可接著跑 /verify。

### `新增設定頁，版面照 profile 頁的寫法` : 指定參考對象（基礎）

點名既有的檔案、測試或寫法，新程式碼會和專案一致

官方寫法：Point at a reference。

### `把 bundle 縮到 200KB 以下，並列出你拿掉了什麼` : 給可量化的目標（基礎）

效能或覆蓋率任務直接給指標與門檻，完成條件才明確

官方寫法：State the measurable target。

### `為什麼建置失敗？@build.log` : 直接給原始資料（基礎）

貼上錯誤、log、截圖，或用 @ 指定檔案，讓 Claude 讀原文

官方寫法：Give it the artifact。

### `用一頁有圖的 HTML 說明付款重試邏輯，做完在瀏覽器打開` : 指定回答格式（基礎）

說明格式、長度或讀者，答案才能直接拿去用

官方寫法：Say how you want the answer。要變成預設可設定 output style。

---
來源：AITerms.tw | https://aiterms.tw/cheatsheet/claude-code