Claude Code：国内 API 配置

时效说明：本文内容以 2026 年 3 月为基准。

3.1 为什么国内用户需要额外配置

直接使用 Anthropic 官方的 Claude API，国内有两个现实问题：

问题一：网络访问不稳定。 Anthropic 的 API 端点没有国内节点，请求需要出境，延迟高，有时连接不上。如果你的网络环境不好，Claude Code 会频繁超时，用起来很痛苦。

问题二：费用较高。 Claude 的定价随版本不同而变化，具体以 Anthropic 官方定价页为准。对于日常开发使用，按量计费累积下来费用不低。

好消息是 Claude Code 支持任何兼容 Anthropic 消息格式的 API 端点，只需要改几个环境变量就可以切换到其他服务。这章介绍国内几个主流选择的具体配置方法。

3.2 为什么推荐 DeepSeek

DeepSeek 是目前国内最推荐的 Claude Code 替代 API，原因有三：

原因一：国内直连，速度快。 DeepSeek 在国内有服务节点，不需要代理，延迟低，请求稳定，用 Claude Code 做长任务时体验好很多。

原因二：价格极低。 DeepSeek 的定价非常有竞争力，以当前价格来说，同样的 token 用量成本大约是 Claude 官方的十分之一到几十分之一（具体价格请以 DeepSeek 官方价格页为准，价格会随市场调整）。对于学习和日常开发来说，基本可以认为"随便用"。

原因三：编程能力强。 DeepSeek 在代码相关任务上的表现非常好，在各种编程 benchmark 上排名前列，实际用于 Claude Code 做代码任务时效果令人满意。对于 Java 后端开发这类结构化代码任务，效果尤为突出。

和 Claude 原生 API 相比的差距： 诚实地说，DeepSeek 在某些复杂推理任务和长上下文理解上还是稍弱于 Claude 最新版本。但对于大多数日常编码任务（重构、加测试、排错、加注释），这个差距几乎感知不到。

3.3 配置原理

Claude Code 通过以下三个环境变量控制它连接哪个模型服务：

ANTHROPIC_BASE_URL：API 的根地址，默认是 Anthropic 官方地址
ANTHROPIC_AUTH_TOKEN：用于认证的 API Key
ANTHROPIC_MODEL：指定使用哪个模型（可选，有默认值）

修改这三个变量，就能无缝切换到任何兼容服务。

3.4 接入 DeepSeek（推荐）

3.4.1 注册和获取 API Key

访问 platform.deepseek.com，点击右上角"注册"
用手机号注册（国内手机号直接注册，不需要翻墙）
登录后进入"API 管理"页面
点击"创建 API Key"，给 Key 起个名字（比如 "claude-code"）
复制生成的 API Key（以 sk- 开头）

新用户通常有免费额度，够你先体验一段时间。需要更多额度时在"充值"页面充值，支持支付宝和微信。

3.4.2 配置环境变量

设置好 Key 之后，配置环境变量：

bash

# 临时设置（只在当前终端会话有效）
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-你的DeepSeek_API_KEY
export ANTHROPIC_MODEL=deepseek-chat

注意：请以 DeepSeek 官方文档为准确认最新端点地址，端点地址可能会随版本更新变化。

设置完之后直接运行 claude 就会走 DeepSeek 的接口了。

如果你想永久生效，把这三行加到你的 shell 配置文件里：

bash

# 如果用 zsh，加到 ~/.zshrc
echo 'export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-你的DeepSeek_API_KEY' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL=deepseek-chat' >> ~/.zshrc
source ~/.zshrc

bash

# 如果用 bash，加到 ~/.bash_profile 或 ~/.bashrc
echo 'export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN=sk-你的DeepSeek_API_KEY' >> ~/.bash_profile
echo 'export ANTHROPIC_MODEL=deepseek-chat' >> ~/.bash_profile
source ~/.bash_profile

Windows PowerShell 用户：

powershell

# 设置用户级别的永久环境变量
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.deepseek.com/anthropic", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的DeepSeek_API_KEY", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-chat", "User")

3.5 阿里云百炼接入（适合重度用户）

阿里云百炼平台提供了包月套餐，如果你用量很大，包月比按量计费划算很多。

3.5.1 注册阿里云百炼

访问 bailian.console.aliyun.com
使用阿里云账号登录（没有的话先注册阿里云账号，实名认证后可用）
在"模型广场"里找到你想用的模型（推荐 Qwen 系列或者其他有 Anthropic 兼容端点的模型）
进入"API-KEY"管理页面，创建 API Key

计费说明： 百炼按 token 用量计费，具体价格以官方页面为准。如果你每天大量使用，可以联系商务购买包月套餐，通常比按量计费便宜很多。

3.5.2 配置环境变量

bash

export ANTHROPIC_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1/anthropic
export ANTHROPIC_AUTH_TOKEN=你的百炼_API_KEY
export ANTHROPIC_MODEL=qwen-max  # 或者其他支持的模型

具体支持的模型列表和最新的接入地址，以百炼官方文档为准，因为这类配置会随平台更新变化。

3.6 智谱 GLM 接入

智谱 AI 的 GLM 系列模型也有 Anthropic 兼容端点：

bash

export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
export ANTHROPIC_AUTH_TOKEN=你的智谱_API_KEY
export ANTHROPIC_MODEL=glm-4-plus

注意：请以智谱开放平台官方文档为准确认最新端点地址。

3.7 什么时候用 DeepSeek，什么时候还是用 Claude 原生

不是所有任务都适合用 DeepSeek 替代 Claude 原生。

适合用 DeepSeek 的场景：

日常编码任务：重构代码、加注释、加测试、排查 bug、实现功能
学习和实验：跑代码示例、探索 API 用法、学习新框架
批量处理：给大量文件加注释、批量重命名变量、格式化代码
费用敏感的项目：个人项目、学生、初创团队

