本仓库保存一组可以直接调用 MiMo Token Plan 的 Codex 全局子代理配置。
子代理通过 Codex 的 mimo_token_plan provider 直接访问 MiMo，不经过
codex-mimo-adapter、本地端口或项目路由。
仓库只包含以下可分发内容：
README.md：安装和配置说明AGENTS.md：全局 Codex 编排规则的仓库内副本.codex/agents/default.toml：通用后备子代理.codex/agents/explorer.toml：只读探索子代理.codex/agents/worker.toml：实现子代理
API 密钥、用户级 config.toml、会话数据和其他运行时状态不应提交到仓库。
Codex 子代理
-> model_provider = "mimo_token_plan"
-> MiMo Token Plan Responses API
-> 子代理继续执行任务、工具调用和流式响应
三个 profile 使用同一个 provider，但职责和模型不同：
| Profile | 模型 | 沙箱 | 用途 |
|---|---|---|---|
default |
mimo-v2.5 |
workspace-write |
通用后备任务 |
explorer |
mimo-v2.5 |
read-only |
仓库探索、诊断和验证 |
worker |
mimo-v2.5-pro |
workspace-write |
边界明确的实现任务 |
三个 TOML 是运行时 profile。根目录的 AGENTS.md 是编排和验收规则；它不会替代 Codex 的 provider 配置。
- 已安装支持自定义 model provider 和 agent profile 的 Codex。
- 已取得 MiMo Token Plan API 密钥。
- 能够访问
https://token-plan-cn.xiaomimimo.com/v1。 - 当前 Codex 版本支持 Responses API provider 配置。
provider 配置应写入用户级 Codex 配置，不要写入本仓库。Windows 默认路径为：
%USERPROFILE%\.codex\config.toml
如果设置了 CODEX_HOME，以该变量指向的目录为准。将以下区块合并到现有 config.toml；如果已经存在同名区块，只更新字段，不要重复创建同名 TOML 表。
[model_providers.mimo_token_plan]
name = "MiMo Token Plan"
base_url = "https://token-plan-cn.xiaomimimo.com/v1"
env_key = "MIMO_API_KEY"
wire_api = "responses"
request_max_retries = 4
stream_max_retries = 10
stream_idle_timeout_ms = 360000三个 agent 文件已经通过 model_provider = "mimo_token_plan" 选择这个 provider，因此不必把默认主代理切换到 MiMo。只有希望主代理也默认使用 MiMo 时，才单独修改顶层 model_provider 和 model。
env_key 表示 Codex 会从 MIMO_API_KEY 读取密钥。开发或当前终端验证时，可以只设置当前 PowerShell 进程：
$env:MIMO_API_KEY = "<your-mimo-token-plan-api-key>"不要把真实密钥写入 config.toml、agent TOML、README、Git 提交或命令输出。需要长期保存时，使用操作系统或组织批准的密钥管理方式，并确保启动 Codex 的进程能够读取该环境变量。
从仓库根目录执行以下 PowerShell 命令。命令会尊重已有的 CODEX_HOME；未设置时使用 %USERPROFILE%\.codex。
$repo = (Resolve-Path .).Path
$codexHome = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $env:USERPROFILE ".codex" }
$agentsDir = Join-Path $codexHome "agents"
New-Item -ItemType Directory -Force -Path $agentsDir | Out-Null
Copy-Item (Join-Path $repo ".codex\agents\default.toml") (Join-Path $agentsDir "default.toml") -Force
Copy-Item (Join-Path $repo ".codex\agents\explorer.toml") (Join-Path $agentsDir "explorer.toml") -Force
Copy-Item (Join-Path $repo ".codex\agents\worker.toml") (Join-Path $agentsDir "worker.toml") -Force
Get-ChildItem $agentsDir -Filter "*.toml" |
Where-Object Name -in @("default.toml", "explorer.toml", "worker.toml") |
Select-Object Name, FullName复制完成后重启 Codex Desktop 或重新启动 Codex CLI，使 provider 和 agent profile 重新加载。仓库内的文件是可审查、可版本化的分发源；复制动作不会自动修改用户的全局配置。
按以下顺序验证：
- 确认
config.toml中存在[model_providers.mimo_token_plan]。 - 在启动 Codex 的同一环境中确认
MIMO_API_KEY非空。 - 确认
%CODEX_HOME%\agents或%USERPROFILE%\.codex\agents中有三个 TOML 文件。 - 新建一个很小的只读探索任务，确认
explorer可以返回结果且不会修改文件。 - 再用
worker执行一个明确、可回滚的小任务，确认它使用mimo-v2.5-pro。 - 检查长时间流式响应没有在约 120 秒或 300 秒处被本地配置提前截断。
如果需要确认当前进程读取到的环境变量，可以执行：
if ([string]::IsNullOrWhiteSpace($env:MIMO_API_KEY)) {
throw "MIMO_API_KEY is not set in this PowerShell process."
}
Write-Output "MIMO_API_KEY is available to the current process."不要打印变量值。
检查 Codex 实际使用的 CODEX_HOME，并确认 provider 区块写在该目录的 config.toml 中，而不是只写在仓库文件里。修改后重启 Codex。
确认 MIMO_API_KEY 设置在启动 Codex 的同一进程环境中。PowerShell 新窗口不会继承旧窗口临时设置的变量；不要把密钥改写进仓库文件作为替代方案。
确认三个文件位于活动 Codex home 的 agents 子目录，并检查文件名是否仍为 default.toml、explorer.toml、worker.toml。修改文件后重启 Codex。
确认 provider 使用 wire_api = "responses"，并保留 stream_idle_timeout_ms = 360000。该值只控制 Codex provider 的流式空闲窗口；网络、账户额度、模型可用性和服务端限制仍可能导致请求失败。
修改本仓库中的 TOML 后，重新执行安装命令覆盖用户级 agent 文件，再重启 Codex。更新 provider 时只改用户级 config.toml，不要把包含机器私有设置或密钥的完整配置文件提交到仓库。
git pull
$codexHome = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $env:USERPROFILE ".codex" }
$agentsDir = Join-Path $codexHome "agents"
Copy-Item .codex\agents\*.toml $agentsDir -Force提交前检查：
git diff --check
git status --short