Claude Code 中转站接入实战：5分钟打通国内可用链路

上一篇我先把大的框架讲清楚了：不管是 Claude Code、OpenCode、Codex 还是 Gemini CLI，接入中转站时，本质上都在解决同一个问题: 让工具用稳定、可控的链路连上模型服务。

这篇开始进入实操。先写最容易卡住、但也最值得先跑通的一个: Claude Code。

如果你只想要一个结果，那目标很简单：装好 Claude Code，拿到中转站的 API Key，配上 ANTHROPIC_API_KEY 和 ANTHROPIC_BASE_URL，然后用一句测试提示确认它已经能正常返回。

本文我用 Tokenfty 作为演示站点，原因也很直接：控制台路径比较清楚，拿 Key、看接口地址、核对模型支持情况这几步不绕，适合第一次接触中转站的读者先把链路跑通。

Claude Code 接入整体流程

图 1：你不用把这件事想复杂。真正要做的，就是把本地终端、Claude Code 和中转站这条链路接起来。

一、开始前先避开 3 个最常见的坑

正式配之前，先把这 3 件事记住，能少走很多弯路。

1. 不要把站点面板地址和接口地址混为一谈

很多人拿到站点后，先打开控制台，然后顺手把浏览器地址栏里的域名当成 Base URL 配进去。这样最容易出错。

你要找的是接口地址，不是登录面板地址。以 Tokenfty 为例，配置前先在控制台确认清楚：你的 API Key 是哪个，Claude 兼容接口的 Base URL 是哪个，别靠猜。

2. 不要先配永久环境变量

第一次接入，建议先在当前终端窗口临时设置，验证成功之后，再写进 ~/.zshrc、~/.bashrc 或 Windows 系统环境变量。这样一旦配错，回滚成本最低。

3. 看到报错，先别怀疑 Claude Code 本身

接入阶段最常见的问题，基本都集中在 3 个地方：

  • API Key 复制错了
  • ANTHROPIC_BASE_URL 配错了
  • 当前套餐或模型权限不匹配

也就是说，先排接入层，再怀疑工具层，效率会高很多。

二、前置准备：先把 Claude Code 装上

如果你还没装 Claude Code，先把命令装起来。

常见安装方式是通过 npm：

npm install -g @anthropic-ai/claude-code

装完之后，先验证命令是否存在：

claude --help

如果终端能正常输出帮助信息，说明安装基本没问题。这里先别急着登录，也别急着进交互界面，先把中转站链路配好更省事。

三、去中转站拿到这两样东西：Key 和接口地址

接入 Claude Code 时，你真正需要的只是一套最小信息：

  • 一个可用的 API Key
  • 一个正确的 ANTHROPIC_BASE_URL

你可以把 API Key 理解成门禁卡，把 Base URL 理解成“Claude Code 这次请求到底往哪儿发”。两者缺一不可。

如果你用的是 Tokenfty，建议你在控制台里依次确认下面几件事：

  1. 已经创建或复制了一条有效的 API Key
  2. 当前账户或套餐支持 Claude 兼容调用
  3. 控制台里能看到对应的接口地址说明
  4. 至少确认一次模型列表或产品说明里包含 Claude 系列能力

这里有个经验判断：如果一个站点连 Key 在哪儿、接口地址在哪儿、支持哪些模型都写不清楚，那它后面的排错成本通常也不会低。 这也是我这篇直接拿 Tokenfty 做演示对象的原因。

四、核心步骤：配置 Claude Code 的环境变量

Claude Code 走的是 Anthropic 兼容链路，所以最关键的两个变量通常是：

  • ANTHROPIC_API_KEY
  • ANTHROPIC_BASE_URL

下面分系统来写。第一次建议先用临时方式配置，当前窗口验证通过后，再考虑长期生效。

Claude Code 环境变量配置示意

图 2：变量名记住这两个就够了，真正容易错的是值，不是命令本身。

macOS / Linux

export ANTHROPIC_API_KEY="tkfy-替换成你自己的API Key"
export ANTHROPIC_BASE_URL="https://api.tokenfty.net"

