Claude Code 接入 JetAPI 完整教程
本文说明如何让 Claude Code 通过 JetAPI 的兼容端点工作。核心只有两步:
把 ANTHROPIC_BASE_URL 指向 https://api.jetapi.icu(注意不带 /v1),
再把 ANTHROPIC_AUTH_TOKEN 设为你的 API Key。配置完成后重启 Claude Code 即可生效。
一、准备条件
开始之前确认以下三项:
| 项目 | 要求 | 检查方法 |
|---|---|---|
| Node.js | 18.0 或更高 | node --version |
| Claude Code CLI | 已全局安装 | claude --version |
| JetAPI API Key | sk- 开头,且所属分组支持 Claude 模型 |
在控制台「API Key」页创建 |
如果还没安装 Claude Code:
npm install -g @anthropic-ai/claude-code
claude --version
二、关键:Base URL 到底填什么
这是最容易出错的地方。Claude Code 会在 Base URL 后面自动拼接 /v1/messages,所以 Base URL 本身不能带 /v1。
| 填法 | 实际请求路径 | 结果 |
|---|---|---|
https://api.jetapi.icu |
/v1/messages |
✓ 正常 |
https://api.jetapi.icu/v1 |
/v1/v1/messages |
✗ 404 Not Found |
https://api.jetapi.icu/anthropic |
/anthropic/v1/messages |
✗ 404 或 405 |
/v1。两个工具的规则不同,混用必然报错。
三、配置步骤
Windows(PowerShell)
仅当前会话有效:
$env:ANTHROPIC_BASE_URL = "https://api.jetapi.icu"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的密钥"
claude
永久写入用户环境变量(新开终端生效):
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.jetapi.icu", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的密钥", "User")
macOS / Linux(zsh)
echo 'export ANTHROPIC_BASE_URL="https://api.jetapi.icu"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"' >> ~/.zshrc
source ~/.zshrc
macOS / Linux(bash)
echo 'export ANTHROPIC_BASE_URL="https://api.jetapi.icu"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"' >> ~/.bashrc
source ~/.bashrc
用配置文件(Claude Code 也读这个)
编辑 ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.jetapi.icu",
"ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
}
}
四、验证配置是否生效
方式一:看环境变量
# PowerShell
echo $env:ANTHROPIC_BASE_URL
# bash / zsh
echo $ANTHROPIC_BASE_URL
输出应该是 https://api.jetapi.icu。如果为空或显示官方地址,说明没写进去。
方式二:直接发一次请求(最可靠)
curl https://api.jetapi.icu/v1/messages \
-H "x-api-key: sk-你的密钥" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-opus-5-5",
"max_tokens": 20,
"messages": [{"role":"user","content":"说一句你好"}]
}'
能返回 JSON 就说明 Key 和端点都正常。
方式三:看有没有产生调用记录
去控制台的「查询用量」页,看刚才那次调用有没有被记录、扣了多少 token。
五、常见错误与排查
| 报错 | 原因 | 解法 |
|---|---|---|
401 Invalid token |
Key 拼错、已禁用,或用了别的平台的 Key | 回控制台重新复制,确认以 sk- 开头 |
404 not_found |
Base URL 多了 /v1 |
改成只填 https://api.jetapi.icu |
405 Method Not Allowed |
Base URL 带了路径(如 /anthropic) |
只填域名 |
model_not_found |
模型名不在该 Key 的分组支持范围内 | 换模型名,或换一个有权限的分组建 Key |
用户额度不足 |
账户余额 ≤ 0 | 充值后立即恢复 |
| 改了 Key 还是报错 | Claude Code 进程缓存了旧的环境变量 | 完全退出所有 claude 进程后重启 |
彻底退出 Claude Code 进程
# Windows PowerShell
Get-Process | Where-Object { $_.ProcessName -match 'claude|node' } | Stop-Process
# macOS / Linux
pkill -f claude
六、常见问题
Q:必须用 ANTHROPIC_AUTH_TOKEN 还是 ANTHROPIC_API_KEY?
Claude Code 两个都读,但优先级不同。推荐用 ANTHROPIC_AUTH_TOKEN,它是为第三方端点设计的;ANTHROPIC_API_KEY 是给官方 API 用的。两个都设可能导致冲突,只设一个就行。
Q:一个 Key 能用所有模型吗?
不能。Key 绑定一个**分组**,分组决定能调哪些模型和按什么倍率计费。想用不同线路需要建多个 Key,在 Claude Code 里切换环境变量。
Q:为什么同样的问题,不同分组价格差很多?
因为分组对应不同的上游线路。低倍率线路通常缓存命中率高、由订阅池共享,适合可重试的场景;高倍率线路是直连,稳定性更好但更贵。具体倍率见定价页。
Q:Claude Code 里能用 GPT 或 DeepSeek 吗?
Claude Code 只发 Anthropic Messages 协议的请求,不能直接用 GPT 模型。如果要在 Claude Code 里调用 OpenAI 协议模型,需要中间层做协议转换(例如 CC Switch 的路由模式)。或者直接用 Codex CLI 调 GPT 模型。
Q:配置好了但 Claude Code 还是提示登录
Claude Code 某些版本会在没有 OAuth 登录态时弹出登录引导。只要环境变量正确,跳过登录直接用即可。如果强制要求登录,检查是不是装了多个版本、或者 ~/.claude/ 下有残留的旧凭据。