這是一篇寫給完全沒用過 Claude Code 的同學(xué)的超詳細(xì)入門教程。每條指令都會(huì)先給你官方說明,再用大白話解釋它到底是干嘛用的,最后配一個(gè)可以照抄的例子。讀完就能上手。

序:什么是"指令"?

Claude Code 是個(gè)跑在終端里的 AI 編程助手。你可以像跟同事聊天那樣跟它說"幫我把這個(gè)函數(shù)重構(gòu)一下",它就會(huì)去讀代碼、改文件、寫測(cè)試。

但除了"聊天"之外,它還提供了一批以斜杠 / 開頭的快捷命令,叫做 Slash Commands(斜杠指令)。這些指令是終端界面提供的控制按鈕,比如:

• /clear 清空對(duì)話
• /model 換模型
• /resume 回到之前的會(huì)話

一句話區(qū)分:

普通 prompt = 你讓 AI 干活的內(nèi)容(比如"幫我寫個(gè)登錄接口")斜杠指令 = 你操作 Claude Code 這個(gè)工具本身的按鈕(比如"清空"、"換模型"、"退出")

一、必須先記住的 3 個(gè)常識(shí)

1. 指令必須是消息的第一個(gè)字符

/model sonnet              ? 正確:會(huì)觸發(fā)換模型
請(qǐng)幫我 /model sonnet        ? 錯(cuò)誤:這就是一句普通聊天

為什么:Claude Code 只在你消息開頭看到 / 才把后面當(dāng)指令解析,中間的 / 一律當(dāng)普通文字。

2. 忘了指令?直接敲一個(gè)/

在對(duì)話框里只輸入一個(gè) /,界面會(huì)自動(dòng)彈出當(dāng)前能用的全部指令列表,可以繼續(xù)輸字母過濾(比如輸 /br 會(huì)看到 /branch)。

每個(gè)人能看到的指令數(shù)量可能不一樣!因?yàn)?

• 有些指令只在特定平臺(tái)有(如 /desktop 只在 macOS/Windows)
• 有些指令只對(duì)特定訂閱有(如 /upgrade 只對(duì) Pro/Max)
• 有些指令裝了插件才出現(xiàn)

所以"本地輸 / 看到的列表"永遠(yuǎn)比文章里的列表更準(zhǔn)。

3. 看懂官方文檔的參數(shù)記號(hào)

• <arg> 表示必填參數(shù),不給會(huì)報(bào)錯(cuò)

  • 例:/add-dir <path> → 必須寫 /add-dir ~/myproject

• [arg] 表示可選參數(shù),不給也能跑

  • 例:/compact [instructions] → 可以光寫 /compact,也可以寫 /compact 只保留登錄相關(guān)

二、整體地圖:Claude Code 一共有多少指令?

截至 2026 年 5 月,官方文檔 Commands - Claude Code Docs 列出的內(nèi)置指令共 83 個(gè)(含別名和已移除的)。按用途大致可以分成 8 大類:

新手其實(shí)只需要掌握 10 條左右就夠用了,后面會(huì)在第四章專門講。先繼續(xù)看第三章,先把兩個(gè)最容易踩坑的指令 /btw 和 /branch 搞清楚。

三、新手 99% 會(huì)卡住的問題:/btw和/branch怎么切回去?

這是用戶最常問的問題,沒有之一。先看圖:

/btw— 表面像切換,其實(shí)沒切

官方說明:Ask a quick side question without adding to the conversation.(問一個(gè)不加入主對(duì)話的小問題)

大白話:你正和 Claude 討論一個(gè)大項(xiàng)目,突然想問一句完全無關(guān)的"Python dataclass 和 pydantic 有啥區(qū)別?"。如果直接問,這次問答會(huì)永久寫進(jìn)你的對(duì)話歷史,以后每次 Claude 都要把它帶上一起讀,越攢越貴。/btw 就是給你開個(gè)小后門:

1. 它會(huì)復(fù)制一份當(dāng)前上下文到臨時(shí)空間
2. 在這個(gè)臨時(shí)空間里回答你這一個(gè)問題
3. 答完把臨時(shí)空間丟掉

所以主對(duì)話的歷史不會(huì)多一行字,也不會(huì)多花 token。

示例

/btw git rebase 和 git merge 的區(qū)別是什么?

怎么切回去? — 不用切,你本來就沒走。答案打印完你還在原會(huì)話里,直接接著敲下一句 prompt 就行。

什么時(shí)候不適合用:需要多輪追問的場(chǎng)景。/btw 只給你一次單輪問答機(jī)會(huì),如果你問完想追問"那 rebase 沖突怎么解決?",這條追問不會(huì)繼承上一次 /btw 的上下文。這種時(shí)候用普通 prompt 更合適。

/branch(別名/fork)— 真的開了新會(huì)話,要手動(dòng)切回