如果你确认这套配置可用，后面想长期保存，可以把它追加到 ~/.zshrc 或 ~/.bashrc，然后执行：

source ~/.zshrc

如果你用的是 bash，就改成：

source ~/.bashrc

Windows CMD

set ANTHROPIC_API_KEY=tkfy-替换成你自己的API Key
set ANTHROPIC_BASE_URL=https://api.tokenfty.net

这两条命令只在当前窗口生效，正好适合第一次验证。确认能跑通后，再决定是否写入系统环境变量。

五、启动 Claude Code，先做一次最小验证

变量配好之后，就可以直接启动：

claude

进入交互界面后，先别上来就让它分析整个项目。第一次验证，越简单越好。你可以先丢一句：

请用一句话介绍你自己，并说明你当前是否已经通过 API 提供服务。

如果它能正常返回内容，而且没有出现认证失败、连接超时、模型不存在之类的错误，说明基础链路已经通了。

如果你更喜欢一步到位的测试方式，也可以直接用命令行传一个很短的提示，让它返回一段简单文本。核心目的只有一个：先确认它能稳定收到请求并返回结果。

六、想长期使用，把环境变量固化下来

如果你已经确认这套配置能跑通，那下一步就是让它每次开新终端都自动生效。

macOS / Linux 推荐做法

把下面两行写进你的 shell 配置文件：

export ANTHROPIC_API_KEY="tkfy-替换成你自己的API Key"
export ANTHROPIC_BASE_URL="https://api.tokenfty.net"

然后重新加载配置文件即可。

Windows 推荐做法

先在图形界面里新增用户级环境变量，确认无误后再重开终端。不要第一次就去改系统级变量，尤其是在公司电脑上，没必要把影响面放大。

七、配不通时，先按这个顺序排查

这部分非常重要。很多人明明只配错了一个字符，却能折腾半小时。

Claude Code 排错顺序图

图 3：多数情况下，401、404、超时这些问题，都能在接入层找到原因。

1. 报 401 或认证失败

优先看 API Key：

  • 有没有复制错
  • 有没有多出空格
  • 当前 Key 是否有效
  • 当前套餐是否支持 Claude 相关调用

如果你用的是 Tokenfty，最省事的做法是直接回控制台重新生成或重新复制一遍 Key，再在当前窗口里重新验证一次。

2. 报 404 或模型相关错误

先查 ANTHROPIC_BASE_URL，再查模型权限。

不少人以为 404 一定是接口不存在，其实也可能是你打到了不对的地址，或者当前站点/套餐根本没有开对应模型能力。

3. 一直超时，或者返回非常慢

这类问题通常不是命令写错，而是链路质量或者站点稳定性问题。优先看：

  • 当前网络环境是否稳定
  • 中转站是否有波动
  • 站点是否明确支持流式输出

如果你已经确认 Key 和地址都没问题，但依然频繁超时，那就该考虑是不是当前站点链路不够稳了。

八、这篇给一个最实在的建议

第一次接入 Claude Code，不要一口气做这几件事：

  • 不要同时换多个中转站
  • 不要一上来就配永久变量
  • 不要一上来就用复杂项目做测试

最稳的节奏应该是：

  1. 装好 Claude Code
  2. 以 Tokenfty 这类控制台清晰的站点为例拿到 Key
  3. 临时配置 ANTHROPIC_API_KEY 和 ANTHROPIC_BASE_URL
  4. 用一句最简单的话验证返回
  5. 成功后再做长期配置

你会发现，真正难的不是命令本身，而是很多人第一次上手时把事情做反了。

九、下一篇写什么

Claude Code 这篇先解决的是“先用起来”。下一篇我会继续写 OpenCode，重点会从“环境变量”切到“多模型和配置文件”，因为这类工具的坑不在安装，而在配置层级和模型切换。

如果你在接 Claude Code 时遇到的是 401、404、超时，还是“命令能启动但不出结果”，也可以把问题先按这 3 类记下来。到系列收尾篇，我会把这些高频报错统一做成一份排查清单。