开始之前：准备好三项参数

配置前准备

用户购买 Token Freedom 套餐以后，进入用户中心「TokenPlan」菜单，获取访问地址，即后续配置需要的 Base URL 地址；点击「新建令牌」自行创建 Key；然后访问「购买记录」菜单，获取 Model ID。

配置任何一个客户端，都只需要刚才获取到的三项。每位用户使用自己获取到的参数，不要共用他人的 Key。

模型说明

模型ID按实际分配填写，并先确认模型支持的协议。平台会提供多种模型，本文各步骤中出现的 glm-5.3-flash 只是示例。配置时请把模型ID替换成你实际获取到的那一个，原样复制、不要改大小写或增删字符；一个模型在每个客户端里添加一条配置，想用多个模型就分别添加多条，之后在客户端里切换即可。

更重要的一点：不同模型支持的接口协议并不相同，而每个客户端固定使用某种协议调用，协议对不上就会报错（常见 400 / 404）。平台目前提供三种协议，配置前先确认模型所支持的协议类型。

软件版本说明

为避免因客户端版本迭代导致的界面布局、配置菜单或参数选项差异，下表汇总了本文档在编写与实测验证过程中所使用的各客户端及辅助管理工具的具体版本号。建议使用最新版本的软件，如您的实际界面与截图标注略有不同，请以当前版本中的对应功能关键词进行定位配置或联系官网客服获取技术支持。

在 WorkBuddy 中配置

第 1 步：打开设置

启动 WorkBuddy，点击左下角的账户头像，在弹出菜单中选择「设置」。

第 2 步：进入模型页并添加模型

在设置左侧选择「模型」，点击右上角「添加模型」。已有其他自定义模型时不要覆盖，新建一条即可。

第 3 步：填写接入参数（关键步）

• 提供商选「自定义 / Custom」；
• 接口地址填 https://tokenplan.miaoyun.net.cn/v1
• API Key 粘贴你自己的 Key；
• 模型名称填 glm-5.3-flash。

第 4 步：高级设置保持默认并保存

高级设置里上下文/输出上限保留「使用供应商默认值」；工具调用按需开启，图片输入支持。核对无误后点「保存」，模型应出现在「已保存模型」列表中。

第 5 步：选模型并验证

回到「新建任务」，在输入框附近的模型选择器中选中刚添加的模型（不要选 自动/Auto，自动/Auto 可能调度到其他模型，无法验证本次配置）。发送测试句：请只回复：配置测试成功。收到正常回复即配置成功。

在 ZCode 中配置

第 1 步：进入模型供应商设置

打开 ZCode，进入「设置 → 模型设置」，点击「添加供应商」。界面措辞随版本变化时，认准「自定义供应商 / 自定义模型」关键词。

第 2 步：填写供应商参数（关键步）

供应商名称随意填（例如 MIAOYUN）；API 格式选择「Chat completions（/chat/completions）」；Base URL 填 https://tokenplan.miaoyun.net.cn/v1（注意带 /v1）；API Key 粘贴你自己的 Key。

第 3 步：手动添加模型

在页面下方「模型列表」区域手动添加模型，模型 ID 填 glm-5.3-flash，然后保存。

第 4 步：新建会话并验证

返回主界面，新建一个会话，在模型列表中选中 Miaoyun / glm-5.3-flash，发送测试句：请只回复：配置测试成功。收到正常回复即配置成功。若旧会话里选不到新模型，新开会话或重启 ZCode 后再选。

在 OpenClaw 中配置

第 1 步：添加自定义模型

编辑 OpenClaw 主配置文件（JSON 格式，支持注释；若文件不存在请自行创建）：

• Linux / macOS：~/.openclaw/openclaw.json
• Windows：%USERPROFILE%\.openclaw\openclaw.json

本章供应商名统一用 MIAOYUN 为例，模型 ID 仍按第一章的说明替换成你实际获取到的模型 ID，此处以 glm-5.3-flash 为例。

增加 models 字段：

"models": {
    "providers": {
        "MIAOYUN": {
            "baseUrl": "https://tokenplan.miaoyun.net.cn/v1",
            "api": "openai-completions",
            "apiKey": "pk-……………………（你自己的 Key）",
            "models": [
                {
                    "id": "glm-5.3-flash",
                    "name": "GLM 5.3 Flash",
                    "input": ["text", "image"],
                    "reasoning": true
                }
            ]
        }
    }
},

Agent 字段中设置 default 模型为我们添加的：

"agents": {
    "defaults": {
        "model": {
            "primary": "MIAOYUN/glm-5.3-flash"
        }
    }
}

