Claude Code完整指南:MCP、Skills、第三方模型配置一次搞定
Claude Code 是 Anthropic 官方出的命令行工具,直接在終端里跟 Claude 交互,干的事情就是幫你寫代碼、改代碼、跑命令。跟 ChatGPT 那種網(wǎng)頁(yè)聊天不一樣,它是嵌在你開發(fā)工作流里的——你在哪個(gè)目錄下啟動(dòng)它,它就能讀那個(gè)目錄的代碼,理解項(xiàng)目結(jié)構(gòu),然后直接動(dòng)手改文件。
說(shuō)白了,它把"復(fù)制代碼到聊天框→拿到回復(fù)→粘貼回編輯器"這個(gè)循環(huán)給干掉了。

安裝
原生安裝器(推薦)
這是目前官方推薦的方式,零依賴,不需要 Node.js,裝完自動(dòng)后臺(tái)更新。
macOS / Linux:
curl -fsSL https://claude.ai/install.sh | bash
Windows:
winget install Anthropic.ClaudeCode
Homebrew(macOS)
brew install --cask claude-code
能用,但新版本發(fā)布后 Homebrew 那邊會(huì)有幾小時(shí)到一兩天的同步延遲。追新版本的話還是用原生安裝器。
npm(已不推薦)
npm install -g @anthropic-ai/claude-code
從 v2 開始就標(biāo)記為 deprecated 了。如果你有特殊原因需要鎖定版本,還能用,但一般沒(méi)必要。需要 Node.js 18+ 環(huán)境。
啟動(dòng)
裝完之后,cd 到你的項(xiàng)目目錄,直接敲:
claude
第一次用會(huì)讓你登錄 Anthropic 賬號(hào)做認(rèn)證。搞定之后就進(jìn)入交互式對(duì)話了。如果你沒(méi)有 Anthropic 賬號(hào),文章后面會(huì)有介紹如何接入其它模型。
非交互模式(適合腳本調(diào)用):
claude -p "解釋一下 src/auth.ts 里的登錄邏輯"
核心用法
讓它讀代碼
最基礎(chǔ)的用法——你不確定某段代碼干了什么,直接問(wèn):
這個(gè)項(xiàng)目的入口文件在哪?整體架構(gòu)是怎樣的?
它會(huì)自己去翻文件、讀代碼,然后給你一個(gè)總結(jié)。不需要你手動(dòng)指定文件路徑(當(dāng)然你也可以指定)。
讓它改代碼
比如你想給某個(gè)函數(shù)加個(gè)參數(shù)校驗(yàn):
給 src/utils/validate.ts 里的 parseConfig 函數(shù)加上參數(shù)類型檢查,如果傳入的不是對(duì)象就拋 TypeError
它會(huì)讀文件、定位函數(shù)、改代碼、寫回去。改之前會(huì)把 diff 展示給你看,你確認(rèn)了才會(huì)真正寫入。
讓它跑命令
跑一下測(cè)試看看有沒(méi)有掛的
它會(huì)根據(jù)項(xiàng)目里的配置(package.json、Makefile 之類的)判斷該用什么命令,然后執(zhí)行。執(zhí)行前同樣會(huì)讓你確認(rèn)。
讓它處理 Git 操作
把當(dāng)前改動(dòng)提交一下,commit message 寫清楚點(diǎn)
它會(huì)看 diff、生成 commit message、執(zhí)行 git add 和 commit。但默認(rèn)不會(huì) push——推送到遠(yuǎn)端這種不可逆操作,它會(huì)額外確認(rèn)。
權(quán)限模型
Claude Code 有三種權(quán)限模式,控制它能自動(dòng)做什么、什么需要你點(diǎn)確認(rèn):
- Ask mode:所有操作都要確認(rèn)。適合剛開始用、不太信任它的時(shí)候。
- Auto-edit mode:讀文件和改文件自動(dòng)放行,但跑命令還是要確認(rèn)。日常開發(fā)比較推薦這個(gè)。
- Full auto mode:啥都自動(dòng)干。適合你很清楚它要做什么、或者在沙箱環(huán)境里跑的場(chǎng)景。
切換方式:在交互模式里輸入 /permissions 就能調(diào)。
一個(gè)實(shí)用建議:剛上手先用 Ask mode 跑幾天,觀察它的行為模式,心里有數(shù)了再切到 Auto-edit。
CLAUDE.md:給它立規(guī)矩
項(xiàng)目根目錄下放一個(gè) CLAUDE.md 文件,Claude Code 每次啟動(dòng)都會(huì)讀它。你可以在里面寫:
- 項(xiàng)目的技術(shù)棧和約定
- 代碼風(fēng)格要求
- 哪些文件不要?jiǎng)?/li>
- 常用命令是什么
示例:
# 項(xiàng)目約定 - 使用 TypeScript strict mode - 組件用 PascalCase 命名,工具函數(shù)用 camelCase - 測(cè)試文件放在同目錄下的 **tests** 文件夾 - 不要修改 src/generated/ 下的任何文件,那是自動(dòng)生成的 - 運(yùn)行測(cè)試:pnpm test - 運(yùn)行 lint:pnpm lint
這個(gè)文件的好處是團(tuán)隊(duì)共享——提交到倉(cāng)庫(kù)里,所有人用 Claude Code 的時(shí)候都遵守同一套規(guī)矩。
MCP:給 Claude Code 接外 掛
MCP 是什么
MCP(Model Context Protocol)是 Anthropic 搞的一套開放協(xié)議,2025 年捐給了 Linux 基金會(huì)。簡(jiǎn)單說(shuō)就是一個(gè)標(biāo)準(zhǔn)化的接口,讓 Claude Code 能連接外部工具和服務(wù)——數(shù)據(jù)庫(kù)、瀏覽器、搜索引擎、GitHub、各種 API,都能通過(guò) MCP 接進(jìn)來(lái)。
沒(méi)有 MCP 的時(shí)候,Claude Code 只能讀文件、改文件、跑命令。有了 MCP,它能查數(shù)據(jù)庫(kù)、搜網(wǎng)頁(yè)、操作瀏覽器、調(diào)第三方 API,能力邊界一下子擴(kuò)大了很多。
怎么加 MCP Server
用 claude mcp add 命令:
# 基本格式 claude mcp add <server-name> -- <啟動(dòng)命令> # 指定作用域 claude mcp add <server-name> --scope user # 個(gè)人級(jí)別,所有項(xiàng)目可用 claude mcp add <server-name> --scope project # 項(xiàng)目級(jí)別,跟著倉(cāng)庫(kù)走
舉個(gè)例子,加一個(gè) GitHub MCP server:
claude mcp add github -- npx -y @modelcontextprotocol/server-github
加完之后重啟 Claude Code 就能用了。也可以直接編輯配置文件,位置在項(xiàng)目的 .claude/settings.json 或者用戶級(jí)別的配置目錄里:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxx"
}
}
}
}
推薦的 MCP Server
用了一段時(shí)間下來(lái),這幾個(gè)是真正高頻用到的:
Context7 —— 實(shí)時(shí)文檔查詢
這個(gè)強(qiáng)烈推薦。它能拉取各種庫(kù)的最新文檔和代碼示例,解決"訓(xùn)練數(shù)據(jù)過(guò)時(shí)"的問(wèn)題。你問(wèn) Claude 一個(gè) Next.js 14 的 API 用法,它可能給你的是舊版本的寫法,但有了 Context7,它會(huì)去查最新文檔再回答。
claude mcp add context7 -- npx -y @upstash/context7-mcp
Memory —— 跨會(huì)話記憶
Claude Code 默認(rèn)每次對(duì)話是獨(dú)立的,關(guān)掉終端就忘了。Memory server 提供一個(gè)持久化的知識(shí)圖譜,讓它能記住跨會(huì)話的信息——比如你的項(xiàng)目架構(gòu)決策、之前踩過(guò)的坑。
claude mcp add memory -- npx -y @modelcontextprotocol/server-memory
GitHub —— 倉(cāng)庫(kù)操作
不只是 git 命令那些基礎(chǔ)操作,而是 GitHub 平臺(tái)層面的——創(chuàng)建 PR、review 代碼、管理 issue、查 CI 狀態(tài)。
claude mcp add github -- npx -y @modelcontextprotocol/server-github
需要設(shè)置 GITHUB_PERSONAL_ACCESS_TOKEN 環(huán)境變量。
Brave Search —— 網(wǎng)頁(yè)搜索
讓 Claude Code 能搜索互聯(lián)網(wǎng)。遇到不確定的技術(shù)問(wèn)題,它可以先搜一下再回答,而不是純靠訓(xùn)練數(shù)據(jù)瞎編。
claude mcp add brave-search -- npx -y @modelcontextprotocol/server-brave-search
需要 Brave Search API key。
Puppeteer —— 瀏覽器自動(dòng)化
能操控瀏覽器,適合做 E2E 測(cè)試、截圖、抓取頁(yè)面內(nèi)容。
claude mcp add puppeteer -- npx -y @modelcontextprotocol/server-puppeteer
PostgreSQL —— 數(shù)據(jù)庫(kù)操作
直接查數(shù)據(jù)庫(kù)、看表結(jié)構(gòu)、跑 SQL。調(diào)試數(shù)據(jù)相關(guān)的 bug 時(shí)特別有用。
claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres postgresql://user:pass@localhost/dbname
Sequential Thinking —— 深度推理
遇到復(fù)雜問(wèn)題時(shí),讓 Claude 用更結(jié)構(gòu)化的方式一步步推理,而不是一口氣給答案。適合架構(gòu)設(shè)計(jì)、復(fù)雜 bug 分析這類需要深度思考的場(chǎng)景。
claude mcp add sequential-thinking -- npx -y @modelcontextprotocol/server-sequential-thinking
MCP 使用建議
- 不要一口氣裝太多。每個(gè) MCP server 都會(huì)占啟動(dòng)時(shí)間和上下文空間,裝個(gè)五六個(gè)常用的就夠了
- 敏感信息(數(shù)據(jù)庫(kù)密碼、API key)放環(huán)境變量里,別硬編碼在配置文件中
- 項(xiàng)目級(jí)別的 MCP 配置(
.claude/settings.json)可以提交到倉(cāng)庫(kù),但記得把 env 里的密鑰排除掉 - 用
/mcp命令可以在會(huì)話中查看和管理當(dāng)前加載的 MCP server
Skills:可復(fù)用的工作流
Skills 是什么
Skills 本質(zhì)上就是 markdown 文件,里面寫著一套指令。你把它放到指定目錄,Claude Code 就能識(shí)別并加載??梢岳斫鉃?quot;預(yù)設(shè)的 prompt 模板",但比直接粘貼 prompt 方便得多——它跟 slash command 是統(tǒng)一的,創(chuàng)建一個(gè) skill 就自動(dòng)注冊(cè)為一個(gè) /命令。
適用場(chǎng)景:你發(fā)現(xiàn)自己反復(fù)給 Claude Code 說(shuō)同樣的話("用 vitest 寫測(cè)試,覆蓋邊界情況,mock 外部依賴"),那就該把它做成 skill 了。
怎么創(chuàng)建 Skill
在項(xiàng)目里創(chuàng)建這個(gè)路徑的文件:
.claude/skills/<skill-name>/SKILL.md
或者放在用戶級(jí)別(所有項(xiàng)目通用):
~/.claude/skills/<skill-name>/SKILL.md
文件內(nèi)容就是 markdown,可以帶 YAML frontmatter 來(lái)控制行為:
--- name: write-test description: 為指定模塊編寫單元測(cè)試 allowed-tools: - Bash - Read - Write - Edit --- # 編寫單元測(cè)試 按照以下規(guī)范為目標(biāo)模塊編寫測(cè)試: 1. 使用 vitest 作為測(cè)試框架 2. 測(cè)試文件放在同目錄的 **tests** 文件夾下 3. 文件名格式:<module-name>.test.ts 4. 必須覆蓋:正常路徑、邊界情況、錯(cuò)誤處理 5. 外部依賴一律 mock,不要發(fā)真實(shí)網(wǎng)絡(luò)請(qǐng)求 6. 每個(gè)測(cè)試用 describe 分組,用清晰的中文描述測(cè)試意圖 7. 寫完之后跑一遍確認(rèn)全部通過(guò)
保存之后不需要重啟,Claude Code 會(huì)自動(dòng)識(shí)別。在對(duì)話里輸入 /write-test 就能觸發(fā)。
frontmatter 字段說(shuō)明
name:skill 的標(biāo)識(shí)符,也是 slash command 的名字description:描述這個(gè) skill 干什么。Claude 會(huì)根據(jù)這個(gè)描述判斷是否自動(dòng)激活allowed-tools:限制這個(gè) skill 能用哪些工具。比如一個(gè)只讀分析的 skill,可以只給 Read 權(quán)限
內(nèi)置的 Slash Commands
Claude Code 自帶這些命令,不需要額外配置:
| 命令 | 干什么的 |
|---|---|
/help | 查看幫助 |
/compact | 壓縮對(duì)話歷史,釋放上下文空間 |
/clear | 清空對(duì)話,重新開始 |
/init | 讀取項(xiàng)目結(jié)構(gòu),生成 CLAUDE.md 初始文件 |
/model | 切換模型(Opus / Sonnet / Haiku) |
/review | 審查代碼改動(dòng) |
/commit | 生成 commit message 并提交 |
/pr | 創(chuàng)建 Pull Request |
/config | 打開或修改設(shè)置 |
/mcp | 管理 MCP server |
/fast | 切換快速模式(同模型,輸出更快) |
/cost | 查看當(dāng)前會(huì)話的 token 用量和費(fèi)用 |
/doctor | 診斷配置問(wèn)題 |
推薦自建的幾個(gè) Skill
代碼審查 skill
--- name: review description: 按團(tuán)隊(duì)標(biāo)準(zhǔn)審查代碼 allowed-tools: - Read - Grep - Glob --- # 代碼審查 審查當(dāng)前分支相對(duì)于 main 的所有改動(dòng),關(guān)注以下方面: 1. 安全問(wèn)題:SQL 注入、XSS、硬編碼密鑰、不安全的反序列化 2. 性能問(wèn)題:N+1 查詢、不必要的循環(huán)、內(nèi)存泄漏風(fēng)險(xiǎn) 3. 邏輯錯(cuò)誤:邊界條件、空值處理、競(jìng)態(tài)條件 4. 代碼規(guī)范:命名是否清晰、函數(shù)是否過(guò)長(zhǎng)、是否有重復(fù)代碼 5. 測(cè)試覆蓋:新增邏輯是否有對(duì)應(yīng)測(cè)試 輸出格式:按嚴(yán)重程度分級(jí)(Critical / Warning / Suggestion),每條給出文件路徑、行號(hào)、問(wèn)題描述和修復(fù)建議。
部署 skill
--- name: deploy-staging description: 部署當(dāng)前分支到 staging 環(huán)境 allowed-tools: - Bash - Read --- # 部署到 Staging 執(zhí)行以下步驟: 1. 確認(rèn)當(dāng)前分支所有測(cè)試通過(guò) 2. 確認(rèn)沒(méi)有未提交的改動(dòng) 3. 構(gòu)建 Docker 鏡像并打 tag(格式:staging-<短 commit hash>) 4. 推送到容器倉(cāng)庫(kù) 5. 觸發(fā) staging 環(huán)境的滾動(dòng)更新 6. 等待健康檢查通過(guò) 7. 輸出部署結(jié)果和訪問(wèn)地址 如果任何步驟失敗,立即停止并報(bào)告原因。
API 文檔生成 skill
--- name: gen-api-doc description: 為 API 端點(diǎn)生成接口文檔 allowed-tools: - Read - Grep - Write --- # 生成 API 文檔 讀取指定的路由文件,為每個(gè)端點(diǎn)生成文檔,包含: - 請(qǐng)求方法和路徑 - 請(qǐng)求參數(shù)(path / query / body),標(biāo)注類型和是否必填 - 響應(yīng)格式,給出示例 JSON - 錯(cuò)誤碼說(shuō)明 - 認(rèn)證要求 輸出為 markdown 格式,保存到 docs/api/ 目錄下。
Skill 的自動(dòng)激活
如果你在 frontmatter 里寫了 description,Claude Code 會(huì)根據(jù)當(dāng)前對(duì)話內(nèi)容判斷是否自動(dòng)加載這個(gè) skill。比如你的 skill 描述是"為指定模塊編寫單元測(cè)試",當(dāng)你在對(duì)話里說(shuō)"幫這個(gè)函數(shù)寫個(gè)測(cè)試",它可能會(huì)自動(dòng)激活這個(gè) skill,不需要你手動(dòng)輸入 /write-test。
這個(gè)機(jī)制挺方便,但如果你不想要自動(dòng)激活,把 description 去掉就行。
實(shí)際工作流場(chǎng)景
場(chǎng)景一:接手陌生項(xiàng)目
剛 clone 下來(lái)一個(gè)項(xiàng)目,啥都不了解:
幫我梳理一下這個(gè)項(xiàng)目的目錄結(jié)構(gòu)和核心模塊,重點(diǎn)說(shuō)說(shuō)數(shù)據(jù)流是怎么走的
比自己一個(gè)個(gè)文件翻快多了。它會(huì)把入口、路由、數(shù)據(jù)層、工具函數(shù)這些串起來(lái)講。
場(chǎng)景二:修 Bug
拿到一個(gè) bug report,知道大概在哪但不確定根因:
用戶反饋登錄后偶爾會(huì)跳回登錄頁(yè)??纯?src/auth/ 目錄下的 token 刷新邏輯有沒(méi)有競(jìng)態(tài)問(wèn)題
它會(huì)讀相關(guān)代碼,分析可能的問(wèn)題點(diǎn),然后給出修復(fù)方案。你覺(jué)得靠譜就讓它直接改。
場(chǎng)景三:重構(gòu)
想把一個(gè)大函數(shù)拆成幾個(gè)小的:
把 src/services/order.ts 里的 processOrder 函數(shù)拆分一下,按職責(zé)分成校驗(yàn)、計(jì)算、持久化三個(gè)步驟
場(chǎng)景四:寫測(cè)試
給 src/utils/format.ts 里的所有導(dǎo)出函數(shù)補(bǔ)上單元測(cè)試,用 vitest,覆蓋邊界情況
場(chǎng)景五:代碼審查
看看 src/api/routes.ts 最近的改動(dòng)有沒(méi)有安全問(wèn)題
一些實(shí)用技巧
用 /compact 壓縮上下文
聊久了上下文會(huì)變長(zhǎng),響應(yīng)變慢。輸入 /compact 可以讓它總結(jié)之前的對(duì)話,釋放上下文空間。長(zhǎng)任務(wù)中途用一下很有幫助。
用 /clear 重新開始
如果話題完全換了,/clear 清掉歷史重新來(lái),比在舊上下文里繼續(xù)聊效果好。
多用具體指令,少用模糊描述
不好的問(wèn)法:
幫我優(yōu)化一下這個(gè)項(xiàng)目
好的問(wèn)法:
src/components/Table.tsx 渲染 1000 行數(shù)據(jù)時(shí)明顯卡頓,看看有沒(méi)有不必要的 re-render,給個(gè)優(yōu)化方案
越具體,輸出質(zhì)量越高。
善用 --continue 恢復(fù)會(huì)話
終端不小心關(guān)了,或者想接著上次的進(jìn)度繼續(xù):
claude --continue
會(huì)恢復(fù)上一次的對(duì)話上下文。
結(jié)合 Git 分支工作
建議在 feature branch 上用 Claude Code 干活。這樣它做的改動(dòng)都在獨(dú)立分支上,不滿意直接扔掉分支就行,不會(huì)污染主線。
它不擅長(zhǎng)什么
說(shuō)幾個(gè)別對(duì)它期望過(guò)高的場(chǎng)景:
- 大規(guī)模架構(gòu)設(shè)計(jì):它能給建議,但最終的架構(gòu)決策還是得人來(lái)拍。它看不到業(yè)務(wù)全貌、團(tuán)隊(duì)能力、歷史包袱這些上下文。
- 跨多個(gè)倉(cāng)庫(kù)的改動(dòng):它的工作范圍是當(dāng)前目錄。如果改動(dòng)涉及多個(gè)獨(dú)立倉(cāng)庫(kù),得分別處理。
- 需要運(yùn)行時(shí)調(diào)試的問(wèn)題:它能讀代碼做靜態(tài)分析,但沒(méi)法真正跑起來(lái)打斷點(diǎn)。涉及到具體運(yùn)行時(shí)狀態(tài)的 bug,還是得配合 debugger。
- 涉及敏感信息的操作:不要讓它處理包含密鑰、密碼的文件。雖然對(duì)話內(nèi)容不會(huì)被用于訓(xùn)練,但養(yǎng)成習(xí)慣比較好。
接入第三方模型
如果你沒(méi)法訂閱 Anthropic 官方服務(wù)(網(wǎng)絡(luò)原因、支付方式限制等),Claude Code 支持通過(guò)環(huán)境變量把請(qǐng)求轉(zhuǎn)發(fā)到其他兼容的 API 端點(diǎn)。只要對(duì)方支持 Anthropic 的消息格式,就能直接接入。
核心環(huán)境變量
| 變量名 | 作用 |
|---|---|
ANTHROPIC_BASE_URL | API 端點(diǎn)地址,默認(rèn)是 https://api.anthropic.com |
ANTHROPIC_AUTH_TOKEN | 目標(biāo)服務(wù)的 API Key |
ANTHROPIC_MODEL | 主力模型名稱 |
ANTHROPIC_SMALL_FAST_MODEL | 輕量任務(wù)用的小模型(后臺(tái)操作、快速補(bǔ)全) |
以 DeepSeek 為例
DeepSeek 原生支持 Anthropic API 格式,不需要任何代理或中間件,配置最簡(jiǎn)單。
先去 platform.deepseek.com 注冊(cè)賬號(hào)拿到 API Key,然后設(shè)置環(huán)境變量:
Linux / macOS(寫到 ~/.bashrc 或 ~/.zshrc 里持久化):
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN=sk-your-deepseek-api-key export ANTHROPIC_MODEL=deepseek-chat export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat
Windows PowerShell:
$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic" $env:ANTHROPIC_AUTH_TOKEN = "sk-your-deepseek-api-key" $env:ANTHROPIC_MODEL = "deepseek-chat" $env:ANTHROPIC_SMALL_FAST_MODEL = "deepseek-chat"
Windows 永久設(shè)置(系統(tǒng)環(huán)境變量):
打開"系統(tǒng)屬性 → 高級(jí) → 環(huán)境變量",新建以下用戶變量:
ANTHROPIC_BASE_URL = https://api.deepseek.com/anthropic ANTHROPIC_AUTH_TOKEN = sk-your-deepseek-api-key ANTHROPIC_MODEL = deepseek-chat ANTHROPIC_SMALL_FAST_MODEL = deepseek-chat
設(shè)置完之后直接啟動(dòng) claude 就行,它會(huì)自動(dòng)走 DeepSeek 的接口。
通過(guò) settings.json 配置模型
除了環(huán)境變量,也可以在 settings 里指定默認(rèn)模型。文件位置:
- 全局:
~/.claude/settings.json(Windows 是%USERPROFILE%\.claude\settings.json) - 項(xiàng)目級(jí):
.claude/settings.json
{
"model": "deepseek-chat",
"smallModel": "deepseek-chat"
}或者啟動(dòng)時(shí)用參數(shù)指定:
claude --model deepseek-chat
進(jìn)入會(huì)話后也能用 /model 命令臨時(shí)切換。
通過(guò) OpenRouter 接入更多模型
如果你想用 GPT、Gemini、Llama 或者其他模型,可以走 OpenRouter。它聚合了幾百個(gè)模型,提供統(tǒng)一的 Anthropic 兼容接口。
export ANTHROPIC_BASE_URL=https://openrouter.ai/api/v1/anthropic export ANTHROPIC_AUTH_TOKEN=sk-or-your-openrouter-key export ANTHROPIC_MODEL=anthropic/claude-sonnet-4 export ANTHROPIC_SMALL_FAST_MODEL=anthropic/claude-haiku-4
OpenRouter 上也能選 DeepSeek、Google Gemini 等模型,但非 Anthropic 模型的兼容性不一定完美——Claude Code 的 agent 循環(huán)是針對(duì) Anthropic 消息格式設(shè)計(jì)的,其他模型可能在工具調(diào)用上有些小問(wèn)題。
本地模型(Ollama)
如果你想完全離線跑,可以用 Ollama 加一個(gè)格式轉(zhuǎn)換代理:
# 先啟動(dòng) Ollama ollama serve # 用社區(qū)代理(如 claude-code-router)橋接格式 # 然后指向本地代理端口 export ANTHROPIC_BASE_URL=http://localhost:3456 export ANTHROPIC_AUTH_TOKEN=dummy export ANTHROPIC_MODEL=qwen2.5-coder:32b claude
本地模型的體驗(yàn)取決于你的硬件和模型大小。32B 以上的模型在工具調(diào)用方面表現(xiàn)還行,更小的模型容易出格式錯(cuò)誤。
社區(qū)代理工具
如果目標(biāo) API 不直接兼容 Anthropic 格式,可以用這些開源代理做轉(zhuǎn)換:
- claude-code-router:支持路由到 OpenRouter、DeepSeek、Ollama、Gemini 等多個(gè)后端
- claude-code-proxy:把 Anthropic 格式轉(zhuǎn)成 OpenAI 格式,適配 GPT 系列
- deepclaude:專門為 DeepSeek + Claude Code 優(yōu)化的代理
這些代理本質(zhì)上都是在本地起一個(gè) HTTP 服務(wù),把 Claude Code 發(fā)出的 Anthropic 格式請(qǐng)求翻譯成目標(biāo) API 能理解的格式。
注意事項(xiàng)
- 第三方模型的工具調(diào)用能力參差不齊。Claude Code 重度依賴 tool use,如果模型在這方面弱,體驗(yàn)會(huì)打折扣
- 用第三方端點(diǎn)時(shí),Claude Code 會(huì)自動(dòng)禁用一些功能(比如 MCP tool search),這是安全限制
- 環(huán)境變量設(shè)置后,
claude啟動(dòng)時(shí)不會(huì)再要求 Anthropic 賬號(hào)登錄 - DeepSeek 的 API 價(jià)格大概是 Anthropic 的 1/10 到 1/20,性價(jià)比很高,但響應(yīng)速度和代碼能力跟 Claude 還是有差距
費(fèi)用相關(guān)
Claude Code 按 token 計(jì)費(fèi),用的是你 Anthropic 賬號(hào)的額度(Pro 訂閱用戶有包含的額度,Max 訂閱額度更高)。幾個(gè)省錢的點(diǎn):
- 問(wèn)題描述清楚,減少來(lái)回對(duì)話
- 大文件不需要全讀的時(shí)候,指定具體行數(shù)范圍
- 用
/compact控制上下文長(zhǎng)度 - 簡(jiǎn)單任務(wù)用
/model切到 Sonnet 或 Haiku,省錢且快 /cost隨時(shí)看當(dāng)前會(huì)話花了多少- 接入 DeepSeek 等第三方模型,成本能降一個(gè)數(shù)量級(jí)
最后
Claude Code 的定位不是替代你寫代碼,而是把那些重復(fù)性的、機(jī)械性的工作接過(guò)去——讀代碼、寫樣板、跑命令、生成測(cè)試、整理 commit。你省下來(lái)的時(shí)間可以花在真正需要思考的地方:系統(tǒng)設(shè)計(jì)、技術(shù)選型、業(yè)務(wù)理解。
MCP 和 Skills 這兩個(gè)擴(kuò)展機(jī)制讓它從一個(gè)"聰明的終端助手"變成了一個(gè)可以深度定制的開發(fā)平臺(tái)。MCP 擴(kuò)展它能觸達(dá)的外部資源,Skills 固化你的工作流程。花點(diǎn)時(shí)間把這兩個(gè)配好,日常效率提升會(huì)很明顯。
用好它的關(guān)鍵就一句話:把它當(dāng)成一個(gè)能力很強(qiáng)但需要明確指令的搭檔,而不是一個(gè)什么都懂的全知全能助手。你給的上下文越充分、指令越具體,它的輸出就越靠譜。
以上就是Claude Code完整指南:MCP、Skills、第三方模型配置一次搞定的詳細(xì)內(nèi)容,更多關(guān)于Claude Code完整指南的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章

