Skip to content

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 CodeAnthropic 官方命令行工具
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 -v

2. 安装 Git

访问 Git 官网,页面会自动推荐适合你操作系统的版本,点击下载并按默认选项安装即可。

安装完成后验证:

bash
git --version

3. 安装 Claude Code

打开 cmd、PowerShell 或终端,通过 npm 安装 Claude Code:

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

安装完成后可以验证:

bash
claude --version

INFO

如果你在亚太地区下载依赖很慢,可以先参考 亚太地区加速访问教程 配置 npm 镜像。

使用 CC Switch 配置

1. 打开 CC Switch

启动 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.com

WARNING

请不要把 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_URLMaoMaoToken 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.com

macOS 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.com

Linux 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"'
} >> ~/.bashrc

Zsh 用户

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.com

DANGER

必须把 你的 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 环境变量后重试。

公开文档只包含客户端和代码类配置教程。