Mixtoken接入 Claude 客户端

官方 Base URL 对照

不同 Agent 对协议路径的拼接规则不同,请按字段填写准确值。

Agent 字段 官方值
Codex config.toml · base_url https://api.mixtoken.ai/v1
Claude Code ANTHROPIC_BASE_URL https://api.mixtoken.ai
cc-switch · Claude Base URL / ANTHROPIC_BASE_URL https://api.mixtoken.ai
cc-switch · Codex Base URL https://api.mixtoken.ai/v1
WorkBuddy Endpoint https://api.mixtoken.ai/v1

Codex、cc-switch 的 Codex Provider 与 WorkBuddy 使用带 /v1 的 OpenAI-compatible Base URL;Claude Code 与 cc-switch 的 Claude Provider 使用 Mixtoken 根地址,由客户端请求 /v1/messages。

Claude Code 官方配置

export ANTHROPIC_BASE_URL=https://api.mixtoken.ai
export ANTHROPIC_AUTH_TOKEN=<你的 Mixtoken API Key>
export ANTHROPIC_MODEL=claude-opus-4-8
export ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-8
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
export CLAUDE_CODE_SUBAGENT_MODEL=claude-sonnet-5
export CLAUDE_CODE_EFFORT_LEVEL=xhigh

settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.mixtoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "<你的 Mixtoken API Key>",
    "ANTHROPIC_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-sonnet-5",
    "CLAUDE_CODE_EFFORT_LEVEL": "xhigh"
  }
}

检查当前 Shell 是否已加载变量:

env | grep -E 'ANTHROPIC_|CLAUDE_CODE_'

Claude Code 使用根地址,并请求 /v1/messages;不要在 ANTHROPIC_BASE_URL 后添加 /v1。

Claude Desktop 是 Anthropic 的桌面聊天应用;Claude Code 是独立的命令行编程工具。本文介绍通过 CC Switch 管理 Claude Desktop 的 Mixtoken 接入配置。

CC Switch 接入

CC Switch 是一个图形界面工具,用来管理和切换 Claude 客户端的接入地址与密钥,一键切换。

安装 Claude 客户端和 CC Switch

本节为安装教程。如果您已安装 Claude 客户端和 CC Switch,接入 Mixtoken 请直接看下一节。

安装 Claude 客户端

  • 到 Claude 官网 下载对应系统的 Claude 客户端并安装。

Claude 客户端下载页面

安装 CC Switch

请安装 v3.16.5 及以上版本。macOS 用户(推荐)通过 Homebrew 安装:

bash
brew install --cask cc-switch

或访问 CC Switch Releases 下载对应平台安装包:

  • macOS:.dmg / .zip
  • Windows:.msi 安装版 / Portable .zip 绿色版
  • Linux:.deb / .rpm / .AppImage

首次打开如被 macOS Gatekeeper 拦截,到「系统设置 → 隐私与安全性」点 「仍要打开」。

接入 Mixtoken

在 CC Switch 的 Claude Desktop 标签中,点击右上角【橙色加号】按钮。

  1. 在 「预设供应商中」 找到 「Mixtoken」(或直接搜索"Mixtoken")。
  1. 填入你在 Mixtoken 控制台 获取的 API Key。
  1. 完成后,点击右下角保存。

在主页启用 Mixtoken,打开 Claude 客户端即可生效。

如果已经打开了 Claude 客户端,需要重启一次生效。

打开 Claude 客户端,即可开始使用了。

Claude 客户端使用界面

常见问题

Windows 系统用户在使用 Claude 客户端时,如遇以下报错:

Virtual Machine Platform not available

Claude's workspace requires the Virtual Machine Platform on Windows. Enable this feature, then restart.

请按照下述步骤完成操作,即可正常使用:

  1. Win + R 输入 optionalfeatures 回车;
  2. 找到并勾选「虚拟机平台」(英文叫 Virtual Machine Platform),确定;
  3. 重启电脑,再打开 Claude 客户端,即可使用。
准备好了?三步即可开始登录控制台 · 购买额度 · 创建 API Key