全部智能体 CLI
NeuroSquad 中的 Codex CLI

Codex CLI,拥有自己的画布

需要多少个 Codex 会话就运行多少个,每个都在自己的卡片里,配有真实终端。NeuroSquad 知道每个会话是在工作、在等你批准,还是已完成;通过箭头为它连接浏览器、终端和笔记;每段对话都从上次停下的地方继续。

官方网站developers.openai.com/codex/cli
  • 真正的 codex CLI,用你自己的登录
  • 不写入 ~/.codex
  • 免费,支持 Windows 10 和 11
生命周期钩子

它知道 Codex 何时完成——何时在提问

终端安静下来,可能是“已完成”,也可能是“在等你批准”。NeuroSquad 不靠猜:每张 Codex 卡片都通过 Codex 自己的生命周期钩子报告每一轮。

UserPromptSubmit钩子
工作中

你按下回车。卡片图标开始旋转,“团队状态”卡片把它计为工作中。Codex 启动的子智能体不会改变卡片的状态。

PermissionRequest钩子
等你处理

Codex 停在批准提示上。卡片闪烁,提示音响一次,通知第一行就是它想运行的内容——Bash — rm -rf dist。通过 request_user_input 提出的问题同样算数。

Stop钩子
已完成

这一轮结束了——而不只是安静了。队列里的下一条提示发出,回答写入工作日志,通知告诉你已完成。一轮中途按 Esc,会通过 Interrupt 钩子结束它。

出错的一轮也会结束

出错后 Codex 不会触发任何钩子。只要这一轮还开着,Codex 自己的“■ …”错误行就会结束它,卡片不会卡在“工作中”。

审查器的决定不打扰你

如果你把批准交给 Codex 的自动审查器,就没有人被询问——卡片也就不会叫你。

受信任,而非绕过

钩子连同它们的信任哈希一起传入,所以启动时没有审查界面——而你仓库里未受信任的钩子依然不受信任。

看看实际效果

你每天都会做的三件事

应用界面的复刻,一步一步播放。Codex 请求批准时,由你来回答。

Codex 修复一个失败的测试,删除文件夹前停在批准提示上,然后完成——工作日志自动写好。

它能得到的一切

Codex CLI 在 NeuroSquad 中能做的一切