保存配置文件后，重启 OpenClaw（或其网关服务）使新配置生效。

第 2 步：新建会话并验证

打开 OpenClaw 本地控制台：http://127.0.0.1:18789/（若提示网关未启动，先在终端运行 openclaw gateway）。在控制台的会话列表中选择 main 会话，在输入框附近的模型选择器中选中刚添加的模型。

发送测试句：请只回复：测试成功。收到正常回复即配置成功。

在 Hermes 中配置

第 1 步：打开设置

打开 Hermes 主配置文件：

• Windows：%USERPROFILE%\AppData\Local\hermes\config.yaml

1、增加新模型配置信息。在文件中 model: 段之后，新增：

providers:
  MIAOYUN:
    name: "MIAOYUN"
    base_url: "https://tokenplan.miaoyun.net.cn/v1"
    api_key: "pk-……………………（你自己的 Key）"
    api_mode: "chat_completions"
    default_model: "glm-5.3-flash"

2、切换默认模型。修改配置文件中 model 段的内容为以下内容：

model:
  default: "glm-5.3-flash"
  provider: "MIAOYUN"

修改完成后保存配置文件。

第 2 步：新建会话并验证

修改完配置文件后需要重新启动 Hermes 客户端。发送测试句：请只回复：测试成功。收到正常回复即配置成功。

在 Pi 中配置

第 1 步：添加自定义模型

Pi 没有图形界面来配置，第三方模型统一写进配置文件 models.json 里（若文件不存在则自行创建）：

• Linux / macOS：~/.pi/agent/models.json
• Windows：%USERPROFILE%\.pi\agent\models.json

本章供应商名统一用 MIAOYUN 为例，模型 ID 仍按第一章的说明替换成你实际获取到的模型 ID，此处以 glm-5.3-flash 为例。

{
    "providers": {
        "MIAOYUN": {
            "baseUrl": "https://tokenplan.miaoyun.net.cn/v1",
            "api": "openai-completions",
            "apiKey": "pk-……………………（你自己的 Key）",
            "models": [
                { "id": "glm-5.3-flash" }
            ]
        }
    }
}

修改内容如图所示。

第 2 步：新建会话并验证

修改完配置文件后需要重新启动 Pi 终端，新建一个会话，发送测试句：请只回复：测试成功。收到正常回复即配置成功。

在 Codex 中配置（Windows / macOS）

建议使用 CC Switch 工具来配置，本文中所有涉及到 CC Switch 的内容均使用 CC Switch v4.0.15 版本进行演示。

CC Switch 是统一管理 Claude Code、Codex 等工具供应商配置的桌面工具，可一键切换供应商，不用手改配置文件。

• 下载：官网 ccswitch.io，或 GitHub 仓库 farion1231/cc-switch 的 Releases 页；macOS 也可执行 brew install --cask cc-switch。
• 建议版本：建议安装最新版。首次启动时如提示导入现有配置，可按向导导入，避免原有配置（MCP、Skills 等）看起来像「丢失」。
• 同一个 MIAOYUN 供应商要在 Codex 和 Claude Code 里各添加一次（两个标签页的配置互相独立），参数区别只有一处：请求地址带不带 /v1，具体详见下表。

7.1 方式一：OpenAI Responses 协议配置（原生直连模式·推荐）

适用情形：所选模型在平台上原生支持 OpenAI Responses 协议（例如平台分配的 glm-5.3-flash 等）。Codex 客户端底层默认以 Responses 协议（/v1/responses）通信，因此选用原生直连链路最短、响应速度最快，且完全不需要 CC Switch 本地路由服务常驻后台。

第 1 步：在 Codex 标签页添加供应商

打开 CC Switch，顶部切到「Codex」标签，点击右上角的 ＋添加供应商，选择「自定义配置」。

第 2 步：填写 Codex 供应商参数（关键步）

供应商名称填 MIAOYUN GLM；API Key 粘贴你自己的 Key；请求地址填 https://tokenplan.miaoyun.net.cn/v1（带 /v1）；默认模型填 glm-5.3-flash。上游格式保持/选择 Responses（原生）即可，本接口实测支持 Responses，无需开启本地路由做协议转换。填完点「添加」。

第 3 步：启用并验证

回到供应商列表，在 MIAOYUN GLM 卡片上点「切换」。然后重启终端（或完全退出并重开 Codex），运行 codex，发送：请只回复：配置测试成功。收到正常回复即成功。Codex 桌面端若暂时看不到自定义模型，先确认已启用且已彻底重启应用。

