MID Code 文档中心

详细介绍 MID Code 中转服务在 Claude Code、Codex、Gemini 等主流 CLI 中的使用方法

MID Code 核心优势

🔗

统一入口,极速连通

以单一域名和密钥连接全部主流大模型,智能容灾切换保障业务不中断。

📊

全栈可观测与管控

实时监控调用量、错误率与费用,灵活配置限流与安全策略。

💰

按需扩容与成本优化

多渠道配额、智能路由与任务调度,灵活控制成本与扩展能力。

🛠

开发者友好体验

兼容 OpenAI 接口协议,支持多种 CLI 工具直接接入,轻松上线。

📖 给阅读者的建议 ① 请在使用前认真阅读完整文档,能解答你 90% 的问题
② 遇到问题先查「常见问题」板块,再联系客服
③ 按照教程一步步操作,基本不会出现配置问题

🚀快速开始

从 0 开始的 MID Code 使用之旅,一步步来,准没问题!

1

注册账号

访问 MID Code 官网注册页面:

URLhttps://code.midaccs.com/register
  • 方式一(推荐)邮箱注册:填写邮箱、用户名、密码(建议字母+数字+特殊字符组合),提交完成注册
  • 方式二 第三方登录:如平台支持 GitHub/Google 等第三方登录,点击对应按钮授权即可
💡 提示妥善保管登录凭证,避免账号被盗用。建议设置高强度密码。
2

登录账号

访问 MID Code 登录页面:

URLhttps://code.midaccs.com/login
  • 输入注册时的邮箱/用户名与密码,点击登录
  • 如使用第三方登录,点击对应按钮授权
ℹ️ 设备登录说明浏览器会保持登录状态;在新设备需重复登录流程。
3

购买额度

登录控制台后,进入「钱包充值」页面进行在线充值。

  • 支持多种充值方式
  • 充值后额度实时到账,可在控制台首页查看余额
⚠️ 注意请通过官方渠道充值,切勿向任何个人转账。
4

创建 API 令牌

登录控制台后创建令牌,用于 CLI 工具或 API 调用的身份认证。

进入令牌管理:

  • 在控制台左侧选择「令牌管理」
  • 点击「添加令牌」按钮

填写令牌信息:

  • 令牌名称 — 便于识别(如 "Claude-生产"、"Codex-测试")
  • 令牌分组非常重要!一定要根据使用的服务选择正确的分组,否则调用会出错
  • 过期时间(可选) — 不填则永久有效
  • 额度设置(可选) — 可限制该令牌最大调用额度
  • 访问限制(可选) — 可限制该令牌可访问的模型

点击「提交」完成创建,然后点击复制按钮获取令牌 Key。

🔴 重要令牌分组一定要根据你使用的服务选择相应的分组!
例如:使用 Claude Code 就选 CC 分组,使用 Codex 就选 Codex 分组,使用 Gemini 就选 Gemini 分组。
5

配置 CLI 工具

MID Code 支持在命令行中使用 Claude Code、Codex、Gemini CLI。请参考下方的 CLI 配置教程 完成配置。

📖 配置前必读不管使用哪个 CLI,请一定先完成 环境检查,确保 Node.js 已正确安装。

⌨️CLI 配置教程

支持 Claude Code、Codex、Gemini CLI 三大主流 AI 编程工具。

🔍

环境检查(通用步骤)

(1)确认 Node.js 环境已安装

在终端输入以下命令:

bashnpm list -g --depth=0

如果提示「命令未找到」,说明需要先安装 Node.js。前往 nodejs.org 下载安装。

(2)安装 CLI 工具

在终端执行以下命令,一次性安装所有需要的 CLI:

bashnpm i -g @anthropic-ai/claude-code@latest npm i -g @openai/codex@latest npm i -g @google/gemini-cli@latest

(3)测试安装成功

🔴 重要这一步必须执行!运行命令后,系统才会在用户目录下生成各 CLI 的配置目录,方便后续配置。

分别在终端输入 claudecodexgemini,出现交互界面即表示安装成功。

C

Claude Code 配置

1.Win + R,输入以下内容后回车,打开配置目录:

路径%userprofile%\.claude

1. 打开终端,进入配置目录:

bashcd ~/.claude

2. 如果目录中没有 settings.json,手动创建一个。

3. 将以下内容写入 settings.json

