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/claude-code@2.1.153

注意

：即使你机器上已经装了新版，直接执行这条命令也会覆盖安装。但 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）中的环境变量和运行参数。我们需要在这个文件里指定国产模型的 API 地址、模型名称和 Token。

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	允许 Claude 使用的工具集（Bash、文件读写等）
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 编程助手了。