还在为 Claude Code 无法直连、API 配额受限而头疼吗?
Claude Code 作为当前最强的 AI 编程 CLI 工具之一,已经能真正做到“读懂整个项目、直接改代码、生成提交”。但很多人卡在第一步:官方 API 难用、网络受限、模型切换复杂。
本文将手把手教你 通过「神马中转 API」快速接入 Claude Code,从安装、环境变量配置,到模型切换与最小可用示例,5 分钟跑起来,10 分钟上生产,让 Claude Code 真正成为你的本地 AI 编程助手。
Claude Code + API中转站的组合
-
Claude Code:Anthropic 推出的命令行 AI 编程工具(能读懂项目上下文、按自然语言改代码、跑命令、生成测试等)。
-
API 中转站(这里用:神马中转API):用你在神马平台生成的 Token,把 Claude Code 的请求转发到可用模型上;核心就是配置两个东西:
-
ANTHROPIC_AUTH_TOKEN(你的 sk-xxx)
-
ANTHROPIC_BASE_URL(指向神马中转的 BaseURL:api.whatai.cc)
-
安装前准备
必备环境
- Node.js 18+(建议 LTS):Claude Code 通过 npm 安装,Node 版本要够新。
验证是否安装成功(任意系统都适用):
node --version
npm --version
示例里提到 Node 版本通常会在 v18.x.x 以上。
安装Claude Code(通用)
用 npm 全局安装:
npm install -g @anthropic-ai/claude-code
文档与文章都给的是这条命令。
配置:接入「神马中转 API」
第一步:在神马平台生成 Token
去神马中转平台后台创建/复制你的 sk- 开头 Token(文章里也强调 Token 是 sk-xxx 这种格式)。
第二步:设置环境变量(关键)
你需要设置两项(重点就是它俩):
-
ANTHROPIC_AUTH_TOKEN
-
ANTHROPIC_BASE_URL
macOS / Linux(Bash 或 Zsh)
Bash:
echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.bash_profile
echo 'export ANTHROPIC_BASE_URL="https://api.whatai.cc"' >> ~/.bash_profile
source ~/.bash_profile
Zsh:
echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.whatai.cc"' >> ~/.zshrc
source ~/.zshrc
设置后如果不生效,重启终端
Windows(推荐图形化 / PowerShell / CMD)
方法一:图形化(推荐、永久生效)
系统环境变量里新增:
-
ANTHROPIC_AUTH_TOKEN = sk-xxx
-
ANTHROPIC_BASE_URL = api.whatai.cc
方法二:PowerShell(永久)
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxx", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.whatai.cc", "User")
方法三:CMD(永久)
setx ANTHROPIC_AUTH_TOKEN "sk-xxx"
setx ANTHROPIC_BASE_URL "https://api.whatai.cc"
Windows 进阶:用 settings.json 一次性写入(可带模型)
如果你更喜欢“写配置文件”的方式,文档给了路径与示例结构:
C:\Users\{user}\.claude\settings.json
示例(你要把 token 改成自己的):
{
"env": {
"ANTHROPIC_MODEL": "claude-sonnet-4-20250514",
"ANTHROPIC_SMALL_FAST_MODEL": "claude-sonnet-4-20250514",
"ANTHROPIC_BASE_URL": "https://api.whatai.cc",
"ANTHROPIC_AUTH_TOKEN": "sk-xxx"
}
}
启动与最小可用验证
进入你的项目目录,然后启动:
cd your-project-folder
claude
文档就是这么启动的。
首次启动一般会引导你做一些初始化选择(主题、确认提示、信任目录等)。
简单使用:3分钟上手
常用命令(最常用的就这些)
-
claude:进入交互模式
-
claude "task":跑一次性任务
-
claude commit:让它帮你生成/组织 Git 提交
-
/help:查看内置命令
-
/clear:清空对话上下文
-
/review:让它做代码审查
最小示例:让它写个函数
在 claude 交互模式里直接说人话,例如(文档示例):
- “请帮我写一个 Python 函数,用于计算斐波那契数列”
一句话做代码审查
直接单次命令:
claude "review this code for potential bugs"
这是文档给的示例之一。
切换模型(重点:/model)
在 Claude Code 里用:
/model [model id]
文档举例:默认 Sonnet 4,也可以切到 Opus 4:
/model opus
还给了类似 claude-3-7-sonnet-20250219 的切换示例,以及 Kimi K2 的示例(/model moonshotai/kimi-k2-instruct),并说明其他 LLM(OpenAI/Gemini/Qwen/Doubao 等)也能用。
小提醒:不同中转站对“模型名/别名”的支持可能不完全一样
常见坑位
-
Token 要换成你自己的:别把示例 sk-xxx 当真。
-
环境变量改完要重启终端(尤其 Windows / macOS)。
-
建议在具体项目目录下用,Claude Code 才能更好读上下文。
-
文档提到:创建令牌时可考虑选择特定分组(示例里建议“企业分组 官转分组”)。