官方說明:Create a branch of the current conversation at this point. Switches you into the branch and preserves the original.(在當(dāng)前節(jié)點(diǎn)創(chuàng)建一條會(huì)話分支,把你切進(jìn)分支,原會(huì)話保留)

大白話:想象你在和 Claude 一起寫代碼,寫到一半你覺得"要不換個(gè)思路試試?"但又怕把現(xiàn)在的成果弄丟。/branch 就像 git 的分支:

1. 把當(dāng)前對(duì)話原樣拷貝一份作為新會(huì)話
2. 把你切進(jìn)新會(huì)話里繼續(xù)折騰
3. 原會(huì)話完整保留,隨時(shí)能回去

示例:先命名主線,再開分支

/rename main
/branch try-another-way

現(xiàn)在你已經(jīng)在 try-another-way 這個(gè)分支里了。折騰完想回主線?有兩種辦法:

方法 1:/resume 切回(推薦)

/resume

敲完會(huì)彈出一個(gè)會(huì)話選擇器,列出你所有歷史會(huì)話。選 main 那條即可回到主線。如果你記得名字,還能直接:

/resume main

方法 2:先退出再重進(jìn)

# 先 /exit 退出
claude --resume main
# 或者交互式選
claude --resume

3 個(gè)防止迷路的小習(xí)慣

1. 分支前先 /rename main 給主線起個(gè)名字,免得一堆 "Unnamed session" 分不清
2. 不確定自己現(xiàn)在在哪條線?用 /recap 看一行總結(jié),或 /status 看會(huì)話信息
3. 分支玩完不想要了,直接 /resume 切回主線就行,分支依然保留但不干擾你

一句話總結(jié):/btw 自動(dòng)回來,/branch 要靠 /resume 回來。

四、新手 10 條黃金指令(配超詳細(xì)解釋)

這 10 條覆蓋了 90% 的日常場(chǎng)景。先把這 10 條練熟,其他用到再查。

1./help— 救命文檔

官方:Show help and available commands.

大白話:你忘了有哪些指令、某條指令怎么拼,第一反應(yīng)就按這個(gè)。它會(huì)把當(dāng)前環(huán)境下所有可用指令列出來,點(diǎn)對(duì)點(diǎn)告訴你怎么用。

/help

什么時(shí)候用:任何時(shí)候都可以——剛裝好想看看有什么玩的、忘了 /compact 還是 /compress、插件裝好想看有沒有新命令進(jìn)來。

2./init— 讓 Claude 認(rèn)識(shí)你的項(xiàng)目

官方:Initialize project with a CLAUDE.md guide.

大白話:Claude 第一次進(jìn)你這個(gè)項(xiàng)目目錄時(shí),對(duì)你代碼庫一無所知。/init 會(huì)讓 Claude 自動(dòng)掃描一遍項(xiàng)目,然后在根目錄生成一個(gè) CLAUDE.md 文件,里面寫著:

• 項(xiàng)目是干嘛的、用什么技術(shù)棧
• 關(guān)鍵目錄結(jié)構(gòu)
• 重要約定(比如"所有 API 都要走 middleware 校驗(yàn)")

以后你每次打開這個(gè)項(xiàng)目,Claude 都會(huì)自動(dòng)讀一遍 CLAUDE.md,不用你重新解釋。等于給它一本"新員工入職手冊(cè)"。

/init

什么時(shí)候用:在一個(gè)新項(xiàng)目第一次用 Claude Code 時(shí),第一步就該敲它。

3./clear和/compact— 兩兄弟:省錢、續(xù)命

這兩個(gè)指令長(zhǎng)得像,作用完全不同。

/clear— 清空一切,重新開始

官方:Start a new conversation with empty context. The previous conversation stays available in /resume.

大白話:把當(dāng)前對(duì)話徹底清空,從零開始聊,效果就像關(guān)了 App 又重新打開。不用擔(dān)心丟數(shù)據(jù):老會(huì)話不會(huì)被刪除,想找回來用 /resume 即可。

/clear

/compact— 壓縮歷史,繼續(xù)當(dāng)前話題

官方:Free up context by summarizing the conversation so far.

大白話:你正在聊的這個(gè)項(xiàng)目很復(fù)雜,已經(jīng)來回 50 輪對(duì)話了,每次 Claude 都要把前面 50 輪全部讀一遍才能回答你下一句——又慢又貴。/compact 會(huì)讓 Claude 把前面 50 輪總結(jié)成一小段摘要,后面繼續(xù)聊時(shí)只帶著這段摘要,歷史信息保留,但體積變小。

/compact
/compact 只保留和登錄模塊相關(guān)的內(nèi)容    ← 可以指定重點(diǎn)

對(duì)比決策:

