客户端接入
Claude Code
使用 ANTHROPIC_BASE_URL 和 apiKeyHelper 通过 InfiniteX Claude-compatible API 完成真实请求
目标
让 Claude Code 通过 InfiniteX /v1/messages 完成最小文本请求,并在使用日志核对状态、Token 与费用。
前置条件
- 已安装 Claude Code;本文配置基于
2.1.201。 - 已创建 1 小时、低额度、单模型 API 密钥。
- 已确认当前 Key 的
/v1/models返回一个支持 Claude-compatible 消息协议的模型。
准确入口
配置步骤
- 执行
claude --version,确认实际版本。 - 在 Claude Code 设置中把
ANTHROPIC_BASE_URL指向https://api.infinitex.pro。该变量不追加/v1/messages,客户端会调用协议 endpoint。 - 配置
apiKeyHelper,让 helper 从本机安全存储读取临时 Key并只输出 Key 本身。不要把 Key 直接写入可提交的设置文件。 - 用当前
/v1/models返回的兼容模型启动单轮测试;模型名不写死在本文。 - 使用
--bare --print发送一条最小无隐私文本问题,确认客户端无 API/auth error。 - 在使用日志按时间定位
/v1/messages,核对模型、Token、费用、耗时和 request ID。 - 永久删除临时 Key,并确认删除后认证失败。
一个不含密钥的设置片段可以写成:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.infinitex.pro"
},
"apiKeyHelper": "<LOCAL_CREDENTIAL_HELPER>"
}成功结果
Claude Code 单轮请求返回文本且没有 API/auth error;InfiniteX 使用日志出现同一时刻的 /v1/messages 记录;撤销 Key 后不能继续调用。
常见错误
| 现象 | 可执行检查 |
|---|---|
401 | helper 是否输出完整有效 Key,Key 是否过期或已删除 |
404 | ANTHROPIC_BASE_URL 是否误加了 /v1/messages 或写成文档域名 |
| 协议错误 | 当前模型/渠道是否支持 Claude-compatible /v1/messages |
| 模型不可用 | 重新查询 /v1/models 并核对可用渠道 |
| 日志无记录 | 检查请求是否在客户端配置阶段失败,扩大时间范围 |
截图状态
CL-02 未发布:真实验证发生在终端客户端,安全采图管线不能自动化 Claude Code CLI;包含完整 Key、prompt 或上游回复的终端画面不能进入公开资产。版本和链路由客户端结果与 InfiniteX 日志共同证明。
安全与计费影响
credential helper 只能输出 Key,不应输出调试日志。Claude Code 可能进行多轮调用;用低额度、单模型、短有效期 Key 验证,完成后撤销。不要公开项目路径、prompt、响应或完整错误 body。
下一步
最后更新于