Claude API Key 获取教程：Console、充值、调用与代理（2026）

Claude API 是 Anthropic 提供的模型接口，常用于长文本、代码、Agent 和复杂推理。很多开发者第一次配置时会混淆三件事：Claude 网页订阅、Claude Code、Claude API。

本文讲清楚 Claude API Key 怎么获取、怎么调用、怎么接到 Claude Code，以及国内访问的两种方案。

说明：Claude、Anthropic 是其权利人的商标。本文以 2026 年 10 月的常见版本为例，接口和价格以官方/站内为准。

一、先分清三个东西

名称	是什么	怎么用
Claude 网页/App	聊天产品	订阅会员
Claude Code	命令行编程工具	通过 API 调用模型
Claude API	模型接口	用 Key 调用 /v1/messages

本文讲的是 Claude API Key。它不是网页会员账号，也不能拿网页订阅直接当 API 用。

二、路线 A：Anthropic Console 官方 Key

1. 打开 Anthropic Console。
2. 注册/登录账号。
3. 进入 API Keys 页面。
4. 创建 Key，命名并保存。
5. 绑定付款方式，确认额度。
6. 复制 Key，保存到密码管理器。

官方 Key 的调用地址通常是：

https://api.anthropic.com

请求头需要 x-api-key 和 anthropic-version。具体以官方文档为准。

三、路线 B：中商起航网关 Key

如果你在国内访问官方接口不稳定，或者需要统一账单/多模型：

1. 打开 中商起航 AI 网关 注册。
2. 进入「API 密钥」创建 Key。
3. 设置额度上限和过期时间。
4. 在钱包充值。
5. 复制 Key。

网关提供两种常见用法：

• Anthropic 兼容：给 Claude Code 等使用 Anthropic 协议的工具。
• OpenAI 兼容：给 OpenAI SDK、Cursor、Chatbox、Dify 等工具，Base URL 用 https://ai.zhongshangqihang.com/v1。

四、用 curl 调 Anthropic 原生接口

export ANTHROPIC_API_KEY="sk-你的密钥"

curl "https://ai.zhongshangqihang.com/v1/messages" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "用三句话解释什么是 API 网关"}
    ]
  }'

模型名以 模型价格 为准。如果网关的 Anthropic 兼容入口路径不同，以站内接入说明为准。

五、用 OpenAI SDK 调 Claude

很多工具只支持 OpenAI 协议。这时用网关的 OpenAI 兼容入口：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ANTHROPIC_API_KEY"],
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[{"role": "user", "content": "只回复 OK"}],
)
print(resp.choices[0].message.content)

注意：Anthropic 原生接口和 OpenAI 兼容接口的请求格式不同，不要混用。

六、接到 Claude Code

Claude Code 走 Anthropic 协议，常见配置：

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

如果客户端要求 ANTHROPIC_AUTH_TOKEN，按客户端文档替换。详细步骤看 Claude Code API 完整教程。

七、常见报错

报错	原因	处理
401	Key 错/过期/请求头不对	检查 x-api-key 或 Bearer
404	Base URL 或路径不对	原生用 /v1/messages；OpenAI 兼容用 /v1
model not found	模型名不对	从价格页复制
429	限流/配额	降并发、重试、升级额度
insufficient quota	余额不足	充值
anthropic-version 报错	缺版本头	加 anthropic-version: 2023-06-01

八、安全建议

• 不要在前端暴露 Key。
• 一人一 Key，按项目限额。
• 设置过期时间，定期轮换。
• 不要把 Key 提交到 Git。
• 生产环境用环境变量/密钥管理服务。

九、官方直连 vs 网关

维度	官方直连	中商起航网关
访问	受网络环境影响	面向国内优化
支付	官方支持方式	站内充值
模型	只有 Claude	可同时接 GPT/Gemini/DeepSeek
账单	官方后台	统一控制台
切换	换供应商要改代码	改模型名即可

如果你只用 Claude、官方访问正常，直连也可以；如果需要国内稳定访问和多模型统一管理，网关更合适。

常见问题

Claude API Key 和 Claude Code 的 Key 是同一个吗？

Claude Code 用的是 Claude API Key（或兼容网关 Key）。网页订阅不是 API Key。

一个 Key 能调多个 Claude 模型吗？

可以，模型在请求参数里指定。具体可用模型看价格页。

为什么官方文档的代码跑不通？

常见原因是 Base URL、请求头、模型名三者不匹配。原生接口和 OpenAI 兼容接口要分开配置。

下一步

需要国内稳定访问或多模型统一入口，可以先 注册中商起航 AI 网关，创建测试 Key，按本文跑通第一条请求。模型和价格以 模型价格 为准。

相关阅读：

• Claude Code API 完整教程
• Claude Code 价格：订阅 vs API
• Anthropic API 是什么？