Claude Code 终端版接入:两个环境变量跑通
Claude Code 终端版接入只需两个环境变量:ANTHROPIC_BASE_URL 指向 https://api.sagelib.com/anthropic(结尾不带 /v1),ANTHROPIC_AUTH_TOKEN 填网关令牌;模型名填模型广场里的模型标识。
更新于 2026-11-14 · SageLib 团队 · 标签:claude-code、cli、anthropic
结论要点
- ANTHROPIC_BASE_URL 不带 /v1,Claude Code 自己会拼 /v1/messages
- 模型必须声明 Anthropic 协议与 /messages 端点
- 接完到控制台「用量日志」确认入口是 /anthropic,才算真的走通
终端版读的是配置文件里的 env 段,改完要重开进程。
写入 settings.json
~/.claude/settings.json(Windows:C:\Users\<你>\.claude\settings.json):
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.sagelib.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "sk-你的网关令牌",
"ANTHROPIC_MODEL": "claude-sonnet-5-5"
}
}
ANTHROPIC_BASE_URL填到/anthropic为止,不要带/v1;ANTHROPIC_AUTH_TOKEN会作为x-api-key发出;ANTHROPIC_MODEL填模型标识(模型广场里的 code),不是你起的显示名。
验证
重开终端跑 claude,发一句话;再到控制台「用量日志」看这条调用,入口应为 /anthropic。
日志里没有记录说明请求没到网关(地址或网络问题),不是模型问题。
三个高频报错
| 现象 | 原因 | 处理 |
|---|---|---|
401 invalid key format / invalid or disabled api key |
令牌填错、被禁用或过期 | 「令牌管理」核对状态与有效期 |
| 404 | Base 漏写 /anthropic,或写成 /anthropic/v1 |
Base 只填到 /anthropic |
does not support the anthropic protocol |
该模型只声明了 OpenAI 协议 | 换支持 /messages 的模型 |
桌面版(截图版)配置见 Claude Code 桌面版。
参考来源
常见问题
Claude Code 能用国产模型吗?
能,前提是该模型在模型详情页声明了 Anthropic 协议与 /messages 端点;只支持 OpenAI 协议的模型直连会返回 does not support the anthropic protocol。
配置改了没生效?
把终端里的 claude 进程完全退出后重开:环境变量在进程启动时读取。