#接入 Codex

由当前Codex模型生成候选，Intent Runtime校验后返回结构化意图。此路径不需要额外模型API Key。CLI与Desktop的加载和兼容状态见兼容与支持。

#1. 保存配置

已有 ESM 项目时保存为 intent.host.config.js，例如 D:\Worker\my-app\intent.host.config.js；项目 package.json 设置 "type":"module"。只想独立保存一个文件时用 .mjs，无需项目配置。两种后缀都支持，内容相同。配置不导入包，可放在没有 node_modules 的目录。

export default {
  mode: 'host',
  instances: {orders: {language: 'zh-CN', schema: {
    type: 'object',
    properties: {orderId: {type: 'string', description: '用户明确提供的订单编号，保留前导零；仅适用于订单意图'}},
  }}},
};

配置是可信Node.js模块。自行添加包导入时，依赖必须能从配置文件所在目录解析；全局安装不改变任意ESM文件的本地依赖解析。

#2. 安装与登记

先按安装与版本完成全局安装，再将下面配置路径换为真实绝对路径执行登记。安装提供命令，setup才修改本模块的宿主登记：

Windows PowerShell：

intent-runtime setup --host codex --config "D:\Worker\my-app\intent.host.config.js"

macOS/Linux：

intent-runtime setup --host codex --config "$PWD/intent.host.config.js"

setup登记用户级MCP并在host模式安装Skill。按客户端要求重载配置，CLI开启新会话。应能发现intent_prepare、intent_accept、intent_cancel；普通npm安装不修改宿主。

#3. 发起识别

在Codex明确提出：

请使用 intent-runtime 识别这句话：“查询订单000123，不取消订单”。
提取订单号，展示用户目标和禁止事项，不执行订单操作。

应得到查询目标、禁止取消的约束和字符串编号 "000123"。setup 安装的 Skill 会指导模型完成工具交接，无需每次在提示中手写协议。它不会自动处理所有消息。

需要排查具体调用时，再展开下面的流程：

#工具与回复

首次识别按上面的prepare → 当前模型生成候选 → accept完成；无法完成时cancel。完整参数、令牌回放、预算和记录回收见宿主交接参考。记录只服务本次识别，不是应用的持久会话。

#手动填写 MCP 表单

手动登记同样的command/args不会安装Skill；使用上面的明确请求调用。日志写stderr，stdout仅传MCP。

#检查与排障

intent-runtime doctor --host codex

诊断不调用模型。更新、修复、移除、dry-run、全部命令选项和退出码见Codex安装维护。