从写代码,到创作下一幕

探索 字节跳动 - 火山方舟 的 AI 编程与视频创作活动。

Agent Plan & Coding Plan

一站体验多款热门模型,为 AI 编程与智能体开发提供更多选择。新用户可联系(微信: goo_lvyouyou)免费体验 9.9 agent plan。

Seedance 2.5

让创意,跃然成片。探索 30 秒视频、多模态参考与局部编辑,把脑海中的画面变成下一支作品。

中文

部署网关

为组织分发并验证 Codex 网关连接

作为网关管理员,请配置模型路由并授权一名试点用户。在向开发者分发设置之前,请在支持的每个客户端上测试连接。使用原生网关 OAuth、API key 或凭据辅助程序进行网关身份验证。要将网关身份验证与 ChatGPT 工作区登录结合使用,请参阅 通过网关登录 ChatGPT。

前提条件

向开发者部署 Codex 之前,请确认已具备:

  • 一个通过 HTTPS 提供服务的网关,其基础 URL 与你将分发的 URL 完全一致。
  • 由网关持有的上游提供商凭据。
  • 已批准的面向 Codex 的模型别名,且已映射到预期的上游模型。
  • 经过测试的身份验证方式:原生网关 OAuth、限定作用域的网关 API key,或凭据辅助程序。
  • 对于 OAuth,已注册的公共客户端、已批准的测试用户,以及网关对 OAuth 访问令牌验证的支持。
  • 对于 API key 或辅助程序,密钥分发机制或经过测试的辅助程序。
  • 用于分发配置、任何必需的辅助程序和目录文件的方式。

网关要求

连接 Codex 之前,请验证网关产品是否保留以下必需行为:

  • 在 POST /v1/responses 接受 Codex Responses API 请求。
  • 无缓冲地流式传输 SSE 事件,并以 response.completed 结束。
  • 支持通过重放输入延续后续对话。
  • 仅在启用 WebSocket 或增量传输时保留 previous_response_id。
  • 保留函数调用及对应的 function_call_output 项。
  • 将每个面向 Codex 的模型别名路由到预期的上游模型。
  • 分别对用户进行身份验证,并返回有助于排查问题且不掩盖原因的错误。

健康检查端点、/v1/models、Chat Completions 响应或一次纯文本回复,都不足以证明网关符合要求。有关详细约定,请参阅网关兼容性要求。

推广网关

要从已部署的网关过渡到经过验证的开发者使用环境,请按顺序完成以下五项检查:

  1. 选择模型名称并验证路由。
  2. 选择身份验证方式。
  3. 通过网关测试 Codex。
  4. 分发配置。
  5. 在开发者计算机上验证。

选择模型名称和路由

将 Codex 的 model 设置为网关的模型名称。配置网关,将该名称路由到已获批准的上游模型。

网关模型名称 Codex 配置
Codex 版本中包含的内置模型名称 将 config.toml 中的 model 设置为这个确切名称。
自定义别名,例如 company-coding-model 提供包含该别名及对应模型元数据的远程或本地目录。

为自定义名称使用模型目录

对于本地目录,请从 models.json 示例开始。

如果网关使用的模型名称无法被 Codex 识别,请提供模型目录。目录提供 Codex 针对该名称使用的指令、推理选项、上下文限制和工具能力。如果没有匹配的条目,请求可能会到达预期的上游模型,但 Codex 会使用通用设置。

使用 model_providers.<id>.model_catalog_url 托管远程目录,以集中更新模型元数据,或使用 model_catalog_json 分发本地文件。当原生网关 OAuth 是唯一的凭据时,请使用本地目录;仅靠 OAuth 无法启用远程目录发现。有关这两项设置,请参阅配置参考。

从云服务提供商或网关提供商处获取与当前 Codex 版本兼容的目录端点或文件。确保其中包含每个获准使用的别名及其模型元数据。有关目录实现,请参阅 为网关和云服务实现模型目录。

提供远程目录

使用提供商提供的 HTTPS 目录端点。在所选提供商的 config.toml 表中分发完整的端点 URL:

model = "company-coding-model"
model_provider = "enterprise-gateway"
web_search = "disabled"

[model_providers.enterprise-gateway]
name = "Organization Gateway"
base_url = "https://gateway.example.com/v1"
model_catalog_url = "https://gateway.example.com/codex/models"
wire_api = "responses"
env_key = "CODEX_GATEWAY_API_KEY"

