JetAPI / Claude Code 接入教程

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
一句话记住:Claude Code 的 Base URL 只填域名,不带任何路径。 Codex CLI 相反,它要带 /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。

这是最能确认「真的走了 JetAPI」的方法。 环境变量可能被旧进程缓存,但调用记录不会骗人。

五、常见错误与排查

报错原因解法
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/ 下有残留的旧凭据。

七、相关页面