之前一直想在本地部署 Claude Code，長期被網(wǎng)絡(luò)問題卡住。官方直連方案一直沒有調(diào)通，第三方中轉(zhuǎn)服務(wù)仍然是使用官方，收費(fèi)偏高。摸索許久，發(fā)現(xiàn)DeepSeek等國內(nèi)人工智能都提供兼容Claude Code的接口，普通國內(nèi)寬帶即可直連調(diào)用，踩坑相對更少，于是整理這份完整落地流程，方便有同樣需求的開發(fā)者參考。

一. 基礎(chǔ)環(huán)境安裝

想要正常運(yùn)行 Claude Code，Node、Git、Python 三樣基礎(chǔ)工具缺一不可，下面一步步把環(huán)境配齊。

1.1 nvm安裝node

本身可能會使用Node有多種版本，所以使用用nvm管理Node版本方便后續(xù)切換。優(yōu)先裝長期支持 LTS 版本。nvm安裝，就不做介紹了。

查看線上可用 Node 版本：

nvm  list available

安裝 24.18.0 LTS 版：

nvm install 24.18.0

如果下載一直卡住，手動(dòng)下載安裝包處理：

下載地址： nodejs.org/dist/v24.18…

把壓縮包重命名 node.zip，放到路徑nvm安裝路徑下的d:\Users\Administrator\AppData\Roaming\nvm\v24.18.0\下再解壓即可。

安裝完成校驗(yàn)版本：

node -v
npm -version

1.2 安裝 git

常規(guī)安裝流程，自行下載安裝包配置環(huán)境變量，這里不多贅述。

1.3 安裝 python

官網(wǎng)下載對應(yīng)系統(tǒng)安裝包

裝好后執(zhí)行命令驗(yàn)證：

python --version
pip --version

1.4 整體環(huán)境校驗(yàn)

打開 PowerShell 一次性執(zhí)行下面四條命令，全部正常輸出版本號就代表基礎(chǔ)環(huán)境沒問題：

>node -v

>npm -v

>git --version

>python --version

1.5 新建測試項(xiàng)目目錄

打開 PowerShell 切換到 E 盤，創(chuàng)建存放代碼項(xiàng)目的文件夾并初始化 git：

 cd .\ivy\ai
 mkdir ai-code-projects
 
 cd .\ai-code-projects\
 git init

以上步驟全部執(zhí)行無報(bào)錯(cuò)，前期準(zhǔn)備工作就全部做完，能正式開始裝 Claude Code 本體了。

二. Claude Code 安裝與 DeepSeek 適配配置

2.1 npm 全局安裝

國內(nèi)網(wǎng)絡(luò)直接裝容易超時(shí)，先切換淘寶鏡像源再安裝：

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code
claude --version

校驗(yàn)是否安裝成功

# 校驗(yàn)是否安裝成功
claude --version

2.2 API 配置

2.2.1 配置說明

安裝好Claude Code后，需要配置API密鑰或登錄方式才能使用。

核心配置參數(shù)速查表：

提示： 參數(shù)關(guān)系說明：ANTHROPIC_API_KEY 用于官方直連，ANTHROPIC_AUTH_TOKEN 用于第三方服務(wù)。兩者不要同時(shí)設(shè)置，否則會沖突。ANTHROPIC_BASE_URL 只在使用非官方端點(diǎn)時(shí)需要設(shè)置。

三種配置方式對比：

配置文件路徑說明：

• 全局：~/.claude/settings.json（Windows：C:\Users\<用戶名>\.claude\settings.json）
• 項(xiàng)目級（團(tuán)隊(duì)共享）：項(xiàng)目根目錄/.claude/settings.json（可提交 Git）
• 項(xiàng)目級（個(gè)人私有）：項(xiàng)目根目錄/.claude/settings.local.json（加入 .gitignore）

三種配置方案

方案選擇指南：

你能直接訪問 Anthropic 網(wǎng)站嗎？
├── 能 → 方案一：使用 Anthropic 官方 API（推薦）
└── 不能 → 你在國內(nèi)嗎？
   ├── 想用原版 Claude 模型 → 方案二：使用第三方API中轉(zhuǎn)服務(wù) 國內(nèi)首選
   ├── 想用其他模型（DeepSeek/千問/GLM等） → 方案三：接入其他模型
   └── 想要包月套餐、省心不操心 → 在方案三中選擇廠商 Coding Plan