Codex 的集成程度与 Claude Code 相当——通过它自己的钩子和会话参数实现。以下是全部功能,每项都附有文档页面;另外单独列出 Codex 本身不支持的少数几点。

  • 01

    清楚自己的状态

    Codex 自己的钩子报告每一轮,无需猜测。

  • “已完成”和“在等你”是两回事

    每张卡片都接入 Codex 的生命周期钩子:UserPromptSubmit 表示工作中,PermissionRequest 表示在等你,Stop 和 Interrupt 表示已完成。

    文档: “已完成”和“在等你”是两回事
  • 说清需要什么的通知

    通知第一行就是 Codex 想做的事:Bash — rm -rf dist、apply_patch 要改的文件,或某个 MCP 工具。每个智能体一条;等待中的通知会一直保留到你回答;点击即可飞到该卡片。

    文档: 说清需要什么的通知
  • 从上次停下的地方继续

    每个钩子都会报告卡片的会话,所以下次启动就是在该卡片自己的文件夹里执行 codex resume <id>。会话文件丢失时会自动重新开始;“重启会话”会给卡片一个全新的会话。

    文档: 从上次停下的地方继续
  • “团队状态”卡片

    工作区里所有 AI 智能体都在一张卡片上——等你、工作中、已完成、空闲——附带取自 Codex 自己会话日志(或你的 config.toml)的模型,以及本轮的实时用时。

    文档: “团队状态”卡片
  • 自定义卡片也能跟踪它

    用 Card SDK 构建的卡片能看到同样的状态和每轮事件,并从会话文件里读取 Codex 的最新回答。

    文档: 自定义卡片也能跟踪它
  • 02

    通过画布工作

    从卡片引出的箭头就是一组工具。画上箭头,Codex 就能使用另一端的东西。

  • 箭头就是工具

    指向浏览器、终端、笔记或其他智能体的箭头,会通过 NeuroSquad 的 MCP 服务器为 Codex 提供 browser_*、terminal_*、note_* 或 agent_*,调用时无需确认——箭头本身就是同意。每次调用都会点亮对应的箭头。

    文档: 箭头就是工具
  • 它能自己添加卡片

    canvas_spawn_card 让它在身边打开终端、浏览器、笔记或助手智能体——Codex 或任何其他 CLI——并已用箭头连好。

    文档: 它能自己添加卡片
  • 卡片模式

    Codex 以 features.shell_tool=false 和 web_search=disabled 启动:它自带的 shell 和网络搜索根本不会提供给模型,因此连危险模式也无法恢复它们。命令在你能看到的终端卡片里运行。

    文档: 卡片模式
  • 来自注册表的 MCP 服务器

    从官方 MCP Registry 安装一次服务器,再用箭头交给智能体。Codex 每次调用前都会询问,服务器的密钥永远不会离开 NeuroSquad。

    文档: 来自注册表的 MCP 服务器
  • 来自 skills.sh 的技能

    指向技能卡片的箭头会为 Codex 提供 skill_load,列出每个技能及其适用场景。新的技能箭头要在卡片重启后才能到达正在运行的 Codex。

    文档: 来自 skills.sh 的技能
  • 03

    为长时间运行而生

    长会话会遇到上下文占满和用量上限。两者都在卡片上处理。

  • 上下文指示与压缩

    标题栏的小圆环显示上下文用了多少——最近一次请求的 token 与模型窗口之比,两者都来自 Codex 自己的日志。“压缩”会发送 /compact。

    文档: 上下文指示与压缩
  • 达到用量上限后自动继续

    当 Codex 显示“You’ve hit your usage limit … try again at 3:00 PM”时,卡片会倒计时到那个时间,然后发送“continue”。可按卡片关闭。

    文档: 达到用量上限后自动继续
  • 提示队列

    把接下来的消息排好队:每条在本轮完成后发出——有了钩子,“完成”是精确的。也支持每日提示。

    文档: 提示队列
  • 交接给新智能体

    会话占满时,在旁边启动一个新智能体——Codex 或任何其他 CLI——工作摘要已经填好,等你发送。

    文档: 交接给新智能体
  • 工作日志

    每个完成的回答都从 Codex 的会话文件读取,并追加到连接的笔记里:智能体所做工作的持续记录。

    文档: 工作日志
  • 04

    团队协作

    多个 Codex 智能体——或多种 CLI 混用——在同一个项目上互不干扰。

  • 隔离的 worktree

    给智能体一个独立的 git worktree,并行的智能体就不会改到同一批文件。文件夹信任设置会跟随 worktree,Codex 打开后直接进入输入框。

    文档: 隔离的 worktree
  • 添加审查者

    一键在同一个 worktree 里启动另一种 CLI 的智能体,带上来自作者的箭头和“只审查、不修改”的提示。其他 CLI 需要审查者时,Codex 也是首选。

    文档: 添加审查者
  • 按卡片开启的危险模式

    对于你信任的任务,卡片可以用 --dangerously-bypass-approvals-and-sandbox 启动 Codex。这是每张卡片单独的开关,默认关闭。

    文档: 按卡片开启的危险模式
  • 角色

    审查者、测试员、研究员、架构师、写作者或自定义:角色作为第一条提示填入,你能看到也能修改,绝不会背着你重复发送。

    文档: 角色
  • 原生支持 AGENTS.md

    Codex 自己读取 AGENTS.md。只需编辑一次,NeuroSquad 会为项目里的其他 CLI 同步镜像。

    文档: 原生支持 AGENTS.md
  • 05

    费用、控制与访问

    它花了多少、最多能花多少、用哪个模型,以及你如何访问它。

  • 精确的用量与费用

    按卡片、工作区和模型统计 token 与费用,数据来自 Codex 自己的会话日志——子智能体的请求会并入启动它的会话。token 按整数计,费用精确。

    文档: 精确的用量与费用
  • 预算刹车

    每个工作区一个上限。超出后,每张 Codex 卡片都会收到 Esc——本轮停止,会话保留——自动提示也随之停止。提高上限即可解除。

    文档: 预算刹车
  • OpenRouter 模型

    让卡片使用 OpenRouter 模型,而不是你的 OpenAI 登录。密钥只进入该卡片的环境变量;即使密钥已删除,会话仍可恢复。

    文档: OpenRouter 模型
  • 语音输入提示

    按住快捷键说话。语音在你的电脑上识别,并输入到当前智能体的提示中。

    文档: 语音输入提示
  • 用手机访问

    扫描二维码,整个画布就会在手机浏览器中打开:查看 Codex 的终端、看它在问什么、发送下一条提示。

    文档: 用手机访问
  • 06

    Codex 不支持的部分

    Codex 本身无法做到而 Claude Code 可以的地方,以及 NeuroSquad 的替代做法。均已对照 Codex 源码核实。

  • 无法预先指定会话 id

    Codex 自己生成会话 id,也没有参数能让它从你指定的 id 开始。因此卡片从第一个钩子得知自己的 id 并据此恢复——一轮都没跑过的卡片直接重新开始。

    文档: 无法预先指定会话 id
  • 新的技能和 MCP 箭头需要重启

    Codex 只读取一次服务器的工具列表,之后的变化都会忽略。NeuroSquad 一开始就提供所有内置工具,由箭头在调用时决定——但指向技能或 MCP 服务器卡片的箭头要等 Codex 下次启动才生效。

    文档: 新的技能和 MCP 箭头需要重启
  • Ctrl+C 会让它退出

    在空闲的 Codex 中,Ctrl+C 会退出程序。所以预算刹车改按 Esc:中断本轮,Codex 继续运行。

    文档: Ctrl+C 会让它退出
  • 内置 provider 不带署名

    如果你自己把 Codex 内置的 openai provider 指向 OpenRouter,Codex 不接受为它添加额外的请求头。你自定义的 OpenRouter provider 则会带上。

    文档: 内置 provider 不带署名
  • “已回答”靠回车判断

    Codex 没有钩子报告你已回答批准请求,所以你按下回车时卡片回到“工作中”。如果用 y 快捷键回答,卡片会一直显示“等你处理”,直到本轮结束。

    文档: “已回答”靠回车判断