确保 Codex 进程可以访问 CODEX_GATEWAY_API_KEY。单独设置 base_url,以便通过网关路由推理请求。如果省略此项,Codex 会使用当前身份验证方式对应的默认 OpenAI 端点。

目录发现需要通过 API key、命令或 Codex 后端进行身份验证。仅使用原生网关 OAuth 或自定义请求头不会触发目录发现。

获准使用的模型发生变化时,请与提供商协调更新目录。更改配置后,重启客户端。

移除所有生效的 model_catalog_json 设置,包括通过 requirements.toml 强制设置的值。它的优先级高于远程 URL,会阻止远程获取。

分发本地目录

使用 model_catalog_json 在启动时加载提供商提供的文件。本地自定义目录会替换内置目录。

将网关别名、目录中的 slug 和 Codex 的 model 设置为 company-coding-model。在分发的 Codex 配置中,将以下设置添加到第一个 TOML 表之前,并使用文件的实际绝对路径:

model = "company-coding-model"
model_catalog_json = "/absolute/path/to/gateway-models.json"

更改目录后,请重启 CLI 或桌面应用,因为 Codex 会在启动时加载目录。

验证模型路由

对每个模型,使用真实的 Responses 请求和网关记录验证路由。/v1/models 响应可以帮助发现名称,但不能证明模型支持所需的请求和工具行为。

模型路由和工具授权是推广过程中的两个独立部分。请分别配置 MCP 连接、插件分发及其策略。

选择身份验证方式

原生网关 OAuth

  1. 注册支持带 PKCE 的授权码流程的公共 OAuth 客户端,并批准可以登录的用户或群组。
  2. 配置网关,使其验证通过所选 cookie 或自定义请求头传递的已签发访问令牌。将批准的模型、速率限制和预算应用于每个用户的身份。
  3. 按照原生网关 OAuth中的说明,收集授权和令牌 URL、公共客户端 ID、作用域、可选资源、令牌传递设置以及任何固定重定向端口。向身份提供商注册匹配的回环重定向 URI。
  4. 在计划部署的 CLI 或桌面应用上,使用测试用户测试浏览器登录、令牌刷新和访问权限撤销。确认浏览器能够访问回调地址,包括远程 CLI 用户的使用场景。

用户各自登录。你分发的是 OAuth 配置,而非客户端密钥、网关 API key 或辅助程序可执行文件。将上游提供商凭据保留在网关上。

API key 或凭据辅助程序

  1. 为每位开发者签发一个限定权限范围的网关凭据,以便将用量归属于具体开发者并单独撤销访问权限。
  2. 为每个凭据设置获准使用的模型、速率限制、预算、有效期和续期周期。
  3. 通过敏感信息管理器或已安装的凭据辅助程序分发凭据。不要将上游提供商和网关管理员凭据存放在开发者机器上。
  4. 如果使用辅助程序,请遵循 基于命令的身份验证约定,并在分发前测试令牌获取和刷新。
  5. 告知开发者如何续期凭据,以及遇到问题时应联系谁。

通过网关测试 Codex

在分发任何内容之前,请按照配置提供商中的说明,使用计划分发的提供商配置块和身份验证方式,为一个独立的测试用户进行配置。

如果网关提供模型目录,请确认它返回与 Codex 兼容的 models 数组。对于使用用户凭据的 OpenAI 推理,请确认网关将所需的 ChatGPT 标头转发到 Codex 后端。

记录试点所用的客户端版本、操作系统、提供商 ID、模型别名和身份验证方式。在计划支持的每个 CLI 或桌面端界面中运行以下检查。如果同时提供仅通过网关进行身份验证的方式,以及网关身份验证与 ChatGPT 登录相结合的方式,请分别测试每种组合。

