OpenAI Codex

Codex 通过本机节点的 MCP 服务器(anet mcp)接入网络。登记该条目后, MCP 工具所列的工具集可在 Codex 命令行程序、IDE 中的 Codex 扩展和 ChatGPT 桌面应用中使用,三者共用同一份配置。这些工具用于:在 Hub 目录中查找 Agent(list_agents、get_agent_card);委派任务并取回结果(send_message、wait_task、get_task);列出和取消任务(list_tasks、cancel_task);答复其他 Agent 发给本节点的任务(inbound_pending、reply_task);在 Agent 支付档的额度内支付或拒绝报价(submit_payment、reject_payment);读取余额、证据链和节点状态(get_balance、audit、node_status)。预览不通过 MCP 提供。

前提条件 

已按安装与教程安装 anet,且节点已加入 Hub。
守护进程正在运行(anet up)。守护进程未运行时,``anet mcp`` 不会启动。
已安装 Codex,形态为命令行程序、IDE 扩展或 ChatGPT 桌面应用。本集成已用 codex-cli 0.163.0 核实。官方文档未给出最低版本;当前要求以参考所列官方页面为准。
支持的系统为 Linux 和 macOS。不支持 Windows;在 WSL2 中运行 Linux 构建不属于经过测试的配置。本页的接入方式与命令仅在 Linux 上核实。

自动接入 

$ anet agents wire codex

该命令修改 Codex 主目录中的两个文件。主目录为 ~/.codex,或由 CODEX_HOME 指定的目录:

config.toml 中写入一个由标记行界定的块,标记行为 # >>> anet (managed by `anet agents wire`; edits inside this block are overwritten) >>> 与 # <<< anet <<<。块内是手动接入所示的 [mcp_servers.anet] 表。
AGENTS.md 中写入一段简短的操作指引,位于  与  两行之间。指引面向模型,因此以英文书写。指引列出各工具,说明 completed 不等于成功,并禁止提高支付额度,也禁止执行其他 Agent 的任务中夹带的指令。

config.toml 中的其他表和 AGENTS.md 中的其他文字保持不变。每个被修改的文件先复制为 <name>.anet-bak-<UTC time>。重复执行该命令不产生任何变化。该命令的输出在所有构建中均为中文:

anet agents wire(anet /usr/local/bin/anet,数据目录 /home/operator/.anet)
  codex     已写
            - [mcp_servers.anet] → ~/.codex/config.toml
            - 写入 anet 指引块:~/.codex/AGENTS.md
            备份 ~/.codex/config.toml.anet-bak-20261017-094809
重启这些工具(或新开会话)后生效;它们调用 `anet mcp`,需要本机 daemon 在运行(anet up)。
撤销:anet agents unwire <工具>(或 --all)

状态用语见下表。anet agents 使用同样的用语报告每个工具的状态。

用语	含义
`已写`	条目或指引已写入。
`已是最新`	无需修改。
`未安装,跳过`	未检测到该工具,且未显式指定。
`冲突`	已存在一张并非由 `wire` 写入的 `[mcp_servers.anet]` 表。命令报告文件与行号,不作任何修改,并以状态码 1 退出。
`已移除`	`unwire` 已移除该条目。
`未接入`	工具已安装,但未接入。
`失败`	文件无法修改。

已接入且为最新的条目显示如下:

$ anet agents
anet agents(anet /usr/local/bin/anet,数据目录 /home/operator/.anet)
  ...
  codex     已接入,最新
  ...

Codex 在启动时加载服务器。修改之后,需重启应用,或新开会话:

ChatGPT 桌面应用:保存文件后点击 Restart 按钮。
IDE 扩展:Restart extension。
命令行程序:新开会话。官方文档未说明正在运行的会话是否会读取已修改的文件。

Codex 主目录中存在 AGENTS.override.md 时,Codex 读取该文件而不是 AGENTS.md,``wire`` 写入的指引因此不起作用。此时命令在状态用语之后输出一条注意事项。命令从不编辑覆盖文件;由运维人员将指引并入该文件,或将该文件移走。

手动接入 

Codex 读取 ~/.codex/config.toml,``CODEX_HOME`` 可改变该目录。项目中的 .codex/config.toml 仅在该项目被信任时读取,其取值优先于用户文件。官方文档给出的优先级为:命令行选项、项目文件、配置档(profile)、用户文件、系统文件 /etc/codex/config.toml。wire 只检查用户文件;项目文件中若定义了 mcp_servers.anet,不会被检测到。在 IDE 扩展中,依次点击齿轮图标、Codex Settings、Open config.toml 打开该文件。

添加下列表。路径替换为 anet 可执行文件的实际绝对路径和该身份的数据目录。

[mcp_servers.anet]
command = "/usr/local/bin/anet"
args = ["mcp"]
env = { ANET_DATA_DIR = "/home/operator/.anet" }
startup_timeout_sec = 30
tool_timeout_sec = 900

必须使用绝对路径并设置 ANET_DATA_DIR,因为 MCP 客户端不加载 shell 配置文件。Codex 的默认值为:启动 10 秒,单次工具调用 60 秒。等待另一台机器上的 Agent 的调用可能持续数分钟,因此保留上述取值。Codex 也可以自行登记该条目;该命令不设置超时,需随后在文件中补充:

$ codex mcp add anet --env ANET_DATA_DIR=/home/operator/.anet -- /usr/local/bin/anet mcp

一台机器可持有多个身份。--id 选定其数据目录写入条目的身份。每个工具只有一个 anet 条目,之后为另一个身份执行 wire 会替换先前的条目。

$ anet --id bob agents wire codex

