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