Appearance
Claude Code 配置指南
Claude Code 可以通过 Anthropic 兼容接口接入 MaoMaoToken API。
本文提供两种配置方式:优先推荐使用 CC Switch 图形化配置;如果你习惯命令行,也可以手动配置环境变量。
TIP
Claude Code 使用 Anthropic 兼容接口,基础地址填写 https://api.maomaotoken.com,不要在末尾添加 /v1。
准备工作
在配置 Claude Code 前,需要先准备好下面几项:
| 项目 | 说明 |
|---|---|
| Node.js | 用于通过 npm 安装 Claude Code |
| Git | 部分依赖和开发流程会用到 |
| Claude Code | Anthropic 官方命令行工具 |
| CC Switch | 用于图形化管理 Claude Code 的供应商配置 |
| MaoMaoToken API Key | 在 MaoMaoToken 获取的令牌 |
下载 CC Switch
CC Switch 下载地址:
WARNING
TODO:补充 CC Switch 的官方下载地址或可信下载地址。
安装步骤
1. 安装 Node.js
访问 Node.js 官网,建议下载左侧的 LTS 版本。LTS 是长期支持版,更适合普通用户和稳定环境。
安装完成后打开命令行验证:
bash
node -v
npm -v2. 安装 Git
访问 Git 官网,页面会自动推荐适合你操作系统的版本,点击下载并按默认选项安装即可。
安装完成后验证:
bash
git --version3. 安装 Claude Code
打开 cmd、PowerShell 或终端,通过 npm 安装 Claude Code:
bash
npm install -g @anthropic-ai/claude-code安装完成后可以验证:
bash
claude --versionINFO
如果你在亚太地区下载依赖很慢,可以先参考 亚太地区加速访问教程 配置 npm 镜像。
使用 CC Switch 配置
1. 打开 CC Switch
启动 CC Switch 应用程序。
后续需要替换的图片
TODO:替换为 CC Switch 启动后的首页截图,标注应用已打开的位置。
2. 点击右上角加号
在界面右上角找到并点击加号按钮,用来添加新的供应商配置。
后续需要替换的图片
TODO:替换为 CC Switch 右上角加号按钮截图。
3. 填写配置信息
按下面内容填写供应商配置:
| 字段 | 填写内容 |
|---|---|
| 供应商名称 | MaoMaoToken,也可以自定义 |
| API Key | 填入您的 MaoMaoToken 令牌 |
| 请求地址 | https://api.maomaotoken.com |
| 主模型 | 选择或填写您账号可用的 Claude 模型 |
示例请求地址:
txt
https://api.maomaotoken.comWARNING
请不要把 API Key 截图公开,也不要把完整令牌发给他人。
后续需要替换的图片
TODO:替换为 CC Switch 新增供应商配置截图,重点标注 供应商名称、API Key、请求地址 和 主模型。
4. 命令行启动 Claude Code
进入你的项目目录,在命令行中启动 Claude Code:
bash
claude后续需要替换的图片
TODO:替换为终端运行 claude 后的启动界面截图。
5. 切换模型
进入 Claude Code 后输入:
txt
/model然后切换到刚刚在 CC Switch 中配置的模型名称。
后续需要替换的图片
TODO:替换为 Claude Code 中输入 /model 并选择模型的截图。
6. 开始使用
回车确认选中模型后,即可开始正常使用 Claude Code。
后续需要替换的图片
TODO:替换为 Claude Code 正常对话或执行任务的截图。
手动配置环境变量
如果不使用 CC Switch,也可以直接在系统里配置 Claude Code 需要的环境变量。
需要配置两个变量:
| 环境变量 | 说明 |
|---|---|
ANTHROPIC_BASE_URL | MaoMaoToken Anthropic 兼容网关地址 |
ANTHROPIC_AUTH_TOKEN | 您的 MaoMaoToken API Key |
TIP
ANTHROPIC_BASE_URL 填写 https://api.maomaotoken.com,不带 /v1。
Windows PowerShell
以下命令会把配置永久保存到用户级环境变量,重启后也不会丢失。
设置网关地址:
powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://api.maomaotoken.com","User")设置 API Key,请把占位内容替换为自己的真实令牌:
powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","你的 MaoMaoToken API Key","User")关闭 PowerShell,重新打开一个新窗口,然后验证:
powershell
echo $env:ANTHROPIC_BASE_URL应显示:
txt
https://api.maomaotoken.commacOS Zsh
macOS 默认使用 Zsh,可以把环境变量写入 ~/.zshrc。
~/.zshrc 是 macOS 的 Shell 配置文件,每次打开终端都会自动加载。下面的命令会自动创建配置文件并追加内容。
写入环境变量,请把 API Key 占位内容替换成自己的真实令牌:
bash
{
echo ''
echo '# MaoMaoToken'
echo 'export ANTHROPIC_BASE_URL="https://api.maomaotoken.com"'
echo 'export ANTHROPIC_AUTH_TOKEN="你的 MaoMaoToken API Key"'
} >> ~/.zshrc立即生效:
bash
source ~/.zshrc验证:
bash
echo "$ANTHROPIC_BASE_URL"应显示:
txt
https://api.maomaotoken.comLinux Bash / Zsh
不确定自己使用哪个 Shell 时,先运行:
bash
echo $SHELL如果看到 /bin/bash,一般使用 Bash;如果看到 /bin/zsh,一般使用 Zsh。
Bash 用户
bash
{
echo ''
echo '# MaoMaoToken'
echo 'export ANTHROPIC_BASE_URL="https://api.maomaotoken.com"'
echo 'export ANTHROPIC_AUTH_TOKEN="你的 MaoMaoToken API Key"'
} >> ~/.bashrcZsh 用户
bash
{
echo ''
echo '# MaoMaoToken'
echo 'export ANTHROPIC_BASE_URL="https://api.maomaotoken.com"'
echo 'export ANTHROPIC_AUTH_TOKEN="你的 MaoMaoToken API Key"'
} >> ~/.zshrc使配置生效:
bash
source ~/.bashrc
# 或
source ~/.zshrc验证:
bash
echo "$ANTHROPIC_BASE_URL"应显示:
txt
https://api.maomaotoken.comDANGER
必须把 你的 MaoMaoToken API Key 替换为自己的真实 API Key,否则 Claude Code 无法正常调用。
启动并验证
进入你的项目目录,启动 Claude Code:
bash
claude可选:先做一次环境检查。
bash
claude doctor如果能够正常对话或执行任务,说明已经成功接入 MaoMaoToken。
常见问题
npm install -g 提示权限错误
Windows 用户可以尝试以管理员身份运行 PowerShell,然后重新执行安装命令。
macOS 用户不要直接使用:
bash
sudo npm install -g @anthropic-ai/claude-code更推荐通过 Homebrew 或 nvm 重新安装 Node.js。Homebrew 或 nvm 安装的 Node.js 通常不需要 sudo 权限。
Linux 用户也不要优先使用 sudo npm install -g。可以使用 nvm 管理 Node.js,或修改 npm 全局目录:
bash
npm config set prefix ~/.npm-global然后将 ~/.npm-global/bin 加入 PATH。
环境变量未生效
Windows 里通过 SetEnvironmentVariable(...,"User") 设置后,需要重新打开终端。仍然不显示时,可以尝试注销 Windows 或重启。
macOS / Linux 中执行:
bash
source ~/.zshrc
# 或
source ~/.bashrc再验证:
bash
echo "$ANTHROPIC_BASE_URL"提示 claude command not found
先确认 Node.js 和 npm 是否安装成功:
bash
node -v
npm -v然后关闭终端重新打开。如果仍然不行,重新安装 Claude Code:
bash
npm install -g @anthropic-ai/claude-code远程服务器连接超时
先检查服务器是否能访问 MaoMaoToken API:
bash
curl -I https://api.maomaotoken.com如果当前网络需要代理,可以配置 HTTPS_PROXY 环境变量后重试。