在 Claude Code 中使用 Nexith
Claude Code 只发 Anthropic 协议(/v1/messages、x-api-key)。Nexith 网关内置这一层适配:
只翻译协议边界,内部仍走同一条执行管道——路由、供应商分派、计费、出口擦除全部复用。
配置#
export ANTHROPIC_BASE_URL="https://api.nexith.ai"
export ANTHROPIC_API_KEY="nx-你的key"把这两行写进 ~/.zshrc 或 ~/.bashrc 以持久化,然后在项目目录里正常用 claude。
关于 base URL(最容易配错的一处)#
不要带 /v1。 客户端会在 base 之后自己拼 /v1/messages:
| 你写的 | 客户端实际请求 | 结果 |
|---|---|---|
https://api.nexith.ai |
https://api.nexith.ai/v1/messages |
✅ |
https://api.nexith.ai/v1 |
https://api.nexith.ai/v1/v1/messages |
❌ 失败 |
这与 Anthropic 官方 SDK 的约定一致(官方 base 是 https://api.anthropic.com,不带 /v1)。
两个 host 都能用#
api.nexith.ai 与 gateway.nexith.ai 是同一后端的两个入口,配哪个都行。
(历史提示:2026-09-20 之前 api.nexith.ai 没有转发模型端点,用它会得到
missing_api_key——一个与 key 是否正确无关的报错。现已修正。)
凭据#
- Claude Code 发的是
x-api-key(不是Authorization)。 - 网关两种都收:
Authorization: Bearer <token>优先,x-api-key作为回退。 - key 从 platform.nexith.ai 创建,形如
nx-加 32 位。
支持的端点#
| 端点 | 说明 |
|---|---|
POST /v1/messages |
Anthropic Messages,支持 tool use 与流式 |
POST /v1/messages/count_tokens |
token 计数 |
POST /v1/chat/completions |
OpenAI 兼容(同一后端) |
POST /v1/responses |
OpenAI Responses(Codex 用) |
GET /v1/models |
模型列表 |
工具调用#
已验证可用:工具定义经 input_schema 原样转成上游的 parameters;响应按 Anthropic 规范
分帧——content_block_start(type: tool_use)→ 若干 input_json_delta(参数按上游切片
原样转发,不做 JSON 解析与再序列化,所以长参数不会因往返丢精度)→ content_block_stop
→ message_delta 带 stop_reason: "tool_use"。
tool_choice 映射:auto → auto,any → required,tool → 指定函数。
计费与长任务#
- 计费按实际 token 结算,与结算账本同源。
- 单个请求有 120 秒上限(当前)。超长 agent 循环若单轮超过 120s 会被截断——这一条正在处理中。
- 上下文超过 32k 的
nexith-core请求会自动升级到更强的上游,并按升级后的档位计价。
故障排除#
401 missing_api_key
说明请求没到网关。检查 base URL 是否多写了 /v1(见上表),或域名是否写错。
401 invalid_api_key
请求到网关了,但 key 不对:确认是 nx- 开头、没有多余空格、账号余额充足。
403 / 404
/v1/messages 只在这两个 host 上提供。如果用了别的域名(如 platform.nexith.ai)不会生效。
流式卡住不动 上游模型在长思考时不会主动发数据。当前网关没有 SSE 心跳,极长思考期间客户端可能看起来 是卡住的;这一条已列入待办。