我只準(zhǔn)備第三種方案，Deepseek配置

2.2.2 DeepSeek 適配完整配置流程

本次只實(shí)操國內(nèi)可用的 DeepSeek 兼容方案，官方文檔參考：api-docs.deepseek.com/zh-cn/quick…

提前給 DeepSeek 賬戶充值，獲取專屬 API Key

跳過登錄驗(yàn)證

編輯或新建 ~/.claude.json（Windows 路徑：C:\Users\<用戶名>\.claude.json），將 hasCompletedOnboarding 設(shè)為 true，跳過 Anthropic 官方登錄驗(yàn)證。

{
  "hasCompletedOnboarding": true
}

配置接入憑證

新建 ~/.claude/settings.json（Windows 路徑：C:\Users\<用戶名>\.claude\settings.json），替換里面<你的 DeepSeek API Key>為自己的密鑰：

{
  "env": {
   "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
   "ANTHROPIC_AUTH_TOKEN": "<你的 DeepSeek API Key>",
   "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
   "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
   "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
   "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
   "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
   "CLAUDE_CODE_EFFORT_LEVEL": "max"
  } 
}

2.3 本地運(yùn)行測試

2.3.1 運(yùn)行Claude

進(jìn)入之前建好的 ai-code-projects 項(xiàng)目目錄，終端直接輸入claude啟動(dòng)程序

2.3.2 彈出選項(xiàng)輸入數(shù)字 1 回車進(jìn)入對話界面

2.3.3 驗(yàn)證

查看當(dāng)前接口、模型狀態(tài)校驗(yàn)配置是否生效

> /status

2.3.4 切換模型命令

/model haiku

開始使用的是千問是按月收費(fèi)，后來切換到deepseek按量收費(fèi)。所以可能圖有的不是很正確。

2.3.5 簡單對話測試可用性

比如輸入「今天星期幾」「你是什么大模型」，能正常返回 回答就代表整套流程跑通。

今天星期幾
你是什么大模型

三. 小結(jié)

很長一段時(shí)間，我一直在尋找穩(wěn)定可用的Claude Code部署方案，先后嘗試兩條路徑都不盡人意：直連 Anthropic官方接口根本無法連通；各類第三方中轉(zhuǎn)服務(wù)，要么費(fèi)用偏高，要么響應(yīng)不穩(wěn)定。兜兜轉(zhuǎn)轉(zhuǎn)，終于找到第三種可行方案，借助DeepSeek兼容接口實(shí)現(xiàn)本地運(yùn)行。普通家庭寬帶就能正常調(diào)用，按量計(jì)費(fèi)模式成本可控。

整套部署最容易踩坑的三處問題：Node 安裝包下載超時(shí)、各類配置文件路徑混淆、兩組密鑰環(huán)境變量弄混。遇到 Node 下載失敗采用離線包手動(dòng)部署；配置文件嚴(yán)格遵循 Windows 指定路徑創(chuàng)建；分清ANTHROPIC_API_KEY與ANTHROPIC_AUTH_TOKEN適用場景，就能規(guī)避絕大多數(shù)報(bào)錯(cuò)。

環(huán)境部署完成后，可以直接在本地終端使用Claude Code編程輔助能力。編寫腳本、改造項(xiàng)目代碼、梳理工程邏輯，不用頻繁切換瀏覽器網(wǎng)頁，對日常開發(fā)提升很明顯。這套兼容接入邏輯通用性較強(qiáng)，后續(xù)打算更換其他兼容Anthropic接口的大模型，直接參照這套配置修改即可復(fù)用。

千問是包月的，DeepSeek是計(jì)量，短期測試還是使用Deepseek比較好，所以前期使用千問后來切換到Deepseek的。

以上就是國內(nèi)直連Claude Code的本地部署完整實(shí)操手冊(DeepSeek兼容接口版)的詳細(xì)內(nèi)容，更多關(guān)于Claude Code本地部署的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論