VScode如何使用Claude Code接入Deepseek
本文介紹了VScode如何使用Claude Code接入Deepseek,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)2026-05-08
本教程詳細(xì)介紹了如何讓Claude Code與MySQL數(shù)據(jù)庫(kù)建立連接,通過(guò)安裝mcp-server-mysql作為中間件,用戶可以通過(guò)兩種方式配置連接,需要的朋友可以參考閱讀本文2026-05-07
Claude Code的CLAUDE.md加載時(shí)機(jī)與配置規(guī)范
最新版 Claude Code Desktop(桌面版)已經(jīng)支持通過(guò)圖形化界面配置第三方大模型,對(duì)于不想反復(fù)折騰 CLI、環(huán)境變量和本地配置文件的用戶來(lái)說(shuō),這個(gè)更新非常實(shí)用,本文就給大家2026-06-09
Claude Code接入國(guó)產(chǎn)大模型(GLM/Qwen)配置全解析
本文介紹了如何將Claude Code接入國(guó)產(chǎn)大模型(GLM/Qwen)的配置方法,并列舉了幾常見問(wèn)題和解決方案,文末還總結(jié)了配置方法和模型分層建議,希望對(duì)大家有一定的幫助2026-05-07
本地安裝Claude Code+自定義API接口的全配置指南
Claude Code 是Anthropic官方推出的AI 編程助手,可以直接在終端、VS Code、JetBrains 等 IDE 中使用,本文詳細(xì)介紹了Claude Code的安裝方法、環(huán)境要求、首次登錄步驟以及如2026-05-06
在Claude Code中接入DeepSeek-V4的完整指南
Claude Code的價(jià)值,在于把代碼理解、修改、執(zhí)行和驗(yàn)證整合進(jìn)同一條工作鏈路,如果你已經(jīng)在使用Claude Code,又希望把底層模型切換到DeepSeek-V4,這篇文章可以直接幫你完2026-05-06
claude code添加 andrej-karpathy-skills的實(shí)現(xiàn)步驟
andreuserandrepathy-skills是為AI編程設(shè)計(jì)的指導(dǎo)框架,旨在減少編程錯(cuò)誤并pathy-skills,本文就來(lái)詳細(xì)的介紹一下claude code添加 andrej-karpathy-skills的實(shí)現(xiàn),感興趣的可2026-05-06
Claude Code接入DeepSeek兼容端點(diǎn)的配置教程
文章介紹了如何通過(guò)環(huán)境變量配置將ClaudeCode的API后端切換為DeepSeek提供的Anthropic兼容端點(diǎn),詳細(xì)說(shuō)明了在Windows和Linux/macOS上的配置步驟,并提供了完整的配置示例,還2026-05-01
Claude Code出現(xiàn)Stream idle timeout問(wèn)題的解決方法
在使用 Claude Code 進(jìn)行項(xiàng)目改造時(shí),頻繁出現(xiàn)Stream idle timeout問(wèn)題,這是因?yàn)楫?dāng)單次任務(wù)過(guò)于復(fù)雜、生成內(nèi)容過(guò)多時(shí),流式連接會(huì)因長(zhǎng)時(shí)間空閑或響應(yīng)過(guò)慢而超時(shí)中斷,本文2026-04-30
文章詳細(xì)介紹了安裝Claude-code的過(guò)程,包括安裝Node.js和Git,配置Git環(huán)境變量,使用npm安裝Claude-code,處理下載慢的問(wèn)題,設(shè)置代理,配置API密鑰和環(huán)境變量等步驟,感興趣的2026-04-30











