配置速查
只想快点跑通的话,看这一张表就够了。下面的章节是给卡住的时候用的。
| 配置项 | 填什么 | 容易错在哪 |
|---|---|---|
ANTHROPIC_BASE_URL |
https://turingapi.space |
不要带 /v1,带了会 404 |
ANTHROPIC_AUTH_TOKEN |
控制台创建的 sk- 密钥 |
变量名别写成 ANTHROPIC_API_KEY |
ANTHROPIC_MODEL |
模型名,从 模型列表 复制 | 拼错会提示 model not found |
/v1/messages。你填 https://turingapi.space,最终请求的是 https://turingapi.space/v1/messages——这正是对的。如果你填了带 /v1 的地址,实际请求就变成 /v1/v1/messages,返回 404。
前置准备
如果已经装好 Claude Code 并有密钥,直接跳到下一步。
在 注册页 用邮箱建账号,登录后进控制台「API Keys」新建一把。密钥只显示一次,创建后立刻复制保存到本地。
终端里运行 claude --version 能看到版本号即可。没有安装的话按 Anthropic 官方文档装好再来。
打开 模型列表,挑一个支持工具调用的模型。Claude Code 要读写文件、执行命令,不支持 tools 的模型会在中途卡住。
配置步骤
下面三种写法选一种。临时适合先验证;写入配置文件适合长期使用,推荐。
方式一:临时设置 先试一下
- 在终端里执行下面三行
- 重开一个终端窗口(这一步很关键,旧窗口读不到新变量)
- 运行
claude发一条消息验证
export ANTHROPIC_BASE_URL="https://turingapi.space"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
export ANTHROPIC_MODEL="模型名"
关掉终端就失效。只想快速验证能不能通,用这个最快。
方式二:写入 shell 配置 推荐
- 打开
~/.zshrc(macOS 新版本)或~/.bashrc(Linux) - 把三行变量追加到文件末尾
- 执行
source ~/.zshrc让它立即生效
# 图灵 API
export ANTHROPIC_BASE_URL="https://turingapi.space"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
export ANTHROPIC_MODEL="模型名"
每次开终端自动生效,不用重复粘贴。
方式三:Windows PowerShell
- 当前窗口临时生效:用
$env:前缀 - 长期生效:用
setx,然后重开终端
# 仅当前窗口
$env:ANTHROPIC_BASE_URL="https://turingapi.space"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
# 长期生效(重开终端后可用)
setx ANTHROPIC_BASE_URL "https://turingapi.space"
setx ANTHROPIC_AUTH_TOKEN "sk-你的密钥"
CMD 里用 set 而不是 $env:。两者不要混用。
可选:让 Claude Code 用中文回答 小技巧
- 编辑
~/.claude/CLAUDE.md(没有就新建) - 写一句语言偏好
请始终使用简体中文与我对话,
包括解释、注释和提交信息。
这个文件是 Claude Code 的项目级记忆,每次启动都会读,比每次口头要求省事。
验证是否配置成功
看到这些就说明通了
claude --version正常输出版本号- 进入 Claude Code 后随便问一句,能流式逐字返回
- 回到控制台「用量」页,能看到刚才这次调用的记录和 token 数
第三条最可靠:用量页有记录,说明请求真的打到了图灵 API,而不是走了别处。
确认变量到底生效了没
- macOS / Linux:
echo $ANTHROPIC_BASE_URL - Windows:
echo $env:ANTHROPIC_BASE_URL - 输出应该是
https://turingapi.space,末尾没有/v1
echo $ANTHROPIC_BASE_URL
# https://turingapi.space
输出为空 = 变量没设上。多半是改完没重开终端,或者写到了别的 shell 配置文件里。
常见问题
Claude Code 接第三方接口时,90% 的问题集中在下面这几条。
报 404,提示 Not Found 或接口不存在
几乎一定是 ANTHROPIC_BASE_URL 多写了 /v1。
Claude Code 会自己拼 /v1/messages,你填 https://turingapi.space/v1 之后,实际请求变成 /v1/v1/messages,自然 404。改成不带 /v1 的写法即可。
报 401,提示未授权或鉴权失败
先查变量名,这是最常见的坑。走第三方网关时用的是 ANTHROPIC_AUTH_TOKEN;如果你设成了 ANTHROPIC_API_KEY,部分客户端版本会用另一套请求头发送,网关认不出来。
再查变量是否在当前终端生效——用上面的 echo 命令验证。最后到控制台确认这把密钥没被删除或禁用。
报 403,提示被拒绝
通常有两种原因:账户余额不足,或者这把密钥没有该协议的授权。
先看余额,再看密钥设置。余额充上后立刻恢复,不需要重启 Claude Code。
报 502 或连接超时
一般是上游线路临时异常,或你所在的模型分组没有这个模型的权限。
换一个模型重试,通常立刻恢复。如果同一模型持续 502,把模型名和时间点发到 QQ 群 1128182538,比反复重试有用。
报 model not found 或 unknown model
ANTHROPIC_MODEL 的值和站内实际模型名不一致。模型名区分大小写和连字符,别手打。
直接从 模型列表 复制,或调控制台的模型接口拉一次完整列表比对。
变量设了,但重启终端又没了
用了 export 只对当前会话有效。要长期生效,必须写进 ~/.zshrc / ~/.bashrc 并 source 一次,或用 Windows 的 setx。
另一种情况:写进了 ~/.bashrc,但你用的是 zsh。两个文件不通用。
本机开了代理,会不会有影响
会。如果环境里设了 HTTPS_PROXY,Claude Code 的请求会先走代理。代理线路不稳或规则不匹配时,表现为超时或 502,看起来像接口挂了。
排查时临时取消代理变量再试一次;确认是代理问题的话,把域名加进 NO_PROXY 直连。
Claude Code 中途卡住不动,也不报错
八成是模型不支持函数调用(tools)。Claude Code 靠工具读写文件、执行命令,模型不支持 tools 时不会报错,而是在那一步静默停住。
换一个支持 tools 的模型。选模型时优先看模型列表里的工具调用标记。
能不能同时保留官方账号和这里
可以,但环境变量是全局的,同一时间只能指向一个地址。常见做法是写两个 shell 函数,需要切换时调用对应的那个,而不是手工改配置文件。
注意:切换后如果行为异常,先 echo 确认变量,别直接怀疑接口。
想让 Claude Code 只对某个项目生效
环境变量本身是全局的。项目级的差异建议放在该项目的 CLAUDE.md 里,用文字约定模型偏好和回答语言;地址和密钥这类连接信息不要写进项目仓库,避免误提交。
相关客户端
2Codex CLI
走 Responses 协议,wire_api 填错会被直接拒绝
3Cursor
需要手动添加模型名,不会自动拉列表
4Cline / Roo Code
靠 tools 读写文件,模型要选对
5Cherry Studio
桌面聊天客户端,图形界面配置
接入过程卡住了?到 QQ 群 1128182538 说明「客户端 + 报错码 + 时间点」,比只说"用不了"好排查得多。其他通用问题见 常见问题。