Muxla 文档

外观

CC MAX 站点接入文档 ​

本文档面向 Claude Code 专用中转场景，仅建议通过 Claude Code 命令行工具或 VS Code 官方插件接入，不建议用于网页版、SDK 直连或第三方聊天软件。

一、支持范围 ​

项目说明
接入客户端Claude Code 命令行工具 / VS Code 官方插件（Claude Code for VS Code）
接入协议Anthropic Messages API
API 地址https://mux.la

检查与安装指定版本 ​

bash
# 查看当前版本
claude --version

# 安装指定版本示例
npm install -g @anthropic-ai/claude-code

二、基础信息 ​

接入前请先准备好以下信息：

名称说明示例
API 地址（Base URL）Muxla 中转地址https://mux.la
API 令牌（API Key）控制台创建的密钥sk-xxxxxxxxxxxxxxxx

三、NewAPI 接入额外配置 ​

如果站点基于 NewAPI 搭建，需要在 NewAPI 的渠道设置中额外配置以下三项，以保证 Claude Code 的请求头能被正确透传，避免被识别拦截或协议异常。

1. 参数覆盖（Parameter Override） ​

将以下配置粘贴到渠道的参数覆盖字段中。它的作用是透传 Claude Code 发出的关键请求头，并保留原始值。

json
{
  "operations": [
    {
      "mode": "pass_headers",
      "value": [
        "X-Stainless-Arch",
        "X-Stainless-Lang",
        "X-Stainless-Os",
        "X-Stainless-Package-Version",
        "X-Stainless-Retry-Count",
        "X-Stainless-Runtime",
        "X-Stainless-Runtime-Version",
        "X-Stainless-Timeout",
        "User-Agent",
        "X-App",
        "Anthropic-Beta",
        "Anthropic-Dangerous-Direct-Browser-Access",
        "Anthropic-Version"
      ],
      "keep_origin": true
    }
  ]
}

2. 请求头覆盖（Header Override） ​

将以下配置粘贴到渠道的请求头覆盖字段中。"*": false 表示不覆盖任何请求头，完全使用客户端发来的原始请求头。

json
{
  "*": false
}

3. 开启透传请求体 ​

在渠道编辑的渠道额外设置中，找到并开启透传请求体功能。

四、Claude Code 接入方式 ​

通过设置环境变量将 Claude Code 指向 Muxla。

方式 A：临时设置 ​

bash
ANTHROPIC_BASE_URL="https://mux.la" \
ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxx" \
claude

方式 B：持久化设置 推荐 ​

编辑 Claude Code 配置文件 ~/.claude/settings.json，Windows 为 C:\Users\<用户名>\.claude\settings.json，加入：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://mux.la",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxx"
  }
}

保存后重新启动 Claude Code 即可生效。

验证接入 ​

bash
claude

进入交互界面后随意发送一条消息，能正常返回即表示接入成功。

五、VS Code 官方插件接入方式 ​

VS Code 官方插件与命令行工具共用同一套配置。

1. 安装插件 ​

在 VS Code 扩展市场搜索 Claude Code（发布者为 Anthropic），安装官方插件。插件依赖本地的 Claude Code，请确保已安装命令行工具。

2. 配置站点地址与令牌 ​

插件会读取与命令行相同的配置文件 ~/.claude/settings.json。只要按第四节方式 B 配置过 env，插件即可直接复用，无需重复设置。

若希望仅对某个项目生效，也可以在已设置环境变量的终端中启动 VS Code，插件会继承这些变量。

六、常见问题 ​

Q1：提示版本不支持或请求被拒绝？ ​

先确认 Claude Code 版本与当前网关兼容，并确认 NewAPI 渠道已正确配置请求头透传与请求体透传。

Q2：能否用网页版、Cherry Studio、SDK 等接入？ ​

不建议。该接入口面向 Claude Code 命令行工具及 VS Code 官方插件。

Q3：设置了环境变量仍连接官方地址？ ​

检查是否同时存在系统级与配置文件级的环境变量冲突。settings.json 中的 env 优先级较高，建议统一在一处配置。