MaoMaoToken 文档

Claude Code

快速开始

本指南将帮助你在几分钟内通过 MaomaoToken 使用 Claude Code。

1. 安装 Claude Code

本地安装

curl -fsSL https://claude.ai/install.sh | bash

使用 npm 安装

需要 Node.js 18 或更高版本

npm install -g @anthropic-ai/claude-code

懒人提示

以下方法主要介绍手动配置方式,不想手动配置的我们推荐使用 CC Switch 配置 Claude Code 路由,用更便捷的方式用 MaomaoToken 的 API 接入。

具体可查看:CC Switch 配置 Claude CLI

2. 配置 MaomaoToken API

要通过兼容 Anthropic API 的方式接入 MaomaoToken 的模型服务,需要配置以下三个环境变量:

  1. ANTHROPIC_BASE_URL 设置为 https://api.maomaotoken.com
  2. ANTHROPIC_AUTH_TOKEN 设置为你在 MaomaoToken 控制台 获取的 API Key
  3. ANTHROPIC_MODEL 设置为支持的 Claude 模型,例如 claude-sonnet-4-5

注意

YOUR_API_KEY 只是占位符,请替换成你自己的真实 Key(通常以 sk- 开头)。如果原样写入,Claude Code 会把它当成真正的 Key,并返回 401 invalid key

  1. 在终端中执行以下命令,查看默认 Shell 类型:
echo $SHELL
  1. 根据 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 ~/.zshrc
  1. 验证环境变量是否生效:
echo $ANTHROPIC_BASE_URL
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"
echo $ANTHROPIC_MODEL

说明

如果你准备通过 CC Switch 管理 Claude Code,建议不要再额外设置全局 ANTHROPIC_AUTH_TOKENANTHROPIC_BASE_URLANTHROPIC_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"}]
  }'

返回 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 后,如仍进入登录流程,可按以下步骤跳过首次引导:

第一步:找到用户主目录下的 .claude.json:
  • macOS / Linux:~/.claude.json
  • Windows:C:\Users\%USERNAME%\.claude.json
第二步:将 hasCompletedOnboarding 设置为 true
{
  "hasCompletedOnboarding": true
}
第三步:保存
  1. 保存文件,重新运行 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"
}
  1. 在预设列表中选择「MaomaoToken」(或手动填写 Base URL https://api.maomaotoken.com
  2. 在「API Key」栏填写你的真实密钥
  3. 使用 claude-sonnet-4-5 作为初始模型 ID,点击「添加」保存
  4. 健康检查通过后,返回首页选择 MaomaoToken,点击「启动」即可

注意

如果 CC Switch 提示「检测到系统环境变量冲突」,请优先清理 ANTHROPIC_AUTH_TOKENANTHROPIC_BASE_URLANTHROPIC_MODEL 这三个全局变量,它们会覆盖 CC Switch 写入的 Provider 配置。


常见问题

提示 401 认证错误怎么办?

  • No token provided:没有传入 Key,检查 ANTHROPIC_AUTH_TOKEN 是否配置
  • invalid key: YOUR_API_KEY:占位符原样写入了,请到 MaomaoToken 控制台 复制真实 Key
  • this 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 claudeclaude -v 能正常输出即可。

升级后无法连接或认证失败

新版本要求将请求头由 ANTHROPIC_API_KEY 改为 ANTHROPIC_AUTH_TOKEN,Key 的值不变,仅需更新变量名称并重新加载配置。


更多资源

On this page