Claude Code
快速开始
本指南将帮助你在几分钟内通过 MaomaoToken 使用 Claude Code。
1. 安装 Claude Code
本地安装
curl -fsSL https://claude.ai/install.sh | bashirm https://claude.ai/install.ps1 | iex使用 npm 安装
npm install -g @anthropic-ai/claude-code懒人提示
以下方法主要介绍手动配置方式,不想手动配置的我们推荐使用 CC Switch 配置 Claude Code 路由,用更便捷的方式用 MaomaoToken 的 API 接入。
具体可查看:CC Switch 配置 Claude CLI
2. 配置 MaomaoToken API
要通过兼容 Anthropic API 的方式接入 MaomaoToken 的模型服务,需要配置以下三个环境变量:
ANTHROPIC_BASE_URL设置为https://api.maomaotoken.comANTHROPIC_AUTH_TOKEN设置为你在 MaomaoToken 控制台 获取的 API KeyANTHROPIC_MODEL设置为支持的 Claude 模型,例如claude-sonnet-4-5
注意
YOUR_API_KEY 只是占位符,请替换成你自己的真实 Key(通常以 sk- 开头)。如果原样写入,Claude Code 会把它当成真正的 Key,并返回 401 invalid key。
- 在终端中执行以下命令,查看默认 Shell 类型:
echo $SHELL- 根据 Shell 类型设置环境变量:
echo 'export ANTHROPIC_BASE_URL="https://api.maomaotoken.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-4-5"' >> ~/.zshrc
source ~/.zshrcecho 'export ANTHROPIC_BASE_URL="https://api.maomaotoken.com"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"' >> ~/.bash_profile
echo 'export ANTHROPIC_MODEL="claude-sonnet-4-5"' >> ~/.bash_profile
source ~/.bash_profile- 验证环境变量是否生效:
echo $ANTHROPIC_BASE_URL
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"
echo $ANTHROPIC_MODELsetx ANTHROPIC_AUTH_TOKEN "YOUR_API_KEY"
setx ANTHROPIC_BASE_URL "https://api.maomaotoken.com"
setx ANTHROPIC_MODEL "claude-sonnet-4-5"打开新窗口验证:
if defined ANTHROPIC_AUTH_TOKEN echo ANTHROPIC_AUTH_TOKEN is set
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.maomaotoken.com", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-5", [EnvironmentVariableTarget]::User)打开新窗口验证:
if ($env:ANTHROPIC_AUTH_TOKEN) { "ANTHROPIC_AUTH_TOKEN is set" }
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL说明
如果你准备通过 CC Switch 管理 Claude Code,建议不要再额外设置全局 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、ANTHROPIC_MODEL。系统或用户环境变量可能覆盖 CC Switch 写入的 Provider 配置,导致界面里选择了正确 Provider,但 Claude Code 实际仍使用旧 Key 或旧模型。
3. 验证配置是否生效
先用一次最小请求确认 Key、模型和接口都可用,再启动长会话:
curl https://api.maomaotoken.com/v1/messages \
-H "content-type: application/json" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 16,
"messages": [{"role": "user", "content": "1+1, output only the answer"}]
}'curl.exe https://api.maomaotoken.com/v1/messages `
-H "content-type: application/json" `
-H "anthropic-version: 2023-06-01" `
-H "x-api-key: $env:ANTHROPIC_AUTH_TOKEN" `
-d "{\"model\":\"claude-sonnet-4-5\",\"max_tokens\":16,\"messages\":[{\"role\":\"user\",\"content\":\"1+1, output only the answer\"}]}"返回 200 且内容为 2,说明 Key 与模型可用。随后运行:
claude -p "1+1, output only the answer" --model claude-sonnet-4-5返回 2 即表示 Claude Code 端到端配置成功。
4. 开始使用
进入你的工作目录,运行 claude 命令:
cd /path/your-project
claude如果启动后看到 Not logged in · Please run /login,通常是 Claude Code 没有读取到可用配置,或首次引导尚未完成。确认最小请求返回 2 后,如仍进入登录流程,可按以下步骤跳过首次引导:
- macOS / Linux:
~/.claude.json - Windows:
C:\Users\%USERNAME%\.claude.json
{
"hasCompletedOnboarding": true
}- 保存文件,重新运行
claude。
(可选)更多模型配置方式
Claude Code 支持以下模型配置方式,按优先级从高到低排列:
- 对话期间:执行
/model <模型名称>临时切换
/model claude-sonnet-4-5- 启动时指定:
claude --model <模型名称> - 环境变量:按任务复杂度分配不同模型
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"- settings.json 永久配置:写入
~/.claude/settings.json(Windows 为C:\Users\%USERNAME%\.claude\settings.json)
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_BASE_URL": "https://api.maomaotoken.com",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5",
"ANTHROPIC_MODEL": "claude-sonnet-4-5"
},
"model": "claude-sonnet-4-5"
}- 在预设列表中选择「MaomaoToken」(或手动填写 Base URL
https://api.maomaotoken.com) - 在「API Key」栏填写你的真实密钥
- 使用
claude-sonnet-4-5作为初始模型 ID,点击「添加」保存 - 健康检查通过后,返回首页选择 MaomaoToken,点击「启动」即可
注意
如果 CC Switch 提示「检测到系统环境变量冲突」,请优先清理 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、ANTHROPIC_MODEL 这三个全局变量,它们会覆盖 CC Switch 写入的 Provider 配置。
常见问题
提示 401 认证错误怎么办?
No token provided:没有传入 Key,检查ANTHROPIC_AUTH_TOKEN是否配置invalid key: YOUR_API_KEY:占位符原样写入了,请到 MaomaoToken 控制台 复制真实 Keythis key is not enabled:Key 未启用、已过期或没有额度,在控制台检查
Windows 上还需检查全局环境变量是否保留了旧值:
[Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User")
[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")
[Environment]::GetEnvironmentVariable("ANTHROPIC_MODEL", "User")提示 400 Incorrect model ID 怎么办?
模型 ID 不正确或当前 Key 没有调用该模型的权限。请在 MaomaoToken 控制台的模型列表中重新复制完整模型 ID,确认拼写和大小写无误。
macOS 安装后提示 zsh: command not found: claude
Claude CLI 已安装,但可执行目录未加入 PATH。
确认安装位置:
ls -l ~/.claude/bin
ls -l ~/.local/bin | grep claude找到 claude 文件后,将对应目录加入 PATH:
# 安装在 ~/.claude/bin
echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
# 安装在 ~/.local/bin
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc验证:which claude 和 claude -v 能正常输出即可。
升级后无法连接或认证失败
新版本要求将请求头由 ANTHROPIC_API_KEY 改为 ANTHROPIC_AUTH_TOKEN,Key 的值不变,仅需更新变量名称并重新加载配置。