所有文档
在 Claude Code 中使用 1024X
Anthropic 官方的 Claude Code CLI 只要后端讲 /v1/messages 协议就能用。把 base URL 切到 1024X, 就走你 1024X 套餐计费。
提示: 底层模型实际是 GPT-5.5
虽然客户端叫 Claude Code, 1024X 在这条链路上接到的请求, 底层实际由 GPT-5.5 推理完成。对话格式、工具调用 schema 仍然按 Anthropic 协议透传, 协议层无感; 但答案风格、能力边界都是 GPT-5.5 的特征。
1. 创建 1024X API Key
登录后进入 /user/keys 生成一个 key (以 nub_ 开头), 只显示一次, 立刻复制保存。
2. 方式 A — 环境变量
Claude Code 启动时会读 ANTHROPIC_API_KEY 和 ANTHROPIC_BASE_URL, 写到你的 shell 配置 (~/.zshrc 或 ~/.bashrc) 即可:
bash
export X1024_API_KEY=nub_xxxxxxxxxxxxxx
export ANTHROPIC_API_KEY=$X1024_API_KEY
export ANTHROPIC_BASE_URL=https://api.1024x.ai注意 ANTHROPIC_BASE_URL 是根路径, 不带 /v1; Claude Code 会自己拼后续路径。
3. 方式 B — settings.json (按机器)
不想污染 shell 的话, 把覆盖写到 Claude Code 自己的设置文件 ~/.claude/settings.json 的 `env` 块下:
json
// ~/.claude/settings.json
{
"env": {
"ANTHROPIC_API_KEY": "nub_xxxxxxxxxxxxxx",
"ANTHROPIC_BASE_URL": "https://api.1024x.ai"
}
}4. 验证
bash
claude --version
claude "ping the gateway in one short sentence"能正常返回就说明网关已经接通。在 dashboard 里可以看到这条请求的明细。
常见问题
- 401 / Invalid API key — 确认 key 没被删, 并且 ANTHROPIC_BASE_URL 末尾不带 /v1。
- 流式卡住 — 确认网络允许长连接, SSE 需要 HTTP/1.1 keep-alive。
- 想切回真 Anthropic? unset ANTHROPIC_BASE_URL, Claude Code 会回落到 api.anthropic.com。
- Token 用量 — 计入 1024X 套餐, 详情见 定价。