Claude Code API 完整教程：API Key、Base URL 与接入（2026）

Claude Code 是 Anthropic 推出的命令行编程工具，适合在终端里读代码、改代码、跑测试、做重构。它默认调用 Anthropic 的 API，所以国内开发者经常会遇到三个问题：官方接口访问不稳定、付款方式受限、团队额度和成本不好管理。

中商起航 AI 网关提供统一的 API 入口：你只需要一个 API Key，就可以通过兼容接口调用 Claude 等主流模型。本文从注册、创建 Key、配置 Base URL 到第一次运行，完整走一遍。

说明：Claude Code 版本更新较快，环境变量和菜单名称可能随版本变化。本文以 2026 年 10 月的常见版本为例，具体以 claude --help 和官方文档为准。

一、先搞清楚：Claude Code 用的是哪种接口

Claude Code 默认走 Anthropic Messages API，不是 OpenAI 的 Chat Completions API。接入第三方网关时，需要准备三样东西：

Base URL：接口地址，例如 https://ai.zhongshangqihang.com。
API Key：在中商起航控制台创建的令牌，通常以 sk- 开头。
模型名：例如 claude-sonnet-4-5、claude-opus-4-1，以站内价格页当前展示的模型名为准。

如果你用的是 OpenAI SDK 或其他 OpenAI 兼容工具，Base URL 通常要写成 https://ai.zhongshangqihang.com/v1；Claude Code 走 Anthropic 协议时，一般填根地址，由客户端自己拼接 /v1/messages。

二、准备账号与 API Key

1. 注册并登录

打开中商起航 AI 网关，注册账号并登录控制台。

2. 创建 API Key

进入控制台的「API 密钥」页面，新建一个密钥。建议：

名称写清楚用途，例如 claude-code-工作电脑。
设置额度上限，避免密钥泄露后被大量消耗。
设置过期时间，长期不用时自动失效。
创建后立即复制保存，密钥通常只完整显示一次。

3. 确认余额

在「钱包」或「充值」页面确认余额。不同模型的计费方式不同，具体单价看模型价格。

三、配置 Claude Code

方式 A：macOS / Linux 环境变量

在终端执行：

export ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
export ANTHROPIC_API_KEY="sk-你的密钥"
claude

如果希望每次打开终端都生效，可以把上面两行写入 ~/.zshrc 或 ~/.bashrc，然后执行 source ~/.zshrc。

方式 B：Windows PowerShell

$env:ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
$env:ANTHROPIC_API_KEY="sk-你的密钥"
claude

方式 C：客户端要求 AUTH_TOKEN 的情况

部分第三方客户端或代理配置使用 ANTHROPIC_AUTH_TOKEN 而不是 ANTHROPIC_API_KEY：

export ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"

如果两个变量同时存在，优先按客户端文档保留一个，避免认证头冲突。不同版本的 Claude Code 对变量名支持不完全一致，遇到 401 时先检查这一点。

方式 D：项目级配置

如果不想污染全局环境，可以在项目目录里用 .env 或启动脚本注入环境变量。注意不要把 .env 提交到 Git：

# .env.local（不要提交）
ANTHROPIC_BASE_URL=https://ai.zhongshangqihang.com
ANTHROPIC_API_KEY=sk-你的密钥

然后在启动 Claude Code 前加载该文件。不同 shell 的加载方式不同，按你的项目规范处理。

四、选择模型

Claude 系列通常分 Opus、Sonnet、Haiku 三档：

档位	适合场景	特点
Opus	复杂重构、长链路 Agent、难题推理	能力最强，单价通常最高
Sonnet	日常写代码、改 Bug、代码审查	能力和成本较均衡
Haiku	简单补全、批量任务、低成本调用	速度快，单价通常更低

在 Claude Code 里可以通过模型参数或环境变量指定模型。实际可用的模型名以模型价格页面为准；如果填了不存在的模型名，通常会返回 model not found。

五、第一次调用与排错

配置好后，在项目目录运行：

claude

然后输入一个简单任务，例如「解释这个项目的目录结构」。如果能看到正常回复，说明 Base URL、Key 和模型都通了。

常见报错：

报错	可能原因	处理
`401 Unauthorized`	Key 错误、过期或变量名不对	重新复制 Key；检查 `ANTHROPIC_API_KEY` / `ANTHROPIC_AUTH_TOKEN`
`404 Not Found`	Base URL 多了或少了 `/v1`	Claude Code 用根地址；OpenAI SDK 用 `/v1`
`model not found`	模型名不存在或未开通	到价格页复制当前模型名
`429 Too Many Requests`	并发或频率超限	降低并发，稍后重试；检查令牌限额
`insufficient quota`	余额不足	充值后重试
一直卡住/超时	网络或代理问题	检查网络、DNS、代理设置

六、费用与额度怎么控制

Claude Code 的成本主要来自输入 Token、输出 Token，以及长上下文和缓存。控制成本可以从这几件事入手：

给每个项目单独建 Key，设置额度和过期时间。
简单任务用 Sonnet/Haiku，复杂任务再切 Opus。
避免把整个大仓库一次性塞进上下文，先让 Claude Code 读相关文件。
定期看用量日志，找出消耗最高的项目和模型。
团队场景用统一网关，把成员、Key、额度和账单分开管理。

具体单价和计费规则以模型价格为准。价格会随模型版本和上游政策变化，本文不写死数字，避免过期。

七、安全建议

不要把 API Key 写进代码、截图、Git 仓库或公开文档。
给 Key 设置额度上限和过期时间。
怀疑泄露时立即删除旧 Key，重新创建。
团队里一人一 Key，方便审计和停用。
生产环境和测试环境分开使用不同 Key。

常见问题

Claude Code 和 Claude API 是同一个东西吗？

不是。Claude Code 是编程工具，Claude API 是模型接口。Claude Code 通过 API 调用模型；你也可以用 Claude API 自己写应用。

中商起航的 Key 能直接用在 Claude Code 里吗？

可以，前提是客户端使用 Anthropic 兼容协议，并且 Base URL、Key、模型名配置正确。具体以站内接入说明和当前客户端版本为准。

为什么建议用网关而不是官方直连？

网关的价值主要是统一入口、统一计费、额度管理、用量可查和多模型切换。对于团队和国内访问场景，通常比每个成员单独申请官方账号更好管理。

需要装 Node.js 吗？

Claude Code 通常通过 npm 安装，需要 Node.js 环境。安装方式以官方文档为准。

下一步

如果你还没有账号，可以先注册中商起航 AI 网关，创建一个测试 Key，按本文配置跑通第一个任务。遇到模型名或计费问题，先看模型价格，再用控制台的用量日志排查。