让任意模型出现在Codex子代理选择器中OpenCodex Sub-agent Surface深度使用教程【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址: https://gitcode.com/gh_mirrors/ope/opencodexOpenCodexOpenAI Codex Claude Code 通用提供方代理的Sub-agent Surface子代理界面功能可以把你配置好的任意第三方模型——Claude、Gemini、Grok、DeepSeek 等——直接放进 Codex 的子代理选择器让主代理随时把任务并行委派给你自选的模型。本教程带你从模式选择、模型名册到委派指引完整配置 OpenCodex 的子代理 Surface让任意模型出现在 Codex 子代理选择器中。什么是子代理先认识这个并行工人子代理sub-agent是主代理创建的独立 Codex 工作器它拥有独立的上下文和工具集因此多个独立任务可以并行推进。OpenCodex 负责管理三件事但不决定主代理何时委派Codex 使用哪种协作界面暴露子代理v1 / base / v2子代理选择器中展示哪些模型roster最多 5 个首选模型失败或配额耗尽时自动回退到哪条链路。打开ocx gui进入仪表盘左侧导航的Subagents页面就是管理子代理选择器的入口。一键切换三种子代理界面模式v1 / base / v2子代理 Surface 有三种模式它决定每个模型在目录中的multi_agent_version字段从而决定 Codex 向子代理提供哪一套工具集模式Codex 获得什么适合谁v1经典spawn_agent、send_input、resume_agent工具spawn 时可直接指定另一个模型需要在不同 provider 之间可靠委派的初学者base默认尊重每个模型的上游固定值未固定的跟随 Codex 功能开关大多数用户推荐从它开始v2扁平化spawn_agent、send_message、interrupt_agent等工具支持并发会话想要最新并发工作流、理解模型继承规则的用户三种方式随时切换任选其一GUIDashboard 顶部 Sub-agent 卡片或 Models 页顶部分段控件点选 v1 / base / v2CLIocx v2 mode v1、ocx v2 mode default、ocx v2 mode v2APIPUT /api/v2请求体{multiAgentMode:v2}注意模式更改只影响新建会话已有会话保留其开始时的界面。若长时间运行的 App 仍显示旧目录请运行ocx sync并重启该 Codex 界面。三步让任意模型出现在子代理选择器这是本教程的核心。原理很简单Codex 会把选择器可见的目录条目按priority升序排序取前 5 个作为spawn_agent的模型 override 列表。OpenCodex 会把你挑选的模型按顺序写入subagentModels并调整目录优先级——被选中的模型由此稳定占据选择器前排。第 1 步在 Subagents 页面挑选并排序最多 5 个模型支持三种形式的模型 id裸原生 id如gpt-5.6-sol、路由 id如anthropic/claude-sonnet-5、xai/grok-4.5、账户限定的selector/native-modelid精确 id 需通过 CLI 设置。第 2 步设置委派指引模型与推理强度可选在 Dashboard 的Sub-agent delegation卡片里选择一个首选工作器模型和可选的 reasoning effortOpenCodex 会在提示词中注入委派指引告诉主代理优先使用该模型、roster 里还有哪些可用。第 3 步同步目录新建会话生效ocx agent subagents set gpt-5.6-sol,anthropic/claude-sonnet-5 # 命令行一键设置名册 ocx sync # 刷新 Codex 模型目录完成以上步骤后你的路由模型就会像上图这样出现在 Codex 的子代理选择器里。✨配置子代理委派模型与推理强度Sub-agent delegation管理三个相关设置injectionModel首选工作器模型、injectionEffort可选的 reasoning effort、injectionPrompt自定义指引文本支持{{model}}、{{effort}}、{{roster}}、{{fallback}}四个占位符。两点常见疑问指引 ≠ 强制这些是发给主代理的建议不是代理侧的 spawn 路由器是否委派仍由主代理判断effort 上限injectionEffort只影响子代理委派指引不会改变父会话的 effortultra是面向客户端的顶级档位Codex 会将其转换为max。回退链子代理配额耗尽时自动换模型首选模型配额用尽时任务不会卡住。OpenCodex 按以下优先级构建回退顺序请求的主模型按模型配置的 per-model 回退链subagentModelFallbackByModel全局回退列表subagentModelFallback。ocx agent fallback set gpt-5.4-mini,xai/grok-4.5 --poll-ms 60000选择过程中会自动跳过已禁用、冷却中、标记不健康或超出配额阈值的候选可用性探测默认缓存 60 秒避免频繁探测。子代理选择器常见问题4 个高频坑问题解答配置的模型没出现在选择器可能被隐藏、超出 5 个的显示上限、未同步进目录或被固定在 v1。运行ocx sync后新建会话再检查v2 子级为什么用了父模型全历史 v2 fork 会继承父模型传递 model/effort 覆盖时需把fork_turns设为none或部分 turn 数出现unreadable_encrypted_agent_taskv2 原生 ChatGPT 子任务是密文外部 provider 读不了可改用 v1 做跨 provider 委派或在 combo 中加入原生 ChatGPT 目标选了委派模型就会强制 spawn 吗不会。指引只是推荐最终由主代理决定相关文档与模块路径 延伸阅读官方指南子代理界面Sub-agent Surface 中文文档选择器原理Codex App 模型选择器CLI 参考CLI 代理命令ocx agent / ocx v2快速上手快速开始含 sub-agent 模型选择 核心源码共享模型目录构建src/codex/catalog.ts回退链实现src/codex/subagent-model-fallback.ts总结OpenCodex 从不修改 Codex 客户端本身它只写入 Codex CLI/TUI/App 共用的配置与模型目录。用 Subagents 页面挑好 5 个模型、选对 v1/base/v2 模式、配上回退链任意 LLM 都能成为 Codex 子代理选择器里的一员。【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址: https://gitcode.com/gh_mirrors/ope/opencodex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考