接入 Codex 与其他客户端

概览

先安装并初始化SecretBridge。0.3.1 原生包提供 Codex 插件导出：用活动程序执行 secretbridge client-plugin codex <新建的绝对目录>，然后按当前 Codex CLI 的插件市场规则安装 secretbridge@secretbridge-local。使用前核对客户端版本、导出目录和插件列表。当前 CLI 对导出目录根部市场清单的识别存在兼容问题；不要把“插件列表可见”当成 MCP 工具已接通的证据。

边界与检查

另一种方式是用 secretbridge client-config codex 生成当前安装路径对应的 TOML 片段，合并到现有 config.toml，不能覆盖其他服务。在新会话中实际发现只读能力和资源目录，确认 MCP 工具可调用；MCP 接通不等于业务操作已获授权。

共同的接入条件

先安装、启动并初始化本机代理。所有本机 AI 客户端共用同一后台；MCP 配置引用活动安装程序的绝对路径和相同数据目录，不需要 PIN、恢复密钥、配对链接或凭据。客户端必须能在代理所在电脑启动本机 stdio 进程；纯云端客户端不能直接连接此入口。

Codex 插件或普通 MCP

插件：活动程序执行 secretbridge client-plugin codex <新建的绝对目录> 导出包内插件。按当前 Codex CLI 规则添加市场和 secretbridge@secretbridge-local，重启会话。先核对是否已有同名市场，不覆盖已有文件。
MCP 配置：执行 secretbridge client-config codex，将输出的 TOML 片段合并进现有客户端配置，保留其他 MCP 服务。当前插件市场目录识别仍有兼容议题；插件列表可见本身不能证明工具已连通。
其他客户端：client-config 支持 Claude Code、Cursor、GitHub Copilot CLI、OpenCode、WorkBuddy、DeepSeek Harness 和通用 stdio 格式。WorkBuddy 与 DeepSeek Harness 还可导出其专用集成。具体配置位置以产品仓库接入说明及客户端当前说明为准。

验证“已连接”

用 secretbridge status 确认后台 running，并检查客户端指向的是其活动程序。
重载客户端，在新会话中发现 secretbridge_* 工具。
调用只读 secretbridge_terminal_capabilities；成功返回能力信息才说明 stdio 桥接连通。实际任务还需要单独审批。

操作 Skill 只指导工具选择与失败恢复，不授予新权限；单独安装 Skill 不等于已连接 MCP。升级或回退后，核对活动程序路径并重新验证客户端。更多细节见产品接入说明。