7.2 方式二：OpenAI Chat Completions 协议配置（本地路由模式）

适用情形：所选模型在平台上仅提供 OpenAI Chat Completions 协议（例如 DeepSeek V3/R1 等纯对话大模型，不支持 Responses 协议）。Codex 客户端发出的仍为 Responses 请求，无法被平台直接解析。此时必须在 CC Switch 中选择 Chat Completions 上游格式，并开启本地路由接管：CC Switch 将在本地代理层把 Codex 的 Responses 请求自动转换为 Chat Completions 转发给平台，再将响应流转回 Responses 格式。

第 1 步：在 Codex 标签页添加供应商并选择上游格式

打开 CC Switch，顶部切到「Codex」标签，点击右上角「+ 添加供应商」，选择「自定义配置」。

第 2 步：填写接入参数并保存

供应商名称填 MIAOYUN GLM (Chat)；API Key 粘贴你的 Key；API 请求地址填写根地址 https://tokenplan.miaoyun.net.cn（注意：路由模式下由 CC Switch 自动拼接路径，请勿加 /v1，避免路径重复报错）；默认模型填写目标模型 ID（如 glm-5.3-flash）。展开「高级选项」，在「上游格式」下拉菜单中选中「OpenAI Chat Completions（需开启路由）」。核对无误后点击「添加」。保存后卡片上会显示「需要路由」标记，表示该通道必须在本机路由运行时生效。

第 3 步：开启本地路由接管并在 Codex 中验证

在供应商列表中点击该卡片的切换/启用按钮，系统会弹出「需要路由」对话框，点击【开始路由并使用它】启动本地代理服务。随后完全退出并重新打开 Codex（或重启终端），执行测试句：请只回复：配置测试成功。收到正常回复即配置成功。

7.3 方式三：Anthropic Messages 协议配置（本地路由模式）

适用情形：上游模型或第三方服务仅提供 Anthropic Messages 协议接口（/v1/messages）。Codex 原生并不支持 Messages 协议，此时同样由 CC Switch 在本机充当协议转换网关，将 Codex 发出的 Responses 请求转换成 Messages 请求发给上游，并将响应解析还原为 Responses 格式。

第 1 步：在 Codex 标签页添加供应商并选择上游格式

在 CC Switch 的「Codex」标签页点击右上角「+ 添加供应商」→「自定义配置」。

第 2 步：填写接入参数并保存

填入供应商名称、粘贴 API Key，请求地址填写根地址 https://tokenplan.miaoyun.net.cn（注意：路由模式下由 CC Switch 自动拼接路径，请勿加 /v1，避免路径重复报错）。默认模型填入目标模型 ID。在「上游格式」下拉菜单中选中「Anthropic Messages（需开启路由）」。核对无误后点击「添加」。保存后卡片上会显示「需要路由」标记，表示该通道必须在本机路由运行时生效。

第 3 步：开启本地路由接管并在 Codex 中验证

点击启用并在弹窗中确认【开始路由并使用它】，保持 CC Switch 在后台运行。彻底重启 Codex 客户端或重启终端，运行 codex 并发送测试消息：请只回复：配置测试成功。验证正常返回即可。

在 Claude Code 中配置（Windows）

建议使用 CC Switch 工具来配置，本文中所有涉及到 CC Switch 的内容均使用 CC Switch v4.0.15 版本进行演示。

Claude Code 底层原生使用 Anthropic Messages 协议（/v1/messages）。

8.1 方式一：Anthropic Messages 协议配置（原生直连模式·推荐）

适用情形：平台提供的模型原生支持 Anthropic Messages 协议（例如平台分配并支持 Messages 协议的 glm-5.3-flash）。由于 Claude Code 原生即走 Messages 协议，因此采用原生直连配置链路最短、性能最高，且不需要 CC Switch 本地路由服务常驻后台。

第 1 步：在 Claude Code 标签页添加供应商

在 CC Switch 左侧菜单切到「Claude Code」标签，点击右上角的「+添加供应商」。注意不要在 Codex 标签页里改，那是另一套配置。

第 2 步：填写 Claude 供应商参数（关键步，最易错）

供应商名称填 MIAOYUN GLM；API Key 粘贴你自己的 Key；请求地址只填 https://tokenplan.miaoyun.net.cn，绝对不要带 /v1（已实测带 /v1 必 404）。高级选项中 API 格式保持默认的「Anthropic Messages（原生）」，本接口原生支持该协议，无需开启本地路由；认证字段保持默认 ANTHROPIC_AUTH_TOKEN。

