NNexithDocs
状态控制台 ↗
概览与快速开始模型目录指南API 参考集成OAuth2 / OIDC

在 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 心跳,极长思考期间客户端可能看起来 是卡住的;这一条已列入待办。