这些场景 DeepSeek 的表现和 Claude 原生相差不大，但费用差距很大。

考虑切回 Claude 原生的场景：

需要处理非常复杂的逻辑推理，涉及多层业务规则
任务需要大量上下文（几十个文件、几万行代码的分析）
需要最新的 Claude 功能（某些新特性只有 Claude 原生支持）
对代码正确性要求极高的关键任务

实际上，对于这门课的大多数练习和项目，DeepSeek 完全够用。你可以先用 DeepSeek 跑通所有流程，之后如果有需要，切换回 Claude 原生只需要改一下环境变量。

3.8 通过 settings.json 永久配置（推荐方式）

比环境变量更推荐的方式是用 Claude Code 的配置文件。这样配置跟着 Claude Code 走，不依赖你的 shell 环境，更稳定，也更容易在不同机器间同步。

Claude Code 的配置文件位于：

全局配置：~/.claude/settings.json
项目级配置：项目根目录/.claude/settings.json

3.8.1 全局配置（推荐）

所有项目都生效，适合个人开发者：

bash

# 创建目录（如果不存在）
mkdir -p ~/.claude

然后创建或编辑 ~/.claude/settings.json：

json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_MODEL": "deepseek-chat"
  }
}

这里的 env 字段会在 Claude Code 启动时自动注入这些环境变量，不需要你每次手动 export。

3.8.2 项目级配置（多 API 并存方案）

有时候你希望不同项目用不同的 API。比如：

工作项目用 Claude 原生（公司报销，要求最好的效果）
个人学习项目用 DeepSeek（省钱）

这时候可以用项目级配置覆盖全局配置：

bash

# 在你的工作项目根目录下
mkdir -p .claude

然后创建 .claude/settings.json：

json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-ant-你的Claude_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
    "ANTHROPIC_MODEL": "claude-opus-4-5"
  }
}

优先级规则： 项目级配置 > 全局配置 > 环境变量。Claude Code 启动时会合并这些配置，项目级的会覆盖全局的。

注意： 如果项目会提交到 git，要把包含 API Key 的 .claude/settings.json 加到 .gitignore：

bash

echo '.claude/settings.json' >> .gitignore

别把 API Key 提交到代码仓库，这是一个基本的安全习惯。

3.9 配置验证的完整测试流程

配置完成后，按这个流程验证：

3.9.1 基础连接测试

启动 Claude Code，输入：

code

/status

正常输出应该类似：

code

● Claude Code Status
  Model:    deepseek-chat
  API URL:  https://api.deepseek.com/anthropic
  Auth:     API Key configured
  Version:  2.x.x

如果 Model 和 API URL 显示的是你配置的值，说明配置已经生效。

3.9.2 简单对话测试

配置连通之后，试一个最简单的任务：

code

你好，你是哪个模型？

它应该能正常回答，并且告诉你是 DeepSeek（或者你配置的其他模型）。

3.9.3 代码任务测试

在一个有代码的项目目录里启动，试一个真实的代码任务：

code

解释一下这个项目的目录结构

如果它能正常扫描目录并给出解释，说明工具调用也正常，API 配置完全没问题。

3.9.4 常见错误提示含义

错误提示	含义	解决方法
`Authentication failed`	API Key 不对或者已过期	检查 ANTHROPIC_AUTH_TOKEN 的值
`Connection timeout`	网络连不上 API 端点	检查 ANTHROPIC_BASE_URL 地址是否正确，或者网络是否正常
`Model not found`	指定的模型名称不存在	检查 ANTHROPIC_MODEL 的值，参考服务商文档里的模型名称
`Rate limit exceeded`	请求频率超过限制	等一会儿再试，或者升级套餐
`Insufficient balance`	余额不足	去 DeepSeek 控制台充值
`Invalid API format`	API 端点格式不对	确认 BASE_URL 是否需要加 `/anthropic` 后缀

一个常见的坑：DeepSeek 的 Anthropic 兼容端点需要在 URL 末尾加 /anthropic，不是直接用 https://api.deepseek.com，而是 https://api.deepseek.com/anthropic。不同服务商的 URL 格式不一样，遇到连接失败先检查这一点。

3.10 Windows 用户的配置方法

Windows 用户用 settings.json 的方式和 macOS/Linux 一样，但如果想用环境变量方式：

WSL2 里的配置（和 Linux 一样）：

bash

echo 'export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-你的DeepSeek_API_KEY' >> ~/.bashrc
echo 'export ANTHROPIC_MODEL=deepseek-chat' >> ~/.bashrc
source ~/.bashrc

原生 Windows 设置系统环境变量：

通过控制面板设置（永久生效）：

右键"我的电脑"→"属性"→"高级系统设置"→"环境变量"
在"用户变量"里点"新建"
添加 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL 三个变量
重新打开 PowerShell 使其生效

或者通过 PowerShell 命令设置（更方便）：

powershell

# 以下命令设置用户级别的持久环境变量，重启后也有效
[System.Environment]::SetEnvironmentVariable(
  "ANTHROPIC_BASE_URL",
  "https://api.deepseek.com/anthropic",
  "User"
)
[System.Environment]::SetEnvironmentVariable(
  "ANTHROPIC_AUTH_TOKEN",
  "sk-你的DeepSeek_API_KEY",
  "User"
)
[System.Environment]::SetEnvironmentVariable(
  "ANTHROPIC_MODEL",
  "deepseek-chat",
  "User"
)

# 在当前 PowerShell 会话中立即生效（不用重启）
$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的DeepSeek_API_KEY"
$env:ANTHROPIC_MODEL = "deepseek-chat"