1. 從被學(xué)長一句話問懵到跑通第一個(gè) Claude Code 任務(wù)Claude Code 是 Anthropic 推出的終端原生 AI 編程助手它直接跑在你的命令行里能讀寫項(xiàng)目文件、執(zhí)行 Shell 命令、搜索代碼庫、跑測(cè)試、提交 Git。它不是一個(gè)聊天窗口而是一個(gè) Agent——聊天窗口只能回答問題Agent 能直接操作你的項(xiàng)目。這篇筆記適合剛接觸 Claude Code、想搞清楚 Plan、Skills、子代理和上下文管理到底怎么用的人也適合已經(jīng)裝好工具但每次只會(huì)“打字讓它寫代碼”的新手。我當(dāng)時(shí)的處境很典型簡(jiǎn)歷上寫著“熟練使用 AI 輔助編程”結(jié)果被問“Claude Code 的三種工作模式分別解決什么問題上下文快滿的時(shí)候你怎么處理”直接卡殼?；厝ブ笪一艘恢苡靡粋€(gè)番茄鐘項(xiàng)目把核心操作全跑了一遍也順手把接入通道換成了 TaoToken 的統(tǒng)一 Key省得每個(gè)工具單獨(dú)配一遍。下面這份筆記不聊虛的只講操作、配置和踩過的坑你跟著做就能獨(dú)立完成一次完整調(diào)用。先明確一個(gè)認(rèn)知Claude Code 的啟動(dòng)方式很簡(jiǎn)單進(jìn)入項(xiàng)目目錄執(zhí)行claude底部出現(xiàn)輸入框就能用自然語言下指令。但真正拉開差距的是你怎么控制它的工作模式、上下文和審查機(jī)制。這三塊搞明白了工具使用能力才算過關(guān)。2. 前置準(zhǔn)備用 TaoToken 統(tǒng)一 Key 接入 Claude Code在講 Plan 和子代理之前得先把通道打通。Claude Code 默認(rèn)走 Anthropic 官方接口但很多新手卡在 Key 配置和環(huán)境變量上。我實(shí)測(cè)下來用 TaoToken 的統(tǒng)一 Key 通道接入更省事一個(gè) Key 能覆蓋模型對(duì)話、編碼計(jì)劃等多個(gè)入口不用來回切換。TaoToken 在這里扮演的是統(tǒng)一 API 通道的角色你拿到 Key 之后把它配到 Claude Code 的環(huán)境變量或 settings.json 里即可。官網(wǎng)入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 這個(gè)不加 UTM。注意API 地址和官網(wǎng)地址是兩個(gè)不同的東西配置時(shí)別填錯(cuò)。你需要提前準(zhǔn)備的東西不多一個(gè) TaoToken 賬號(hào)、一個(gè) API Key、本地裝好的 Node.js 環(huán)境Claude Code 依賴 npm 安裝。Key 的獲取在控制臺(tái)的 API Keys 頁面建議單獨(dú)建一個(gè)項(xiàng)目專用的 Key方便后續(xù)排查和輪換。提示Key 只顯示一次復(fù)制后立刻存到密碼管理器或本地環(huán)境變量文件里別直接提交到 Git。拿到 Key 后先別急著跑復(fù)雜任務(wù)。我建議先用一個(gè)空目錄做驗(yàn)證確認(rèn)通道通了再上真實(shí)項(xiàng)目。這一步花五分鐘能省掉后面半小時(shí)的排錯(cuò)時(shí)間。3. 可復(fù)制配置settings.json 骨架與環(huán)境變量Claude Code 的配置分兩層一層是環(huán)境變量放 Key 和 API 地址一層是項(xiàng)目級(jí)的 settings.json放模型、權(quán)限、工具開關(guān)。下面這份骨架你可以直接復(fù)制把占位符換成自己的值。先配環(huán)境變量。Linux/macOS 在~/.zshrc或~/.bashrc里加Windows 用系統(tǒng)環(huán)境變量或 PowerShell 的$env:# TaoToken 統(tǒng)一通道配置 export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoTokenKey改完執(zhí)行source ~/.zshrc讓它生效。驗(yàn)證是否讀到echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_API_KEY | head -c 8第二條只打印前 8 位確認(rèn) Key 非空又不泄露全文。然后是項(xiàng)目級(jí) settings.json放在項(xiàng)目根目錄的.claude/settings.json{ model: claude-sonnet-4-20250514, permissions: { allow: [ Read, Write, Edit, Bash(git status), Bash(git diff), Bash(npm run test) ], deny: [ Bash(rm -rf *), Bash(curl *) ] }, env: { ANTHROPIC_BASE_URL: https://taotoken.net/api } }這份配置做了三件事鎖定模型、用 allow/deny 控制工具權(quán)限、把 API 地址寫進(jìn)項(xiàng)目環(huán)境。deny 里擋掉rm -rf和curl是保命操作新手階段尤其重要——Agent 能執(zhí)行 Shell權(quán)限邊界必須自己劃。如果你要長期跑編碼任務(wù)或 Agent 工作流可以了解下 Coding Plan 入口它更適合高頻、長會(huì)話的場(chǎng)景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。短期驗(yàn)證模型能力的話模型對(duì)話入口更輕量https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。配置寫完進(jìn)入項(xiàng)目目錄執(zhí)行claude如果沒報(bào)認(rèn)證錯(cuò)誤說明通道通了。接下來才是真正的操作部分。4. 跑通首個(gè)任務(wù)Plan 模式 Skills 子代理完整流程4.1 三種工作模式先搞清楚Claude Code 有三種模式按ShiftTab循環(huán)切換。很多人用了半年只用默認(rèn)模式這是硬傷。模式核心行為適用場(chǎng)景Normal默認(rèn)每步操作需確認(rèn)不熟悉項(xiàng)目時(shí)需要人工把關(guān)Auto-accept自動(dòng)執(zhí)行不再彈窗信任度高、批量操作時(shí)Plan只分析不修改先出方案復(fù)雜需求必須先規(guī)劃再動(dòng)手判斷標(biāo)準(zhǔn)很簡(jiǎn)單不確定 Claude 會(huì)做什么就用 Normal確定它不會(huì)搞砸就用 Auto-accept需求復(fù)雜到你自己都沒想清楚就切 Plan。4.2 Plan 模式先出方案再動(dòng)手大部分人一上來就讓 Claude 寫代碼結(jié)果寫出來和預(yù)期不符改來改去。正確流程是切到 Plan 模式給結(jié)構(gòu)化提示詞請(qǐng)幫我開發(fā)一個(gè)番茄鐘 Web 應(yīng)用技術(shù)棧用 React TypeScript Tailwind CSS。 功能包括25 分鐘倒計(jì)時(shí)、開始/暫停/重置、番茄計(jì)數(shù)、休息提醒。 請(qǐng)先幫我規(guī)劃項(xiàng)目結(jié)構(gòu)和開發(fā)步驟不要寫代碼。這段提示詞有三個(gè)硬性要求技術(shù)棧鎖死、功能邊界明確、行為約束只規(guī)劃不寫代碼。Claude 輸出方案后會(huì)給你三個(gè)選項(xiàng)自動(dòng)執(zhí)行 / 逐步確認(rèn) / 修改方案。計(jì)劃會(huì)寫入一個(gè).md文檔可以用CtrlG編輯。提示詞質(zhì)量直接決定產(chǎn)出質(zhì)量模糊的提示詞產(chǎn)出模糊的代碼這是等式關(guān)系。4.3 Skills給 Agent 掛載專業(yè)能力功能能跑但頁面丑不是模型能力問題是缺少設(shè)計(jì)領(lǐng)域的上下文。Skills 就是預(yù)置的能力擴(kuò)展包/plugin install frontend-design安裝后在提示詞里指定使用番茄鐘功能都完成了但頁面很丑。請(qǐng)用 frontend-design skill 幫我重新設(shè)計(jì)界面。 我想要簡(jiǎn)潔現(xiàn)代的風(fēng)格暖色調(diào)圓形倒計(jì)時(shí)顯示配合番茄的紅色主題。Skills 的本質(zhì)是在主對(duì)話中注入領(lǐng)域知識(shí)Claude 還是同一個(gè)實(shí)例但它“讀過了”一份專業(yè)設(shè)計(jì)規(guī)范。注意Skills 內(nèi)容會(huì)占用主會(huì)話上下文空間這一點(diǎn)后面和子代理對(duì)比時(shí)很關(guān)鍵。4.4 子代理獨(dú)立上下文的 Code Review讓 Claude 審查自己寫的代碼存在確認(rèn)偏誤它傾向于認(rèn)為自己的代碼是對(duì)的。子代理啟動(dòng)一個(gè)擁有獨(dú)立上下文窗口的新實(shí)例從零開始審查。通過/agents命令創(chuàng)建選擇作用域推薦 Project用自然語言描述職責(zé)和審查標(biāo)準(zhǔn)配置可用工具和權(quán)限。使用方式用 code-quality-reviewer agents 幫我審核這個(gè)項(xiàng)目的代碼子代理審查完只把精煉摘要返回主對(duì)話對(duì)主會(huì)話上下文占用很小。這里有個(gè)架構(gòu)級(jí)區(qū)別要記住維度Skills子代理執(zhí)行實(shí)例主 Claude 本體獨(dú)立的新 Claude 實(shí)例上下文隔離不隔離占用主會(huì)話空間完全隔離獨(dú)立窗口來源插件市場(chǎng)安裝通過 /agents 自定義創(chuàng)建適用場(chǎng)景增強(qiáng)特定領(lǐng)域能力需要獨(dú)立視角的任務(wù)Skills 是往主對(duì)話注入知識(shí)子代理是開辟新推理空間。主會(huì)話上下文緊張時(shí)子代理比 Skills 更優(yōu)因?yàn)樗患又刂鲗?duì)話負(fù)擔(dān)。4.5 上下文管理/compact 與 /clearClaude 開始犯迷糊改錯(cuò)文件、混淆語法、遺忘約定時(shí)不是模型退化是上下文窗口快溢出了。用/context診斷占用比例超過 70% 就要干預(yù)。后續(xù)任務(wù)與當(dāng)前相關(guān)用/compact把對(duì)話歷史壓縮為摘要切換到無關(guān)任務(wù)用/clear徹底清空。/compact不是無損壓縮會(huì)丟部分細(xì)節(jié)但核心技術(shù)決策和文件修改記錄會(huì)保留。關(guān)閉終端后對(duì)話自動(dòng)存檔恢復(fù)用claude --resume # 從列表選擇歷史會(huì)話 claude --continue # 直接恢復(fù)最近一次簡(jiǎn)寫 claude -c5. 本篇常見報(bào)錯(cuò)排查配置和調(diào)用過程中新手最容易撞上這幾類報(bào)錯(cuò)我按出現(xiàn)頻率排一下。認(rèn)證失敗401 或 invalid api key。先確認(rèn)環(huán)境變量是否真的生效執(zhí)行echo $ANTHROPIC_API_KEY | head -c 8看有沒有值。如果為空說明 shell 配置文件沒 source或者寫錯(cuò)了文件zsh 用戶寫進(jìn).bashrc是無效的。再檢查 Key 有沒有多余空格復(fù)制時(shí)很容易帶上換行。連接超時(shí)或 base url 報(bào)錯(cuò)。檢查ANTHROPIC_BASE_URL是否填成了官網(wǎng)地址。API 地址是https://taotoken.net/api不帶 UTM 參數(shù)別把官網(wǎng)鏈接整個(gè)粘進(jìn)去。地址末尾不要多加斜杠有些客戶端對(duì)尾斜杠敏感。權(quán)限被拒permission denied。這是 settings.json 的 allow 列表沒放行對(duì)應(yīng)工具。比如你想讓它跑npm run test但 allow 里只寫了Bash(git status)就會(huì)被攔。按報(bào)錯(cuò)提示把具體命令加進(jìn) allow別圖省事寫B(tài)ash(*)那等于放棄權(quán)限邊界。上下文溢出context length exceeded。說明單次會(huì)話塞太多了。先/compact壓縮如果還不行就/clear重開靠 CLAUDE.md 兜底項(xiàng)目背景。CLAUDE.md 放在項(xiàng)目根目錄啟動(dòng)時(shí)自動(dòng)讀取用/init可以自動(dòng)生成。寫它的原則是每條信息都問自己“刪掉這條 Claude 會(huì)不會(huì)犯錯(cuò)”不會(huì)就不寫。子代理不生效。確認(rèn)/agents創(chuàng)建時(shí)作用域選的是 Project且調(diào)用時(shí)名字拼寫一致。子代理的審查標(biāo)準(zhǔn)描述太模糊也會(huì)導(dǎo)致它“走過場(chǎng)”把審查維度寫具體比如“檢查是否有未處理的 Promise rejection、是否有硬編碼密鑰”。6. 把工具用明白才是 AI 工程化的底座回到開頭那次模擬面試學(xué)長的話不好聽但說的是事實(shí)工具使用能力是 AI 工程化能力的底座。面試官不會(huì)滿足于“我用過 Claude Code”他會(huì)追問你怎么管理上下文窗口、Plan 模式和直接編碼的區(qū)別、子代理和 Skills 的架構(gòu)差異。這些答案不在文檔里在你實(shí)際操作的手感里。我的建議是新建一個(gè)空項(xiàng)目把 Plan、Skills、子代理、/compact、/clear、引用、CLAUDE.md 這幾樣從頭到尾跑一遍。讀十遍不如動(dòng)手一次。接入通道用 TaoToken 統(tǒng)一 Key 配好之后重點(diǎn)就全在操作細(xì)節(jié)上了。需要長期跑編碼任務(wù)的話Coding Plan 入口在這里https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 想先驗(yàn)證模型對(duì)話效果走這個(gè)https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 管理在控制臺(tái)https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 接入文檔在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。配置過程中卡住了先翻接入文檔的排錯(cuò)章節(jié)比到處問人快。