• 這件事做完了,要開始做新的 → /clear
• 這件事沒完,但對(duì)話太長(zhǎng)了 → /compact

4./resume— 找回昨天沒說完的話

官方:Resume a conversation by ID or name, or open the session picker. Alias: /continue.

大白話:下班前你和 Claude 正討論一個(gè) bug,關(guān)機(jī)走人;第二天想接著聊——用這個(gè)。它會(huì)彈出一個(gè)歷史會(huì)話列表,選一條就回到當(dāng)時(shí)的對(duì)話上下文,連同你之前的改動(dòng)記錄、討論細(xì)節(jié)都在。

/resume             ← 打開選擇器,看歷史列表
/resume login-bug   ← 如果會(huì)話起過名,可直接跳

配合 /rename 效果更好:開始一個(gè)新話題時(shí)先 /rename my-task,以后 /resume my-task 一秒回到現(xiàn)場(chǎng)。

5./rewind— 終極反悔鍵(Ctrl+Z 加強(qiáng)版)

官方:Rewind the conversation and/or code to a previous point. Aliases: /checkpoint, /undo.

大白話:Claude 剛幫你改了 5 個(gè)文件,一看效果反而更糟——別慌。/rewind 會(huì)彈出一個(gè)菜單讓你選:

• Restore code and conversation:代碼和對(duì)話都回到那一刻
• Restore conversation:只回退對(duì)話,保留代碼
• Restore code:只回退代碼,保留對(duì)話

/rewind

比手動(dòng) git reset --hard 安全得多,因?yàn)樗€管對(duì)話歷史,不用你重新給 Claude 解釋狀況。

什么時(shí)候用:Claude 自作主張改多了、改錯(cuò)方向了、或者你自己話說錯(cuò)了想重來。

6./model— 換模型,省錢或提質(zhì)

官方:Select or change the AI model.

大白話:Claude 有不同型號(hào):

• Haiku:便宜、快、笨一點(diǎn)——適合寫注釋、改錯(cuò)別字、整理格式
• Sonnet:中等價(jià)位、中等智力——日常開發(fā)主力
• Opus:最貴、最強(qiáng)——復(fù)雜架構(gòu)設(shè)計(jì)、難題攻關(guān)

簡(jiǎn)單活用便宜模型省錢,難題用強(qiáng)模型才能想清楚。

/model           ← 打開選擇器
/model sonnet    ← 直接切換到 Sonnet

順手記一下 /effort:同一個(gè)模型,還能調(diào)推理強(qiáng)度。/effort high 會(huì)讓它想得更仔細(xì)(更貴),/effort low 會(huì)讓它答得更快(更便宜)。

7./btw— 問一句不污染主線的題外話

見第三章詳解。一句話記住:/btw 你的問題,答完自動(dòng)回主線,省錢不破壞對(duì)話歷史。

/btw Nginx 的 proxy_pass 末尾加不加斜杠有什么區(qū)別?

8./permissions和/fewer-permission-prompts— 告別彈窗騷擾

官方 /permissions:Manage allow, ask, and deny rules for tool permissions.官方 /fewer-permission-prompts:Scan your transcripts for common read-only Bash and MCP tool calls, then add a prioritized allowlist.

大白話:Claude 每次要跑一條 bash 命令(比如 ls、grep、git status)都會(huì)彈窗問你"要允許嗎?"——很煩。這兩個(gè)指令就是讓煩變少。

• /permissions:手動(dòng)設(shè)置白名單,精細(xì)控制哪些命令免確認(rèn)
• /fewer-permission-prompts:讓 Claude 掃描你的歷史記錄,自動(dòng)把那些只讀的、沒危險(xiǎn)的命令加進(jìn)白名單

/permissions                    ← 進(jìn)入手動(dòng)管理界面
/fewer-permission-prompts       ← 讓 AI 替你配好

安全提醒:只把只讀命令(ls、cat、grep、git status)加白名單是安全的;不要把寫操作(rm、mv、curl)一股腦加進(jìn)去,否則 Claude 跑錯(cuò)命令你都不知道。

9./review和/security-review— 提 PR 前自查

官方 /review:Review a pull request locally in your current session.官方 /security-review:Analyze pending changes on the current branch for security vulnerabilities.

大白話:代碼寫完要提 PR 了,讓 Claude 先幫你過一遍,能擋掉很多低級(jí)錯(cuò)誤。

• /review [PR號(hào)]:像個(gè) reviewer 那樣讀你的改動(dòng),指出邏輯問題、風(fēng)格問題
• /security-review:專門掃安全風(fēng)險(xiǎn),比如 SQL 注入、明文密鑰、越權(quán)檢查

/review 1234
/security-review

什么時(shí)候用:自己提交前跑一遍,比被同事在評(píng)論區(qū)噴強(qiáng)多了。

10./doctor— 什么都不對(duì)勁時(shí)按它