检查项 操作 通过依据
生效配置 检查各配置层,确认提供商、模型和要求符合预期。 试点使用已分发的设置。用户或配置档案的默认设置未选择其他路由。
连接 按照验证连接中的步骤操作。 预期的提供商和别名已启用,测试提示词执行成功,且网关日志中可识别测试用户。
流式传输 要求生成包含多个段落的简短回答。 文本逐步到达,且当前传输方式发出 response.completed。单独测试 HTTP,验证网关转发 SSE 事件时不会缓冲。
本地工具循环 在具有只读权限的临时文件夹中,要求 Codex 列出顶层文件并概述其内容。 Codex 发起本地工具调用、返回结果,并在不修改文件的情况下生成最终回答。
追问 在同一对话线程中追问。 回答使用上一轮的内容;网关接受重放的输入。如果启用了 WebSocket 或增量传输,还会保留 previous_response_id。
错误与归属 使用故意设为无效的测试别名或已过期的测试凭据重复测试。 客户端收到有助于排查问题的路由或身份验证错误,且有效请求仍归属于测试用户。

如果启用了自动审批,请使用临时测试文件夹,触发一项根据预期策略需要评审的工具操作。确认网关能够处理评审请求,且客户端会应用审批决定。不需要审批的只读工具调用无法测试此流程。在扩大试点范围之前,记录所有不受支持的工作流。

如果此次部署会更改现有用户的提供商,请在每个受支持的客户端上测试新对话和更改前创建的对话。记录用户能否查看、继续现有对话或从中创建分支,并为任何受阻的工作流提供恢复步骤。不要假定更改默认提供商会迁移对话历史记录。

这些检查通过后,准备向开发者交接。

分发配置

要让所有计算机使用相同的连接路径,请分发网关基础 URL、提供商 ID、已批准的模型别名和身份验证设置。

分发内容

对于原生网关 OAuth,请分发提供商表和 [model_providers.<id>.gateway_oauth] 表,具体参见连接指南,并填入上面收集的注册信息。保留 requires_openai_auth = false,并省略 env_key、experimental_bearer_token 和基于命令的 auth 表,前提是 OAuth 是唯一的网关凭据。

对于凭据辅助程序,请通过所选的配置层分发以下 config.toml 配置块。使用当前 Codex 版本能够识别的模型,或提供上文所述的匹配目录。将令牌解析程序安装到配置的命令路径:

model = "gpt-6-sol"
model_provider = "enterprise-gateway"
web_search = "disabled"

[model_providers.enterprise-gateway]
name = "Organization Gateway"
base_url = "https://gateway.example.com/v1"
wire_api = "responses"

[model_providers.enterprise-gateway.auth]
command = "/usr/local/bin/fetch-codex-gateway-token"
args = ["print-token"]
timeout_ms = 30000
refresh_interval_ms = 300000

对于短期有效的静态测试密钥,移除身份验证配置块,将 env_key = "CODEX_GATEWAY_API_KEY" 放入 [model_providers.enterprise-gateway] 中,并在 TOML 之外设置该变量。不要将 env_key 与基于命令的身份验证结合使用。

分发默认值和强制要求

如果用户不使用 ChatGPT 登录 Codex,你可以从自己的服务器分发团队设置。Codex 获取这些设置的过程独立于模型请求的路由方式。

使用配置优先级 选择分发默认值的位置。有关强制设置和 macOS MDM 载荷,请参阅受管配置。

对于 macOS 或 Linux 上的整机默认值,使用 /etc/codex/config.toml。在 Windows 上,将 config.toml 放入 %ProgramData%\OpenAI\Codex\。用户和配置档案可以覆盖这些默认值。链接中的参考资料介绍了支持的强制要求及其文件位置。

单独分发引用的辅助程序可执行文件和本地目录文件。

要强制使用远程目录 URL,请将完整的提供商定义放在 requirements.toml 的 [model_providers.<id>] 下。强制执行的提供商定义会替换常规配置中匹配的提供商表;请包含其 base_url、身份验证设置和其他必需字段。如果还需要强制选择提供商,请使用 model_provider 要求。

model_catalog_json 指向本地 JSON 文件。如果通过 requirements.toml 强制设置它,该要求只会固定路径;不会分发文件。请在 Codex 启动前将目录放到该绝对路径。

在 TOML 中写入已解析的 Windows 绝对路径。Codex 不会展开 model_catalog_json 或提供商身份验证 command 值中的 %ProgramData%。例如,只有在部署时将文件放到以下位置后,才能使用这些路径:

model_catalog_json = 'C:\ProgramData\OpenAI\Codex\models.json'

[model_providers.enterprise-gateway.auth]
command = 'C:\ProgramData\OpenAI\Codex\fetch-gateway-token.cmd'
args = ["print-token"]

WSL 中的 CLI 读取 Linux 路径和 Linux 的 CODEX_HOME;不会自动继承原生 Windows 配置。

