不用手改 TOML,即可管理模型、推理强度、速度、上下文、自动压缩和 Agent 角色。你可以操作面板,也可以直接用自然语言告诉 Codex 要改什么;写入前都能查看变更。
点击 GIF 可打开完整版视频演示。
本地运行 · 使用 Codex 官方 TOML · 写入前预览
在 Codex 中添加 GitHub 插件市场并安装 Agent Switchboard:
codex plugin marketplace add xiajiadi/agent-switchboard
codex plugin add agent-switchboard@agent-switchboard-community安装后新建一个 Codex 任务,再打开 Agent Switchboard。本地 MCP 服务需要安装 uv 和 Python 3.11 或更新版本。仓库已包含构建好的界面;只有重新构建时才需要 Node.js。
- 安装后看不到插件: 新建一个 Codex 任务,再打开 Agent Switchboard。
- 项目配置没有生效: 确认 Codex 已信任该项目。Codex 只会读取受信任项目中的
.codex/config.toml。 - 插件无法启动: 检查是否已安装 Python 3.11+ 和
uv,并确保两者可从命令行运行。 - 模型列表没有更新: 在面板中点击“刷新模型目录”,重新读取本机 Codex 模型目录。
| 手动编辑 TOML | 使用 Agent Switchboard |
|---|---|
| 查找全局或项目文件,并确认配置优先级 | 在面板中选择作用域和 Agent 类型 |
| 查询字段与模型选项 | 从本机 Codex CLI 提供的模型目录中选择 |
| 手动检查、保存和恢复 | 先预览、校验和查看差异,确认后再写入 |
插件直接编辑 Codex 配置文件。设置仍由 Codex 读取,不需要另建一套配置存储。
- 可视化配置: 按支持范围设置作用域、Agent 类型、模型、推理强度、速度、上下文窗口和自动压缩阈值。
- 全局和项目作用域: 管理用户默认值或项目覆盖。Codex 只读取受信任项目中的项目配置。
- 默认子 Agent 和命名角色: 配置默认子 Agent,并将命名角色保存在各自的 TOML 文件中。
- 自然语言操作: 直接告诉 Codex 要检查或修改什么,例如:“把当前项目的默认子 Agent 设为 GPT-6 Luna、高推理强度和 Fast。”
- 写入前审阅: 校验支持的值、查看拟议差异,并确认后写入。
- 本地操作记录: 查看最近操作及其修改的设置。
- 使用原生配置: 直接读写 Codex TOML,保留已有注释和无关设置。
打开 Agent Switchboard,选择作用域和 Agent,调整可用设置,然后点击“预览并应用”。确认前检查受影响的文件和配置值。
例如:
把当前项目的默认子 Agent 设为 GPT-6 Sol 和 high 推理强度。
应用前先展示拟议的改动。
插件会读取现有配置、校验请求的值,并在写入前显示差异。
| 作用域 | 文件 | 用途 |
|---|---|---|
| 全局 | $CODEX_HOME/config.toml |
跨项目的用户默认值 |
| 项目 | <project>/.codex/config.toml |
单个受信任项目的覆盖值 |
| 命名角色 | 由 agents.<name>.config_file 指定的角色 TOML 文件 |
命名 Agent 角色的设置 |
最终生效的配置由 Codex 的优先级规则决定。命令行参数和更高优先级的设置可能覆盖这些文件中的值。主 Agent 的模型、推理强度和速度仍在 Codex 模型选择器中调整;面板可管理主 Agent 支持的上下文和自动压缩设置。
插件会校验选定的修改、显示差异,并等待用户确认。它保留 TOML 注释和无关字段,再通过原子文件替换写入。操作记录保存在本机 $CODEX_HOME/logs/agent-switchboard.jsonl。
插件没有内置遥测或托管服务。日志可能包含本机路径和插件管理的设置值。分享日志前请阅读 PRIVACY.md,发布问题时请先脱敏本机信息。
可安装插件位于 plugins/agent-switchboard。进入该目录运行:
uv sync --locked
uv run python -m unittest discover -s tests -v
npm ci
npm run build:ui最后两条命令会重新构建打包的界面,需要 Node.js 20 或更新版本。开发流程见 CONTRIBUTING.md;工具、配置细节和本地开发安装方式见技术说明。
- 通过 GitHub Issues 报告问题或提出功能建议。
- 安装和使用问题、功能想法也可以在 GitHub Discussions 中交流。
- 提交 pull request 前请阅读 CONTRIBUTING.md。
- 安全问题请按 SECURITY.md 中的说明报告。
- 支持信息见 SUPPORT.md。
Agent Switchboard 使用 MIT 许可证。


