ModoBox API 对接指南

准备工作（必读）

别紧张，后续的操作步骤并没有什么难度

新手和技术高手都欢迎，但完全不动脑子的人请直接关闭此页面

碰到问题的时候，推荐先借助其他大模型辅助工具，多个工具配合使用能显著提升你的工作效率

第一部分 基础概念

本节对一些核心概念进行说明，帮助你快速了解本平台

各分组之间的差异

虽然不同分组可能包含相同的模型，但模型的来源渠道不同，运营成本不同，收费标准也不同，请结合自身需求进行选择

价格会受到多种因素的影响，将根据实际运营状况进行调整，相关变动会提前在站内发布公告

以下是当前平台的分组列表，分组会根据实际运营情况进行调整

关于计费

你只需关注模型卡片上标注的价格就行，无需理会分组倍率和汇率换算

怎么用？调用前需要做什么

  1. 确认你打算使用哪个模型
  2. 找到包含该模型的分组
  3. 选好分组后，为该分组生成一个令牌

第二部分 语言模型对接示例

简易方案（推荐）

此方案适用于大部分用户，mac、windows、linux 系统均兼容

安装 CLI 工具

该工具用来实际调用模型，选择其中一个安装即可

Claude Code CLI

根据你的操作系统，选择对应的方式依次运行所有命令

mac / linux / wsl

bash 
curl -fsSL https://deb.nodesource.com/setup_lts.x | bash
apt-get install -y nodejs
npm install -g @anthropic-ai/claude-code

windows powershell

powershell 
winget install OpenJS.NodeJS.LTS -e --accept-package-agreements --accept-source-agreements; npm install -g @anthropic-ai/claude-code

确认安装成功，查看版本信息

bash 
claude -v
Codex CLI

mac / linux / wsl

bash 
# 1. 安装 NVM v0.40.3
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 2. 刷新环境变量
source ~/.bashrc 2>/dev/null || source ~/.zshrc

# 3. 安装 Node.js LTS
nvm install --lts

# 4. 检查环境
node -v && npm -v

# 5. 安装 Codex CLI
npm install -g @openai/codex

windows powershell

powershell 
# 1. 安装运行环境
winget install OpenJS.NodeJS.LTS

# 2. 检查环境
node -v && npm -v

# 3. 安装 Codex CLI
npm install -g @openai/codex

确认安装成功，查看版本信息

bash 
codex --version
Gemini CLI
bash 
npm i -g @google/gemini-cli@latest

确认安装成功，查看版本信息

bash 
gemini -v

下载 cc-switch 并对接 CLI 工具

这是一个带有图形界面的本地多环境管理工具，方便管理本地的多套配置，切换起来简单灵活

使用 CC-Switch，您可以：

  • ✅ 一键切换 API 配置 - 在多个 API 提供商之间快速切换
  • ✅ 可视化配置管理 - 通过图形界面轻松管理所有配置
  • ✅ MCP 服务器管理 - 管理 Model Context Protocol 服务器
  • ✅ 系统托盘快捷操作 - 通过托盘菜单快速切换
  • ✅ 本地代理 - 支持热切换CC、CX、Gemini的供应商
  • ✅ 故障转移 - 全自动渠道故障转移

下载安装完成后，根据你之前选择的 CLI 工具，进行对接配置

对接 Claude Code CLI

第一步：先选择 claude，然后新增一个配置方案

第二步：在配置页面向下滚动，将下面的内容粘贴进去

json 
{
    "env": {
      "ANTHROPIC_BASE_URL": "https://www.modobox.cc",
      "ANTHROPIC_AUTH_TOKEN": "sk-你为当前分组新建的站内令牌",
      "ANTHROPIC_MODEL": "claude-opus-4-7",
      "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-4-7",
      "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7",
      "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4-7",
      "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
      "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
    },
    "skipWebFetchPreflight": true,
    "ENABLE_TOOL_SEARCH": true,
    "model": "opus"
}

第三步：点击保存，系统会自动解析你填入的 JSON 并补全上方的配置项，如有遗漏可手动补充，然后切换模型

第四步：配置完毕即可开始使用，在终端中执行以下命令进入交互模式

bash 
claude

随便输入一些问题，如果有回复，说明配置完成，或者在ccswitch中点击测试模型按钮，如果能弹出延迟，说明配置成功

对接 Codex CLI

第一步：切换到 codex 界面，添加一个新的供应商

第二步：在配置页面向下滚动，将下面的内容粘贴进去

auth.json

json 
{
  "OPENAI_API_KEY": "sk-你自己的令牌"
}

config.toml

toml 
model_provider = "modobox"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.modobox]
name = "modobox"
base_url = "https://www.modobox.cc/v1"
wire_api = "responses"
requires_openai_auth = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

第三步：开始使用，通过任意终端启动

bash 
codex

随便输入一些问题，如果有回复，说明配置完成，或者在ccswitch中点击测试模型按钮，如果能弹出延迟，说明配置成功

对接 Gemini CLI

第一步：选择 gemini，创建一个新配置

第二步：按如下方式配置

环境变量 .env

env 
GOOGLE_GEMINI_BASE_URL=https://www.modobox.cc
GEMINI_API_KEY=sk-你的密钥
GEMINI_MODEL=gemini-3.1-pro-preview

配置文件 config.json

json 
{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

第三步：开始使用，通过终端启动

bash 
gemini

随便输入一些问题，如果有回复，说明配置完成，或者在ccswitch中点击测试模型按钮，如果能弹出延迟，说明配置成功

opencode

仓库地址：https://github.com/anomalyco/opencode/

第一步：确认 opencode 已正确安装，在终端运行以下命令，能通过 ip:port 方式打开即可

bash 
opencode web --hostname 0.0.0.0

第二步：修改配置文件，以类 Unix 系统为例，配置文件通常位于以下路径

bash 
vim ~/.config/opencode/opencode.jsonc

假设需要对接 gpt-5.4 模型，协议类型为 Codex CLI UA，首先创建一个支持外接分组的令牌，然后选择支持外接的模型（例如选择 gpt-codex 分组）

配置时需要留意以下细节：base_url 的 /v1 后缀；匹配的 UA 头；准确的模型名称（建议直接从模型广场复制）；支持外接的分组令牌

jsonc 
{
  "$schema": "https://opencode.ai/config.json",
  "disabled_providers": [],
  "provider": {
    "modobox_gpt-codex": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "modobox_gpt-codex",
      "options": {
        "baseURL": "https://www.modobox.cc/v1",
        "name": "modobox_gpt-codex",
        "headers": {
          "Authorization": "Bearer sk-xxxxxxx",
          "User-Agent": "codex_cli_rs/0.77.0 (Windows 10.0.26100; x86_64) WindowsTerminal"
        }
      },
      "models": {
        "gpt-5.4": {
          "name": "gpt-5.4",
          "attachment": true,
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          },
          "limit": {
            "context": 1000000,
            "output": 32000
          }
        }
      }
    }
  }
}

第三步：重新启动 opencode 页面，即可开始使用。如果你需要使用其他模型，请自行修改配置文件，并确保你的模型名称正确，否则将无法使用。

bash 
opencode web --hostname 0.0.0.0

如果有问题，请私聊站长

后续其他内容，请等待更新......