图灵 APIAI 大模型 API 中转站

首页 / 客户端配置 / Claude Code

Claude Code 接入图灵 API

Claude Code 是 Anthropic 的命令行编程工具。接入图灵 API 只需要设置两个环境变量,两分钟就能在终端里跑通,不涉及改动任何代码。

Anthropic 协议 命令行 / 终端 macOS · Linux · Windows

配置速查

只想快点跑通的话,看这一张表就够了。下面的章节是给卡住的时候用的。

配置项填什么容易错在哪
ANTHROPIC_BASE_URL https://turingapi.space 不要带 /v1,带了会 404
ANTHROPIC_AUTH_TOKEN 控制台创建的 sk- 密钥 变量名别写成 ANTHROPIC_API_KEY
ANTHROPIC_MODEL 模型名,从 模型列表 复制 拼错会提示 model not found
为什么地址不带 /v1:Claude Code 走的是 Anthropic Messages 协议,它会自己往地址后面拼 /v1/messages。你填 https://turingapi.space,最终请求的是 https://turingapi.space/v1/messages——这正是对的。如果你填了带 /v1 的地址,实际请求就变成 /v1/v1/messages,返回 404。

前置准备

如果已经装好 Claude Code 并有密钥,直接跳到下一步。

1
注册并创建密钥

在 注册页 用邮箱建账号,登录后进控制台「API Keys」新建一把。密钥只显示一次,创建后立刻复制保存到本地。

2
确认 Claude Code 已安装

终端里运行 claude --version 能看到版本号即可。没有安装的话按 Anthropic 官方文档装好再来。

3
准备好要用的模型名

打开 模型列表,挑一个支持工具调用的模型。Claude Code 要读写文件、执行命令,不支持 tools 的模型会在中途卡住。

配置步骤

下面三种写法选一种。临时适合先验证;写入配置文件适合长期使用,推荐。

方式一:临时设置 先试一下

  1. 在终端里执行下面三行
  2. 重开一个终端窗口(这一步很关键,旧窗口读不到新变量)
  3. 运行 claude 发一条消息验证
export ANTHROPIC_BASE_URL="https://turingapi.space"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
export ANTHROPIC_MODEL="模型名"

关掉终端就失效。只想快速验证能不能通,用这个最快。

方式二:写入 shell 配置 推荐

  1. 打开 ~/.zshrc(macOS 新版本)或 ~/.bashrc(Linux)
  2. 把三行变量追加到文件末尾
  3. 执行 source ~/.zshrc 让它立即生效
# 图灵 API
export ANTHROPIC_BASE_URL="https://turingapi.space"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
export ANTHROPIC_MODEL="模型名"

每次开终端自动生效,不用重复粘贴。

方式三:Windows PowerShell

  1. 当前窗口临时生效:用 $env: 前缀
  2. 长期生效:用 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 用中文回答 小技巧

  1. 编辑 ~/.claude/CLAUDE.md(没有就新建)
  2. 写一句语言偏好
请始终使用简体中文与我对话,
包括解释、注释和提交信息。

这个文件是 Claude Code 的项目级记忆,每次启动都会读,比每次口头要求省事。

验证是否配置成功

看到这些就说明通了

  1. claude --version 正常输出版本号
  2. 进入 Claude Code 后随便问一句,能流式逐字返回
  3. 回到控制台「用量」页,能看到刚才这次调用的记录和 token 数

第三条最可靠:用量页有记录,说明请求真的打到了图灵 API,而不是走了别处。

确认变量到底生效了没

  1. macOS / Linux:echo $ANTHROPIC_BASE_URL
  2. Windows:echo $env:ANTHROPIC_BASE_URL
  3. 输出应该是 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 里,用文字约定模型偏好和回答语言;地址和密钥这类连接信息不要写进项目仓库,避免误提交。

相关客户端

还没密钥?注册后直接创建一个 邮箱注册即用,控制台自助创建密钥、查看用量与余额。
免费注册 →

接入过程卡住了?到 QQ 群 1128182538 说明「客户端 + 报错码 + 时间点」,比只说"用不了"好排查得多。其他通用问题见 常见问题。