官方:Diagnose and verify your Claude Code installation and settings.

大白話:Claude Code 響應(yīng)奇怪、工具用不了、登錄好像過期了、配置文件好像壞了——先按這個(gè)。它會(huì):

1. 檢查安裝是不是完整
2. 檢查賬號(hào)登錄狀態(tài)
3. 檢查插件、權(quán)限、配置有沒有沖突
4. 列出所有問題

然后你按 f 鍵,Claude 會(huì)嘗試自動(dòng)修復(fù)。

/doctor

五、5 分鐘上手流程:第一次用照著敲就行

六、所有 83 條指令分類大全(每條都帶示例)

下面是完整清單,不用硬記。當(dāng)做目錄查即可——真用到哪條再翻哪條。標(biāo) [Skill] 的是官方內(nèi)置 Skill(可手動(dòng)調(diào)用也可被自動(dòng)觸發(fā))。

會(huì)話與上下文(最常用)

模型、效果與外觀

權(quán)限、安全與工具

項(xiàng)目與規(guī)劃

Git / PR / Code Review

集成、分發(fā)與遠(yuǎn)程

Skills 與插件

賬號(hào)、計(jì)費(fèi)、反饋

診斷與系統(tǒng)

七、最容易混淆的指令對(duì)比(帶示例)

這些指令名字長(zhǎng)得像、作用容易搞混,單獨(dú)列一張表記住差異。

八、進(jìn)階:定義你自己的/指令

Claude Code 現(xiàn)在把"自定義命令"和 Skills 合成一套機(jī)制。在項(xiàng)目里創(chuàng)建:

.claude/skills/commit-msg/SKILL.md

文件里寫好 name、description 和 prompt 模板,會(huì)話里用:

/commit-msg

就能調(diào)用。團(tuán)隊(duì)成員 clone 倉庫即可共享同一套自定義命令。

MCP 服務(wù)器暴露的 prompt 會(huì)自動(dòng)注冊(cè)成 /mcp__<server>__<prompt> 形式,同樣直接調(diào)用:

/mcp__github__create_issue

九、常見疑問 FAQ

Q1:我看到的指令比文章里少,正常嗎?

A:完全正常。指令是否出現(xiàn)取決于你的操作系統(tǒng)、訂閱計(jì)劃和插件安裝情況。在終端里敲 / 看到的列表永遠(yuǎn)最準(zhǔn)。

Q2:/compact 會(huì)不會(huì)讓 Claude "忘記"關(guān)鍵信息?

A:會(huì)壓縮但不會(huì)徹底丟失。想保險(xiǎn)一點(diǎn)可以給它指示:/compact 保留 API 設(shè)計(jì)部分和數(shù)據(jù)庫 schema。真的擔(dān)心壓丟細(xì)節(jié),壓之前先 /export 導(dǎo)出一份對(duì)話備份。

Q3:/rewind 能回退幾步?

A:能回到本次會(huì)話中任意一個(gè) Claude 做出更改的節(jié)點(diǎn),不限步數(shù)。但前提是這次會(huì)話還沒關(guān)——關(guān)了會(huì)話再開回來,rewind 歷史就丟了(但代碼修改在磁盤上還在)。

Q4:/model 切模型后,前面的對(duì)話歷史還在嗎?

A:在。切模型只是換 AI 大腦,對(duì)話上下文照舊。

Q5:開太多 /branch,最后分不清怎么辦?

A:給每條線都 /rename 起名字。/resume 選擇器里會(huì)按名字+時(shí)間排序。分支玩完不想要的不用特意清理,放著就行,反正不碰它就不花錢。

Q6:/usage 顯示的價(jià)格準(zhǔn)嗎?

A:準(zhǔn)。它是基于實(shí)際 API 調(diào)用算的。Pro/Max 訂閱會(huì)顯示相對(duì)套餐額度的消耗比例。

結(jié)語

指令看起來多,其實(shí)日常用的就第四章那 10 條。剩下 70 多條等你真遇到需求再查即可。最容易卡住的是"進(jìn)入某個(gè)狀態(tài)后怎么出來",記住三個(gè)反悔鍵:

• 忘了路 → /help
• 回到從前 → /resume
• 撤銷剛才 → /rewind

你就已經(jīng)比 80% 的 Claude Code 用戶熟練了。

最后的建議:這篇文章不用一次讀完。先把第三章(/btw vs /branch)+ 第四章(10 條黃金指令)+ 第五章(5 分鐘流程)三章吃透,立刻就能開干;第六章當(dāng)目錄收藏著隨時(shí)查;第七章是踩坑急救包。

本文參考:Commands - Claude Code Docs(官方)

到此這篇關(guān)于Claude Code指令超詳細(xì)入門教程的文章就介紹到這了,更多相關(guān)ClaudeCode指令入門內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論