Appearance
Codex 使用第三方模型
本教程适用于已配置过本站 Codex 的用户。如果还没有配置，请先完成 Codex 安装使用，再按下面的步骤添加其他模型。
检查密钥分组
请先到 网页后台 确认你的 API Key 所属分组能够看到并调用目标模型。JSON 中出现某个模型，不代表该密钥的分组已开通它。
复制给 Agent 配置
已经配置过本站 Codex 的用户，可以直接把下面的提示词复制给 Agent：
text
帮我给 Codex 添加 CloudAwn 模型目录。我已经配置过本站 Codex，请保留现有 API 地址、密钥和其他设置。
1. 下载 https://docs.cloudawn.top/downloads/model-catalog.json ，确认下载内容是有效的模型目录 JSON，不是 HTML 或错误页面。
2. 创建 ~/.codex/model-catalogs 目录，将文件保存为 ~/.codex/model-catalogs/model-catalog.json。Windows 使用当前用户目录下的 .codex。已有同名文件时先备份。
3. 修改 ~/.codex/config.toml，然后只在文件头部添加这一行：
model_catalog_json = "model-catalogs/model-catalog.json"
这行必须作为顶层配置，放在任何 [表头] 之前。如果已有顶层 model_catalog_json，就修改原字段，不要重复添加。
4. 不要覆盖整个 config.toml，不要修改默认模型、API 地址或密钥。仅为下面的模型列表检查，在本地读取当前 provider 使用的密钥；不要在日志、命令输出或回复中暴露密钥，也不要将它写入其他文件。配置目录以实际 CODEX_HOME 为准（未设置时为 ~/.codex）。
5. 检查 JSON 和 TOML 格式有效，并告诉我修改了哪些文件。完成后提醒我重启 Codex，在模型列表中选择模型；不要自动结束当前会话。
使用当前 API Key，向现有 provider 的 base_url 对应的 /v1/models 端点发送 GET 请求（本站主站为 https://api.cloudawn.top/v1/models），通过 Authorization: Bearer <当前密钥> 认证。不要重复拼接 /v1。检查响应中的 data[].id，确认目标模型是否出现在当前密钥可见的模型列表中；如果我没有指定目标模型，就列出模型目录中哪些模型可见、哪些未返回。只报告检查结果，不输出密钥。模型列表可见不代表实际调用一定成功；请求失败时如实说明，不要推断为已开通权限。如果希望手动配置，按下面的步骤操作。
1. 下载模型目录
在 .codex 目录下新建 model-catalogs 文件夹，把下载的 JSON 文件放进去：
| 平台 | 文件位置 |
|---|---|
| macOS / Linux | ~/.codex/model-catalogs/model-catalog.json |
| Windows | %userprofile%\.codex\model-catalogs\model-catalog.json |
macOS / Linux 可以先创建目录：
bash
mkdir -p ~/.codex/model-catalogs这份 JSON 同时包含常用 GPT 模型和部分第三方模型，方便在同一份目录中切换使用：
- GPT：
gpt-5.5、gpt-5.6-luna、gpt-5.6-terra、gpt-5.6-sol、gpt-6-astra。 - 第三方模型：GLM、MiniMax、Grok、Kimi、Qwen、MiMo、DeepSeek 等。
示例沿用 Codex 模板的 272K（272,000 tokens）上下文，在约 244.8K tokens 时触发自动压缩。这是本示例的客户端配置，不代表所有 Codex 模型的默认值或上游的原生最大上下文。
这是基础示例，不是完整的模型列表，也不是 Codex 官方目录的完整副本。新增 GPT 条目沿用示例模板，能力和上下文参数应按实际模型支持调整。更多模型和价格请查看 模型广场，你可以参照示例自由添加或修改。
2. 修改 config.toml
放好 JSON 文件后，只需在 config.toml 头部添加一行，其他配置保持不变：
toml
model_catalog_json = "model-catalogs/model-catalog.json"配置文件位置为 ~/.codex/config.toml（Windows 为 %userprofile%\.codex\config.toml）。无需重新填写 API 地址或密钥，也不用替换整个文件。
配置位置
这行必须放在 [model_providers.cloudawn] 等表头之前，作为顶层配置。已有该字段时直接修改，不要重复添加；原有的 API 地址和密钥配置不需要替换。
保存后重启 Codex，再选择目录中的模型。CLI 可以通过 /model 查看模型选项。
如果提示找不到 JSON 文件，可将 model_catalog_json 改为该文件的完整绝对路径。Windows 路径建议使用正斜杠，例如 C:/Users/你的用户名/.codex/model-catalogs/model-catalog.json。
3. 替换或增加模型
示例包含 GLM、Grok、Kimi、DeepSeek 等模型。你可以在 JSON 的 models 数组中参照已有条目添加模型，再将 config.toml 的 model 改为对应的 slug。
| 字段 | 用途 |
|---|---|
slug | 请求使用的模型名称，需与模型广场中的名称一致 |
display_name | Codex 中显示的模型名称 |
description | 模型说明 |
supported_reasoning_levels | 可选择的推理强度，例如 low、medium、high、xhigh |
default_reasoning_level | 默认推理强度，应来自该模型支持的等级 |
input_modalities | 输入类型；["text", "image"] 表示声明支持文字和图片输入 |
能力声明不等于实际能力
模型目录描述的是 Codex 如何展示和使用模型，不会自动给模型增加视觉、推理或工具调用能力。推理强度如何映射、图片是否可用，以及模型能否通过 Responses 接口调用，都取决于 CloudAwn 对应上游的实际支持。不要只改模型名称，就把示例中的全部能力照搬给新模型。
示例中的第三方能力按具体型号整理，而不是统一照搬 GPT 的档位：
| 模型 | 示例推理选项 | 图片输入 | 官方依据 |
|---|---|---|---|
| GLM 5.3 Flash | low / high / max | 支持 | 模型卡 |
| MiniMax M3 | none / high（关闭 / 开启自适应思考） | 支持 | Codex 配置 |
| Grok 4.6 | low / medium / high / xhigh | 支持 | 推理说明、模型说明 |
| Kimi K3 | low / high / max | 支持 | 模型说明 |
| Qwen 3.8 Max | low / medium / xhigh | 支持 | 推理说明、发布说明 |
| MiMo V2.5 Pro | none / high（关闭 / 开启思考，不区分深度） | 不支持 | 模型规格、Responses 说明 |
| DeepSeek V4.1 Flash | none / low / high / max | 支持 | 思考模式、视觉说明 |
| DeepSeek V4 Flash | none / low / high / max | 支持（本站渠道已确认） | 更新日志 |
| DeepSeek V4 Pro | none / low / high / max | 示例按纯文本配置 | 更新日志 |
none 表示关闭思考；MiniMax 和 MiMo 的 high 只代表开启思考。本站 deepseek-v4-flash 已确认支持图片输入，示例保留视觉声明；V4 Pro 仍按纯文本配置。官方模型能力与本站转发层的推理档位映射仍需分别核对。
这是基础配置，你可以按需要保留常用模型、调整顺序或补充其他模型。修改 JSON 后请保持格式有效，并重启 Codex 加载新的目录。
配置字段说明可参考 Codex 官方配置参考。