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 编程助手，现在就可以开始使用！