斜線指令

​

內建斜線指令

​

自訂斜線指令

自訂斜線指令允許您將常用提示定義為 Markdown 檔案，Claude Code 可以執行這些檔案。指令按範圍（專案特定或個人）組織，並透過目錄結構支援命名空間。

​

語法

/<command-name> [arguments]

​

參數

​

指令類型

​

專案指令

儲存在您的儲存庫中並與您的團隊共享的指令。在 /help 中列出時，這些指令在其描述後顯示「(project)」。

位置：.claude/commands/

在以下範例中，我們建立 /optimize 指令：

# 建立專案指令
mkdir -p .claude/commands
echo "Analyze this code for performance issues and suggest optimizations:" > .claude/commands/optimize.md

​

個人指令

在您所有專案中可用的指令。在 /help 中列出時，這些指令在其描述後顯示「(user)」。

位置：~/.claude/commands/

在以下範例中，我們建立 /security-review 指令：

# 建立個人指令
mkdir -p ~/.claude/commands
echo "Review this code for security vulnerabilities:" > ~/.claude/commands/security-review.md

​

功能

​

命名空間

在子目錄中組織指令。子目錄決定指令的完整名稱。描述將顯示指令是來自專案目錄（.claude/commands）還是使用者層級目錄（~/.claude/commands）。

不支援使用者和專案層級指令之間的衝突。否則，具有相同基本檔案名稱的多個指令可以共存。

例如，位於 .claude/commands/frontend/component.md 的檔案建立指令 /frontend:component，描述顯示「(project)」。 同時，位於 ~/.claude/commands/component.md 的檔案建立指令 /component，描述顯示「(user)」。

​

參數

使用 $ARGUMENTS 佔位符將動態值傳遞給指令。

例如：

# 指令定義
echo 'Fix issue #$ARGUMENTS following our coding standards' > .claude/commands/fix-issue.md

# 使用方式
> /fix-issue 123

​

Bash 指令執行

在斜線指令執行前使用 ! 前綴執行 bash 指令。輸出包含在指令上下文中。您_必須_包含 allowed-tools 與 Bash 工具，但您可以選擇允許的特定 bash 指令。

例如：

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
description: Create a git commit
---

## Context

- Current git status: !`git status`
- Current git diff (staged and unstaged changes): !`git diff HEAD`
- Current branch: !`git branch --show-current`
- Recent commits: !`git log --oneline -10`

## Your task

Based on the above changes, create a single git commit.

​

檔案參考

使用 @ 前綴在指令中包含檔案內容以參考檔案。

例如：

# 參考特定檔案

Review the implementation in @src/utils/helpers.js

# 參考多個檔案

Compare @src/old-version.js with @src/new-version.js

​

思考模式

斜線指令可以透過包含延伸思考關鍵字來觸發延伸思考。

​

前置資料

指令檔案支援前置資料，對於指定指令的中繼資料很有用：

| 前置資料 | 用途 | 預設值 | | :--- | :--- | :--- | --- | ---- | | allowed-tools | 指令可以使用的工具清單 | 從對話中繼承 | | argument-hint | 斜線指令預期的參數。例如：argument-hint: add [tagId] | remove [tagId] | list。此提示在使用者自動完成斜線指令時顯示給使用者。 | 無 | | description | 指令的簡短描述 | 使用提示的第一行 | | model | opus、sonnet、haiku 或特定模型字串 | 從對話中繼承 |

例如：

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
argument-hint: [message]
description: Create a git commit
model: haiku
---

An example command

​

MCP 斜線指令

MCP 伺服器可以將提示公開為斜線指令，這些指令在 Claude Code 中變為可用。這些指令從連接的 MCP 伺服器動態發現。

​

指令格式

MCP 指令遵循以下模式：

/mcp__<server-name>__<prompt-name> [arguments]

​

功能

​

動態發現

MCP 指令在以下情況下自動可用：

• MCP 伺服器已連接且處於活動狀態
• 伺服器透過 MCP 協定公開提示
• 在連接期間成功檢索提示

​

參數

MCP 提示可以接受伺服器定義的參數：

# 不含參數
> /mcp__github__list_prs

# 含參數
> /mcp__github__pr_review 456
> /mcp__jira__create_issue "Bug title" high

​

命名慣例

• 伺服器和提示名稱已標準化
• 空格和特殊字元變成底線
• 名稱小寫以保持一致性

​

管理 MCP 連線

使用 /mcp 指令來：

• 檢視所有已設定的 MCP 伺服器
• 檢查連線狀態
• 使用啟用 OAuth 的伺服器進行驗證
• 清除驗證 token
• 檢視每個伺服器的可用工具和提示

​

另請參閱

• 互動模式 - 快捷鍵、輸入模式和互動功能
• CLI 參考 - 命令列旗標和選項
• 設定 - 設定選項
• 記憶管理 - 跨會話管理 Claude 的記憶