、快捷鍵與自然語言全掌握)
把 Claude Code 當聊天窗口用的人大概只發(fā)揮了它兩成不到的功力。真正讓它從“玩具”變成“生產(chǎn)力工具”的不是誰的提示詞寫得更華麗而是誰腦子里存的指令多、用得準。這篇文章我把自己每天真實在敲的指令全部掏出來分門別類整理成套最后給出一張剛好 100 條的速查表覆蓋斜杠指令、終端參數(shù)、快捷鍵和常用自然語言操作既不聊虛的架構(gòu)也不堆沒用的概念打開就能照著敲。我默認你已經(jīng)在用 Claude Code或者至少裝好了準備開始用。如果你還卡在安裝、登錄、連不上服務(wù)這種階段第 2 節(jié)先把環(huán)境趟平再往后看。1. 先理清 Claude Code 指令體系的四條線很多人剛開始用 Claude Code 會犯同一個錯以為指令只有/開頭的那些。其實日常使用的“指令”至少分成四條線理解了這條線后面的速查表才看得懂。第一條線是斜杠指令也就是在對話里直接敲/開頭的命令。它們作用在會話內(nèi)部管的是“當前這輪對話怎么處理”清空歷史用/clear壓縮上下文用/compact切換模型用/model查看費用用/cost。這類指令數(shù)量不算多但每條都是高頻中的高頻是每天手速最快的幾個按鍵。第二條線是終端參數(shù)和子命令也就是你在 Shell 里輸入claude時攜帶的那些參數(shù)。它們決定的是“這次程序以什么方式啟動”是用交互模式還是非交互模式是繼續(xù)上次會話還是重新開一個是允許自動編輯還是每次詢問。這條線最容易被忽略但恰恰是在自動化、腳本、CI 場景里的命根子。第三條線是快捷鍵。Claude Code 的鍵盤操作繼承了終端工具一貫的克制風格數(shù)量不多但每個都關(guān)鍵。比如中斷生成、允許工具執(zhí)行、切換到全允許模式這些動作如果不走快捷鍵交互效率會斷崖式下跌。第四條線是最容易被忽略的自然語言指令。Claude Code 本質(zhì)上是個編碼代理它最擅長的不是機械地執(zhí)行命令而是聽懂你的意圖。所以“打開 src/index.js 看前 80 行”“找出所有調(diào)用 formatDate 的文件”“把這兩個函數(shù)合并成一個”這些話本身就是指令。很多人只會寫開場提示詞后面事無巨細全靠打字不習慣用自然語言做局部的、精準的指令這樣效率反而低了。四條線合在一起才構(gòu)成完整的“Claude Code 指令體系”。下面我按工作順序一條一條把這四條線拆開講。2. 開工前必跑的安裝與檢查指令以及連接問題怎么排先把地基打牢。我見過太多人連claude doctor都沒跑過遇到問題就蒙圈。2.1 安裝、升級、環(huán)境自檢安裝本身很簡單一條命令的事npm install -g anthropic-ai/claude-code裝完先確認版本并且養(yǎng)成定期升級的習慣claude --version claude update這里要提醒一句claude update這個動作我一開始總忘。Claude Code 的迭代速度極快有時候頭一天還在用的指令第二天更新后就有了新參數(shù)或者舊參數(shù)改了名。我踩過一次坑某次升級后--continue的行為變了我沒注意到版本號還以為是 bug折騰半天才發(fā)現(xiàn)是自己用的老參數(shù)沒跟上新版本的語義。所以每周至少跑一次claude update真的很有必要。環(huán)境自檢是很多人的盲區(qū)claude doctor這條命令會檢查安裝狀態(tài)、登錄狀態(tài)、環(huán)境變量、配置文件位置輸出一份診斷報告。遇到任何詭異問題先跑它大部分時候問題當場就暴露了。如果claude doctor提示沒問題但依然用不了那基本可以斷定是網(wǎng)絡(luò)層或者賬號層的問題繼續(xù)往 2.3 走。2.2 登錄與密鑰配置安裝完成后第一件正事是登錄claude首次運行會引導你完成登錄流程。背后實際生效的方式有兩種瀏覽器登錄得到臨時憑證或者直接用 API Key。API Key 的方式更適合服務(wù)器環(huán)境export ANTHROPIC_API_KEYsk-ant-your-key-here claude會話內(nèi)也可以隨時處理登錄狀態(tài)用斜杠指令/login /logout/login的作用是重新認證或者切換賬號/logout則是登出。我一般在團隊公用服務(wù)器上干完活會主動/logout避免把憑證留在公共環(huán)境這個習慣建議你也有。2.3 “無法連接 Anthropic 服務(wù)”的通用排查鏈路很多新手經(jīng)常會碰到標題里那個報錯unable to connect to anthropic services fail。這個報錯在不同版本里措辭略有差異比如failed to connect、request failed之類但本質(zhì)都一樣客戶端沒能和 Anthropic 服務(wù)端建立起正常的通信鏈路。我自己的排查順序是固定的一套每次照著走基本幾分鐘能定位claude doctor看基礎(chǔ)環(huán)境有沒有問題。claude --version確認版本號不是太老、不是太新剛升級。檢查網(wǎng)絡(luò)出口是不是正常最簡單的方式是直接在終端里探測一下比如ping api.anthropic.com或者用curl試著拉一次接口。如果連基本的網(wǎng)絡(luò)請求都到不了對端那問題十有八九不在 Claude Code 本身。檢查環(huán)境變量里有沒有殘留的ANTHROPIC_API_KEY或者ANTHROPIC_BASE_URL。如果之前配過別的服務(wù)商地址現(xiàn)在忘了清除請求就會打到錯誤的地方。用env | grep ANTHROPIC看一下最直觀。重新登錄一次/logout然后/login有時是憑證過期但客戶端沒給出明確提醒。如果是剛升級完版本后突然連不上而你的網(wǎng)絡(luò)完全正常那多數(shù)是版本本身的問題優(yōu)先去看官方更新說明或者臨時降回上一個穩(wěn)定版本繼續(xù)把手頭事干完。不要反復(fù)重裝重裝解決不了這類問題。3. 每天撲進項目里最常用的一批指令會話、文件與編輯這部分是我每天敲得最多的地方。熟練之后你會發(fā)現(xiàn)自己不再盯著屏幕等回復(fù)而是像開車一樣變道、跟車、按喇叭一系列動作全憑肌肉記憶。3.1 開啟、繼續(xù)、恢復(fù)會話日常開始工作就兩條路claude進一個新會話默認讀取當前目錄上下文。如果今天要接著昨天沒干完的活別開新的用繼續(xù)claude -c-c等價于--continue會直接接上最近一次會話的歷史繼續(xù)。如果開了太多會話想指定某個用claude -r claude --resume 12345678-r會給出一個會話列表讓你挑--resume后面跟會話 ID 直接精準回到那一次對話。這個功能對“隔了好幾天才回來的考古現(xiàn)場”尤其好用。3.2 會話生命周期管理會話開久了上下文會越來越臃腫處理速度下降、理解變形。這種時候別硬撐三件套直接上/clear清空當前上下文重新開始一個干凈會話。Claude Code 會忘掉之前所有對話內(nèi)容但項目文件還在重啟對話不受影響。/compact不清空而是把歷史壓縮成摘要。適合還想保留當前任務(wù)脈絡(luò)但上下文已經(jīng)太長的情況。壓縮之后它能記住關(guān)鍵結(jié)論但細節(jié)會丟失一些使用前心里要有數(shù)。/rewind回退到之前的某個狀態(tài)。如果發(fā)現(xiàn)自己剛才讓它干了一堆錯誤操作別手動糾正了直接/rewind回到出錯之前。這個功能是我重度依賴項它相當于給對話上了一道存檔。查看上下文占用情況也有一個專門指令/context能顯示當前上下文里有哪些文件、多少字符、大致占比。我一般每半小時就掃一眼一旦發(fā)現(xiàn)某個大文件占了太多上下文空間立刻考慮是不是要把那個文件從上下文里趕出去給真正重要的代碼騰位置。費用控制也是一天要看好幾次的事/cost顯示當前會話累計 token 消耗和費用。價格焦慮人士的定心丸也是估算一個任務(wù)花多少錢的最快方式。3.3 文件導航、檢索與編輯的高頻話術(shù)代碼操作里有那么幾句自然語言是我用成千上萬次總結(jié)出來的萬能話術(shù)直接照著說就行先說看文件“打開 src/utils/date.ts先看前 120 行完整貼給我。”“不要貼代碼只用三句話告訴我這個文件是干什么的?！薄鞍?src/server 這個目錄下的所有文件用目錄樹的形式列出來標出每個文件的作用?！痹僬f檢索“在倉庫里找到 defineStore 這個函數(shù)的所有定義和調(diào)用位置。”“搜索所有用到 getUserInfo 的文件按調(diào)用鏈整理成列表?！薄鞍?package.json 里的依賴和 scripts 整理成我要看的摘要?！弊詈笳f編輯這是重頭戲。Claude Code 之所以比普通聊天強就是因為它能直接改文件“把 utils/request.ts 里的超時時間從 5000 改成 10000其他任何地方都不要動。”“把這兩個函數(shù)拆成一個工具類保持外部調(diào)用不變?！薄霸?README 里加一節(jié) Quick Start內(nèi)容照抄現(xiàn)有注釋的風格?！庇米匀徽Z言下指令有一個原則要養(yǎng)成說清范圍。只說“幫我優(yōu)化一下代碼”它可能給你重寫一遍但如果說“只優(yōu)化 utils/date.ts 中的 parseDate 函數(shù)保持入?yún)⒊鰠⒉蛔儭彼蜁蚨ㄔ跍蚀_的邊界里改改動可控得多。3.4 權(quán)限批準從每步確認到放心自動Claude Code 執(zhí)行寫文件、跑命令這類高危操作前會向你請求權(quán)限。交互中你按幾個鍵就能控制節(jié)奏y允許當前這一次操作。A允許當前這一類操作后面不再詢問accept always。R拒絕當前操作。E進入編輯模式手動改寫它要發(fā)出的工具調(diào)用。還有個容易被忽略的快捷鍵是ShiftTab它會在工具的權(quán)限模式之間循環(huán)切換從“每次都問”切到“只允許編輯類操作”再切到別的模式。切到什么模式直接決定你接下來是“用人肉控制臺”還是“半自動駕駛”用熟之后能明顯減少坐在屏幕前機械按 y 的次數(shù)。如果你已經(jīng)足夠信任它也能直接在啟動時指定權(quán)限模式claude --permission-mode acceptEdits這個模式會自動允許它改文件但執(zhí)行 shell 命令時還是會問。我自己的日常配置就是這種安全性和效率取了一個穩(wěn)定平衡點。4. 讓 Claude 記得住、看得懂、會自查規(guī)則、記憶與審查如果你只把 Claude Code 當成一個“一次性問答機器”那確實不太需要這部分。但如果你要它在同一個項目里連續(xù)工作幾個月就必須讓它記住項目約定并且有能力自查輸出質(zhì)量。4.1 用 CLAUDE.md 把項目約定寫進它腦子里Claude Code 會在每次啟動時自動讀取項目里的CLAUDE.md文件把它當作長期記憶。這個機制適合放什么放那些“你希望每次對話它都默認知道”的事項目技術(shù)棧是什么主語言、框架、包管理器。代碼風格規(guī)范縮進、命名、注釋語言。目錄結(jié)構(gòu)約定業(yè)務(wù)代碼放哪、工具函數(shù)放哪、測試放哪。常見注意事項“不要動 migrations 目錄”“改 schema 前先看設(shè)計文檔”。手動創(chuàng)建一份太慢了直接用它的初始化能力/init/init會掃描當前項目結(jié)構(gòu)結(jié)合已有的代碼和 README自動生成一份初始的CLAUDE.md。我自己用下來的體驗是它生成的骨架比想象中靠譜你只需要再人工補幾條只有項目老人知道的“潛規(guī)則”進去就行。全局和項目級的記憶是分層的~/.claude/CLAUDE.md存的是所有項目通用的偏好項目根目錄的CLAUDE.md存的是本項目特有約定。兩者不沖突是疊加的關(guān)系。4.2 /memory把臨時記住的事變成長期規(guī)則除了CLAUDE.mdClaude Code 還有一套會話記憶機制/memory有時候你在對話里隨口說了一句“以后提交信息都用約定式提交”它當時記住了但新會話開了又忘。/memory就能把這類“臨時共識”固化下來寫進持久化的記憶文件之后的會話自動加載。我的用法是凡是我們團隊在一個會話里達成的新約定比如“測試文件后綴改成 .spec.ts”“所有 API 返回結(jié)構(gòu)統(tǒng)一成 { code, data, msg }”都會順手讓 Claude Code 用/memory記住而不是每次重新交代。這個動作一次幾秒鐘長期省下來的重復(fù)說明時間非?？捎^。4.3 /review寫完就審不用等 Code Review 會議代碼改完之后別急著走人。讓 Claude Code 自己先審一遍/review它會查看當前未提交的改動給出評審意見包括潛在 bug、邊界條件、風格問題、遺漏的錯誤處理。這個環(huán)節(jié)相當于多了個“第二雙眼睛”而且比人工 Review 快得多。我現(xiàn)在的固定流程是文件改完 →/review→ 根據(jù)意見修一輪 → 再/review一次確認干凈了才提交。注意/review看的是當前工作區(qū)改動如果你已經(jīng)把代碼提交了它默認看不到。所以節(jié)奏是先git add但別急著 commit或者干脆保持工作區(qū)帶改動狀態(tài)審?fù)暝偬峤弧?.4 用 hooks 做自動化自檢Claude Code 的 hooks 機制可以把自定義腳本掛到特定事件上。比較實用的事件有這么幾類PreToolUse在它調(diào)用某個工具前觸發(fā)適合做“安檢”PostToolUse工具執(zhí)行完后觸發(fā)適合做“復(fù)核”Notification需要中斷工作時通知你Stop一輪完整輸出結(jié)束后觸發(fā)。hooks 的配置放在.claude/settings.json里。舉個例子如果我不希望 Claude Code 不小心執(zhí)行sudo命令可以做一條PreToolUse規(guī)則匹配Bash(sudo*)直接攔截讓命令在執(zhí)行前就被卡掉。這類自動化我一般配置在.claude/settings.local.json里只有自己機器生效不會把個人偏好帶進團隊倉庫。5. 插件化玩法的指令自定義斜杠命令、技能與 MCP 服務(wù)用了一段時間后你需要把 Claude Code 長成自己的形狀而不是每次重新教它。這個階段的核心是自定義斜杠命令、Skills、MCP 服務(wù)。5.1 自定義斜杠命令把固定流程固化成單詞每次都要手打一大段 prompt 來讓它“做某某事”其實是懶人的災(zāi)難。正確做法是把這段動作固化成你的專屬斜杠命令。方法很簡單在項目的.claude/commands/目錄下新建一個 Markdown 文件文件名就是斜杠命令名。比如建一個deploy.md文件內(nèi)容寫清楚“當用戶執(zhí)行 /deploy 時要做哪些步驟”保存后在 Claude Code 里敲/deploy它就會按文件里的規(guī)則去執(zhí)行。里面還能用$ARGUMENTS接收你傳給這個斜杠命令的參數(shù)寫一些變量化的處理邏輯。哪個場景適合自定義我舉幾個自己已經(jīng)固化的例子/changelog根據(jù) git log 生成本周變更日志/refactor讀取指定文件按項目重構(gòu)規(guī)范給出重構(gòu)方案并實施/help-dir生成當前目錄的說明文檔/test給當前改動文件補單元測試。這些本質(zhì)上是把高頻、固定、帶約束的任務(wù)從“每次打 50 個字”壓縮成“一個斜杠命令”。5.2 Skills給 Claude Code 裝上“專屬知識包”Skills 和自定義斜杠命令的區(qū)別在于斜杠命令是你主動觸發(fā)的一次性動作Skills 更像是一個常駐的技能包Claude Code 會在你在對話中自然遇到相關(guān)問題時就嘗試使用它。技能文件一般放在.claude/skills/目錄下每個技能是一個子目錄里面有一份SKILL.md描述這個技能的觸發(fā)場景、使用步驟、注意事項還可以附帶腳本、模板、規(guī)則文件等資源。配置好后通過/skills查看當前加載了哪些技能也可以主動在斜杠指令里選擇讓 Claude Code 調(diào)用某個技能。我在團隊里最常用的做法是給“代碼遷移”“依賴升級”“日志分析”這類既有方法論又包含大量檢查步驟的場景單獨寫技能寫一次全隊復(fù)用。它最大的價值不是單個步驟神奇而是把“老師傅的操作習慣”變成了“可被自動觸發(fā)的標準流程”少了每次重新摸索的時間。5.3 MCP 服務(wù)把外部工具接進來MCP 是讓 Claude Code 能訪問外部工具和數(shù)據(jù)的標準接口。有人用它連數(shù)據(jù)庫有人連文件系統(tǒng)有人連瀏覽器自動化工具。Claude Code 自帶一套 MCP 管理子命令claude mcp add 服務(wù)名 -- 啟動命令 claude mcp list claude mcp get 服務(wù)名 claude mcp remove 服務(wù)名add把服務(wù)注冊進來list查看所有服務(wù)get看某個服務(wù)的配置詳情remove移除。也可以在項目根目錄建.mcp.json文件手動聲明服務(wù)后一種方式更適合放進 Git 倉庫和團隊共享。我不建議一開始就接一堆 MCP 服務(wù)先徒手跑一段時間發(fā)現(xiàn)“哪類操作 Claude Code 需要反復(fù)借助外部數(shù)據(jù)才能完成”再有針對性地去接。服務(wù)接太多了每次啟動的上下文也很浪費上下文就是錢。6. 100 條常用指令速查表按場景整理下面這張表就是我日常用的全部家底按場景分組編號。前面幾節(jié)已經(jīng)展開講過的這里只留關(guān)鍵詞和適用場景方便你復(fù)制、檢索、貼到自己的筆記里。6.1 安裝、更新與登錄01–14序號指令什么時候用01npm install -g anthropic-ai/claude-code全局安裝 Claude Code02claude --version查看當前版本03claude update升級到最新版04claude doctor環(huán)境自檢排查安裝/配置問題05claude在項目目錄啟動交互式會話06/login登錄或重新認證07/logout登出當前賬號08export ANTHROPIC_API_KEYsk-ant-...設(shè)置 API Key 后啟動09claude --model sonnet用 Sonnet 模型啟動會話10claude --model opus用 Opus 模型啟動復(fù)雜任務(wù)首選11claude --model haiku用 Haiku 模型快而省12ANTHROPIC_MODELsonnet claude通過環(huán)境變量指定默認模型13claude -c/claude --continue繼續(xù)最近一次會話14claude -r/claude --resume 12345678從會話列表或指定 ID 恢復(fù)會話6.2 會話生命周期與上下文管理15–30序號指令什么時候用15/clear清空當前會話上下文16/compact壓縮歷史摘要保留主線17/rewind回退到之前的某一個操作節(jié)點18/context查看上下文占用、已讀文件、字符量19/cost查看當前會話 token 費用20/status查看會話狀態(tài)和錯誤信息21/export導出當前會話內(nèi)容22/model會話內(nèi)切換模型23/help查看斜杠指令幫助24/init初始化 CLAUDE.md25/memory查看/管理記憶26/add-dir把目錄加進當前上下文27/config打開配置文件28Esc中斷當前工具操作29CtrlC終止當前輸出30/vim切換 Vim 風格鍵盤導航6.3 文件、檢索與編輯31–52序號指令什么時候用31“打開 src/utils/date.ts貼前 120 行”固定范圍看文件32“用三句話說出這個文件是干什么的”快速理解文件33“把 src 目錄列成樹狀結(jié)構(gòu)”梳理項目結(jié)構(gòu)34“找到 getUserInfo 的所有定義和調(diào)用位置”檢索函數(shù)35“搜索所有用到 formatDate 的文件”按引用反向搜索36“把 package.json 的依賴整理成摘要”快速了解依賴37“把超時時間從 5000 改成 10000其他地方不動”精準改單個值38“把兩個函數(shù)拆成一個工具類外部調(diào)用不變”重構(gòu)函數(shù)39“給 utils/request.ts 加注釋風格照舊”按現(xiàn)有風格補注釋40“在 README 里加 Quick Start 一節(jié)”補充文檔41“對比這兩個文件的差異并總結(jié)”文件對比42“把這段報錯貼進去解釋原因并修復(fù)”報錯排查43“列出 src 下所有測試文件名”測試文件檢索44“找出所有 console.log列出行號和內(nèi)容”定位調(diào)試殘留45“重命名這個函數(shù)所有引用處同步改”聯(lián)動重命名46“把這段邏輯提取成公共函數(shù)”去除重復(fù)代碼47“檢查這個文件有沒有未處理的異?！贝a質(zhì)量檢查48“把 utils 目錄下的 TODO 全部列出來”找待辦標記49“給當前改動寫一份變更說明”生成改動摘要50“這個項目的測試怎么跑”問項目運行方式51“把改動文件按 git status 列出來并解釋”結(jié)合 Git 理解改動52“按函數(shù)調(diào)用關(guān)系畫一個 ASCII 圖表”依賴關(guān)系可視化6.4 權(quán)限、安全與確認53–64序號指令什么時候用53y允許當前這一次工具調(diào)用54A當前會話始終允許同類調(diào)用55R拒絕當前工具調(diào)用56E編輯工具調(diào)用參數(shù)后再執(zhí)行57ShiftTab循環(huán)切換工具權(quán)限模式58claude --permission-mode acceptEdits允許自動改文件命令仍需確認59claude --permission-mode plan只做規(guī)劃不執(zhí)行操作60claude --dangerously-skip-permissions跳過全部權(quán)限確認實驗室用61claude --allowedTools Bash(git*)白名單放行指定工具62claude --disallowedTools Bash(sudo*)黑名單禁止指定工具63claude --permission-prompt-tool Bash(git status)只對指定工具彈確認64/permissions查看當前權(quán)限配置6.5 模型、規(guī)則與配置65–78序號指令什么時候用65CLAUDE.md項目根目錄項目級長期記憶66~/.claude/CLAUDE.md全局通用規(guī)則67RULES文件追加約束規(guī)則68.claude/settings.json團隊共享配置69.claude/settings.local.json個人本地配置70.gitignore里加.claude/settings.local.json防止個人配置入庫71claude --system-prompt ...附加系統(tǒng)角色提示詞72claude --settings啟動時查看配置信息73claude -p ...非交互式一次性執(zhí)行74claude -p ... --max-turns 8限制最多執(zhí)行 8 輪75claude -p ... --include-partial-messages流式輸出部分消息76claude -p ... --verbose輸出完整日志77claude -p ... --debug調(diào)試模式運行78claude -p ... -o json輸出 JSON 格式供腳本解析6.6 自動化鉤子、技能與 MCP79–91序號指令什么時候用79/hooks打開鉤子配置向?qū)?0PreToolUse鉤子事件在工具調(diào)用前攔截檢查81PostToolUse鉤子事件工具執(zhí)行后復(fù)核82Notification鉤子事件需要人工確認時通知83Stop鉤子事件輸出結(jié)束后觸發(fā)后續(xù)動作84/skills查看當前已加載的技能85claude install-skill安裝技能包86.claude/skills/xxx/SKILL.md手動創(chuàng)建技能定義87.claude/commands/deploy.md自定義斜杠命令文件88$ARGUMENTS在自定義命令中接收參數(shù)89claude mcp add name -- cmd注冊 MCP 服務(wù)90claude mcp list查看已注冊的 MCP 服務(wù)91claude mcp remove name移除 MCP 服務(wù)6.7 Git 工作流與 CI 場景92–100)序號指令什么時候用92git diffclaude -p 寫一條 git commit 信息93git log --oneline -10claude -p 整理最近的變更94claude -p 審查當前工作區(qū)改動代碼審查不進交互界面95claude -p 把 src 下所有 TODO 列出 -o json腳本化提取待辦96claude --session-id id在 CI 中指定會話標識97echo ...claude -p ...98cat error.logclaude -p 歸納三類主要錯誤99claude -p ... --model opus復(fù)雜一次性任務(wù)用更強模型100cd /project claude -c進項目目錄后繼續(xù)上個會話用這張表的時候記住幾件事斜杠指令在交互模式內(nèi)輸入終端參數(shù)在啟動時輸入快捷鍵是運行中直接按鍵盤那幾顆鍵。剩下的自然語言指令不用死記理解“范圍明確 輸出明確”的說話方式你就能自己造出第 101 條、102 條。最后補一句我自己的體會指令背得再熟也代替不了理解。真正把工具用順的人其實是把每條指令背后的“為什么”想通了知道什么時候該清上下文、什么時候該開新會話、什么時候該給自己加權(quán)限。這份清單只是把路鋪好怎么走得看你自己。 Claude Code 100條指令速查表：斜杠指令、終端參數(shù)、快捷鍵與自然語言全掌握
把 Claude Code 當聊天窗口用的人大概只發(fā)揮了它兩成不到的功力。真正讓它從“玩具”變成“生產(chǎn)力工具”的不是誰的提示詞寫得更華麗而是誰腦子里存的指令多、用得準。這篇文章我把自己每天真實在敲的指令全部掏出來分門別類整理成套最后給出一張剛好 100 條的速查表覆蓋斜杠指令、終端參數(shù)、快捷鍵和常用自然語言操作既不聊虛的架構(gòu)也不堆沒用的概念打開就能照著敲。我默認你已經(jīng)在用 Claude Code或者至少裝好了準備開始用。如果你還卡在安裝、登錄、連不上服務(wù)這種階段第 2 節(jié)先把環(huán)境趟平再往后看。1. 先理清 Claude Code 指令體系的四條線很多人剛開始用 Claude Code 會犯同一個錯以為指令只有/開頭的那些。其實日常使用的“指令”至少分成四條線理解了這條線后面的速查表才看得懂。第一條線是斜杠指令也就是在對話里直接敲/開頭的命令。它們作用在會話內(nèi)部管的是“當前這輪對話怎么處理”清空歷史用/clear壓縮上下文用/compact切換模型用/model查看費用用/cost。這類指令數(shù)量不算多但每條都是高頻中的高頻是每天手速最快的幾個按鍵。第二條線是終端參數(shù)和子命令也就是你在 Shell 里輸入claude時攜帶的那些參數(shù)。它們決定的是“這次程序以什么方式啟動”是用交互模式還是非交互模式是繼續(xù)上次會話還是重新開一個是允許自動編輯還是每次詢問。這條線最容易被忽略但恰恰是在自動化、腳本、CI 場景里的命根子。第三條線是快捷鍵。Claude Code 的鍵盤操作繼承了終端工具一貫的克制風格數(shù)量不多但每個都關(guān)鍵。比如中斷生成、允許工具執(zhí)行、切換到全允許模式這些動作如果不走快捷鍵交互效率會斷崖式下跌。第四條線是最容易被忽略的自然語言指令。Claude Code 本質(zhì)上是個編碼代理它最擅長的不是機械地執(zhí)行命令而是聽懂你的意圖。所以“打開 src/index.js 看前 80 行”“找出所有調(diào)用 formatDate 的文件”“把這兩個函數(shù)合并成一個”這些話本身就是指令。很多人只會寫開場提示詞后面事無巨細全靠打字不習慣用自然語言做局部的、精準的指令這樣效率反而低了。四條線合在一起才構(gòu)成完整的“Claude Code 指令體系”。下面我按工作順序一條一條把這四條線拆開講。2. 開工前必跑的安裝與檢查指令以及連接問題怎么排先把地基打牢。我見過太多人連claude doctor都沒跑過遇到問題就蒙圈。2.1 安裝、升級、環(huán)境自檢安裝本身很簡單一條命令的事npm install -g anthropic-ai/claude-code裝完先確認版本并且養(yǎng)成定期升級的習慣claude --version claude update這里要提醒一句claude update這個動作我一開始總忘。Claude Code 的迭代速度極快有時候頭一天還在用的指令第二天更新后就有了新參數(shù)或者舊參數(shù)改了名。我踩過一次坑某次升級后--continue的行為變了我沒注意到版本號還以為是 bug折騰半天才發(fā)現(xiàn)是自己用的老參數(shù)沒跟上新版本的語義。所以每周至少跑一次claude update真的很有必要。環(huán)境自檢是很多人的盲區(qū)claude doctor這條命令會檢查安裝狀態(tài)、登錄狀態(tài)、環(huán)境變量、配置文件位置輸出一份診斷報告。遇到任何詭異問題先跑它大部分時候問題當場就暴露了。如果claude doctor提示沒問題但依然用不了那基本可以斷定是網(wǎng)絡(luò)層或者賬號層的問題繼續(xù)往 2.3 走。2.2 登錄與密鑰配置安裝完成后第一件正事是登錄claude首次運行會引導你完成登錄流程。背后實際生效的方式有兩種瀏覽器登錄得到臨時憑證或者直接用 API Key。API Key 的方式更適合服務(wù)器環(huán)境export ANTHROPIC_API_KEYsk-ant-your-key-here claude會話內(nèi)也可以隨時處理登錄狀態(tài)用斜杠指令/login /logout/login的作用是重新認證或者切換賬號/logout則是登出。我一般在團隊公用服務(wù)器上干完活會主動/logout避免把憑證留在公共環(huán)境這個習慣建議你也有。2.3 “無法連接 Anthropic 服務(wù)”的通用排查鏈路很多新手經(jīng)常會碰到標題里那個報錯unable to connect to anthropic services fail。這個報錯在不同版本里措辭略有差異比如failed to connect、request failed之類但本質(zhì)都一樣客戶端沒能和 Anthropic 服務(wù)端建立起正常的通信鏈路。我自己的排查順序是固定的一套每次照著走基本幾分鐘能定位claude doctor看基礎(chǔ)環(huán)境有沒有問題。claude --version確認版本號不是太老、不是太新剛升級。檢查網(wǎng)絡(luò)出口是不是正常最簡單的方式是直接在終端里探測一下比如ping api.anthropic.com或者用curl試著拉一次接口。如果連基本的網(wǎng)絡(luò)請求都到不了對端那問題十有八九不在 Claude Code 本身。檢查環(huán)境變量里有沒有殘留的ANTHROPIC_API_KEY或者ANTHROPIC_BASE_URL。如果之前配過別的服務(wù)商地址現(xiàn)在忘了清除請求就會打到錯誤的地方。用env | grep ANTHROPIC看一下最直觀。重新登錄一次/logout然后/login有時是憑證過期但客戶端沒給出明確提醒。如果是剛升級完版本后突然連不上而你的網(wǎng)絡(luò)完全正常那多數(shù)是版本本身的問題優(yōu)先去看官方更新說明或者臨時降回上一個穩(wěn)定版本繼續(xù)把手頭事干完。不要反復(fù)重裝重裝解決不了這類問題。3. 每天撲進項目里最常用的一批指令會話、文件與編輯這部分是我每天敲得最多的地方。熟練之后你會發(fā)現(xiàn)自己不再盯著屏幕等回復(fù)而是像開車一樣變道、跟車、按喇叭一系列動作全憑肌肉記憶。3.1 開啟、繼續(xù)、恢復(fù)會話日常開始工作就兩條路claude進一個新會話默認讀取當前目錄上下文。如果今天要接著昨天沒干完的活別開新的用繼續(xù)claude -c-c等價于--continue會直接接上最近一次會話的歷史繼續(xù)。如果開了太多會話想指定某個用claude -r claude --resume 12345678-r會給出一個會話列表讓你挑--resume后面跟會話 ID 直接精準回到那一次對話。這個功能對“隔了好幾天才回來的考古現(xiàn)場”尤其好用。3.2 會話生命周期管理會話開久了上下文會越來越臃腫處理速度下降、理解變形。這種時候別硬撐三件套直接上/clear清空當前上下文重新開始一個干凈會話。Claude Code 會忘掉之前所有對話內(nèi)容但項目文件還在重啟對話不受影響。/compact不清空而是把歷史壓縮成摘要。適合還想保留當前任務(wù)脈絡(luò)但上下文已經(jīng)太長的情況。壓縮之后它能記住關(guān)鍵結(jié)論但細節(jié)會丟失一些使用前心里要有數(shù)。/rewind回退到之前的某個狀態(tài)。如果發(fā)現(xiàn)自己剛才讓它干了一堆錯誤操作別手動糾正了直接/rewind回到出錯之前。這個功能是我重度依賴項它相當于給對話上了一道存檔。查看上下文占用情況也有一個專門指令/context能顯示當前上下文里有哪些文件、多少字符、大致占比。我一般每半小時就掃一眼一旦發(fā)現(xiàn)某個大文件占了太多上下文空間立刻考慮是不是要把那個文件從上下文里趕出去給真正重要的代碼騰位置。費用控制也是一天要看好幾次的事/cost顯示當前會話累計 token 消耗和費用。價格焦慮人士的定心丸也是估算一個任務(wù)花多少錢的最快方式。3.3 文件導航、檢索與編輯的高頻話術(shù)代碼操作里有那么幾句自然語言是我用成千上萬次總結(jié)出來的萬能話術(shù)直接照著說就行先說看文件“打開 src/utils/date.ts先看前 120 行完整貼給我。”“不要貼代碼只用三句話告訴我這個文件是干什么的?！薄鞍?src/server 這個目錄下的所有文件用目錄樹的形式列出來標出每個文件的作用?！痹僬f檢索“在倉庫里找到 defineStore 這個函數(shù)的所有定義和調(diào)用位置。”“搜索所有用到 getUserInfo 的文件按調(diào)用鏈整理成列表?！薄鞍?package.json 里的依賴和 scripts 整理成我要看的摘要?！弊詈笳f編輯這是重頭戲。Claude Code 之所以比普通聊天強就是因為它能直接改文件“把 utils/request.ts 里的超時時間從 5000 改成 10000其他任何地方都不要動。”“把這兩個函數(shù)拆成一個工具類保持外部調(diào)用不變?！薄霸?README 里加一節(jié) Quick Start內(nèi)容照抄現(xiàn)有注釋的風格?！庇米匀徽Z言下指令有一個原則要養(yǎng)成說清范圍。只說“幫我優(yōu)化一下代碼”它可能給你重寫一遍但如果說“只優(yōu)化 utils/date.ts 中的 parseDate 函數(shù)保持入?yún)⒊鰠⒉蛔儭彼蜁蚨ㄔ跍蚀_的邊界里改改動可控得多。3.4 權(quán)限批準從每步確認到放心自動Claude Code 執(zhí)行寫文件、跑命令這類高危操作前會向你請求權(quán)限。交互中你按幾個鍵就能控制節(jié)奏y允許當前這一次操作。A允許當前這一類操作后面不再詢問accept always。R拒絕當前操作。E進入編輯模式手動改寫它要發(fā)出的工具調(diào)用。還有個容易被忽略的快捷鍵是ShiftTab它會在工具的權(quán)限模式之間循環(huán)切換從“每次都問”切到“只允許編輯類操作”再切到別的模式。切到什么模式直接決定你接下來是“用人肉控制臺”還是“半自動駕駛”用熟之后能明顯減少坐在屏幕前機械按 y 的次數(shù)。如果你已經(jīng)足夠信任它也能直接在啟動時指定權(quán)限模式claude --permission-mode acceptEdits這個模式會自動允許它改文件但執(zhí)行 shell 命令時還是會問。我自己的日常配置就是這種安全性和效率取了一個穩(wěn)定平衡點。4. 讓 Claude 記得住、看得懂、會自查規(guī)則、記憶與審查如果你只把 Claude Code 當成一個“一次性問答機器”那確實不太需要這部分。但如果你要它在同一個項目里連續(xù)工作幾個月就必須讓它記住項目約定并且有能力自查輸出質(zhì)量。4.1 用 CLAUDE.md 把項目約定寫進它腦子里Claude Code 會在每次啟動時自動讀取項目里的CLAUDE.md文件把它當作長期記憶。這個機制適合放什么放那些“你希望每次對話它都默認知道”的事項目技術(shù)棧是什么主語言、框架、包管理器。代碼風格規(guī)范縮進、命名、注釋語言。目錄結(jié)構(gòu)約定業(yè)務(wù)代碼放哪、工具函數(shù)放哪、測試放哪。常見注意事項“不要動 migrations 目錄”“改 schema 前先看設(shè)計文檔”。手動創(chuàng)建一份太慢了直接用它的初始化能力/init/init會掃描當前項目結(jié)構(gòu)結(jié)合已有的代碼和 README自動生成一份初始的CLAUDE.md。我自己用下來的體驗是它生成的骨架比想象中靠譜你只需要再人工補幾條只有項目老人知道的“潛規(guī)則”進去就行。全局和項目級的記憶是分層的~/.claude/CLAUDE.md存的是所有項目通用的偏好項目根目錄的CLAUDE.md存的是本項目特有約定。兩者不沖突是疊加的關(guān)系。4.2 /memory把臨時記住的事變成長期規(guī)則除了CLAUDE.mdClaude Code 還有一套會話記憶機制/memory有時候你在對話里隨口說了一句“以后提交信息都用約定式提交”它當時記住了但新會話開了又忘。/memory就能把這類“臨時共識”固化下來寫進持久化的記憶文件之后的會話自動加載。我的用法是凡是我們團隊在一個會話里達成的新約定比如“測試文件后綴改成 .spec.ts”“所有 API 返回結(jié)構(gòu)統(tǒng)一成 { code, data, msg }”都會順手讓 Claude Code 用/memory記住而不是每次重新交代。這個動作一次幾秒鐘長期省下來的重復(fù)說明時間非?？捎^。4.3 /review寫完就審不用等 Code Review 會議代碼改完之后別急著走人。讓 Claude Code 自己先審一遍/review它會查看當前未提交的改動給出評審意見包括潛在 bug、邊界條件、風格問題、遺漏的錯誤處理。這個環(huán)節(jié)相當于多了個“第二雙眼睛”而且比人工 Review 快得多。我現(xiàn)在的固定流程是文件改完 →/review→ 根據(jù)意見修一輪 → 再/review一次確認干凈了才提交。注意/review看的是當前工作區(qū)改動如果你已經(jīng)把代碼提交了它默認看不到。所以節(jié)奏是先git add但別急著 commit或者干脆保持工作區(qū)帶改動狀態(tài)審?fù)暝偬峤弧?.4 用 hooks 做自動化自檢Claude Code 的 hooks 機制可以把自定義腳本掛到特定事件上。比較實用的事件有這么幾類PreToolUse在它調(diào)用某個工具前觸發(fā)適合做“安檢”PostToolUse工具執(zhí)行完后觸發(fā)適合做“復(fù)核”Notification需要中斷工作時通知你Stop一輪完整輸出結(jié)束后觸發(fā)。hooks 的配置放在.claude/settings.json里。舉個例子如果我不希望 Claude Code 不小心執(zhí)行sudo命令可以做一條PreToolUse規(guī)則匹配Bash(sudo*)直接攔截讓命令在執(zhí)行前就被卡掉。這類自動化我一般配置在.claude/settings.local.json里只有自己機器生效不會把個人偏好帶進團隊倉庫。5. 插件化玩法的指令自定義斜杠命令、技能與 MCP 服務(wù)用了一段時間后你需要把 Claude Code 長成自己的形狀而不是每次重新教它。這個階段的核心是自定義斜杠命令、Skills、MCP 服務(wù)。5.1 自定義斜杠命令把固定流程固化成單詞每次都要手打一大段 prompt 來讓它“做某某事”其實是懶人的災(zāi)難。正確做法是把這段動作固化成你的專屬斜杠命令。方法很簡單在項目的.claude/commands/目錄下新建一個 Markdown 文件文件名就是斜杠命令名。比如建一個deploy.md文件內(nèi)容寫清楚“當用戶執(zhí)行 /deploy 時要做哪些步驟”保存后在 Claude Code 里敲/deploy它就會按文件里的規(guī)則去執(zhí)行。里面還能用$ARGUMENTS接收你傳給這個斜杠命令的參數(shù)寫一些變量化的處理邏輯。哪個場景適合自定義我舉幾個自己已經(jīng)固化的例子/changelog根據(jù) git log 生成本周變更日志/refactor讀取指定文件按項目重構(gòu)規(guī)范給出重構(gòu)方案并實施/help-dir生成當前目錄的說明文檔/test給當前改動文件補單元測試。這些本質(zhì)上是把高頻、固定、帶約束的任務(wù)從“每次打 50 個字”壓縮成“一個斜杠命令”。5.2 Skills給 Claude Code 裝上“專屬知識包”Skills 和自定義斜杠命令的區(qū)別在于斜杠命令是你主動觸發(fā)的一次性動作Skills 更像是一個常駐的技能包Claude Code 會在你在對話中自然遇到相關(guān)問題時就嘗試使用它。技能文件一般放在.claude/skills/目錄下每個技能是一個子目錄里面有一份SKILL.md描述這個技能的觸發(fā)場景、使用步驟、注意事項還可以附帶腳本、模板、規(guī)則文件等資源。配置好后通過/skills查看當前加載了哪些技能也可以主動在斜杠指令里選擇讓 Claude Code 調(diào)用某個技能。我在團隊里最常用的做法是給“代碼遷移”“依賴升級”“日志分析”這類既有方法論又包含大量檢查步驟的場景單獨寫技能寫一次全隊復(fù)用。它最大的價值不是單個步驟神奇而是把“老師傅的操作習慣”變成了“可被自動觸發(fā)的標準流程”少了每次重新摸索的時間。5.3 MCP 服務(wù)把外部工具接進來MCP 是讓 Claude Code 能訪問外部工具和數(shù)據(jù)的標準接口。有人用它連數(shù)據(jù)庫有人連文件系統(tǒng)有人連瀏覽器自動化工具。Claude Code 自帶一套 MCP 管理子命令claude mcp add 服務(wù)名 -- 啟動命令 claude mcp list claude mcp get 服務(wù)名 claude mcp remove 服務(wù)名add把服務(wù)注冊進來list查看所有服務(wù)get看某個服務(wù)的配置詳情remove移除。也可以在項目根目錄建.mcp.json文件手動聲明服務(wù)后一種方式更適合放進 Git 倉庫和團隊共享。我不建議一開始就接一堆 MCP 服務(wù)先徒手跑一段時間發(fā)現(xiàn)“哪類操作 Claude Code 需要反復(fù)借助外部數(shù)據(jù)才能完成”再有針對性地去接。服務(wù)接太多了每次啟動的上下文也很浪費上下文就是錢。6. 100 條常用指令速查表按場景整理下面這張表就是我日常用的全部家底按場景分組編號。前面幾節(jié)已經(jīng)展開講過的這里只留關(guān)鍵詞和適用場景方便你復(fù)制、檢索、貼到自己的筆記里。6.1 安裝、更新與登錄01–14序號指令什么時候用01npm install -g anthropic-ai/claude-code全局安裝 Claude Code02claude --version查看當前版本03claude update升級到最新版04claude doctor環(huán)境自檢排查安裝/配置問題05claude在項目目錄啟動交互式會話06/login登錄或重新認證07/logout登出當前賬號08export ANTHROPIC_API_KEYsk-ant-...設(shè)置 API Key 后啟動09claude --model sonnet用 Sonnet 模型啟動會話10claude --model opus用 Opus 模型啟動復(fù)雜任務(wù)首選11claude --model haiku用 Haiku 模型快而省12ANTHROPIC_MODELsonnet claude通過環(huán)境變量指定默認模型13claude -c/claude --continue繼續(xù)最近一次會話14claude -r/claude --resume 12345678從會話列表或指定 ID 恢復(fù)會話6.2 會話生命周期與上下文管理15–30序號指令什么時候用15/clear清空當前會話上下文16/compact壓縮歷史摘要保留主線17/rewind回退到之前的某一個操作節(jié)點18/context查看上下文占用、已讀文件、字符量19/cost查看當前會話 token 費用20/status查看會話狀態(tài)和錯誤信息21/export導出當前會話內(nèi)容22/model會話內(nèi)切換模型23/help查看斜杠指令幫助24/init初始化 CLAUDE.md25/memory查看/管理記憶26/add-dir把目錄加進當前上下文27/config打開配置文件28Esc中斷當前工具操作29CtrlC終止當前輸出30/vim切換 Vim 風格鍵盤導航6.3 文件、檢索與編輯31–52序號指令什么時候用31“打開 src/utils/date.ts貼前 120 行”固定范圍看文件32“用三句話說出這個文件是干什么的”快速理解文件33“把 src 目錄列成樹狀結(jié)構(gòu)”梳理項目結(jié)構(gòu)34“找到 getUserInfo 的所有定義和調(diào)用位置”檢索函數(shù)35“搜索所有用到 formatDate 的文件”按引用反向搜索36“把 package.json 的依賴整理成摘要”快速了解依賴37“把超時時間從 5000 改成 10000其他地方不動”精準改單個值38“把兩個函數(shù)拆成一個工具類外部調(diào)用不變”重構(gòu)函數(shù)39“給 utils/request.ts 加注釋風格照舊”按現(xiàn)有風格補注釋40“在 README 里加 Quick Start 一節(jié)”補充文檔41“對比這兩個文件的差異并總結(jié)”文件對比42“把這段報錯貼進去解釋原因并修復(fù)”報錯排查43“列出 src 下所有測試文件名”測試文件檢索44“找出所有 console.log列出行號和內(nèi)容”定位調(diào)試殘留45“重命名這個函數(shù)所有引用處同步改”聯(lián)動重命名46“把這段邏輯提取成公共函數(shù)”去除重復(fù)代碼47“檢查這個文件有沒有未處理的異?！贝a質(zhì)量檢查48“把 utils 目錄下的 TODO 全部列出來”找待辦標記49“給當前改動寫一份變更說明”生成改動摘要50“這個項目的測試怎么跑”問項目運行方式51“把改動文件按 git status 列出來并解釋”結(jié)合 Git 理解改動52“按函數(shù)調(diào)用關(guān)系畫一個 ASCII 圖表”依賴關(guān)系可視化6.4 權(quán)限、安全與確認53–64序號指令什么時候用53y允許當前這一次工具調(diào)用54A當前會話始終允許同類調(diào)用55R拒絕當前工具調(diào)用56E編輯工具調(diào)用參數(shù)后再執(zhí)行57ShiftTab循環(huán)切換工具權(quán)限模式58claude --permission-mode acceptEdits允許自動改文件命令仍需確認59claude --permission-mode plan只做規(guī)劃不執(zhí)行操作60claude --dangerously-skip-permissions跳過全部權(quán)限確認實驗室用61claude --allowedTools Bash(git*)白名單放行指定工具62claude --disallowedTools Bash(sudo*)黑名單禁止指定工具63claude --permission-prompt-tool Bash(git status)只對指定工具彈確認64/permissions查看當前權(quán)限配置6.5 模型、規(guī)則與配置65–78序號指令什么時候用65CLAUDE.md項目根目錄項目級長期記憶66~/.claude/CLAUDE.md全局通用規(guī)則67RULES文件追加約束規(guī)則68.claude/settings.json團隊共享配置69.claude/settings.local.json個人本地配置70.gitignore里加.claude/settings.local.json防止個人配置入庫71claude --system-prompt ...附加系統(tǒng)角色提示詞72claude --settings啟動時查看配置信息73claude -p ...非交互式一次性執(zhí)行74claude -p ... --max-turns 8限制最多執(zhí)行 8 輪75claude -p ... --include-partial-messages流式輸出部分消息76claude -p ... --verbose輸出完整日志77claude -p ... --debug調(diào)試模式運行78claude -p ... -o json輸出 JSON 格式供腳本解析6.6 自動化鉤子、技能與 MCP79–91序號指令什么時候用79/hooks打開鉤子配置向?qū)?0PreToolUse鉤子事件在工具調(diào)用前攔截檢查81PostToolUse鉤子事件工具執(zhí)行后復(fù)核82Notification鉤子事件需要人工確認時通知83Stop鉤子事件輸出結(jié)束后觸發(fā)后續(xù)動作84/skills查看當前已加載的技能85claude install-skill安裝技能包86.claude/skills/xxx/SKILL.md手動創(chuàng)建技能定義87.claude/commands/deploy.md自定義斜杠命令文件88$ARGUMENTS在自定義命令中接收參數(shù)89claude mcp add name -- cmd注冊 MCP 服務(wù)90claude mcp list查看已注冊的 MCP 服務(wù)91claude mcp remove name移除 MCP 服務(wù)6.7 Git 工作流與 CI 場景92–100)序號指令什么時候用92git diffclaude -p 寫一條 git commit 信息93git log --oneline -10claude -p 整理最近的變更94claude -p 審查當前工作區(qū)改動代碼審查不進交互界面95claude -p 把 src 下所有 TODO 列出 -o json腳本化提取待辦96claude --session-id id在 CI 中指定會話標識97echo ...claude -p ...98cat error.logclaude -p 歸納三類主要錯誤99claude -p ... --model opus復(fù)雜一次性任務(wù)用更強模型100cd /project claude -c進項目目錄后繼續(xù)上個會話用這張表的時候記住幾件事斜杠指令在交互模式內(nèi)輸入終端參數(shù)在啟動時輸入快捷鍵是運行中直接按鍵盤那幾顆鍵。剩下的自然語言指令不用死記理解“范圍明確 輸出明確”的說話方式你就能自己造出第 101 條、102 條。最后補一句我自己的體會指令背得再熟也代替不了理解。真正把工具用順的人其實是把每條指令背后的“為什么”想通了知道什么時候該清上下文、什么時候該開新會話、什么時候該給自己加權(quán)限。這份清單只是把路鋪好怎么走得看你自己。