Claude Code 国内使用教程：接入国产大模型与代理配置完整方案（2026）

适合人群

• 国内开发者，想用 Claude Code 但直连 Anthropic API 不稳定
• 已经有国内大模型 API（通义千问、智谱、DeepSeek、MiniMax），想接入 Claude Code
• 在海外 VPS 或云服务器上运行 Claude Code 的开发者
• 对网络配置和 API 代理有一定基础的技术用户

准备清单

• 一台 Linux 服务器（海外 VPS 或国内服务器均可）
• Node.js 18+ 环境
• 至少一个国内大模型 API Key（通义千问 / 智谱 / DeepSeek / MiniMax）
• 基本的终端操作能力
• 了解 HTTP 代理概念

为什么需要这篇教程

Claude Code 是目前最强的终端 AI 编程助手，但它默认连接 Anthropic 的 API。国内开发者面临两个问题：一是网络不通，二是 Anthropic API 价格偏高。

好消息是，Claude Code 支持自定义 API 端点。这意味着你可以把请求转发到兼容 OpenAI 格式的国内大模型，或者通过代理转发到 Anthropic。两种方案各有优劣，本文逐一讲解。

方案一：Claude Code 接入国内大模型

原理

Claude Code 支持通过环境变量配置自定义 API Base URL。只要国内大模型提供兼容 OpenAI 格式的 API，就能接入。

支持的国内模型

配置步骤

步骤一：获取 API Key

以 DeepSeek 为例：

1. 访问 platform.deepseek.com
2. 注册并登录
3. 进入 API Keys 页面
4. 点击「创建 API Key」
5. 复制生成的 Key（以 sk- 开头）

其他模型平台流程类似，在各自的控制台创建 API Key 即可。

步骤二：配置环境变量

在 ~/.bashrc 或 ~/.zshrc 中添加：

# DeepSeek 配置
export ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"
export ANTHROPIC_API_KEY="sk-your-deepseek-key"

# 或者通义千问
# export ANTHROPIC_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
# export ANTHROPIC_API_KEY="sk-your-qwen-key"

# 或者智谱
# export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/paas/v4"
# export ANTHROPIC_API_KEY="your-zhipu-key"

保存后执行 source ~/.bashrc 使配置生效。

步骤三：安装并启动 Claude Code

npm install -g @anthropic-ai/claude-code

# 进入项目目录
cd your-project

# 启动
claude

启动后 Claude Code 会自动使用你配置的国内模型 API。

步骤四：验证连接

在 Claude Code 中输入一个简单问题：

你好，请介绍一下你自己

如果收到正常回复，说明配置成功。如果报错，检查 API Key 和 Base URL 是否正确。

常见问题排查

「401 Unauthorized」错误：

• API Key 复制不完整，重新复制
• Base URL 末尾多了 / 或少了 /v1

「Connection refused」错误：

• 国内服务器访问某些 API 需要确认白名单
• 检查 Base URL 是否正确

「Model not found」错误：

• 部分国内模型可能不支持 Claude Code 使用的模型名称参数
• 尝试在环境变量中指定模型名称

方案二：通过代理连接 Anthropic API

如果你坚持要用原版 Claude 模型（Opus、Sonnet），需要通过网络代理。

方案 A：海外 VPS 转发

在海外 VPS 上搭建一个简单的 API 代理：

# 在海外 VPS 上安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 直接使用，无需额外配置
export ANTHROPIC_API_KEY="sk-ant-your-key"
claude

这是最稳定的方案。推荐使用日本、新加坡、美国西海岸的 VPS。

方案 B：本地代理转发

在本地配置 HTTP 代理后启动 Claude Code：

# 设置代理
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

# 设置 API Key
export ANTHROPIC_API_KEY="sk-ant-your-key"

# 启动
claude

需要先配置好本地代理工具（如 Shadowrocket 或 Clash），确保代理端口正确。

方案 C：使用 API 中转服务

有一些第三方提供 Anthropic API 的中转服务，配置方式类似方案一：

export ANTHROPIC_BASE_URL="https://your-proxy-service.com/v1"
export ANTHROPIC_API_KEY="your-proxy-key"
claude

注意： 中转服务存在数据安全风险，你的代码和对话内容会经过第三方服务器。涉及商业项目或敏感代码时，优先选择方案 A（自有 VPS）。

方案三：Claude Pro 订阅

不想折腾网络配置？直接订阅 Claude Pro 月卡 是最省心的方案。

优点：

• 无需配置 API Key
• 无需担心网络问题
• 可使用 Opus 4.7 等最强模型
• 包含 Claude Code 使用额度

限制：

• 有每月使用额度上限
• 高峰期可能需要排队
• 终端使用需要通过网页版或官方客户端

三种方案对比

实战推荐配置

个人开发者（预算有限）

# 使用 DeepSeek V3 作为主力模型
export ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"
export ANTHROPIC_API_KEY="sk-your-deepseek-key"

性价比最高，日常编程够用。

团队开发（追求质量）

# 海外 VPS 上直连 Anthropic
export ANTHROPIC_API_KEY="sk-ant-your-key"

代码质量最高，适合商业项目。

非技术用户（追求简单）

直接购买 Claude Pro 月卡，开箱即用，不需要任何终端配置。

常见问题

Q: 国内模型和 Anthropic 原版模型差距大吗？

日常编程任务差距不大。复杂架构设计、长上下文理解、多文件重构等高难度任务，Opus 4.7 仍然明显更强。建议：简单任务用国内模型省钱，复杂任务切到 Anthropic API。

Q: 能不能同时配置多个模型？

可以。通过 shell 别名或脚本来切换：

# 在 ~/.bashrc 中添加
alias claude-deepseek='ANTHROPIC_BASE_URL="https://api.deepseek.com/v1" ANTHROPIC_API_KEY="sk-xxx" claude'
alias claude-anthropic='ANTHROPIC_API_KEY="sk-ant-xxx" HTTP_PROXY=http://127.0.0.1:7890 claude'

Q: Claude Code 用国内模型，MCP 还能用吗？

MCP 是本地运行的协议，与底层模型无关。GitHub、文件系统、数据库等 MCP Server 都能正常使用。

Q: MiniMax 模型接入有什么特殊配置？

MiniMax 的 API 地址是 https://api.minimax.chat/v1。部分用户反馈需要额外设置模型映射参数。具体可参考 Claude Code 接入 MiniMax 教程。

参考来源

• 实测小米 MiMo-V2.5-Pro，国内最适合 Claude Code 的新模型 - 投资界
• 实测 Claude Code 配合国内大模型完整配置教程 - 51CTO
• 与 MiniMax 斗智斗勇：PC 端用 Claude Code 接入 MiniMax 模型 - PANews
• Claude Code 官方文档
• DeepSeek API 文档

下一步建议

• 刚接触 Claude Code？→ Claude Code 完整教程：35 个实战技巧
• 想学 MCP 配置？→ Claude Code MCP 配置完整教程
• 想控制费用？→ Claude Code 成本优化指南
• 想省心使用？→ Claude Pro 月卡