模型映射六项——Sonnet、Opus、Fable、Haiku、Subagent、默认兜底模型——全部填 glm-5.3-flash（只用一个模型时必须这样填，否则 Claude Code 发出的分档模型名传到上游会报 model not found）。「声明支持 1M」不要勾。填完点「添加」。

第 3 步：启用并验证

在供应商卡片上点「启用」。新开一个终端会话，运行 claude，可先用 /model 确认当前模型，再发送：请只回复：配置测试成功。收到正常回复即成功。

8.2 方式二：OpenAI Chat Completions 协议配置（本地路由模式）

第 1 步：添加供应商并选择 API 格式（关键步）

在 CC Switch 左侧菜单切到「Claude Code」标签，点击右上角的「+添加供应商」，选择自定义配置，按下图填写。两种情形只有「API 格式」一行不同，其余相同：

请求地址为什么填根地址：路由模式下由 CC Switch 按所选协议自动拼接上游路径（Chat Completions 拼 /v1/chat/completions，Responses 拼 /v1/responses），所以这里只填根地址；若填成带 /v1 的地址会路径重复而报错。

模型映射六项——Sonnet、Opus、Fable、Haiku、Subagent、默认兜底模型——全部填 glm-5.3-flash（只用一个模型时必须这样填，否则 Claude Code 发出的分档模型名传到上游会报 model not found）。「声明支持 1M」不要勾。填完点「添加」。

保存后，该供应商卡片上会出现「需要路由」标记，这是正常标识，表示它必须在本机路由运行时才能工作。

Claude Code 使用除了 Anthropic Messages 以外的协议都需要通过 CC Switch 的路由功能进行协议转换，所以使用时要保持 CC Switch 开启并路由功能为打开状态。

第 2 步：开启本地路由并接管 Claude Code

点击【开始路由并使用它】以后需要退出并重新打开 Claude Code。

路由模式使用须知：

• 使用期间 CC Switch 必须保持运行且路由开关保持开启；退出 CC Switch 或关掉路由，Claude Code 的请求会立刻失败（这与 8.1 章节原生直连不同，直连不依赖 CC Switch 常驻）。
• 在路由模式下切换供应商是热切换，不必重启终端；但 /model 菜单里的显示名称要新开会话才刷新。
• 想恢复官方或原生直连用法：在供应商列表切回对应供应商，重启 Claude Code 客户端。
• 路由模式多了一层本机转换，个别极端响应（如超大工具参数）可能出现流中断，重试或新开会话尝试。

第 3 步：启用客户端并验证

运行 claude：发送测试句「请只回复：配置测试成功」，收到正常回复即成功。再回到 CC Switch「设置 → 路由」页面核对：当前 Provider 应显示为刚启用的供应商、「总请求数」会随对话增长；用量页面里请求会按上游真实模型名显示，可据此确认流量确实走到了目标模型。

再回到 CC Switch「用量统计」页面核对：查看 Claude Code 应用请求日志，可据此确认流量确实走到了目标模型。

8.3 方式三：OpenAI Responses 协议配置（本地路由模式）

适用情形：所选模型仅提供 OpenAI Responses 协议（/v1/responses）。Claude Code 原生发出的 Messages 请求无法直接对接 Responses 接口，此时同样通过 CC Switch 本地路由进行协议转换：CC Switch 本地代理接收 Claude Code 的 Messages 请求并转为 Responses 格式请求平台，将流式响应转回后返回给 Claude Code。

第 1 步：添加供应商并选择上游格式为 Responses API

在 CC Switch 的「Claude Code」标签页点击右上角「+ 添加供应商」→「自定义配置」。

第 2 步：填写接入参数与模型映射

填入供应商名称、API Key，请求地址填写根地址 https://tokenplan.miaoyun.net.cn（路由模式自动拼接路径，请勿带 /v1）。认证字段保持默认 ANTHROPIC_AUTH_TOKEN。展开高级选项，在「上游格式」下拉菜单中选择「OpenAI Responses API（需开启路由）」。

模型映射六项——Sonnet、Opus、Fable、Haiku、Subagent、默认兜底模型——全部填 glm-5.3-flash。「声明支持 1M」不要勾。填完点「添加」。卡片显示「需要路由」标识。

第 3 步：开启本地路由接管并在终端验证

点击该供应商卡片上的启用按钮，在弹出的提示框中点击【开始路由并使用它】启动路由服务。退出并重新打开终端窗口，运行 claude 命令，发送测试句：请只回复：配置测试成功。收到正常回复即代表配置成功。

可在 CC Switch「用量统计」页面确认调用日志已正确转发至 Responses 模型。

常见问题排查

完成自查清单