AiTongdao 这是一篇详细教程:从前置环境检查,到一键脚本 / 手动环境变量(多 shell)/ 官方 IDE 扩展三种配置方式,再到 401 / 超时 / model not found 等常见错误逐条排查。只想 30 秒最快装好的看 Claude Code 国内一键接入;想搞懂每一步、能自己排错的,读这篇。AiTongdao把 Anthropic 官方协议代理到国内 ICP 备案域名 ai.aitongdao.com,免翻墙、免海外卡,按 1 RMB ≈ 1 USD 计价。
终端跑 node -v,低于 18 先去 nodejs.org 或用 nvm 升级。Claude Code 本体通过 npm 分发,与模型请求是两条独立链路。
bash / zsh / fish / PowerShell 都支持,区别只是写环境变量的语法(下面方式 2 每种都给了)。Windows 直接用 PowerShell,不需要 WSL。
ai.aitongdao.com 是国内 ICP 备案域名,直连。反而要清掉系统里劫持流量的 HTTP_PROXY / HTTPS_PROXY(常见超时原因)。
邮箱注册 AiTongdao → 充值 → Dashboard 选 Claude Code 卡片,复制那一行命令到终端回车。脚本自动装 Claude Code + 写好 endpoint 和 key,30 秒可用。完整一键路径见 Claude Code 国内一键接入。本页重点是后面的手动方式与排错。
先装 Claude Code:npm install -g @anthropic-ai/claude-code(或 pnpm add -g @anthropic-ai/claude-code),claude --version 验证。装好后不要跑官方登录流程,直接配下面两个变量指向 AiTongdao:
写进 ~/.zshrc 或 ~/.bashrc:
export ANTHROPIC_BASE_URL="https://ai.aitongdao.com"
export ANTHROPIC_AUTH_TOKEN="你的 AiTongdao API key"保存后 source ~/.zshrc(或重开终端)生效,运行 claude。
set -Ux ANTHROPIC_BASE_URL "https://ai.aitongdao.com"
set -Ux ANTHROPIC_AUTH_TOKEN "你的 AiTongdao API key"-Ux 是 universal + export,设一次永久生效,新开 fish 窗口即可用。
setx ANTHROPIC_BASE_URL "https://ai.aitongdao.com"
setx ANTHROPIC_AUTH_TOKEN "你的 AiTongdao API key"setx 写入用户环境变量,必须重开 PowerShell 窗口才加载;当前窗口想立刻用可临时 $env:ANTHROPIC_BASE_URL="https://ai.aitongdao.com"。
在 VS Code 或 JetBrains 系列(IntelliJ / PyCharm / WebStorm 等)的扩展市场搜 Claude Code 安装。这是 Anthropic 官方扩展,不是第三方编辑器。
扩展读取你终端里已配好的 ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN。方式 2 配通后 IDE 扩展不用再配一遍,自动同样走 AiTongdao。
九成是 key 没生效:① ANTHROPIC_AUTH_TOKEN 是否填了 AiTongdao Dashboard 的 key 原文(无多余空格/引号);② echo $ANTHROPIC_AUTH_TOKEN 是否真有值(改了 rc 没重开终端是最常见);③ 是否有旧的 ANTHROPIC_API_KEY 覆盖;④ 账户余额是否 > 0。
确认 ANTHROPIC_BASE_URL 是 https://ai.aitongdao.com 而非默认 api.anthropic.com(后者国内不可达,表现就是超时)。curl https://ai.aitongdao.com 测连通;curl 通但 Claude Code 超时,多半是系统 HTTP_PROXY / HTTPS_PROXY 把请求劫持到了不可用代理,清掉这俩变量。
请求的模型不在当前分组。AiTongdao不命中型号直接报错(不偷换廉价模型)。Dashboard 确认 key 绑定的分组覆盖目标模型,或在 Claude Code 里 /model 切到分组内存在的模型。
npm 全局 bin 不在 PATH。跑 npm config get prefix 看全局目录,把其下 bin 加进 PATH;或用 pnpm add -g 重装并确保 pnpm 全局 bin 已 setup。
每天高强度跑 Claude Code 的,用 ccmax 分组(等价官方 Claude Max 订阅,满血资源池 + 超高缓存命中),倍率 2.5x;日常用量走 claude 分组按量计费 · 折合官方约 1 折。两个分组共用同一账户余额。倍率即官方折扣,不要再 × 汇率。
Anthropic 的 prompt caching(cache_control)直通,Claude Code 长上下文重复读同一批文件时自动命中缓存,Dashboard 计费区分 cached / fresh input,享受官方缓存折扣后再按分组倍率结算。
三步:在 aitongdao.com 邮箱注册并充值 → Dashboard 拿到 API key 和 https://ai.aitongdao.com endpoint → 在终端给 Claude Code 配置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 两个环境变量。最快是用 Dashboard 给的一键脚本,自动装 Node 依赖 + 写好配置;想完全手动也可以,本教程后面有 bash / zsh / fish / PowerShell 各 shell 的写法。全程不需要翻墙、不需要 Anthropic 账号、不需要海外信用卡。
Claude Code 依赖 Node.js 18 及以上(建议 20 LTS),用 node -v 检查;包管理器 npm 或 pnpm 任一即可。终端 shell 任意(bash / zsh / fish / PowerShell 都支持,只是写环境变量的语法不同)。网络方面:配置好 AiTongdao endpoint 后不需要任何代理或 VPN,ai.aitongdao.com 是国内 ICP 备案域名直连。Windows 用户可直接用 PowerShell,无需 WSL。
官方安装命令是 npm install -g @anthropic-ai/claude-code(或用 pnpm add -g)。装完用 claude --version 验证。如果 npm 全局安装在国内慢,可以先把 npm registry 换成国内镜像再装;Claude Code 本体下载走 npm,与模型请求是两条独立链路,模型请求才走 AiTongdao endpoint。装好后不要运行官方登录流程,直接按本教程配环境变量指向 AiTongdao。
两个变量:ANTHROPIC_BASE_URL 设为 https://ai.aitongdao.com,ANTHROPIC_AUTH_TOKEN 设为 AiTongdao 的 API key。bash/zsh 写进 ~/.bashrc 或 ~/.zshrc:export ANTHROPIC_BASE_URL="..." 和 export ANTHROPIC_AUTH_TOKEN="..."。fish 用 set -Ux ANTHROPIC_BASE_URL "..."。Windows PowerShell 用 setx ANTHROPIC_BASE_URL "..." 然后重开终端。配完 source 一下配置文件或重开终端,运行 claude 即生效。
Claude Code 官方提供 VS Code 和 JetBrains 系列(IntelliJ / PyCharm / WebStorm 等)的扩展,在编辑器扩展市场搜 "Claude Code" 安装即可。扩展会复用你终端里已配好的 ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN 环境变量,所以只要终端那套配置指向 AiTongdao 跑通了,IDE 扩展自动同样走 AiTongdao,不用在 IDE 里再配一遍。
401 基本是 key 或 token 变量没生效:① 确认 ANTHROPIC_AUTH_TOKEN 填的是 AiTongdao Dashboard 的 API key 原文,没有多余空格或引号;② 确认环境变量真的加载了(echo $ANTHROPIC_AUTH_TOKEN 看有没有值),很多时候是改了 rc 文件但没重开终端;③ 确认没有同时设置 ANTHROPIC_API_KEY 之类的旧变量覆盖;④ 确认账户余额 > 0。改完一定重开终端或 source 配置再试。
先确认 ANTHROPIC_BASE_URL 指向的是 https://ai.aitongdao.com 而不是默认的 api.anthropic.com —— 后者在国内不可达,会表现为超时。用 curl https://ai.aitongdao.com 测连通;如果 curl 通而 Claude Code 超时,检查是否有系统级 HTTP_PROXY / HTTPS_PROXY 环境变量把请求劫持到了不可用的代理(国内直连 AiTongdao 反而要清掉这些代理变量)。
说明请求的模型名不在你当前分组里。AiTongdao请求不命中型号会直接报错而不是偷换廉价模型。解决:在 Dashboard 确认 key 绑定的分组覆盖你要的 Claude 模型(Opus / Sonnet / Haiku 全系在 claude 分组,Claude Code 重度用户走 ccmax 分组);或在 Claude Code 里用 /model 切到分组内确实存在的模型名。模型清单以 Dashboard 实时为准。
AiTongdao按 1 RMB ≈ 1 USD 计价,倍率即真实折扣(不要再 × 汇率那样会算贵)。日常用 claude 分组按量计费;每天高强度跑 Claude Code 的重度用户用 ccmax 分组(等价官方 Claude Max 订阅,满血资源池 + 超高缓存命中),两个分组共用同一账户余额。具体倍率和折扣以 价格页实时数据为准,微信支付宝充值,余额永不过期。
AiTongdao按 1 RMB ≈ 1 USD 计价 —— 倍率就是官方折扣,不要再 × 汇率(那样会算贵)。当前实时汇率 1 USD ≈ 6.81 RMB:
只想最快装好不看教程,走 Claude Code 国内一键接入;要 Claude 的纯 API(非 Claude Code)见 Claude API 国内直连。