Claude Code 安装与配置完整指南：兼容国产模型，禁止自动更新

兼容国产模型并禁止自动更新：Claude Code 配置与安装指南

解决新版 Claude Code 无法使用国产模型的问题，完整本地配置教程

背景说明

近期 Claude Code 的新版本（如 2.1.162）对国产模型（如 DeepSeek、智谱等）的兼容已经停止。要继续获得国产模型提供的 AI 编程辅助，只能将版本降级到 2.1.153 版本，同时锁定自动更新。

本指南将帮助你完成：

• 安装指定版本并完成版本降级
• 跳过官方登录验证
• 设置国产模型接入凭证
• 完全禁止自动更新

第一步：为 Claude Code 指定版本并安装

1.1 查看当前版本

执行操作前，先启动 CMD、PowerShell 或 Bash 终端：

claude --version

若输出类似 2.1.162 或更高版本，就代表需要降级。

1.2 安装或降级至兼容版本

使用 npm 全局安装 2.1.153 版本：

npm install -g @anthropic-ai/[email protected]

注意：即使已安装新版，直接执行上述命令会覆盖安装。但 npm 默认可能自动更新到最新版，请务必按后续步骤禁用自动更新。

第二步：绕开官方 Anthropic 登录验证

启动 Claude Code 时，程序会检查登录状态；修改配置文件即可直接跳过这项检查。

在用户根目录中找到或新建 .claude.json 文件：

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

若文件尚未创建，先新建；随后通过文本编辑器打开并写入下列内容：

{
  "hasCompletedOnboarding": true
}

登录检测来自 Anthropic，保存该设置即可将其绕开。

第三步：设置国产模型接入凭证

Claude Code 会读取 ~/.claude/settings.json（Windows 路径：C:Users<用户名>.claudesettings.json）负责保存运行参数及环境变量。国产模型的 Token、模型名称和 API 地址均需在这个文件内指定。

3.1 新建配置文件

在对应路径中新建 settings.json，并参考以下完整配置，按实际情况进行修改：

{
  "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 关键配置项说明

配置项	作用
ANTHROPIC_BASE_URL	请自行换成有效服务地址的国产模型 API 代&理地址
ANTHROPIC_MODEL	用于主对话的模型名称
ANTHROPIC_AUTH_TOKEN	你的 API 密钥（sk- 开头）
DISABLE_AUTOUPDATER	禁止 Claude Code 自动更新（重要）
autoUpdates	同时禁用自动更新（双重保险）
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC	关闭不必要的网络请求，增强隐私安全
language	将界面语言设置为中文
allowTools	工具集许可范围（文件读写、Bash等）由 Claude 获得
hasCompletedOnboarding	再次标明引导已经完成，以跳过检测

⚠️ 请务必将 ANTHROPIC_AUTH_TOKEN 替换为你自己的有效 API Key。

第四步：关闭 Claude Code 的自动更新功能

即便已经安装 2.1.153，自动更新仍是 Claude Code 默认会尝试执行的操作，可用前述配置中的下列方式进行阻止：

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

此外，如果你使用 npm 安装，建议不要运行 npm update -g 相关命令。

第五步：检查安装与配置

打开一个新的终端窗口（确保环境变量已经刷新），然后执行：

claude

交互式界面会在 Claude Code 正常启动后出现，届时可用一条简单消息完成测试，例如：

你好，请用中文回复一句问候。

如能看到正常回答，即表示配置成功。

常见问题及注意事项

❓ 为什么必须使用2.1.153版本？

国产模型之所以无法正常返回结果，是因为新版本（≥2.1.160）更改了模型 API 调用方式；降级能够恢复完全兼容。

❓ 配置文件路径错误，为什么配置没有生效？

• Windows 注意 .claude.json 和 .claude 文件夹均位于 C:Users<用户名> 下。
• Linux/macOS 用户的对应路径是 ~/.claude.json 和 ~/.claude/settings.json。
• 目录不存在时，请手动新建。

❓ 怎样确认自动更新已被禁用？

运行 claude --version 仍然显示 2.1.153，并且经过一段时间版本仍未改变，就说明设置成功。

❓ 能否使用其他国产模型？

支持，只需要把 ANTHROPIC_BASE_URL 和 ANTHROPIC_MODEL 替换成对应模型服务的地址与模型名称。

总结

完成本指南后，你能够：

• 让兼容国产模型的版本成为 Claude Code 固定版本
• 绕过官方强制登录
• 国产模型服务只要支持 Anthropic API 格式即可接入
• 避免版本再次因“升级”失效，需把自动更新完全禁用

由国产模型驱动的 AI 编程助手，现在就可以开始使用！