许多新手朋友参照上篇《30s 快速安装 Claude Code》教程完成安装后，普遍遇到了连接异常的问题。接下来本文将循序渐进讲解排查思路，并指导大家完成模型配置

目录

一、主要问题

二、通用思路：修改 settings.json

三、如何找到合适的中转服务？

四、以 DeepSeek 为例的完整配置

1. 获取 DeepSeek API Key

2. 填写配置

3. 启动验证

五、备选方案：通过环境变量临时生效

六、常见问题排查

七、总结

八、评论区留言下期想看那个大模型配置

一、主要问题

这是因为 Claude Code 默认连接的是 Anthropic 官方 API (api.anthropic.com)，而该服务在国内无法直接访问。

但好消息是：Claude Code 本身是开放的，它允许用户自定义 API 地址和认证信息。我们只需要做一个“偷梁换柱”——把原本发给 Anthropic 的请求，转发给另一个兼容 Anthropic API 格式的服务即可。这就是所谓的中转方案。中转服务可以是任何能够提供 Anthropic‑风格接口的服务

本文先讲清楚通用的配置方法，再给出一个以 DeepSeek  v4模型为例的具体配置。

二、通用思路：修改 settings.json

Claude Code 的配置文件位于：

• Windows：C:\Users\你的用户名\.claude\settings.json

• macOS / Linux：~/.claude/settings.json

如果文件或目录不存在，请手动创建。

我们需要在该文件中添加两个关键内容：

1. "hasCompletedOnboarding": true
   跳过启动时的地区检查（避免程序直接拒绝运行）。

2. "env" 对象
   设置环境变量，告诉 Claude Code “不要用默认的 Anthropic 服务器，改用我的”。

下面是通用的配置模板：

{
  "hasCompletedOnboarding": true,
  "env": {
    "ANTHROPIC_BASE_URL": "你的中转服务地址",
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_MODEL": "目标模型名称",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
 

​​​​参数说明：

• ANTHROPIC_BASE_URL：中转服务的入口地址，必须兼容 Anthropic 的 API 格式。

• ANTHROPIC_AUTH_TOKEN：中转服务给你的 API Key（或 token）。

• ANTHROPIC_MODEL：你想调用的具体模型名称（例如 claude-3-sonnet-20240229 或 deepseek-v4-pro）。

• 其余两个参数可选，但建议加上，可提高稳定性。

三、如何找到合适的中转服务？

任何提供 Anthropic API 兼容层 的 AI 服务都可以充当这个中转。常见的有：

服务商	中转地址示例	备注
DeepSeek	https://api.deepseek.com/anthropic	国内可直接访问，有免费额度
阿里云百炼	https://dashscope.aliyuncs.com/compatible-mode/anthropic	需要开通模型服务
智谱AI	https://open.bigmodel.cn/api/anthropic	兼容接口，需获取 API Key

你可以根据自己的偏好选择。下文将以 DeepSeek 为例，因为它网络稳定，且模型性能出色。

四、以 DeepSeek 为例的完整配置

1. 获取 DeepSeek API Key

• 访问 DeepSeek 开放平台

• 注册/登录 → 进入 API Keys 页面 → 点击 创建 API Key

• 复制生成的密钥（形如 sk-xxx...）

2. 填写配置

将下面的 JSON 完整 复制到 settings.json 中，替换 你的DeepSeek_API_Key：

{
  "hasCompletedOnboarding": true,
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your_deepseek_api_key",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "API_TIMEOUT_MS": 3000000,
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": true
  },
  "model": "deepseek-v4-pro"
}
 

其中多出来的 ANTHROPIC_SMALL_FAST_MODEL 等字段是 Claude Code 内部用来选择不同型号的，你可以保留，也可以只保留最基础的四个参数。

3. 启动验证

保存文件后，在终端输入 claude。如果一切正常，你将会看到欢迎界面，而不会再出现 ERR_BAD_REQUEST。你可以问它 “你是什么模型？”，如果它回答 “DeepSeek V4 Pro”，说明中转成功。

五、备选方案：通过环境变量临时生效

如果你不想动配置文件，也可以通过环境变量让当前终端会话使用中转服务：

Windows PowerShell：

# 设置DeepSeek API环境变量
$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "你的DeepSeek_API_Key"
$env:ANTHROPIC_MODEL = "deepseek-v4-pro"

# 调用Claude模型
claude
 

这种方法适合临时测试，但关闭终端后会失效，因此推荐使用配置文件方式。

六、常见问题排查

报错现象	可能原因	解决办法
仍然尝试连接 api.anthropic.com	配置文件未生效或格式错误	检查 settings.json 是否保存在正确路径，JSON 格式是否合法（可用在线工具校验）。
401 Unauthorized	API Key 无效或过期	重新生成 API Key，并确保复制时没有多余空格。
404 Not Found	中转地址拼写错误	确认 ANTHROPIC_BASE_URL 是否以 /anthropic 结尾（DeepSeek 需要）。
启动后一直卡住或超时	网络问题或 API 超时太短	增加 API_TIMEOUT_MS（例如 3000000 即 50 分钟）。

七、总结

• 核心原理：Claude Code 允许用户自定义 API 地址，我们只需将请求指向一个国内可访问的、兼容 Anthropic API 的中转服务。

• 通用配置：修改 settings.json，设置 "hasCompletedOnboarding": true 和 "env" 中的 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL。

• 具体示例：DeepSeek 提供了开箱即用的兼容端点，只需填入 API Key 即可。

• 扩展性：你完全可以换成其他服务商（如阿里云、智谱），只要有它们提供 Anthropic 风格的接口。

八、评论区留言下期想看那个大模型配置