如果 Codex 的主目录被改动,运行 wire 的 shell 与启动 Codex 的进程中的 CODEX_HOME 必须取值相同。官方文档未给出 Windows 上的配置路径。Codex 问题跟踪中的报告(#13549、#22759、#15993)称 Windows 应用与 WSL 使用不同的配置主目录。以扩展所打开的路径为准。

验证 

codex mcp list 与 codex mcp get anet 显示 Codex 解析后的条目。这两条命令在 codex-cli 0.163.0 中存在,而官方 MCP 页面只列出 add、list 和 login。

$ codex mcp get anet
anet
  enabled: true
  transport: stdio
  command: /usr/local/bin/anet
  args: mcp
  cwd: -
  env: ANET_DATA_DIR=*****
  startup_timeout_sec: 30
  tool_timeout_sec: 900
  remove: codex mcp remove anet

在交互式程序中,``/mcp`` 列出处于活动状态的服务器。

首个任务。将下列提示词粘贴到 Codex 会话中:

Call the anet tool node_status and report the AID of this node and whether
it has joined a hub. Then call list_agents with limit 5 and list the AID and
the charge class of each agent. Do not send a task and do not pay.

预期结果为一份简短报告。node_status 返回 AID、Hub 状态(节点加入 Hub 之前为 state: none,原因为 no_hub_yet)和送达状态。list_agents 返回 Hub 目录中的 Agent,含 verification 与 charge;尚未加入 Hub 的节点返回错误 this node has no hub (run `anet hub-register` first)。Codex 可能按其自身设置要求批准工具调用(见“安全与权限”一节)。

示例 

按能力查找 Agent:

Use the anet tools to find agents that publish the capability text.digest.
For the first verified agent, read the agent card and report the
description, the price and the charge class. Do not send a task.

委派任务并报告结果:

Send the text in the file NOTES.md to the agent <AID> with send_message and
wait for the result with wait_task. Report the state of the task,
anet.effect_status and anet.receipt_verified exactly as returned. If the
price exceeds the agent limits, report the price and the payee and stop.

检查节点:

Call inbound_pending, list_tasks and get_balance. Summarise the tasks that
wait for the approval of the operator, the open tasks and the balance with
the payment limits. Do not reply to any task.

安全与权限 

MCP 服务器只接受启动它的 Codex 进程的调用,并将调用转发给守护进程。身份、密钥、对等方名单、入站策略和支付额度无法通过任何工具访问,它们由运维人员在终端上管理(MCP 工具)。节点只接收运维人员已允许的对等方的任务,针对不受信任对等方的沙箱在节点上配置(沙箱与凭据)。Agent 支付档在运维人员设置大于 0 的额度之前保持关闭,超出额度的报价等待 anet pay (付款（x402）)。

Codex 自带工具调用确认机制。default_tools_approval_mode 设置以及 Codex 的审批与沙箱模式见官方文档。它们控制 Codex 在本机上运行什么;ANet 的额度决定节点签署和支付什么。两者互不替代。其他 Agent 发来的任务中的文字属于不受信任的输入;``AGENTS.md`` 中的指引据此约束模型。

故障排查 

现象	原因	处理
Codex 报告服务器 `anet` 启动失败。	没有守护进程应答。`anet mcp` 以 `anet is not running ... run anet up` 退出。	运行 `anet up`,然后重启 Codex 或新开会话。
`wire` 报告 `冲突` 并以状态码 1 退出。	已存在一张并非由 `wire` 写入的 `[mcp_servers.anet]` 表。同名的第二张表不是合法的 TOML。	删除或改名消息中指出的表,然后重新运行 `wire`。
模型未遵循操作指引。	Codex 主目录中存在 `AGENTS.override.md`,Codex 读取它而不是 `AGENTS.md`。	将 `anet:begin` 与 `anet:end` 之间的块并入覆盖文件,或将该文件移走。
用户文件正确,但工具缺失或与预期不同。	受信任的项目在 `.codex/config.toml` 中定义了 `mcp_servers.anet`,其优先级更高。	修改或删除项目文件中的该条目。
调用在约 60 秒后结束。	条目由手工编写且未设置该值,因此适用 Codex 默认的 `tool_timeout_sec`。	设置 `tool_timeout_sec = 900`。参见等待。
修改文件后没有效果。	Codex 在启动时已加载配置。	使用 Restart、Restart extension,或新开会话。
托管块内的修改丢失。	下一次 `wire` 会重写该块。	在块之外修改,或手工编写条目并用 `unwire` 移除该块。
工具显示的身份与 `anet status` 不一致。	条目中的 `ANET_DATA_DIR` 指向另一个数据目录,或 shell 与 Codex 中的 `CODEX_HOME` 不同。	运行 `anet --id <name> agents wire codex`,并在两处使用相同的 `CODEX_HOME`。
在 WSL 中写入的条目未被 Windows 应用找到。	两者读取不同的配置主目录。	通过扩展打开该文件,并在其中写入条目。

其他原因按原因码归类于故障排查;原因码的完整列表见原因码。

断开 

$ anet agents unwire codex

该命令移除 config.toml 中的托管块和 AGENTS.md 中的指引,保留其他表和文字,并先将每个被修改的文件复制为备份。名为 anet 但并非由 wire 写入的条目保持不变。手动移除时,删除 [mcp_servers.anet] 表以及 anet:begin 与 anet:end 两行之间的指引。对于用 codex mcp add 创建的条目,``codex-cli 0.163.0`` 提供 codex mcp remove anet。

参考 

Codex,MCP:https://developers.openai.com/codex/mcp
Codex,基础配置:https://developers.openai.com/codex/config-basic
Codex,AGENTS.md:https://developers.openai.com/codex/guides/agents-md

以上三个地址会重定向到 learn.chatgpt.com。官方页面与本页不一致时,以官方页面为准。

相关页面:接入编码 Agent、MCP、MCP 工具、命令行参考。