分发路由请求头

如果网关根据配置或工具来路由请求,请在受管的 requirements.toml 中,将网关所需的请求头添加到提供商配置中。以下示例提供了路由配置 ID,并将 Codex 标识为客户端:

[model_providers.enterprise-gateway.http_headers]
x-portkey-config = "<gateway-routing-config-id>"
x-portkey-metadata = '{"tool_id":"codex"}'

对于由客户端环境提供的请求头值,请使用 env_http_headers。发送测试请求,并在网关日志中确认所选路由。有关请求头选项,请参阅自定义模型提供商。

向开发者提供配置值

向开发者提供一套与你测试过的试点一致的设置流程。即使集中分发配置,也应包含以下信息:

交接项目 需要提供的内容
已批准的客户端 试点所用的客户端、版本、操作系统,以及安装或更新说明。
配置交付 说明设置是否已受管,还是需要在本地设置;指出所有单独安装的辅助程序或目录文件。
预期连接 提供商 ID、模型别名和网关 URL(包括其 API 路径)。说明用户可以更改哪些值。
登录步骤 说明用户是否必须登录 ChatGPT 工作区、向网关进行身份验证,或同时完成两者。明确所需的工作区和网关身份验证方式。
凭据和目录 OAuth 注册参数值、凭据环境变量或已安装的辅助程序配置,以及任何目录 URL 或解析后的本地路径。通过已批准的密钥分发机制交付密钥。
验证与支持 连接测试、预期结果、网关负责人,以及报告故障时需要提供的信息。

对于受管设备,请引导开发者参阅检查现有配置。对于手动设置,请引导他们参阅配置提供商。

如果此次部署会更改提供商,请附上经过测试的现有对话处理说明。为部署负责人保留先前可用的配置,以便在试点发现问题时使用。

手动设置不是强制配置渠道。项目本地的 .codex/config.toml 无法覆盖敏感的提供商或身份验证路由键。

在开发者机器上验证

要确认分发的设置已到达开发者机器:

  1. 确认已安装获批的客户端以及所有必需的辅助程序或目录文件。重启 Codex,并完成交接说明中的登录步骤。
  2. 确认提供商和模型符合预期。在 CLI 中,使用 /status。当生效设置与交接说明不一致时,使用 /debug-config 检查各配置层。
  3. 运行连接到网关中的简短测试。
  4. 追问一次以确认对话可以继续,然后检查网关日志中该开发者的请求。

在所支持的客户端和身份验证组合上通过试点测试后,再扩大访问范围。将经过测试的配置和结果与部署说明一并保存,以便在客户端、网关或策略更新后重复检查。

排查推广过程中的故障

根据问题定位需要处理的配置层、凭据层或网关层:

问题 解决方法
重启后未显示预期的提供商。 检查最终生效的配置层。用户配置或配置档案可以覆盖系统默认值。
所有用户的身份验证均失败。 检查网关身份验证和上游提供商凭据;确定是哪个服务拒绝了请求。
某个用户的身份验证失败。 检查该用户的身份提供商访问权限、网关凭据或令牌解析程序。
流式传输停滞。 检查网关缓冲以及表示结束的 response.completed 事件是否被转发。
模型缺失或使用了通用能力。 对于自定义别名,确认网关别名、Codex model 和目录 slug 一致。检查目录路径及其与已安装 Codex 版本的兼容性,然后重启 Codex。
Windows 路径不可用。 使用解析后的绝对路径。在 TOML 中,对使用单个反斜杠的 Windows 路径使用单引号字符串。

复用现有网关部署

如果组织已经通过网关使用 Claude Code,你或许可以复用网关产品、网络路径、日志记录和 Bedrock 访问。添加面向 Codex 的 Responses 路由、凭据、模型别名和 config.toml,同时保留现有可用配置。Claude 客户端设置和 /v1/messages 约定不会配置 Codex。

