Claude Code 安裝與配置指南：兼容國產(chǎn)模型，禁止自動更新

解決新版 Claude Code 無法使用國產(chǎn)模型的問題，完整本地配置教程

背景說明

近期 Claude Code 的新版本（如 2.1.162）不再兼容國產(chǎn)模型（如 DeepSeek、智譜等）。如果你希望繼續(xù)使用國產(chǎn)模型進(jìn)行 AI 編程輔助，需要降級到 2.1.153 版本并鎖定自動更新。

本指南將帶你完成：

• 指定版本安裝與版本降級
• 跳過官方登錄驗證
• 配置國產(chǎn)模型接入憑證
• 徹底禁止自動更新

第一步：安裝指定版本 Claude Code

1.1 檢查當(dāng)前版本

打開終端（CMD、PowerShell 或 Bash），執(zhí)行：

claude --version

如果輸出類似 2.1.162 或更高版本，說明需要降級。

1.2 安裝或降級到兼容版本

使用 npm 全局安裝 2.1.153 版本：

npm install -g @anthropic-ai/claude-code@2.1.153

注意：即使已安裝新版，直接執(zhí)行上述命令會覆蓋安裝。但 npm 默認(rèn)可能自動更新到最新版，請務(wù)必按后續(xù)步驟禁用自動更新。

第二步：跳過 Anthropic 官方登錄驗證

Claude Code 啟動時會檢測是否已登錄。我們可以通過修改配置文件直接跳過。

在用戶根目錄下找到或創(chuàng)建 .claude.json 文件：

• Windows：C:\Users\<你的用戶名>\.claude.json
• Linux / macOS：~/.claude.json

用文本編輯器打開（若不存在則新建），填入以下內(nèi)容：

{
  "hasCompletedOnboarding": true
}

保存后，Anthropic 的登錄檢測將被繞過。

第三步：配置國產(chǎn)模型接入憑證

Claude Code 會讀取 ~/.claude/settings.json（Windows 路徑：C:\Users\<用戶名>\.claude\settings.json）中的環(huán)境變量和運行參數(shù)。我們需要在此文件中指定國產(chǎn)模型的 API 地址、模型名稱和 Token。

3.1 創(chuàng)建配置文件

在對應(yīng)路徑下新建 settings.json，參考以下完整配置（請根據(jù)你的實際情況修改）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://token.sensenova.cn",
    "ANTHROPIC_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的實際API密鑰",
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "DISABLE_AUTOUPDATER": "1",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "sensenova-6.7-flash-lite",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "sensenova-6.7-flash-lite",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-flash"
  },
  "teammateMode": "tmux",
  "language": "Chinese",
  "alwaysThinkingEnabled": false,
  "allowTools": [
    "Bash",
    "Glob",
    "Grep",
    "Read",
    "Write",
    "Edit"
  ],
  "autoUpdates": false,
  "CLAUDE_CODE_TELEMETRY_DISABLED": "1",
  "ANTHROPIC_CLI_NO_UPDATE_CHECK": "1",
  "hasCompletedOnboarding": true,
  "model": "deepseek-v4-flash",
  "agentSettings": {
    "teammateModel": "sonnet"
  }
}

3.2 關(guān)鍵配置項解釋

?? 請務(wù)必將 ANTHROPIC_AUTH_TOKEN 替換為你自己的有效 API Key。

第四步：禁止 Claude Code 自動更新

即使你安裝了 2.1.153，Claude Code 默認(rèn)仍會嘗試自動更新。上述配置中已經(jīng)通過以下方式阻止：

• "DISABLE_AUTOUPDATER": "1"
• "autoUpdates": false
• "ANTHROPIC_CLI_NO_UPDATE_CHECK": "1"

此外，如果你使用 npm 安裝，建議不要運行 npm update -g 相關(guān)命令。

第五步：驗證安裝與配置

打開一個新的終端窗口（確保環(huán)境變量已刷新），執(zhí)行：

claude

如果一切正常，Claude Code 會啟動交互式界面。你可以發(fā)送一條簡單消息測試，例如：

你好，請用中文回復(fù)一句問候。

看到正?；卮?，說明配置成功。

常見問題與注意事項

? 為什么一定要用2.1.153版本？

因為新版本（≥2.1.160）針對模型 API 的調(diào)用方式發(fā)生了變化，導(dǎo)致國產(chǎn)模型無法正常返回結(jié)果。降級后可完美兼容。

? 配置文件路徑不對導(dǎo)致配置不生效？

• Windows 注意 .claude.json 和 .claude 文件夾都在 C:\Users\<用戶名>\ 下。
• Linux/macOS 用戶對應(yīng)路徑為 ~/.claude.json 和 ~/.claude/settings.json。
• 如果目錄不存在，請手動創(chuàng)建。

? 如何確認(rèn)自動更新已禁用？

運行 claude --version 仍顯示 2.1.153，且過一段時間后版本不變，即表示成功。

? 是否支持其他國產(chǎn)模型？

支持。只需將 ANTHROPIC_BASE_URL 和 ANTHROPIC_MODEL 改為對應(yīng)模型服務(wù)的地址和模型名稱即可。

總結(jié)

通過本指南，你可以：

• 固定使用兼容國產(chǎn)模型的 Claude Code 版本
• 繞過官方強(qiáng)制登錄
• 接入任意支持 Anthropic API 格式的國產(chǎn)模型服務(wù)
• 徹底禁止自動更新，避免版本“升級”后再次失效

現(xiàn)在，開始享受使用國產(chǎn)模型驅(qū)動的 AI 編程助手吧！

到此這篇關(guān)于Claude Code 安裝與配置指南：兼容國產(chǎn)模型，禁止自動更新的文章就介紹到這了,更多相關(guān)Claude Code 安裝與配置內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論