Claude Code 国内配置教程:通过中转站接入的完整流程
摘要不少开发者体验完 Claude Code 的免费额度后想继续使用却卡在网络可达性和支付门槛上。本文给出一条相对省心的路径通过中转站把 Claude Code 接入国内可达的地址跳过海外支付和网络配置的麻烦。教程含完整命令、常见报错排查和跨平台配置。一、为什么国内使用 Claude Code 需要中转Anthropic 官方的免费额度对国内开发者来说门槛不低注册通常需要海外手机号 / 邮箱。免费额度跑几次 Opus 的 Agent 任务就会用完。国内网络环境下直连经常返回 403。用一个国内可达的中转地址可以绕开这几点。这里以 jiekou.vip 为例演示配置流程其他兼容 Anthropic 协议的中转同理。二、配置流程macOS / Linux步骤 1安装 Claude Codenpminstall-ganthropic-ai/claude-code或使用 Anthropic 官方的安装脚本。步骤 2拿到中转的 base_url 和 key在中转平台控制台创建一个 API Key形如sk-xxx并记下它提供的 Anthropic 协议 base_url。步骤 3设置环境变量exportANTHROPIC_BASE_URLhttps://api.highwayapi.ai/anthropicexportANTHROPIC_API_KEYsk-xxx可写入~/.bashrc、~/.zshrc或放到项目根目录的.env。步骤 4运行 Claude Codeclaude第一次启动会让你选择模型常用的是主力claude-sonnet-4-6关键任务claude-opus-4-8三、Windows 配置打开 PowerShell$env:ANTHROPIC_BASE_URLhttps://api.highwayapi.ai/anthropic$env:ANTHROPIC_API_KEYsk-xxxclaude也可以用系统环境变量设置右键此电脑 → 属性 → 高级系统设置 → 环境变量 → 新建两条。四、常见报错排查报错 1401 Unauthorized原因key 写错或复制时多了空格。重新从控制台复制 key。报错 2Anthropic-Version header missing原因Claude Code 版本太老。用npm update -g anthropic-ai/claude-code升级。报错 3Connection refused原因网络层问题。用curl测试 base_url 是否可达。报错 4model_not_found原因model 名写错。确认所用中转控制台里支持的型号名称。五、把环境变量写入项目如果只想给某个项目用不污染全局环境可以在项目根目录建一个.env.localANTHROPIC_BASE_URLhttps://api.highwayapi.ai/anthropic ANTHROPIC_API_KEYsk-xxx然后用direnv或dotenv自动加载。六、与 Cursor 共用同一个 keyClaude Code 用的是 Anthropic 原生协议的 base_url.../anthropicCursor 用的是 OpenAI 兼容协议的 base_url.../openai。两者可以共用同一个 key余额和计费汇总在一起。七、配置完后跑一个真实任务cd~/your-project claude进入交互式 shell 后输入帮我把 src/i18n.ts 里的所有硬编码中文抽到 locales/zh-CN.jsonClaude Code 会自动读相关文件、生成新 locales、改 src/i18n.ts整个过程不需要额外的网络配置。八、成本参考Claude Code 的费用取决于任务的 token 消耗和所选模型。Opus 单价高于 Sonnet日常开发用 Sonnet、关键任务再切 Opus 是比较经济的做法。具体价格以所用平台的计费页为准。九、直连免费版 vs 中转的差异维度免费版直连中转接入国内可达性不稳定稳定支付门槛需海外卡人民币充值额度持续性用完即停按量充值多模型切换受免费额度限制自由切换团队管理无子账号体系十、写在最后配置好中转后Claude Code 在国内的使用就顺畅多了。下一篇会走一遍 Cursor 在国内的完整配置流程。