MaiToken
登录/注册

Claude

适用场景：

适合希望在终端中使用 Claude 模型完成代码分析、代码修改和 Agent 任务的用户。
Claude Code 使用 Anthropic Messages 协议。请从模型限制列表中选择 Claude 模型，不建议在 Claude Code 中使用 GPT、Gemini 等非 Claude 模型。
ANTHROPIC_BASE_URL 应填写 https://api.maitoken.com ，不要添加 /v1。Claude Code 会自动请求 https://api.maitoken.com/v1/messages 。

1. macOS / Linux 配置

  1. 检查 Claude Code： 打开终端并运行 claude --version。如果提示找不到命令，请先按照 Claude Code 的安装说明完成安装。

  2. 选择模型： 在 MaiToken 控制台的模型限制列表中复制一个可用的 Claude 模型 ID。

  3. 设置网关地址： 将 ANTHROPIC_BASE_URL 设置为 https://api.maitoken.com 。

  4. 设置认证信息： 将 MaiToken Key 写入 ANTHROPIC_AUTH_TOKEN。Claude Code 会自动使用 Authorization: Bearer 方式发送认证信息。

  5. 设置模型： 将准确的 Claude 模型 ID 写入 ANTHROPIC_MODEL，然后在同一个终端窗口中运行 claude。

export ANTHROPIC_BASE_URL="https://api.maitoken.com"export ANTHROPIC_AUTH_TOKEN="<你的 MaiToken Key>"export ANTHROPIC_MODEL="<Claude模型ID>" claude

2. Windows PowerShell 配置

打开 PowerShell，运行以下命令：

$env:ANTHROPIC_BASE_URL="https://api.maitoken.com"$env:ANTHROPIC_AUTH_TOKEN="<你的 MaiToken Key>"$env:ANTHROPIC_MODEL="<Claude模型ID>" claude

登录说明： 使用 ANTHROPIC_AUTH_TOKEN 通过 MaiToken 网关认证时，不需要登录 Claude.ai；首次进入项目时出现的目录信任确认也不是账号登录。

为避免后台模型报错，建议为 Claude Code 使用的模型别名指定可用模型。Claude Code 可能使用 sonnet、opus 和 haiku 别名处理不同任务。如果测试时出现其他模型无权限，可以将下列变量全部设置为同一个可用的 Claude 模型 ID。
macOS / Linux
export ANTHROPIC_DEFAULT_SONNET_MODEL="<Claude模型ID>"export ANTHROPIC_DEFAULT_OPUS_MODEL="<Claude模型ID>"export ANTHROPIC_DEFAULT_HAIKU_MODEL="<Claude模型ID>"export CLAUDE_CODE_SUBAGENT_MODEL="<Claude模型ID>"
Windows PowerShell
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="<Claude模型ID>"$env:ANTHROPIC_DEFAULT_OPUS_MODEL="<Claude模型ID>"$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="<Claude模型ID>"$env:CLAUDE_CODE_SUBAGENT_MODEL="<Claude模型ID>"
变量 填写内容
ANTHROPIC_BASE_URL https://api.maitoken.com
ANTHROPIC_AUTH_TOKEN <你的 MaiToken Key>
ANTHROPIC_MODEL <Claude模型ID>
实际请求地址 https://api.maitoken.com/v1/messages ，由 Claude Code 自动拼接

配置完成后这样测试

  1. 测试普通对话： 输入“只回复 OK”。如果收到正常回复，说明 API Key、网关地址和模型 ID 基本正确。

  2. 测试项目读取： 打开一个测试项目，输入“请读取当前项目，只列出一级文件名，不要修改任何文件。”

  3. 测试 Agent： 获得目录读取结果后，让 Agent 新建一个名为 test-maitoken.txt 的文件并写入 hello。请勿使用真实生产项目进行测试。

常见问题

问题 处理建议
401 / Unauthorized 确认使用的是 ANTHROPIC_AUTH_TOKEN，并确保在启动 claude 的同一个终端窗口中设置了该变量。
404 /v1/messages ANTHROPIC_BASE_URL 应只填写 https://api.maitoken.com ，不要填写到 /v1 或 /v1/messages。
模型不可用 从模型限制列表中选择准确的 Claude 模型 ID，不要填写中文展示名称。
启动后调用了其他模型 设置 ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL 和 CLAUDE_CODE_SUBAGENT_MODEL。
可以聊天但不能修改文件 确认当前目录具有写入权限，并确认模型和网关完整支持 Anthropic 工具调用及流式输出。