Claude Code、Codex CLI、OpenCode 接入 Midalo

接入前先准备什么？

在 Midalo 创建 API 密钥，确认账户余额和目标模型可用，然后把密钥填入客户端。示例中的 sk-xxxxxxxx 与 REPLACE_WITH_MODEL_ID 都必须替换。

密钥可以按项目分别创建，并设置可用模型和额度。常用型号可查模型广场；需要 Qwen、GLM、Kimi、豆包或 MiniMax 接入，可看国产模型指南并确认目标 ID、接口和价格。再发送一条短请求验证，不要将真实密钥提交到 Git 仓库或分享配置链接。

四种接入方式有什么差异？

客户端决定 URL 后缀。把完整请求地址填进 Base URL，通常会让客户端重复拼接路径。

工具	协议与 Base URL	密钥填法	完整步骤
Claude Code	Anthropic `https://midalo.ai`	`ANTHROPIC_AUTH_TOKEN`	Claude Code 文档
Codex CLI	OpenAI Responses `https://midalo.ai/v1`	`OPENAI_API_KEY`，由 `env_key` 引用	Codex CLI 文档
OpenCode	OpenAI 兼容 `https://midalo.ai/v1`	`options.apiKey`，可引用环境变量	OpenCode 文档
CC Switch	按所选客户端自动生成	从 Midalo 的密钥行导入	CC Switch 文档

表格较宽，手机上可横向滑动。

OpenAI、Anthropic、Gemini 的 Base URL 怎么填？

协议	Base URL	密钥在 HTTP 请求中的位置	客户端拼出的常用路径
OpenAI 兼容	`https://midalo.ai/v1`	`Authorization: Bearer sk-...`	`/v1/chat/completions` 或 `/v1/responses`
Anthropic 兼容	`https://midalo.ai`	`x-api-key: sk-...`	`/v1/messages`
Gemini 原生	`https://midalo.ai`	`x-goog-api-key: sk-...`	`/v1beta/models/{model}:generateContent`

表格较宽，手机上可横向滑动。

这里的密钥都是你的 Midalo API 密钥，表中的请求头由相应客户端或 SDK 按协议发送。Gemini 原生客户端不要在 Base URL 后预加 /v1beta；Claude Code 不要预加 /v1。更多示例见后缀速查和鉴权方式。

Claude Code 最小配置

在启动 Claude Code 的终端设置环境变量。下面以 macOS、Linux 的 shell 为例；重新打开终端后，需要让新会话也加载这些变量。

export ANTHROPIC_BASE_URL="https://midalo.ai"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxx"

Claude Code 使用 Anthropic Messages 路径 /v1/messages，所以 Base URL 保持裸域名。完整配置文件写法见Claude Code 接入文档。

Codex CLI 最小配置

先在终端设置密钥，再编辑用户级 ~/.codex/config.toml。将模型占位符换成你账户已开通且支持 Responses 接口的精确 ID；公开上架型号可从模型广场核对。

export OPENAI_API_KEY="sk-xxxxxxxx"

model = "REPLACE_WITH_MODEL_ID"
model_provider = "midalo"

[model_providers.midalo]
name = "Midalo"
base_url = "https://midalo.ai/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

Codex CLI 的自定义提供商使用 Responses 协议，路径为 /v1/responses。base_url 需要带 /v1。字段含义可核对OpenAI 官方 Codex 配置参考，站内步骤见Codex CLI 接入文档。

OpenCode 最小配置

下面按当前站内 OpenCode 文档使用的配置格式，走 OpenAI 兼容 Chat Completions 接口。先设置环境变量，再把 JSON 放入 ~/.config/opencode/opencode.json。

export MIDALO_API_KEY="sk-xxxxxxxx"

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "midalo": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Midalo",
      "options": {
        "baseURL": "https://midalo.ai/v1",
        "apiKey": "{env:MIDALO_API_KEY}"
      },
      "models": {
        "REPLACE_WITH_MODEL_ID": { "name": "Midalo model" }
      }
    }
  }
}

替换模型 ID 后，在 OpenCode 的模型选择器中选 midalo 提供商。OpenCode 不同版本的配置字段可能变化，可核对OpenCode 官方提供商文档；若使用 Responses 接口，也需选用相应的提供商适配包。

用 CC Switch 导入客户端配置

登录 Midalo，进入API 密钥页面，在目标密钥所在行点击“CC Switch”。
选择 Claude、Codex 或 Gemini，填入已确认可用的模型 ID。
打开生成的导入链接，在 CC Switch 中预览并确认导入，再回到客户端发一条测试消息。

导入时，Claude 和 Gemini 使用裸域名，Codex 使用带 /v1 的地址。导入链接可能包含密钥，请只在自己的设备上使用。站内说明见CC Switch 一键导入。

接入后怎么验证，报错怎么排查？

在客户端发送一条短消息，再到 Midalo 使用日志核对请求、模型 ID、用量与扣费。GET /v1/models 可以辅助查看列表，但列表出现某个名称不等于该模型在当前密钥和接口上一定能调用。

401：密钥或鉴权头

确认密钥仍启用且没有多余空格；OpenAI 用 Bearer，Anthropic 用 x-api-key，Gemini 用 x-goog-api-key。

402：余额或密钥额度

检查钱包余额及该密钥自身的额度上限。

403：模型访问权限

核对密钥分组、可用模型范围及该模型支持的接口。可到模型广场核对，或联系 Midalo 确认目标型号是否已为账户开通。

404：URL 路径

对照上面的后缀表，检查是否把 /v1 或 /v1beta 重复拼接。

429：请求过密

降低并发并加入退避间隔，避免立即连续重试；同时核对账号或密钥的限流设置。

若仍无法定位，保留请求时间、模型 ID、响应状态和使用日志记录，按错误码排查文档做最小请求复现。其他 OpenAI 兼容客户端的通用填法见常用客户端。

Claude Code、Codex CLI 等客户端怎么配置？