Claude Code 的 Anthropic 兼容接入:配置、环境变量与常见报错
把 Claude Code 指向自己的网关,看起来只是设两个环境变量的事。但真正动手时会冒出一堆「变量名不对」「地址多了一级路径」「为什么工具调用报不支持」的问题,它们背后是一条清晰的逻辑链。
变量名比路径更容易出错
不同版本的客户端读的 token 变量不一样,有的读 ANTHROPIC_AUTH_TOKEN,有的读 ANTHROPIC_API_KEY。装之前先 claude --version,两个都设上是最省事的做法。
在 Claude Code 里配置 ANTHROPIC_BASE_URL=https://aiminis.info、再填上 ANTHROPIC_AUTH_TOKEN,工具链就能直接跑起来,不需要改任何 SDK 代码。
这条路径的价值在于:它让你的 Coding Agent 用量、成本、并发全部收敛到同一套配额体系里。
Base URL 不加 /v1 的原因
Anthropic 的 SDK 自己会拼 /v1/messages,所以 base_url 应该填根地址。多加一级 /v1 会变成 /v1/v1/messages,表现为 404。
Anthropic 生态的客户端最舒服的一点,是它们约定了一个不带 /v1 的 Base URL。
工具调用在 Anthropic 侧的表达
Anthropic 用 tool_use 和 tool_result 两种内容块,OpenAI 用 tool_calls 和 tool 消息。转换层必须同时处理工具声明、调用和结果这三样。
因为工具调用涉及结构化参数的生成、解析、聚合和回传,任何一环处理得不严谨,模型就会收到一段语法错误的 JSON,然后开始胡说八道。
所以做工具调用的第一天,不要急着接 Agent 框架,先用最朴素的 curl 把单轮工具调用跑通。
报「不支持的参数」时的判断逻辑
跨协议转换时,temperature、top_p 这类采样参数在某些通道上是不支持的。这类情况应该明确报错,而不是悄悄忽略——否则你会以为参数生效了,其实没有。
然后看是不是被降级了——健康看板里 status 是 degraded 时,响应变慢是预期内的,不是 bug。
脚本要能参数化:Base URL、Key、模型、是否流式。
实操:把 Claude Code 接到你的网关上。
把这几行放进 shell 配置,再开一个终端验证环境变量是否生效。
export ANTHROPIC_BASE_URL="https://aiminis.info"
export ANTHROPIC_AUTH_TOKEN="sk-gw-你的密钥"
# 某些版本读的是 ANTHROPIC_API_KEY,装之前先确认客户端读哪个变量:
# claude --version
# 两个都设上最保险(值相同)。
claude
# 想让 Claude Code 用指定的模型,还要配模型别名映射,
# 让网关把客户端里的短名字映射到实际可用的模型 ID。
几个容易踩的坑
- Anthropic 侧 Base URL 多加了
/v1,请求路径变成/v1/v1/messages。 - 客户端版本读的是
ANTHROPIC_API_KEY,你只设了ANTHROPIC_AUTH_TOKEN。 - 在不支持
temperature的通道上一直传它,结果报参数错误。 - 以为
count_tokens返回的是模型原生 tokenizer 结果,其实可能是本地估算。
小结
网关这层看不见,但它的每一次选择都在影响你的延迟、成本和成功率,值得花点时间打磨。
对具体能力有疑问,可以直接看接入文档 https://aiminis.info/docs/api-integration,里面把 Base URL、鉴权方式和各协议的可选范围都列清楚了。
- 点赞
- 收藏
- 关注作者
评论(0)