json{ "env": { "ANTHROPIC_BASE_URL": "https://code.midaccs.com", "ANTHROPIC_AUTH_TOKEN": "你的令牌Key", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1" } }

4.你的令牌Key 替换为你在 MID Code 控制台创建的 CC 分组 令牌。

5. 在终端运行 claude,出现对话界面后测试对话,收到回复即配置成功。

⚠️ 常见问题如果配置完提示需要登录或无法连接,请检查:
① 令牌分组是否选择了 CC 分组
② ANTHROPIC_BASE_URL 地址是否正确
③ 令牌 Key 是否正确复制(注意无多余空格)
X

Codex 配置

1.Win + R,输入以下路径回车,打开配置目录:

路径%userprofile%\.codex

1. 打开终端,进入配置目录:

bashcd ~/.codex

2. 你需要配置以下两个文件(如果没有请手动创建):

  • config.toml — Codex 核心配置文件
  • auth.json — API Key 认证文件

3. 将以下配置写入 config.toml

tomldisable_response_storage = true model = "gpt-4.1" model_provider = "midcode" model_reasoning_effort = "high" [model_providers.midcode] base_url = "https://code.midaccs.com/v1" name = "midcode" requires_openai_auth = true wire_api = "responses"

4. 将以下配置写入 auth.json

json{ "OPENAI_API_KEY": "你的令牌Key" }

你的令牌Key 替换为你在 MID Code 控制台创建的 Codex 分组 令牌。

5. 在终端运行 codex,进行对话测试,收到回复即配置成功。

G

Gemini CLI 配置

1.Win + R,输入以下路径回车,打开配置目录:

路径%userprofile%\.gemini

1. 打开终端,进入配置目录:

bashcd ~/.gemini

2. 如果目录下没有 .env 文件,请新建一个,写入以下内容:

.envGOOGLE_GEMINI_BASE_URL=https://code.midaccs.com GEMINI_API_KEY=你的令牌Key GEMINI_MODEL=gemini-2.5-pro

3.你的令牌Key 替换为你在 MID Code 控制台创建的 Gemini 分组 令牌。

4. 在终端运行 gemini,看到交互界面并能正常回复即配置成功。

常见问题

遇到问题时请先对照以下排查清单。

Claude Code 提示无法连接到 Anthropic 服务

请依次检查:

  • 确认 ANTHROPIC_BASE_URL 地址填写正确(注意末尾不要加 /
  • 确认令牌分组选择的是 CC 分组
  • 尝试在终端执行 claude config reset 重置后重新配置
  • 检查网络环境是否能正常访问 MID Code 服务地址
Claude Code 提示需要登录

这通常是因为 Claude Code 默认尝试连接官方服务器。请确保 settings.json 中的环境变量配置正确,特别是 ANTHROPIC_AUTH_TOKEN。配置完成后重新启动终端再运行 claude

Codex 报错 401 / Authentication Failed

请检查:

  • auth.json 中的 Key 是否为 Codex 分组 的令牌
  • config.tomlmodel_provider 是否指向正确的 provider 名称
  • base_url 末尾是否带了 /v1
  • 令牌是否已过期或额度用完
Codex 配置了但无法获取回复

确保 config.tomlwire_api 设置为 "responses",且 model 字段填写的模型名称在 MID Code 平台上可用。可在控制台的模型列表中确认支持的模型。

Gemini CLI 提示 API Key 无效

请检查:

  • .env 文件中 GEMINI_API_KEY 是否为 Gemini 分组 的令牌
  • GOOGLE_GEMINI_BASE_URL 地址是否正确
  • 注意 .env 文件中等号两侧 不要有空格
令牌分组选错了怎么办?

令牌创建后分组无法修改。请在「令牌管理」中重新创建一个正确分组的令牌,然后将旧令牌删除。更新对应 CLI 配置文件中的 Key 即可。

额度用完后还能调用吗?

额度耗尽后 API 调用会返回 402 错误。请前往控制台充值额度后即可恢复使用,无需重新配置。

npm 安装 CLI 时报错

常见原因及解决方案:

  • 权限不足:Windows 以管理员身份运行终端;macOS/Linux 使用 sudo npm i -g ...
  • Node.js 版本过低:确保 Node.js >= 18.x,运行 node -v 检查版本
  • 网络问题:可尝试设置 npm 镜像源 npm config set registry https://registry.npmmirror.com

📬联系我们

如果按照文档步骤仍遇到问题,请截图当前步骤与报错信息发给我们,客服会尽快解答。

💬

微信

请填写微信号

✈️

Telegram

请填写 Telegram