所有文档

在 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 套餐, 详情见 定价