现有 Claude 部署 Codex 迁移
网关产品、DNS、TLS、私有网络、日志记录、脱敏和监控 保留这些服务。添加满足网关兼容性要求的面向 Codex 的路由。
Bedrock 账户、提供商凭据、IAM 边界、推理配置档案和凭据轮换 仅当它们授权访问新 Codex 别名背后的上游模型时才予以保留。提供商凭据仍保留在网关上。
Claude /v1/messages 路由、Bedrock InvokeModel 格式、Anthropic 请求头以及 Claude 专用的重试或错误处理 不要将这些作为兼容性证明。Codex 需要 POST /v1/responses、Responses 流式传输、对话延续、工具调用以及有助于排查问题的错误信息。
ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY 或 apiKeyHelper Codex 不支持 apiKeyHelper。请配置原生网关 OAuth、通过 env_key 使用的限定作用域的密钥,或基于命令的 Codex 令牌解析程序。
Claude 模型名称、ANTHROPIC_MODEL、ANTHROPIC_DEFAULT_*_MODEL、modelOverrides 和 Bedrock 配置档案映射 请网关团队选择模型名称并配置任何自定义别名。使用他们提供的模型名称和任何模型目录 JSON。
Claude settings.json、managed-settings.json、JSON env 块、plist 或注册表载荷 保留原有的 MDM 或配置管理渠道,但改为分发 Codex config.toml 和受支持的 requirements.toml 值。

要安全迁移,请按顺序完成以下步骤:

  1. 盘点当前 Claude 的接入路径:网关 URL、凭据来源、必需的请求头、模型别名、Bedrock 配置档案映射和受管分发渠道。
  2. 添加一条并行的、面向 Codex 的 Responses 路由,以及 Codex 模型别名。
  3. 选择网关原生 OAuth、API key 或凭据辅助程序,并授权一名测试用户。对于静态凭据,通过 env_key 提供;对于辅助程序,实现并测试 Codex 基于命令的解析器契约。
  4. 使用第 3 步所选的身份验证方式,为该开发者配置提供商。对于受管部署,将载荷转换为部署网关中所述的 Codex 路径和优先级。
  5. 在开发者实际使用的 CLI 或桌面端界面中运行简短的连接检查,然后运行通过网关测试 Codex中的完整检查,涵盖流式传输、对话继续、工具调用、错误、日志和别名路由。
  6. 试点通过后,向其余开发者分发配置。

模型目录参考

从本地 models.json 文件开始

首先,在运行 Codex 的设备上配置并选择网关提供商。

将此目录保存为运行 Codex 的设备上的 models.json。将 gateway-model 替换为网关接受的确切模型 ID。显示名称是用户在模型选择器中看到的标签。

{
  "models": [
    {
      "slug": "gateway-model",
      "display_name": "Gateway model",
      "base_instructions": "Help the user with their coding tasks.",
      "supported_reasoning_levels": [],
      "shell_type": "shell_command",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 0,
      "support_verbosity": false,
      "truncation_policy": { "mode": "tokens", "limit": 10000 },
      "experimental_supported_tools": []
    }
  ]
}

如需更完整的示例,请参阅 Codex 的模型目录。

将 config.toml 中的 model_catalog_json 设置为该文件的绝对路径。重启 Codex,选择 Gateway model,然后发送请求。检查网关是否收到了你在 slug 中设置的模型 ID。

对于内置模型的别名,复制与你的 Codex 版本对应的完整目录条目,并更改其中的 slug 和 display_name。如果该别名没有迁移目标,请将 upgrade 设置为 null。这样可以保留模型的上下文窗口、推理选项和工具设置。

向客户端提供目录

本页面向实现 Codex Models 格式的开发者,该格式定义了模型目录,并为模型选择器提供支持。如果你正在构建推理提供商(例如网关或云服务),可使用本规范,让 Codex 桌面应用和 CLI 发现你的模型,并使用其指令和能力设置。

如果你是企业管理员,希望控制模型目录,请参阅 model_catalog_url 配置指南。

要支持此格式,请实现一个需要身份验证的目录端点。根据发起请求的 Codex 版本,获取上游提供商当前的默认配置,应用你的覆盖配置,然后返回生成的目录。

实现目录端点

默认目录端点位于提供商的 base_url 下,路径为 /models。例如,配置为 base_url = "https://gateway.example.com/v1" 时,Codex 会请求:

GET /v1/models?client_version=0.162.1
Authorization: Bearer <PROVIDER_ACCESS_TOKEN>

默认发现机制支持基于命令的身份验证和 Codex 后端身份验证,例如 ChatGPT。对于使用 API key 身份验证但未使用基于命令的身份验证的自定义提供商,请显式设置 model_providers.<id>.model_catalog_url,以启用远程发现。仅提供 API key 不会触发默认路径上的发现。