一目了然

谁在等你,花了多少

同时运行多个 Codex 会话时,这两张卡片回答你最常问的问题。

“团队状态”卡片

工作区里每个智能体的状态、模型和本轮用时。在等你的排在最前,并写明它想运行什么。点击状态即可筛选。

  • coupon-fixCodex CLIgpt-5.5Bash — rm -rf dist等你处理2:34
  • api-migrationCodex CLIgpt-5.5把路由迁移到新客户端工作中14:58
  • db-indexesCodex CLIgpt-5.4-mini补上缺失的索引工作中6:42
  • docs-passCodex CLIgpt-5.4-mini更新 README已完成4分钟前

用量与费用

读取你磁盘上 Codex 自己的会话日志,并按钩子报告的会话对应到卡片。各行之和始终等于合计。

智能体令牌费用
coupon-fix1,196,402US$2.74
api-migration781,355US$1.63
docs-pass238,610US$0.09
总计2,216,367US$4.46
精确到皮美元,仅在显示时四舍五入。每一行都包含该会话启动的子智能体。
幕后

真正的 Codex,外加几个会话参数

Codex 没有单次运行的设置文件,但任何设置都可以用 `-c` 只对这一次运行生效——叠加在你的 `config.toml` 之上,绝不写入其中。以下是 NeuroSquad 添加的全部内容:

NeuroSquad 为命令添加的参数
❯ codex
resume <the session its hooks reported>之后的启动重启后继续同一段对话
-c mcp_servers.neurosquad.url=… -c mcp_servers.neurosquad.default_tools_approval_mode=approve每次启动这张卡片的 NeuroSquad MCP 服务器,工具预先批准:你画的箭头就是同意
-c mcp_servers.ns-connected.url=… -c mcp_servers.ns-connected.default_tools_approval_mode=prompt每次启动你安装的 MCP 服务器:Codex 每次调用前都会询问
-c hooks={<six lifecycle hooks>, state={<each one’s trusted_hash>}}每次启动生命周期钩子及其信任记录——没有审查界面,也没有绕过
-c projects={"<the card’s folder>"={trust_level="trusted"}}每次启动这个文件夹你已经选过了,所以没有信任界面
-c tui.terminal_title=["app-name","thread-title"]每次启动会话线程的名称成为卡片标题
-c features.shell_tool=false -c web_search=disabled卡片模式关闭自带的 shell 和网络搜索,改用画布上的卡片
--dangerously-bypass-approvals-and-sandbox危险模式跳过批准和沙箱

不写入 ~/.codex

一切都是本次运行的 -c 参数。MCP 令牌通过环境变量传递,从不出现在参数里。

你的登录,你的套餐

Codex 使用它已有的 ChatGPT 登录或 API 密钥运行。NeuroSquad 账号与它相互独立,也看不到它。

直接运行真正的 codex.exe

npm 的 codex.cmd 只是启动一个脚本,再由脚本启动 codex.exe——卡片直接启动 exe,所以停止卡片就真正停止了 Codex。

常见问题

NeuroSquad 中的 Codex CLI:问与答

给 Codex 一块画布

免费,支持 Windows 10 和 11。你的代码、登录和费用都留在你的电脑上。