claude code 中转配置全流程:ANTHROPIC_BASE_URL 与 ANTHROPIC_API_KEY 一步到位
摘要
配置 claude code 中转其实只有两个关键动作:把请求地址指向中转节点、把密钥换成中转站发放的 Key。本文提供一份从零到能用的完整教程,覆盖环境变量设置(Windows PowerShell 与 macOS/Linux 两种写法)、验证连通、常见尾部路径坑点。按步骤走完,你就能让 Claude Code 稳定跑在这条通道上。文中以 jiekou.vip 为例说明拿密钥的流程。
第一步:拿到中转站的密钥
配置之前,你需要在中转站注册并生成一个 API Key。以 jiekou.vip 为例,登录后台后在密钥管理里新建一个 Key,复制备用。这个 Key 就是后面 ANTHROPIC_API_KEY 要填的值,请妥善保管,不要提交到 Git 仓库。
同时记下中转站用于 Claude Code 的 Anthropic 原生协议地址。Claude Code 走的是 Anthropic 原生协议,对应的 base_url 是:
https://api.highwayapi.ai/anthropic
注意:base_url 的域名是 api.highwayapi.ai,不是 jiekou.vip。jiekou.vip 是你注册、管理密钥和查用量的门户,实际请求走的是上面这个 API 域名。
第二步:设置环境变量
Claude Code 通过 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 两个环境变量识别请求出口和身份。下面给出两大平台的写法。
macOS / Linux(bash / zsh)
临时设置(当前终端会话有效):
export ANTHROPIC_BASE_URL="https://api.highwayapi.ai/anthropic"export ANTHROPIC_API_KEY="你的中转站密钥"
想永久生效,把上面两行写进 ~/.bashrc 或 ~/.zshrc,然后执行 source ~/.zshrc 重新加载。
Windows PowerShell
临时设置(当前窗口有效):
$env:ANTHROPIC_BASE_URL = "https://api.highwayapi.ai/anthropic"$env:ANTHROPIC_API_KEY = "你的中转站密钥"
想永久生效,用 setx 写入用户环境变量(写完需要重开终端):
setx ANTHROPIC_BASE_URL "https://api.highwayapi.ai/anthropic"setx ANTHROPIC_API_KEY "你的中转站密钥"
第三步:启动并验证
设置好环境变量后,在项目目录里直接运行:
claude
如果配置正确,Claude Code 会正常进入交互界面。随便发一句”你好,介绍下自己”,能得到正常回复就说明这条中转通道已经打通。你也可以让它读一个文件、改一行代码,确认工具调用链路完整。
关于尾部 /v1 的重要提醒
这是新手最容易踩的坑:如果启动后遇到 404,绝大多数情况是 base_url 尾部的路径拼错了。不同工具在拼接请求路径时逻辑不同——有的会自动补 /v1,有的不会。
排查方法很简单:如果当前用 https://api.highwayapi.ai/anthropic 报 404,试着检查 URL 尾部是否多写或少写了 /v1。Claude Code 走 Anthropic 原生协议时,通常直接用到 /anthropic 这一级即可,无需手动再加 /v1。记住原则——404 先看尾部路径,这一步能解决大多数配置期报错。
第四步:把配置固化下来(可选)
如果你在多个项目里都用 Claude Code,建议把环境变量做成永久配置,避免每次开终端重设。团队协作时,可以在 jiekou.vip 后台为不同成员分发独立密钥,既方便按人核算用量,也便于出问题时单独吊销某个 Key,不影响他人。
小结
配置 claude code 中转的核心就三件事:填对 base_url(https://api.highwayapi.ai/anthropic)、换上中转站密钥、遇 404 检查尾部 /v1。两个环境变量搞定,Claude Code 就能稳定跑在这条通道上。密钥的申请和用量管理都在 jiekou.vip 完成,配置一次,长期受用。