使用 model_catalog_url 指定完整的目录 URL,例如 https://gateway.example.com/codex/models。它也可以指向默认的 /v1/models 端点。Codex 会直接使用此 URL,不会追加 /models。使用 API key 进行发现时,请保持 features.api_key_model_discovery 启用;该设置默认启用。仅配置自定义请求头不会启用发现。

Codex 会发送所选提供商的身份验证信息和已配置的请求头,并追加 client_version 以及提供商的所有 query_params。请将目录托管在获准接收这些凭据的服务上。

验证调用方身份,获取相应的上游默认配置,应用你的覆盖配置,并直接返回完整的 ModelsResponse JSON。为每个条目指定唯一且非空的 slug。对于显式指定的 model_catalog_url,Codex 会拒绝重定向和大于 1 MiB 的响应。仍需对推理请求强制执行模型访问控制。

从使用该端点的客户端中移除所有生效的 model_catalog_json 设置:本地文件具有更高优先级,会阻止远程获取。

匹配客户端的架构

读取目录请求中的 client_version 查询参数。Codex 会以 major.minor.patch 格式发送其 CLI 版本,并移除所有预发布后缀。对于桌面客户端,该版本是其捆绑的 CLI 版本。

使用公共 Codex 仓库中匹配的 rust-v<version> 标签;对于自定义构建,请使用其确切的源代码提交。以下链接使用 rust-v0.162.1;请选择与你的客户端匹配的修订版本:

捆绑的文件是发布时的快照。生成目录前,请先获取当前默认配置。

获取当前上游默认配置

提供 OpenAI 模型的云提供商从 OpenAI 获取默认配置。网关读取其云提供商或上游提供商的目录,以保留已部署模型的设置,以及账户和区域可用性。每一步都要传递发起请求的 Codex 版本,并分别向各个端点进行身份验证。

要直接从 OpenAI 获取默认配置,请使用相同的 client_version 调用 Codex 模型端点。例如,使用 OpenAI API key:

curl --fail --silent --show-error \
  'https://chatgpt.com/backend-api/codex/models?client_version=0.162.1' \
  -H "Authorization: Bearer $OPENAI_API_KEY"

对于 ChatGPT 集成,请使用调用方的 ChatGPT 访问令牌,并在适用时使用 ChatGPT-Account-ID 请求头。请使用获准访问上游端点的凭据;网关自身的 API key 无法用于向 OpenAI 进行身份验证。

解析完整响应,包括其顶层 models 数组。此端点返回 Codex 元数据,例如指令、推理默认配置、工具设置、上下文限制和服务层级。公共 /v1/models 端点不提供此目录。

即使 Codex 版本未发生变化,也要刷新这些默认配置。将请求限定在预期的上游身份范围内,并遵循响应的缓存控制:目录可能取决于调用方的访问权限。单独保存你的覆盖配置,以便将其重新应用于最新的默认配置。

应用提供商覆盖配置

修改字段值,同时保留该版本的响应结构:

  • 筛选模型,仅保留调用方可使用的模型。将每个 slug 映射到受支持的推理路由,并调整 display_name、description 或 priority。对于不涉及模型迁移的别名,将 upgrade 设置为 null。
  • 将推理选项、上下文限制、输入模态和服务层级设置为你的模型和路由支持的值。确保默认值处于支持的选项范围内。对于不支持服务层级的路由,清空 service_tiers 和 additional_speed_tiers,并将 default_service_tier 设置为 null。
  • 保留上游指令和工具设置,除非你已测试过替代配置。元数据不会增加模型能力,也不会授予推理访问权限。

对于网关模型别名,请参阅如何 提供模型元数据。使用每个受支持的 Codex 版本测试生成的目录。

使用公共 Rust 类型

使用与客户端架构对应的同一公共 Git 标签或提交中的 crate:

  • 使用 codex-protocol 中的 codex_protocol::openai_models::{ModelsResponse, ModelInfo}。通过 serde_json::from_slice::<ModelsResponse>() 解析,编辑 catalog.models,再通过 serde_json::to_vec() 序列化整个封装对象。该封装对象会处理模型指令的兼容性字段。
  • 使用 codex-models-manager::bundled_models_response(),将该修订版本捆绑的静态目录加载为 ModelsResponse。它不会获取当前上游默认配置。

相关文档