Claude Code 国内直连教程:改两个环境变量,支付宝充值直接用(2026)
国内用不了 Claude Code?cocodot 提供 Anthropic 兼容端点,设 ANTHROPIC_BASE_URL + key 两个环境变量就能直连跑真 Claude,支付宝充值、按量计费,逐型号以价格页实时标价为准。附逐步配置、模型代号表、降智自查和常见报错。
1. 国内到底能不能用 Claude Code?
能,而且不需要任何魔改。Claude Code 走 Anthropic 私有接口、需要海外支付,这是国内用户的两道坎;但它官方支持用环境变量 ANTHROPIC_BASE_URL 把请求指向第三方 Anthropic 兼容端点——这是 Anthropic 自己留的标准机制,不是 hack。cocodot 提供这样一个端点,内部把请求转换后调用真正的 Claude(Opus / Sonnet / Haiku / Fable),所以你只需要设两个环境变量,Claude Code 本体原封不动。
2. 先装好 Claude Code:原生安装器、WinGet、npm 三种装法
装法以官方 Advanced setup 页(code.claude.com/docs/en/setup,2026-11-03 核对)为准。系统要求:macOS 13.0+、Windows 10 1809+、Ubuntu 20.04+、Debian 10+ 等,4GB 以上内存,x64 或 ARM64 处理器;同一处还列了所在地一项,范围以 Anthropic 的 supported-countries 页为准。官方写明 npm 包装的是和原生安装器同一个原生程序,几种装法的一个明显差别在更新方式。① 官方原生安装器(官方标为推荐):macOS / Linux / WSL 一条 curl,Windows 分 PowerShell 和 CMD 两条,不需要以管理员身份运行;装好后在后台自动更新。Windows 先看提示符:带 PS 的是 PowerShell,不带的是 CMD —— 按官方说明,报 The token '&&' is not a valid statement separator 是把 CMD 那条贴进了 PowerShell,报 'irm' is not recognized 则相反。官方推荐在原生 Windows 上装 Git for Windows,让 Claude Code 用 Git Bash 执行命令;没装就改用 PowerShell。② WinGet(Windows):一条 winget install 就装完,但官方写明它默认不自动更新,要自己定期跑 winget upgrade;想让 Claude Code 代你跑升级,官方给的开关是环境变量 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1。③ npm:官方要求 Node.js 22 或更高。一个容易误判的细节:Node 偏旧时 npm 只打印 EBADENGINE 警告、不会让安装失败,装完照常能跑 —— 官方的解释是 npm 包下载的原生程序运行时不用你的 Node。别加 sudo(Claude Code 自更新时不带 sudo,要 sudo 才装得上的那份以后不能自动更新);升级用 @latest 重装,别用 npm update -g(它按最初安装时的版本范围走,可能升不到最新)。装完一跑报 Error: claude native binary not installed(Windows 上不出这句,而是 PowerShell / CMD 提示这个文件运行不了),按官方排错页先查这三处:npm --version 是不是 12 开头(npm 12 默认跳过 postinstall,官方给的办法是改用原生安装器,或把 @anthropic-ai/claude-code 加进 npm 的 allow-scripts 后重装,12.0.x 先升到 12.1 以上);安装命令或 .npmrc 里有没有关掉可选依赖(--omit=optional、optional=false);你用的 npm 镜像有没有同步全部 8 个 @anthropic-ai/claude-code-* 平台包 —— 官方写明原生程序只通过可选依赖下发,没有 JS 兜底。当前用的源用 npm config get registry 查,npm 默认源是 https://registry.npmjs.org/。装完自查:开一个新终端窗口(装的那个窗口还是旧 PATH)跑 claude --version,打出版本号才算装上;原生安装器装完却提示找不到 claude 的,官方的解释是安装目录(macOS / Linux 为 ~/.local/bin,Windows 为 %USERPROFILE%\.local\bin)还不在 PATH 里。再跑 claude doctor:它不开会话,只读地输出安装和设置诊断,包括设置文件的校验错误和带修复建议的警告;接口能不能通,以下面配好后实际发一次请求为准。安装命令要是报 syntax error near unexpected token '<' 或 curl: (22) … 403,官方排错页的解释是下载回来的不是安装脚本:403 可能是网络过滤或公司防火墙挡了 downloads.claude.ai,也可能是所在地区不在 Claude Code 的支持范围(报错原文带 App unavailable in region 时,官方给的结论是后者)。可以先用 curl -sI 看下载地址返回的首行状态码,官方以 200 为连上(Windows PowerShell 里写 curl.exe)。接中转:除了下一节的 export 写法(只对当前终端会话生效),也可以把变量写进用户级设置文件 ~/.claude/settings.json(Windows 为 %USERPROFILE%\.claude\settings.json)的 env 里,官方写明不论 claude 从哪里启动都会读到;同一个变量两处都设了,以设置文件里的值为准 —— 用 export 临时换模型却没变,先看这里。几点注意:设置文件是严格 JSON,结尾多一个逗号或写了 // 注释,下次启动会报 Settings Error,保存后跑一次 claude doctor 能看到哪条被拒;已有 settings.json 的把 env 这一段并进去、别整份覆盖;官方提醒 env 里的值以明文存在文件里、会传给 Claude Code 启动的每个子进程,所以 key 别写进项目里的 .claude/settings.json(那个文件是给团队提交进 git 共享的),这份用户级文件也别发给别人;快模型变量官方已把 ANTHROPIC_SMALL_FAST_MODEL 标为 DEPRECATED,新配置用 ANTHROPIC_DEFAULT_HAIKU_MODEL。按官方鉴权优先级,ANTHROPIC_AUTH_TOKEN 排在 ANTHROPIC_API_KEY 和 /login 订阅登录之前:本机登录过订阅的,配好 ANTHROPIC_BASE_URL 和它之后,生效的是这个 token;想切回订阅,把这两个变量从设置文件和 shell 里都删掉,再用 /status 看当前生效的是哪个凭据。官方还写明,Claude 桌面 App 和云端会话不读这些环境变量(桌面 App 另有第三方推理配置的接法,以官方页为准),所以这里按命令行版来装。想直接用官方账号的:官方要求 Pro / Max / Ultra / Team / Enterprise 订阅或 Console 账号,免费版 claude.ai 不含 Claude Code;有用户用 cocodot 的卡在 Anthropic 付款成功过,第一次建议先小额验证,订阅怎么选见 /hub/claude-code。运行中的报错对照见 /hub/claude-code-errors-fix。
# 方式一:官方原生安装器(推荐,后台自动更新)
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell(提示符以 PS 开头)
irm https://claude.ai/install.ps1 | iex
# Windows CMD(提示符不带 PS)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
# 方式二:WinGet(默认不自动更新,升级跑第二条)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode
# 方式三:npm(官方要求 Node.js 22 或更高;不要加 sudo)
node --version
npm --version
npm config get registry
npm install -g @anthropic-ai/claude-code
# 升级用这条,别用 npm update -g
npm install -g @anthropic-ai/claude-code@latest
# 镜像缺平台包时,临时指定 npm 默认源重装
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmjs.org/
# npm 12 报 native binary 时改用上面的原生安装器
# 装完:开一个新终端窗口再跑
claude --version
claude doctor
# 安装脚本报 403 或返回 HTML 时,看下载地址首行状态码(Windows PowerShell 写 curl.exe)
curl -sI https://downloads.claude.ai/claude-code-releases/latest
# 接中转:下面这段不是终端命令,是 ~/.claude/settings.json 的内容
# (Windows 为 %USERPROFILE%\.claude\settings.json;已有文件就把 env 并进去)
{
"env": {
"ANTHROPIC_BASE_URL": "https://cocodot.co/api/ai",
"ANTHROPIC_AUTH_TOKEN": "你的 cocodot key",
"ANTHROPIC_MODEL": "mcs-7",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "mch-1"
}
}
# 保存后再跑一次,确认没有被拒的设置
claude doctor3. 三步跑通
① 注册 cocodot、支付宝充值,在控制台建一个 API Key(以 cocodot- 开头);② 终端里设两个环境变量:export ANTHROPIC_BASE_URL=https://cocodot.co/api/ai 和 export ANTHROPIC_AUTH_TOKEN=你的key;③ 运行 claude,正常用。想固定模型再加两个:export ANTHROPIC_MODEL=mcs-7(主模型)、export ANTHROPIC_DEFAULT_HAIKU_MODEL=mch-1(快模型)。写进 ~/.zshrc 或 ~/.bashrc 就不用每次重设。Windows 用户在 PowerShell 里用 $env:ANTHROPIC_BASE_URL="..." 的写法,或到「系统环境变量」里永久添加。
4. 模型怎么选:主模型 + 快模型
Claude Code 运行时会同时用两个模型:主模型干正经活(读代码、写代码、做计划),快模型干杂活(文件摘要、快速判断)。对应关系见上表:主模型推荐 mcs-7(Claude Sonnet 5.5),写进 ANTHROPIC_MODEL;快模型固定 mch-1(Haiku),写进 ANTHROPIC_DEFAULT_HAIKU_MODEL 即可。中途想换,改环境变量重启 claude 就行——同一个 key 全部通用,不用重新配置。
5. 计费与充值:按量计费、以价格页为准
按 token 计费,Claude / GPT / Gemini 各线挂牌价不超官网,逐型号以价格页实时标价为准。充值支持支付宝 / 微信支付(人民币)、USDT / USDC,到账即变 USD 余额。没有包月套餐,用多少扣多少——这对 Claude Code 用户其实是优点:官方订阅的额度窗口限制(几小时一刷新)在按量模式下不存在,但速率限制仍以服务端返回为准。控制台能看每次调用的 token 和扣费,写代码烧了多少钱一目了然。第一次建议小额充值,跑一个真实任务看延迟和效果,再按用量加。
6. 怕降智?自己验,别猜
走中转时,模型是不是你付费的那个,值得自己用探针验一遍。不要靠感觉判断,用可复现的探针验:probe.cocodot.co 可以协助检查上下文、usage 和模型行为,也欢迎拿来测 cocodot。模型自述或一次回答都不是身份铁证,要结合模型目录、请求 id、usage、能力测试和重复基线判断。对任何第三方检测工具都只用临时、低额度 key,不要放进 URL、截图或公开配置,测完删除。
7. 常见报错排查
① 鉴权失败 / 401:ANTHROPIC_AUTH_TOKEN 是不是完整的 cocodot key、余额是否 > 0;注意变量名是 AUTH_TOKEN 不是 API_KEY。② 连不上 / 超时:ANTHROPIC_BASE_URL 必须正好是 https://cocodot.co/api/ai——末尾不带 /v1,Claude Code 会自己补路径,这是常见的配置错误之一。③ 模型报错:型号写带版本号的官方名(如 claude-sonnet-5-5)或代号(如 mcs-7)都能识别;别只写 opus 这类不带版本的名字,它会落到旧型号。④ 工具调用 / 流式偶发异常:端点目前标记 BETA,我们测过的基础对话、读写文件、跑命令、流式输出正常,遇到边角问题欢迎反馈。
8. 不想直连?还有两条路
按场景选:想在 IDE 里用——同一个 cocodot key 走 OpenAI 兼容端点 https://cocodot.co/api/ai/v1,在 Cursor / Cherry Studio / Cline 里填自定义端点即可调 Claude(模型填 mcs-7);想要官方原版订阅——有用户用 cocodot 的卡在 Anthropic 付款成功过,第一次建议先小额验证。三条路(直连 / IDE / 官订)用的是同一个 cocodot 钱包,不用重复开户。
Claude Code 可用的模型代号
| 代号 | 对应模型 | 定位 | 建议用法 |
|---|---|---|---|
| mco-8 | Claude Opus 5.5 | 多步任务 / 跨文件改动 | 可选主模型 |
| mcs-7 | Claude Sonnet 5.5 | 日常编程 / agent | 推荐主模型(ANTHROPIC_MODEL) |
| mco-6 | Claude Opus 4.8 | 复杂代码 / 重构 | 可选主模型 |
| mcf-1 | Claude Fable 5 | 旗舰 | 可选主模型 |
| mcs-5 | Claude Sonnet 4.6 | 日常主力,更省 | 可选主模型 |
| mch-1 | Claude Haiku 4.5 | 小任务快模型 | 快模型(ANTHROPIC_DEFAULT_HAIKU_MODEL) |