教程：配置環(huán)境變量與API Key，實(shí)現(xiàn)低成本終端Agent)
先說結(jié)論Claude Code 加 DeepSeek 這套組合完全能跑通而且跑通之后日常開發(fā)效率提升得不是一星半點(diǎn)。最近我在多個(gè)項(xiàng)目里把 Claude Code 的默認(rèn)后端換成 DeepSeek整體體驗(yàn)穩(wěn)定成本也比直接用官方模型更可控。如果你還沒試過這種“終端 Agent 配第三方模型后端”的玩法這篇文章就是按保姆級(jí)標(biāo)準(zhǔn)寫的操作手冊(cè)從檢查本機(jī)環(huán)境、裝 Node、裝 Claude Code、取 DeepSeek API Key到第一條指令跑通再給你一份我在實(shí)際使用中踩過坑之后的調(diào)優(yōu)經(jīng)驗(yàn)。1. 為什么要把 Claude Code 和 DeepSeek 組合在一起1.1 這套組合解決的真實(shí)問題Claude Code 本質(zhì)上是一個(gè)運(yùn)行在終端里的編碼代理。它不只是一個(gè)聊天窗口而是能讀項(xiàng)目文件、搜函數(shù)、執(zhí)行命令、查看 Git 差異的研發(fā)助手。默認(rèn)情況下它調(diào)用的是官方模型接口生成質(zhì)量沒得說但對(duì)個(gè)人開發(fā)者來(lái)說高頻使用的成本是一道很現(xiàn)實(shí)的門檻。DeepSeek 的模型接口以低成本和穩(wěn)定性著稱兩者組合起來(lái)就是用 Claude Code 的智能體工作流配上 DeepSeek 的模型推理能力。最實(shí)在的價(jià)值就是省成本同樣的會(huì)話密度賬單能低一個(gè)量級(jí)。除此之外DeepSeek 的接口對(duì)中文理解也很友好代碼注釋和需求描述的識(shí)別基本不會(huì)跑偏。1.2 客戶端與模型后端分離的原理Claude Code 在設(shè)計(jì)上支持通過環(huán)境變量指定 API 地址和認(rèn)證令牌。DeepSeek 對(duì)外提供了兼容模式專門有一個(gè)能接收 Claude Code 請(qǐng)求格式的轉(zhuǎn)換端點(diǎn)。因此不需要改動(dòng) Claude Code 內(nèi)部任何代碼也不需要搭建中間層只要在環(huán)境變量里寫明地址和 keyClaude Code 發(fā)出去的請(qǐng)求就會(huì)落到 DeepSeek 的模型服務(wù)推理完成之后再用同樣的格式返回。理解這一點(diǎn)很重要Claude Code 是“大腦的殼”DeepSeek 是“計(jì)算的大腦”配置的本質(zhì)就是把兩者原本的固定連接方式改掉。你可以隨時(shí)再改回來(lái)也可以在同一臺(tái)機(jī)器上維護(hù)多個(gè)配置按項(xiàng)目切換模型后端。1.3 什么人適合這套方案?jìng)€(gè)人開發(fā)者想在本地快速擁有一個(gè)能讀懂整個(gè)倉(cāng)庫(kù)的 AI 編碼助手小團(tuán)隊(duì)想給核心成員配置編碼 Agent又不想預(yù)算失控自動(dòng)化腳本、CI 場(chǎng)景里需要一個(gè)無(wú)界面的代碼審查助手對(duì)數(shù)據(jù)鏈路比較敏感的項(xiàng)目希望請(qǐng)求走自己可控的服務(wù)商。如果你的需求只是偶爾問幾個(gè)零散的編程問題那直接打開網(wǎng)頁(yè)對(duì)話就夠用了。但如果你想讓它真正介入項(xiàng)目、替你讀文件、替你跑命令Claude Code 加 DeepSeek 是一套性價(jià)比很高的組合。2. 開工前的清晰準(zhǔn)備清單2.1 本機(jī)環(huán)境要求Claude Code 基于 Node.js 構(gòu)建所以第一件事是確認(rèn)本機(jī)有可用的 Node.js 運(yùn)行時(shí)。建議版本不低于 18我在測(cè)試時(shí)用 20 和 22 都沒有問題。macOS 用戶可以用 Homebrew 安裝Linux 用戶建議用包管理器或 nvmWindows 用戶推薦直接用官方安裝包。安裝完之后在終端跑下面這兩條命令確認(rèn)版本號(hào)能正常顯示node -v npm -v如果提示 command not found說明 Node 還沒有進(jìn)入 PATH需要先解決環(huán)境變量問題再往下走。2.2 獲取 DeepSeek API Key去 DeepSeek 開放平臺(tái)注冊(cè)賬號(hào)登錄后進(jìn)入控制臺(tái)創(chuàng)建 API key。創(chuàng)建時(shí)系統(tǒng)通常只會(huì)完整顯示一次務(wù)必先復(fù)制保存到本地再關(guān)閉頁(yè)面。建議給 key 設(shè)置一個(gè)容易識(shí)別的名稱比如claude-code-local這樣以后在控制臺(tái)里看到這個(gè) key能立刻知道它用在哪里。創(chuàng)建 key 之后還需要根據(jù)實(shí)際用量給賬戶充值。如果賬戶余額為 0后續(xù)請(qǐng)求會(huì)一直報(bào)錯(cuò)而且這個(gè)錯(cuò)誤信息和 key 無(wú)關(guān)容易被誤判為配置問題提前充值可以省掉一次無(wú)意義的排查。2.3 影響全局的 3 個(gè)環(huán)境變量變量名作用示例值A(chǔ)NTHROPIC_BASE_URL指定 Claude Code 的請(qǐng)求轉(zhuǎn)發(fā)地址https://api.deepseek.com/anthropicANTHROPIC_AUTH_TOKEN讓 Claude Code 用 DeepSeek key 完成身份認(rèn)證sk-你的keyANTHROPIC_MODEL指定默認(rèn)使用的模型deepseek-chat關(guān)于模型選擇我實(shí)際使用的經(jīng)驗(yàn)是deepseek-chat日常代碼生成、解釋、重構(gòu)走這里響應(yīng)快、費(fèi)用低適合大多數(shù)場(chǎng)景deepseek-reasoner適合復(fù)雜問題思維鏈更完整但更慢也更貴遇到跨模塊重構(gòu)、疑難 bug 時(shí)再切過去。如果你沒有特殊理由默認(rèn)寫成deepseek-chat即可。后面使用中再按任務(wù)類型切換。3. 保姆級(jí)安裝與跑通全過程3.1 安裝 Node.js如果本機(jī)還沒有 Node.js最簡(jiǎn)單的方式是去 Node 官網(wǎng)下載長(zhǎng)期支持版LTS安裝包雙擊安裝即可一路默認(rèn)選項(xiàng)就可以。習(xí)慣用命令行的同學(xué)macOS 可以這樣裝brew install node20安裝完成后新開一個(gè)終端窗口再次確認(rèn)node -v和npm -v都有輸出。這里強(qiáng)調(diào)新開窗口是因?yàn)楹芏?macOS 用戶在安裝之后不刷新 PATH終端仍然顯示舊環(huán)境導(dǎo)致誤判安裝失敗。3.2 全局安裝 Claude CodeClaude Code 目前通過 npm 分發(fā)執(zhí)行npm install -g anthropic-ai/claude-code等待安裝完成后驗(yàn)證claude --version如果找到不到claude命令基本是 npm 全局目錄沒有加入 PATH。macOS 常見全局目錄是/usr/local/binLinux 可能在/usr/bin或 nvm 對(duì)應(yīng)的版本目錄里。先定位 npm 全局目錄npm prefix -g把輸出路徑加入 PATH 即可。這一步卡住的人不少但解決起來(lái)也就是一行 export 的事。3.3 寫入環(huán)境變量最關(guān)鍵的一步這一步最容易被忽略也最容易出錯(cuò)。打開你的 shell 配置文件macOS 默認(rèn)是~/.zshrcLinux 默認(rèn)是~/.bashrc在文件末尾加入export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKENsk-你的DeepSeek API Key export ANTHROPIC_MODELdeepseek-chat保存后執(zhí)行source ~/.zshrc然后確認(rèn)變量真正加載了echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_AUTH_TOKEN輸出內(nèi)容應(yīng)該是你寫入的地址和一整串 key。這個(gè)地方最容易踩的坑是復(fù)制時(shí)把 key 漏了后半段或者引號(hào)不匹配導(dǎo)致環(huán)境變量存了半個(gè) key。我遇到過好幾次表面看起來(lái)配置了實(shí)際echo出來(lái)發(fā)現(xiàn) key 末尾缺了好幾位。3.4 從零跑通第一條 Claude Code 指令新建一個(gè)測(cè)試項(xiàng)目mkdir ~/demo-agent cd ~/demo-agent準(zhǔn)備一個(gè)測(cè)試文件test.pydef add(a, b): return a b print(add(1, 2))啟動(dòng) Claude Codeclaude首次進(jìn)入時(shí)如果提示登錄或跳轉(zhuǎn)授權(quán)界面不要慌。由于我們已經(jīng)把后端切到 DeepSeekClaude Code 應(yīng)該會(huì)讀取ANTHROPIC_AUTH_TOKEN作為憑證。如果它仍然彈官方的登錄流程說明機(jī)器上存在舊的登錄狀態(tài)先執(zhí)行claude /logout然后重新運(yùn)行claude。正常情況下一兩秒內(nèi)就會(huì)進(jìn)入一個(gè)交互式命令行界面。輸入請(qǐng)閱讀 test.py說明這段代碼做了什么并指出如果 a、b 不是數(shù)字會(huì)有什么問題。等模型返回之后可以繼續(xù)提要求“順便幫我改成帶類型檢查的版本?！迸芡ǖ哪且豢棠銜?huì)看到內(nèi)容先生成后逐字輸出這就是終端 Agent 在工作了。最后輸入/exit退出會(huì)話。4. 從會(huì)跑到用好核心會(huì)話技巧4.1 讓 Agent 更懂你的項(xiàng)目在項(xiàng)目根目錄啟動(dòng)claude是最重要的一條使用習(xí)慣。它會(huì)自動(dòng)讀取當(dāng)前目錄里的文件結(jié)構(gòu)并結(jié)合項(xiàng)目?jī)?nèi)容回答問題。如果你在別的目錄啟動(dòng)它只能基于你顯式提供的文件信息工作效果會(huì)打折。想進(jìn)一步提高貼合度可以在項(xiàng)目根目錄放一個(gè)CLAUDE.md文件用幾行說明項(xiàng)目用途、技術(shù)棧、目錄規(guī)范、常用命令。Claude Code 每次啟動(dòng)時(shí)都會(huì)默認(rèn)讀取這個(gè)文件DeepSeek 生成出來(lái)的建議會(huì)明顯更貼項(xiàng)目。我在幾個(gè)項(xiàng)目里對(duì)比過有CLAUDE.md的項(xiàng)目Agent 給出的代碼風(fēng)格基本不需要改沒有的它會(huì)按通用風(fēng)格寫改起來(lái)反而更花時(shí)間。4.2 拆分任務(wù)與使用上下文壓縮別讓 Agent 一次性重構(gòu)整個(gè)項(xiàng)目。指令越細(xì)效果越穩(wěn)。一個(gè)合理的指令結(jié)構(gòu)是先讓它讀文件列出影響范圍確認(rèn)它理解準(zhǔn)確后再讓它改每完成一個(gè)小目標(biāo)就停下來(lái)檢查最后讓它跑一遍測(cè)試或至少給出驗(yàn)證方法。上下文變長(zhǎng)之后費(fèi)用和等待時(shí)間都會(huì)明顯上升。這時(shí)候可以用/compact壓縮上下文或者在確認(rèn)階段性成果后重啟會(huì)話。/clear可以清空當(dāng)前對(duì)話歷史適合切換到完全無(wú)關(guān)的新任務(wù)時(shí)使用。4.3 隨時(shí)切換模型配置里默認(rèn)是deepseek-chat但遇到復(fù)雜問題可以臨時(shí)切到deepseek-reasoner。在會(huì)話中輸入/model按菜單切換即可。也可以不進(jìn)入交互界面直接執(zhí)行claude --model deepseek-reasoner這個(gè)命令很適合在遇到跨文件重構(gòu)、復(fù)雜調(diào)試時(shí)使用。我一般先讓deepseek-chat快速生成初稿遇到瓶頸再切推理模型這樣能把成本和效率平衡好。4.4 把 Claude Code 嵌進(jìn) Git 工作流日常開發(fā)里我最常用的動(dòng)作是改完代碼后運(yùn)行claude然后輸入“查看 git diff幫我寫一份規(guī)范的 commit message”。它會(huì)把改動(dòng)梳理成邏輯清晰的一二三條比手動(dòng)寫提交說明省很多時(shí)間。還可以讓它做“提交前審查”輸入“檢查未提交的代碼重點(diǎn)關(guān)注明顯的邏輯錯(cuò)誤”它會(huì)基于當(dāng)前 diff 給出建議。注意在提交之前人工瞄一眼生成結(jié)果仍然是必要的。Claude Code 加 DeepSeek 的組合大多數(shù)時(shí)候可靠但偶爾也會(huì)一本正經(jīng)地錯(cuò)判把它當(dāng)成一個(gè)高效率的實(shí)習(xí)生來(lái)復(fù)核比較穩(wěn)妥。5. 常見問題與我的排查實(shí)錄5.1 認(rèn)證失敗401 / 403現(xiàn)象是啟動(dòng)后報(bào)認(rèn)證錯(cuò)誤或者請(qǐng)求返回 401。常見原因有三個(gè)API key 復(fù)制不完整、環(huán)境變量未加載、key 余額不足。排查順序是先用echo $ANTHROPIC_AUTH_TOKEN確認(rèn)環(huán)境變量是否完整再去 DeepSeek 控制臺(tái)檢查 key 狀態(tài)和余額。之前遇到過一種情況key 本身沒問題環(huán)境變量也有但終端是從舊窗口打開的shell 配置文件沒有重新加載導(dǎo)致進(jìn)程從頭到尾拿到的都是空變量。新開終端窗口或手動(dòng) source 一下就好。5.2 模型不存在model_not_found這個(gè)報(bào)錯(cuò)基本上只有一個(gè)原因ANTHROPIC_MODEL的值寫錯(cuò)了。只要不是deepseek-chat或deepseek-reasoner服務(wù)端都會(huì)拒絕。我自己踩過一次坑把模型名寫成deepseek-v3服務(wù)端不認(rèn)識(shí)。改成deepseek-chat后立刻正常。如果你不確定當(dāng)前支持哪些模型名去 DeepSeek 控制臺(tái)的最新文檔里核對(duì)不要憑記憶寫。5.3 請(qǐng)求超時(shí)與響應(yīng)緩慢單次請(qǐng)求攜帶大量代碼容易觸發(fā)超時(shí)網(wǎng)絡(luò)抖動(dòng)和服務(wù)繁忙也會(huì)導(dǎo)致響應(yīng)變慢。我的處理辦法是把問題拆小減少單次請(qǐng)求塞入的文件數(shù)量一次只讓它看一兩個(gè)關(guān)鍵文件如果上下文已經(jīng)很長(zhǎng)先用/compact壓縮再繼續(xù)提問。也可以用claude --debug啟動(dòng)看請(qǐng)求到底發(fā)到了哪里、延遲主要出現(xiàn)在哪個(gè)環(huán)節(jié)。5.4 中文亂碼或輸出被截?cái)嘟K端里中文顯示為亂碼通常不是模型的問題而是終端編碼不是 UTF-8。把終端字體和編碼切到 UTF-8 基本能解決?；卮鸬揭话刖屯３Ｒ娪谡?qǐng)求上下文過大或輸出長(zhǎng)度達(dá)到上限可以縮小任務(wù)范圍、壓縮上下文之后重試。5.5 不想每次都寫環(huán)境變量如果你希望配置只作用于當(dāng)前項(xiàng)目可以在項(xiàng)目根目錄創(chuàng)建.claude/settings.json{ env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_AUTH_TOKEN: sk-你的key, ANTHROPIC_MODEL: deepseek-chat } }這樣進(jìn)入項(xiàng)目后 Claude Code 會(huì)自動(dòng)讀取這份配置不影響其他項(xiàng)目。但有一個(gè)必須強(qiáng)調(diào)的細(xì)節(jié)這個(gè)文件里包含密鑰如果項(xiàng)目用版本管理一定要把它加入.gitignore避免把 API key 提交到倉(cāng)庫(kù)。我之前見過有人把這類文件傳上去結(jié)果第二天 key 就被盜刷了極其肉疼。5.6 如何驗(yàn)證請(qǐng)求確實(shí)發(fā)到了 DeepSeek想確認(rèn)請(qǐng)求路徑?jīng)]走錯(cuò)可以打開 DeepSeek 控制臺(tái)的調(diào)用日志查看是否有來(lái)自你的 key 的請(qǐng)求記錄。也可以在發(fā)請(qǐng)求之前用claude --debug抓一下輸出。這個(gè)習(xí)慣能幫你快速區(qū)分兩個(gè)方向的問題是 Claude Code 配置錯(cuò)了還是 DeepSeek 側(cè)拒絕了請(qǐng)求。最后再分享一點(diǎn)個(gè)人實(shí)操體會(huì)。用 Claude Code 加 DeepSeek 的組合最值得投入的不是安裝配置那一步而是養(yǎng)成“給它項(xiàng)目背景”的習(xí)慣。我現(xiàn)在的固定流程是每個(gè)項(xiàng)目先花五分鐘寫一個(gè)CLAUDE.md把項(xiàng)目結(jié)構(gòu)、構(gòu)建命令、代碼規(guī)范寫清楚之后所有會(huì)話的質(zhì)量都會(huì)明顯提升。還有一個(gè)細(xì)節(jié)想補(bǔ)充在會(huì)話中如果覺得某次回答質(zhì)量特別高我會(huì)順手記下當(dāng)時(shí)的 prompt 寫法下次同類任務(wù)直接復(fù)用。調(diào)教 Agent 和帶新人做事非常像背景越完整期望越具體產(chǎn)出越靠譜。多試幾次你會(huì)找到屬于自己團(tuán)隊(duì)的那套最佳操作方式。 Claude Code接入DeepSeek保姆級(jí)教程：配置環(huán)境變量與API Key，實(shí)現(xiàn)低成本終端Agent
先說結(jié)論Claude Code 加 DeepSeek 這套組合完全能跑通而且跑通之后日常開發(fā)效率提升得不是一星半點(diǎn)。最近我在多個(gè)項(xiàng)目里把 Claude Code 的默認(rèn)后端換成 DeepSeek整體體驗(yàn)穩(wěn)定成本也比直接用官方模型更可控。如果你還沒試過這種“終端 Agent 配第三方模型后端”的玩法這篇文章就是按保姆級(jí)標(biāo)準(zhǔn)寫的操作手冊(cè)從檢查本機(jī)環(huán)境、裝 Node、裝 Claude Code、取 DeepSeek API Key到第一條指令跑通再給你一份我在實(shí)際使用中踩過坑之后的調(diào)優(yōu)經(jīng)驗(yàn)。1. 為什么要把 Claude Code 和 DeepSeek 組合在一起1.1 這套組合解決的真實(shí)問題Claude Code 本質(zhì)上是一個(gè)運(yùn)行在終端里的編碼代理。它不只是一個(gè)聊天窗口而是能讀項(xiàng)目文件、搜函數(shù)、執(zhí)行命令、查看 Git 差異的研發(fā)助手。默認(rèn)情況下它調(diào)用的是官方模型接口生成質(zhì)量沒得說但對(duì)個(gè)人開發(fā)者來(lái)說高頻使用的成本是一道很現(xiàn)實(shí)的門檻。DeepSeek 的模型接口以低成本和穩(wěn)定性著稱兩者組合起來(lái)就是用 Claude Code 的智能體工作流配上 DeepSeek 的模型推理能力。最實(shí)在的價(jià)值就是省成本同樣的會(huì)話密度賬單能低一個(gè)量級(jí)。除此之外DeepSeek 的接口對(duì)中文理解也很友好代碼注釋和需求描述的識(shí)別基本不會(huì)跑偏。1.2 客戶端與模型后端分離的原理Claude Code 在設(shè)計(jì)上支持通過環(huán)境變量指定 API 地址和認(rèn)證令牌。DeepSeek 對(duì)外提供了兼容模式專門有一個(gè)能接收 Claude Code 請(qǐng)求格式的轉(zhuǎn)換端點(diǎn)。因此不需要改動(dòng) Claude Code 內(nèi)部任何代碼也不需要搭建中間層只要在環(huán)境變量里寫明地址和 keyClaude Code 發(fā)出去的請(qǐng)求就會(huì)落到 DeepSeek 的模型服務(wù)推理完成之后再用同樣的格式返回。理解這一點(diǎn)很重要Claude Code 是“大腦的殼”DeepSeek 是“計(jì)算的大腦”配置的本質(zhì)就是把兩者原本的固定連接方式改掉。你可以隨時(shí)再改回來(lái)也可以在同一臺(tái)機(jī)器上維護(hù)多個(gè)配置按項(xiàng)目切換模型后端。1.3 什么人適合這套方案?jìng)€(gè)人開發(fā)者想在本地快速擁有一個(gè)能讀懂整個(gè)倉(cāng)庫(kù)的 AI 編碼助手小團(tuán)隊(duì)想給核心成員配置編碼 Agent又不想預(yù)算失控自動(dòng)化腳本、CI 場(chǎng)景里需要一個(gè)無(wú)界面的代碼審查助手對(duì)數(shù)據(jù)鏈路比較敏感的項(xiàng)目希望請(qǐng)求走自己可控的服務(wù)商。如果你的需求只是偶爾問幾個(gè)零散的編程問題那直接打開網(wǎng)頁(yè)對(duì)話就夠用了。但如果你想讓它真正介入項(xiàng)目、替你讀文件、替你跑命令Claude Code 加 DeepSeek 是一套性價(jià)比很高的組合。2. 開工前的清晰準(zhǔn)備清單2.1 本機(jī)環(huán)境要求Claude Code 基于 Node.js 構(gòu)建所以第一件事是確認(rèn)本機(jī)有可用的 Node.js 運(yùn)行時(shí)。建議版本不低于 18我在測(cè)試時(shí)用 20 和 22 都沒有問題。macOS 用戶可以用 Homebrew 安裝Linux 用戶建議用包管理器或 nvmWindows 用戶推薦直接用官方安裝包。安裝完之后在終端跑下面這兩條命令確認(rèn)版本號(hào)能正常顯示node -v npm -v如果提示 command not found說明 Node 還沒有進(jìn)入 PATH需要先解決環(huán)境變量問題再往下走。2.2 獲取 DeepSeek API Key去 DeepSeek 開放平臺(tái)注冊(cè)賬號(hào)登錄后進(jìn)入控制臺(tái)創(chuàng)建 API key。創(chuàng)建時(shí)系統(tǒng)通常只會(huì)完整顯示一次務(wù)必先復(fù)制保存到本地再關(guān)閉頁(yè)面。建議給 key 設(shè)置一個(gè)容易識(shí)別的名稱比如claude-code-local這樣以后在控制臺(tái)里看到這個(gè) key能立刻知道它用在哪里。創(chuàng)建 key 之后還需要根據(jù)實(shí)際用量給賬戶充值。如果賬戶余額為 0后續(xù)請(qǐng)求會(huì)一直報(bào)錯(cuò)而且這個(gè)錯(cuò)誤信息和 key 無(wú)關(guān)容易被誤判為配置問題提前充值可以省掉一次無(wú)意義的排查。2.3 影響全局的 3 個(gè)環(huán)境變量變量名作用示例值A(chǔ)NTHROPIC_BASE_URL指定 Claude Code 的請(qǐng)求轉(zhuǎn)發(fā)地址https://api.deepseek.com/anthropicANTHROPIC_AUTH_TOKEN讓 Claude Code 用 DeepSeek key 完成身份認(rèn)證sk-你的keyANTHROPIC_MODEL指定默認(rèn)使用的模型deepseek-chat關(guān)于模型選擇我實(shí)際使用的經(jīng)驗(yàn)是deepseek-chat日常代碼生成、解釋、重構(gòu)走這里響應(yīng)快、費(fèi)用低適合大多數(shù)場(chǎng)景deepseek-reasoner適合復(fù)雜問題思維鏈更完整但更慢也更貴遇到跨模塊重構(gòu)、疑難 bug 時(shí)再切過去。如果你沒有特殊理由默認(rèn)寫成deepseek-chat即可。后面使用中再按任務(wù)類型切換。3. 保姆級(jí)安裝與跑通全過程3.1 安裝 Node.js如果本機(jī)還沒有 Node.js最簡(jiǎn)單的方式是去 Node 官網(wǎng)下載長(zhǎng)期支持版LTS安裝包雙擊安裝即可一路默認(rèn)選項(xiàng)就可以。習(xí)慣用命令行的同學(xué)macOS 可以這樣裝brew install node20安裝完成后新開一個(gè)終端窗口再次確認(rèn)node -v和npm -v都有輸出。這里強(qiáng)調(diào)新開窗口是因?yàn)楹芏?macOS 用戶在安裝之后不刷新 PATH終端仍然顯示舊環(huán)境導(dǎo)致誤判安裝失敗。3.2 全局安裝 Claude CodeClaude Code 目前通過 npm 分發(fā)執(zhí)行npm install -g anthropic-ai/claude-code等待安裝完成后驗(yàn)證claude --version如果找到不到claude命令基本是 npm 全局目錄沒有加入 PATH。macOS 常見全局目錄是/usr/local/binLinux 可能在/usr/bin或 nvm 對(duì)應(yīng)的版本目錄里。先定位 npm 全局目錄npm prefix -g把輸出路徑加入 PATH 即可。這一步卡住的人不少但解決起來(lái)也就是一行 export 的事。3.3 寫入環(huán)境變量最關(guān)鍵的一步這一步最容易被忽略也最容易出錯(cuò)。打開你的 shell 配置文件macOS 默認(rèn)是~/.zshrcLinux 默認(rèn)是~/.bashrc在文件末尾加入export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKENsk-你的DeepSeek API Key export ANTHROPIC_MODELdeepseek-chat保存后執(zhí)行source ~/.zshrc然后確認(rèn)變量真正加載了echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_AUTH_TOKEN輸出內(nèi)容應(yīng)該是你寫入的地址和一整串 key。這個(gè)地方最容易踩的坑是復(fù)制時(shí)把 key 漏了后半段或者引號(hào)不匹配導(dǎo)致環(huán)境變量存了半個(gè) key。我遇到過好幾次表面看起來(lái)配置了實(shí)際echo出來(lái)發(fā)現(xiàn) key 末尾缺了好幾位。3.4 從零跑通第一條 Claude Code 指令新建一個(gè)測(cè)試項(xiàng)目mkdir ~/demo-agent cd ~/demo-agent準(zhǔn)備一個(gè)測(cè)試文件test.pydef add(a, b): return a b print(add(1, 2))啟動(dòng) Claude Codeclaude首次進(jìn)入時(shí)如果提示登錄或跳轉(zhuǎn)授權(quán)界面不要慌。由于我們已經(jīng)把后端切到 DeepSeekClaude Code 應(yīng)該會(huì)讀取ANTHROPIC_AUTH_TOKEN作為憑證。如果它仍然彈官方的登錄流程說明機(jī)器上存在舊的登錄狀態(tài)先執(zhí)行claude /logout然后重新運(yùn)行claude。正常情況下一兩秒內(nèi)就會(huì)進(jìn)入一個(gè)交互式命令行界面。輸入請(qǐng)閱讀 test.py說明這段代碼做了什么并指出如果 a、b 不是數(shù)字會(huì)有什么問題。等模型返回之后可以繼續(xù)提要求“順便幫我改成帶類型檢查的版本?！迸芡ǖ哪且豢棠銜?huì)看到內(nèi)容先生成后逐字輸出這就是終端 Agent 在工作了。最后輸入/exit退出會(huì)話。4. 從會(huì)跑到用好核心會(huì)話技巧4.1 讓 Agent 更懂你的項(xiàng)目在項(xiàng)目根目錄啟動(dòng)claude是最重要的一條使用習(xí)慣。它會(huì)自動(dòng)讀取當(dāng)前目錄里的文件結(jié)構(gòu)并結(jié)合項(xiàng)目?jī)?nèi)容回答問題。如果你在別的目錄啟動(dòng)它只能基于你顯式提供的文件信息工作效果會(huì)打折。想進(jìn)一步提高貼合度可以在項(xiàng)目根目錄放一個(gè)CLAUDE.md文件用幾行說明項(xiàng)目用途、技術(shù)棧、目錄規(guī)范、常用命令。Claude Code 每次啟動(dòng)時(shí)都會(huì)默認(rèn)讀取這個(gè)文件DeepSeek 生成出來(lái)的建議會(huì)明顯更貼項(xiàng)目。我在幾個(gè)項(xiàng)目里對(duì)比過有CLAUDE.md的項(xiàng)目Agent 給出的代碼風(fēng)格基本不需要改沒有的它會(huì)按通用風(fēng)格寫改起來(lái)反而更花時(shí)間。4.2 拆分任務(wù)與使用上下文壓縮別讓 Agent 一次性重構(gòu)整個(gè)項(xiàng)目。指令越細(xì)效果越穩(wěn)。一個(gè)合理的指令結(jié)構(gòu)是先讓它讀文件列出影響范圍確認(rèn)它理解準(zhǔn)確后再讓它改每完成一個(gè)小目標(biāo)就停下來(lái)檢查最后讓它跑一遍測(cè)試或至少給出驗(yàn)證方法。上下文變長(zhǎng)之后費(fèi)用和等待時(shí)間都會(huì)明顯上升。這時(shí)候可以用/compact壓縮上下文或者在確認(rèn)階段性成果后重啟會(huì)話。/clear可以清空當(dāng)前對(duì)話歷史適合切換到完全無(wú)關(guān)的新任務(wù)時(shí)使用。4.3 隨時(shí)切換模型配置里默認(rèn)是deepseek-chat但遇到復(fù)雜問題可以臨時(shí)切到deepseek-reasoner。在會(huì)話中輸入/model按菜單切換即可。也可以不進(jìn)入交互界面直接執(zhí)行claude --model deepseek-reasoner這個(gè)命令很適合在遇到跨文件重構(gòu)、復(fù)雜調(diào)試時(shí)使用。我一般先讓deepseek-chat快速生成初稿遇到瓶頸再切推理模型這樣能把成本和效率平衡好。4.4 把 Claude Code 嵌進(jìn) Git 工作流日常開發(fā)里我最常用的動(dòng)作是改完代碼后運(yùn)行claude然后輸入“查看 git diff幫我寫一份規(guī)范的 commit message”。它會(huì)把改動(dòng)梳理成邏輯清晰的一二三條比手動(dòng)寫提交說明省很多時(shí)間。還可以讓它做“提交前審查”輸入“檢查未提交的代碼重點(diǎn)關(guān)注明顯的邏輯錯(cuò)誤”它會(huì)基于當(dāng)前 diff 給出建議。注意在提交之前人工瞄一眼生成結(jié)果仍然是必要的。Claude Code 加 DeepSeek 的組合大多數(shù)時(shí)候可靠但偶爾也會(huì)一本正經(jīng)地錯(cuò)判把它當(dāng)成一個(gè)高效率的實(shí)習(xí)生來(lái)復(fù)核比較穩(wěn)妥。5. 常見問題與我的排查實(shí)錄5.1 認(rèn)證失敗401 / 403現(xiàn)象是啟動(dòng)后報(bào)認(rèn)證錯(cuò)誤或者請(qǐng)求返回 401。常見原因有三個(gè)API key 復(fù)制不完整、環(huán)境變量未加載、key 余額不足。排查順序是先用echo $ANTHROPIC_AUTH_TOKEN確認(rèn)環(huán)境變量是否完整再去 DeepSeek 控制臺(tái)檢查 key 狀態(tài)和余額。之前遇到過一種情況key 本身沒問題環(huán)境變量也有但終端是從舊窗口打開的shell 配置文件沒有重新加載導(dǎo)致進(jìn)程從頭到尾拿到的都是空變量。新開終端窗口或手動(dòng) source 一下就好。5.2 模型不存在model_not_found這個(gè)報(bào)錯(cuò)基本上只有一個(gè)原因ANTHROPIC_MODEL的值寫錯(cuò)了。只要不是deepseek-chat或deepseek-reasoner服務(wù)端都會(huì)拒絕。我自己踩過一次坑把模型名寫成deepseek-v3服務(wù)端不認(rèn)識(shí)。改成deepseek-chat后立刻正常。如果你不確定當(dāng)前支持哪些模型名去 DeepSeek 控制臺(tái)的最新文檔里核對(duì)不要憑記憶寫。5.3 請(qǐng)求超時(shí)與響應(yīng)緩慢單次請(qǐng)求攜帶大量代碼容易觸發(fā)超時(shí)網(wǎng)絡(luò)抖動(dòng)和服務(wù)繁忙也會(huì)導(dǎo)致響應(yīng)變慢。我的處理辦法是把問題拆小減少單次請(qǐng)求塞入的文件數(shù)量一次只讓它看一兩個(gè)關(guān)鍵文件如果上下文已經(jīng)很長(zhǎng)先用/compact壓縮再繼續(xù)提問。也可以用claude --debug啟動(dòng)看請(qǐng)求到底發(fā)到了哪里、延遲主要出現(xiàn)在哪個(gè)環(huán)節(jié)。5.4 中文亂碼或輸出被截?cái)嘟K端里中文顯示為亂碼通常不是模型的問題而是終端編碼不是 UTF-8。把終端字體和編碼切到 UTF-8 基本能解決?；卮鸬揭话刖屯３Ｒ娪谡?qǐng)求上下文過大或輸出長(zhǎng)度達(dá)到上限可以縮小任務(wù)范圍、壓縮上下文之后重試。5.5 不想每次都寫環(huán)境變量如果你希望配置只作用于當(dāng)前項(xiàng)目可以在項(xiàng)目根目錄創(chuàng)建.claude/settings.json{ env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_AUTH_TOKEN: sk-你的key, ANTHROPIC_MODEL: deepseek-chat } }這樣進(jìn)入項(xiàng)目后 Claude Code 會(huì)自動(dòng)讀取這份配置不影響其他項(xiàng)目。但有一個(gè)必須強(qiáng)調(diào)的細(xì)節(jié)這個(gè)文件里包含密鑰如果項(xiàng)目用版本管理一定要把它加入.gitignore避免把 API key 提交到倉(cāng)庫(kù)。我之前見過有人把這類文件傳上去結(jié)果第二天 key 就被盜刷了極其肉疼。5.6 如何驗(yàn)證請(qǐng)求確實(shí)發(fā)到了 DeepSeek想確認(rèn)請(qǐng)求路徑?jīng)]走錯(cuò)可以打開 DeepSeek 控制臺(tái)的調(diào)用日志查看是否有來(lái)自你的 key 的請(qǐng)求記錄。也可以在發(fā)請(qǐng)求之前用claude --debug抓一下輸出。這個(gè)習(xí)慣能幫你快速區(qū)分兩個(gè)方向的問題是 Claude Code 配置錯(cuò)了還是 DeepSeek 側(cè)拒絕了請(qǐng)求。最后再分享一點(diǎn)個(gè)人實(shí)操體會(huì)。用 Claude Code 加 DeepSeek 的組合最值得投入的不是安裝配置那一步而是養(yǎng)成“給它項(xiàng)目背景”的習(xí)慣。我現(xiàn)在的固定流程是每個(gè)項(xiàng)目先花五分鐘寫一個(gè)CLAUDE.md把項(xiàng)目結(jié)構(gòu)、構(gòu)建命令、代碼規(guī)范寫清楚之后所有會(huì)話的質(zhì)量都會(huì)明顯提升。還有一個(gè)細(xì)節(jié)想補(bǔ)充在會(huì)話中如果覺得某次回答質(zhì)量特別高我會(huì)順手記下當(dāng)時(shí)的 prompt 寫法下次同類任務(wù)直接復(fù)用。調(diào)教 Agent 和帶新人做事非常像背景越完整期望越具體產(chǎn)出越靠譜。多試幾次你會(huì)找到屬于自己團(tuán)隊(duì)的那套最佳操作方式。