全部教程 /
在 Claude Code 中使用 XHuoAPI
Claude Code 用 Anthropic Messages 格式发请求，XHuoAPI 支持这个格式，所以不需要任何转换工具，改两个环境变量就能接入。我们用 Claude Code 2.1.284 实际跑过写文件的任务，下面的步骤和注意事项都来自那次测试。
开始之前
先验证一下
curl https://api.xhuoapi.ai/v1/chat/completions \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v3.2","messages":[{"role":"user","content":"ping"}]}'
配置步骤
1
安装 Claude Code（需要 Node.js 18 或更高版本）。
npm install -g @anthropic-ai/claude-code
2
设置环境变量。Base URL 不要带 /v1，Claude Code 会自己补上 /v1/messages。把这几行加进 ~/.zshrc 或 ~/.bashrc 可以长期生效。
export ANTHROPIC_BASE_URL=https://api.xhuoapi.ai export ANTHROPIC_AUTH_TOKEN=YOUR_XHUOAPI_KEY export ANTHROPIC_MODEL=claude-sonnet-4-6 export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-sonnet-4-6
3
也可以不改 shell 配置，改写 ~/.claude/settings.json 里的 env 块，效果相同。
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.xhuoapi.ai",
"ANTHROPIC_AUTH_TOKEN": "YOUR_XHUOAPI_KEY",
"ANTHROPIC_MODEL": "claude-sonnet-4-6",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-6"
}
}
4
在项目目录里运行 claude 进入交互模式；或者用 -p 跑一次性任务，先确认能连通。
claude -p "Reply with the single word: ok"
5
要换成非 Claude 模型，把 ANTHROPIC_MODEL 和 ANTHROPIC_DEFAULT_HAIKU_MODEL 改成对应的模型 ID 即可，例如 deepseek-v3.2。
export ANTHROPIC_MODEL=deepseek-v3.2 export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v3.2
注意事项
实测结果（2026-10-06，让 Claude Code 新建并写入一个文件）：claude-sonnet-4-6、deepseek-v3.2、glm-5.3、qwen3.8-max 都一次完成；kimi-k3 第一次报错，重试后完成。不同模型速度差别很大，同一个任务 DeepSeek 约 9 秒，GLM 约 45 秒。
Claude Code 的一部分后台小任务默认交给 Haiku 档模型。把 ANTHROPIC_DEFAULT_HAIKU_MODEL 设成你正在用、并且确认能调通的模型，避免后台请求落到你没测过的模型上。
Claude Code 每次请求都会带上很长的系统提示。我们的测试里第一次请求写入缓存约 3.6 万 tokens，之后的请求从缓存读取约 6.4 万 tokens。缓存读取按缓存价计费，比普通输入便宜，各模型的缓存价见定价页。
ANTHROPIC_AUTH_TOKEN 以 Authorization: Bearer 头发送，ANTHROPIC_API_KEY 以 x-api-key 头发送，XHuoAPI 两种都接受。用 ANTHROPIC_API_KEY 时，Claude Code 交互模式第一次启动会询问是否使用这个 Key。
Qwen 系列与图像/视频模型只在 Standard 与 Official 分组可用。令牌建在 Saver 或 Spot 分组下时，这些模型会返回「模型不可用」。
模型名必须与定价页里的 ID 完全一致（例如 deepseek-v4-pro，不是 DeepSeek V4 Pro）。大小写、连字符都算。