cocodot
← 返回教程
国内卡付不了海外 AI?cocodot 一张卡 + 一个 Key 搞定
接入更新于 2026-11-03

Claude Code 国内直连教程:改两个环境变量,支付宝充值直接用(2026)

国内用不了 Claude Code?cocodot 提供 Anthropic 兼容端点,设 ANTHROPIC_BASE_URL + key 两个环境变量就能直连跑真 Claude,支付宝充值、按量计费,逐型号以价格页实时标价为准。附逐步配置、模型代号表、降智自查和常见报错。

一句话结论:Claude Code 是 2026 年开发者圈最主流的终端 AI 编程智能体,但官方需要海外支付,国内直接用不了。最快的合规路径是它官方支持的环境变量机制:Claude Code 允许用 ANTHROPIC_BASE_URL 把请求指向第三方 Anthropic 兼容端点,cocodot 提供这样的端点,内部调用真正的 Claude 系列模型。配置只要两步:export ANTHROPIC_BASE_URL=https://cocodot.co/api/ai,export ANTHROPIC_AUTH_TOKEN=你的 cocodot key,然后正常运行 claude 命令即可。充值支持支付宝 / 微信支付(人民币)、USDT / USDC,按 token 量计费,Claude / GPT / Gemini 各线挂牌价不超官网,逐型号以价格页实时标价为准。模型是不是你付费的那个,值得自己用开源探针 probe.cocodot.co 验一遍——包括验我们。注册验证邮箱送 $0.5,可以先把链路跑通(体验额度限便宜模型,跑 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 doctor

3. 三步跑通

① 注册 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-8Claude Opus 5.5多步任务 / 跨文件改动可选主模型
mcs-7Claude Sonnet 5.5日常编程 / agent推荐主模型(ANTHROPIC_MODEL)
mco-6Claude Opus 4.8复杂代码 / 重构可选主模型
mcf-1Claude Fable 5旗舰可选主模型
mcs-5Claude Sonnet 4.6日常主力,更省可选主模型
mch-1Claude Haiku 4.5小任务快模型快模型(ANTHROPIC_DEFAULT_HAIKU_MODEL)

常见问题

和官方 Claude Pro / Max 订阅比,哪个划算?

看用法。官方订阅是固定月费 + 额度窗口(几小时刷新一次,重度使用会撞墙);直连是按量计费、无窗口限制。轻度用户订阅省心;每天长时间跑 Claude Code 的重度用户,成本跟真实用量走。

怎么确认没有被降智?

用开源工具 probe.cocodot.co 对端点跑一遍探针(上下文长度、tokenizer、模型自述等六项),几分钟出结果。我们把工具开源就是欢迎互相验证——对我们也一样适用。

我的代码会被存下来吗?

cocodot 是通道:请求转换后直达模型方,我们不存储你的对话与代码内容,控制台流水只记 token 用量和扣费,不记内容。对数据敏感的场景,建议再配合公司自己的脱敏规范使用。

体验额度能跑 Claude Code 吗?

注册送的 $0.5 限便宜模型,用来验证链路通不通(配置对不对、延迟如何)足够;真正跑 Claude 主模型需要小额充值。先验链路再充钱,顺序是对的。

余额用完了正在跑的任务会怎样?

预付余额不等于硬上限:余额用尽时,已经发出的请求仍可能计费,以账单为准。余额不足时新请求会被拒绝,Claude Code 会报错停下。控制台充值到账后重跑即可。建议长任务前看一眼余额。

Windows 下环境变量怎么设?

PowerShell 临时:$env:ANTHROPIC_BASE_URL="https://cocodot.co/api/ai" 和 $env:ANTHROPIC_AUTH_TOKEN="你的key";永久:系统设置 → 环境变量里添加同名两项,重开终端生效。

关于 cocodot

cocodot 是面向中国大陆开发者与出海团队的支付与 AI 接入服务:由持牌机构发行的美国卡段虚拟卡(用于在海外网站完成订阅与广告扣费),以及 OpenAI 兼容的 AI API 中转(在中国大陆直连调用 Claude、GPT、Gemini)。两者共用同一个钱包,支持支付宝 / 微信支付(人民币)、USDT / USDC 充值、以美元记账。卡费率:开卡 $9.9、充值到卡 3%、每张活跃卡每月 $1;消费:单笔 <$20 收 $0.60 结算费;发卡方按笔收费时另收相应费用。

服务范围、价格与能力边界 →