內建斜線命令
| 命令 | 用途 |
|---|---|
/add-dir | 新增其他工作目錄 |
/agents | 管理用於特定任務的自訂 AI 子代理 |
/bug | 回報錯誤(將對話傳送至 Anthropic) |
/clear | 清除對話歷史記錄 |
/compact [instructions] | 壓縮對話,可選擇性地提供焦點指示 |
/config | 開啟設定介面(設定標籤) |
/cost | 顯示權杖使用統計資訊(請參閱成本追蹤指南以了解訂閱特定詳細資訊) |
/doctor | 檢查您的 Claude Code 安裝的健康狀況 |
/help | 取得使用說明 |
/init | 使用 CLAUDE.md 指南初始化專案 |
/login | 切換 Anthropic 帳戶 |
/logout | 登出您的 Anthropic 帳戶 |
/mcp | 管理 MCP 伺服器連線和 OAuth 驗證 |
/memory | 編輯 CLAUDE.md 記憶檔案 |
/model | 選擇或變更 AI 模型 |
/permissions | 檢視或更新權限 |
/pr_comments | 檢視提取請求評論 |
/review | 要求程式碼審查 |
/sandbox | 啟用沙箱化 bash 工具,具有檔案系統和網路隔離,以實現更安全、更自主的執行 |
/rewind | 倒轉對話和/或程式碼 |
/status | 開啟設定介面(狀態標籤),顯示版本、模型、帳戶和連線狀態 |
/terminal-setup | 安裝 Shift+Enter 按鍵繫結以換行(僅限 iTerm2 和 VSCode) |
/usage | 顯示方案使用限制和速率限制狀態(僅限訂閱方案) |
/vim | 進入 vim 模式以交替插入和命令模式 |
自訂斜線命令
自訂斜線命令可讓您將經常使用的提示定義為 Markdown 檔案,Claude Code 可以執行這些檔案。命令按範圍(專案特定或個人)組織,並透過目錄結構支援命名空間。語法
參數
| 參數 | 說明 |
|---|---|
<command-name> | 從 Markdown 檔案名稱衍生的名稱(不含 .md 副檔名) |
[arguments] | 傳遞給命令的選用引數 |
命令類型
專案命令
儲存在您的儲存庫中並與您的團隊共享的命令。在/help 中列出時,這些命令在其說明後顯示「(project)」。
位置:.claude/commands/
在下列範例中,我們建立 /optimize 命令:
個人命令
在您所有專案中可用的命令。在/help 中列出時,這些命令在其說明後顯示「(user)」。
位置:~/.claude/commands/
在下列範例中,我們建立 /security-review 命令:
功能
命名空間
在子目錄中組織命令。子目錄用於組織,並出現在命令說明中,但不會影響命令名稱本身。說明將顯示命令來自專案目錄(.claude/commands)或使用者層級目錄(~/.claude/commands),以及子目錄名稱。
不支援使用者和專案層級命令之間的衝突。否則,多個具有相同基本檔案名稱的命令可以共存。
例如,位於 .claude/commands/frontend/component.md 的檔案會建立命令 /component,說明顯示「(project:frontend)」。
同時,位於 ~/.claude/commands/component.md 的檔案會建立命令 /component,說明顯示「(user)」。
引數
使用引數預留位置將動態值傳遞給命令:使用 $ARGUMENTS 的所有引數
$ARGUMENTS 預留位置會擷取傳遞給命令的所有引數:
使用 $1、$2 等的個別引數
使用位置參數(類似於 shell 指令碼)個別存取特定引數:
- 在命令的不同部分中個別存取引數
- 為遺漏的引數提供預設值
- 使用特定參數角色建立更結構化的命令
Bash 命令執行
使用! 前置詞在斜線命令執行前執行 bash 命令。輸出包含在命令內容中。您_必須_使用 Bash 工具包含 allowed-tools,但您可以選擇要允許的特定 bash 命令。
例如:
檔案參考
使用@ 前置詞在命令中包含檔案內容以參考檔案。
例如:
思考模式
斜線命令可以透過包含延伸思考關鍵字來觸發延伸思考。前置事項
命令檔案支援前置事項,適用於指定有關命令的中繼資料:| 前置事項 | 用途 | 預設值 |
|---|---|---|
allowed-tools | 命令可以使用的工具清單 | 繼承自對話 |
argument-hint | 斜線命令預期的引數。範例:argument-hint: add [tagId] | remove [tagId] | list。此提示在自動完成斜線命令時向使用者顯示。 | 無 |
description | 命令的簡短說明 | 使用提示中的第一行 |
model | 特定模型字串(請參閱模型概觀) | 繼承自對話 |
disable-model-invocation | 是否防止 SlashCommand 工具呼叫此命令 | false |
外掛程式命令
外掛程式可以提供與 Claude Code 無縫整合的自訂斜線命令。外掛程式命令的運作方式與使用者定義的命令完全相同,但透過外掛程式市集分發。外掛程式命令的運作方式
外掛程式命令具有以下特點:- 命名空間:命令可以使用
/plugin-name:command-name格式以避免衝突(除非存在名稱衝突,否則外掛程式前置詞是選用的) - 自動可用:安裝並啟用外掛程式後,其命令會出現在
/help中 - 完全整合:支援所有命令功能(引數、前置事項、bash 執行、檔案參考)
外掛程式命令結構
位置:外掛程式根目錄中的commands/ 目錄
檔案格式:具有前置事項的 Markdown 檔案
基本命令結構:
- 引數:在命令說明中使用
{arg1}之類的預留位置 - 子目錄:在子目錄中組織命令以進行命名空間
- Bash 整合:命令可以執行 shell 指令碼和程式
- 檔案參考:命令可以參考和修改專案檔案
調用模式
直接命令(無衝突時)
外掛程式前置詞(需要消除歧義時)
使用引數(如果命令支援)
MCP 斜線命令
MCP 伺服器可以將提示公開為斜線命令,這些命令在 Claude Code 中變為可用。這些命令從連線的 MCP 伺服器動態發現。命令格式
MCP 命令遵循以下模式:功能
動態發現
MCP 命令在以下情況下自動可用:- MCP 伺服器已連線且處於活動狀態
- 伺服器透過 MCP 協定公開提示
- 在連線期間成功擷取提示
引數
MCP 提示可以接受伺服器定義的引數:命名慣例
- 伺服器和提示名稱已正規化
- 空格和特殊字元變成底線
- 名稱已轉換為小寫以保持一致性
管理 MCP 連線
使用/mcp 命令來:
- 檢視所有已設定的 MCP 伺服器
- 檢查連線狀態
- 使用啟用 OAuth 的伺服器進行驗證
- 清除驗證權杖
- 檢視每個伺服器的可用工具和提示
MCP 權限和萬用字元
設定 MCP 工具的權限時,請注意不支援萬用字元:- ✅ 正確:
mcp__github(核准來自 github 伺服器的所有工具) - ✅ 正確:
mcp__github__get_issue(核准特定工具) - ❌ 不正確:
mcp__github__*(不支援萬用字元)
mcp__servername。若要僅核准特定工具,請個別列出每個工具。
SlashCommand 工具
SlashCommand 工具允許 Claude 在對話期間以程式設計方式執行自訂斜線命令。這使 Claude 能夠在適當時代表您調用自訂命令。
為了鼓勵 Claude 觸發 SlashCommand 工具,您的指示(提示、CLAUDE.md 等)通常需要使用斜線按名稱參考命令。
範例:
/context 監視權杖使用情況,並按照以下操作管理內容。
SlashCommand 工具支援的命令
SlashCommand 工具僅支援以下自訂斜線命令:
- 是使用者定義的。內建命令(如
/compact和/init)_不_受支援。 - 已填入
description前置事項欄位。我們在內容中使用description。
claude --debug 並觸發查詢來查看 SlashCommand 工具可以調用哪些自訂斜線命令。
停用 SlashCommand 工具
若要防止 Claude 透過工具執行任何斜線命令:
僅停用特定命令
若要防止特定斜線命令變為可用,請將disable-model-invocation: true 新增至斜線命令的前置事項。
這也會從內容中移除命令的中繼資料。
SlashCommand 權限規則
權限規則支援:
- 完全符合:
SlashCommand:/commit(僅允許/commit且無引數) - 前置詞符合:
SlashCommand:/review-pr:*(允許/review-pr使用任何引數)
字元預算限制
SlashCommand 工具包含字元預算以限制向 Claude 顯示的命令說明的大小。這可防止在許多命令可用時發生權杖溢位。
預算包括每個自訂斜線命令的名稱、引數和說明。
- 預設限制:15,000 個字元
- 自訂限制:透過
SLASH_COMMAND_TOOL_CHAR_BUDGET環境變數設定
/context 中,警告將顯示「M of N commands」。
技能與斜線命令
斜線命令和代理技能在 Claude Code 中有不同的用途:使用斜線命令
快速、經常使用的提示:- 您經常使用的簡單提示片段
- 快速提醒或範本
- 適合在一個檔案中的經常使用的指示
/review→ 「審查此程式碼以查找錯誤並建議改進」/explain→ 「用簡單的術語解釋此程式碼」/optimize→ 「分析此程式碼以查找效能問題」
使用技能
具有結構的綜合功能:- 具有多個步驟的複雜工作流程
- 需要指令碼或公用程式的功能
- 跨多個檔案組織的知識
- 您想要標準化的團隊工作流程
- 具有表單填充指令碼和驗證的 PDF 處理技能
- 具有不同資料類型參考文件的資料分析技能
- 具有風格指南和範本的文件技能
主要差異
| 方面 | 斜線命令 | 代理技能 |
|---|---|---|
| 複雜性 | 簡單提示 | 複雜功能 |
| 結構 | 單一 .md 檔案 | 具有 SKILL.md + 資源的目錄 |
| 發現 | 明確調用(/command) | 自動(基於內容) |
| 檔案 | 僅一個檔案 | 多個檔案、指令碼、範本 |
| 範圍 | 專案或個人 | 專案或個人 |
| 共享 | 透過 git | 透過 git |
範例比較
作為斜線命令:/review(手動調用)
作為技能:
何時使用各個
使用斜線命令:- 您重複調用相同的提示
- 提示適合在單一檔案中
- 您想要明確控制何時執行
- Claude 應該自動發現功能
- 需要多個檔案或指令碼
- 具有驗證步驟的複雜工作流程
- 團隊需要標準化、詳細的指導