在 DevAgent 中使用 Codex
Codex 是 OpenAI 的 agentic CLI。DevAgent 对 Codex 的集成是整个应用中最深入的之一 —— 用量、热切换以及重启都会保留账号身份。
配置
- 按照 OpenAI 的文档安装 Codex。
- 在任意终端中登录。
- DevAgent 会读取
~/.codex获取账号和凭据。
启动
从 agent 下拉框中选择 Codex。DevAgent 会以该 worktree 作为 cwd 启动 codex，并通过当前所选账号来路由授权。
账号热切换
许多 Codex 用户会运行多个账号以延展速率限制。DevAgent 的账号切换器可在无需重新登录或编辑配置的情况下切换活动账号。参见热切换 Codex 账号。
系统默认账号 vs 额外账号
System default（系统默认） 使用你真实的 ~/.codex 登录信息（与在 DevAgent 之外裸跑 codex 所使用的 home 目录相同）。DevAgent 所管理的额外账号会获得位于 DevAgent 账号数据下的各自 home 目录，以保持凭据和 rollout 相互隔离。新启动的 Codex 会跟随活动账号；已经在运行的会话会保留其启动时使用的 home，直到你重启它们。
嵌套的 Task 子 agent
当 Codex 派生出 Task 子 agent 时，DevAgent 可以在 worktree agent 列表和 Agent Dashboard 中，将它们作为父 agent 下方的子行显示。展开箭头即可看到每个子项；点击某个子项会聚焦到父终端（子 agent 并不拥有独立的 窗格）。
在新会话中继续
在 agent 终端的标题栏或右键菜单中，选择 Continue in New Session…（在新会话中继续）。DevAgent 会启动一个全新的 agent 会话（相同或不同的 CLI），并从先前的会话记录或已捕获的上下文中注入一段有边界的交接提示。原有会话保持不变 —— 这并不是 codex resume。
重启徽标
当 Codex 退出时，重启徽标会用相同的账号重新启动该 agent。如果你在会话中途切换了账号并希望用新账号重启，请先使用账号切换器，然后再重启。
用量与速率限制
DevAgent 会读取活动账号本地的 Codex 用量状态，并在状态栏中呈现。参见用量与速率限制跟踪。
Windows 上的 Codex（WSL）
在 Windows 上，DevAgent 既可以从你的宿主安装运行 Codex，也可以从某个 WSL 发行版运行。可从账号切换器添加一个 WSL 托管的 Codex 账号 —— DevAgent 会在该发行版内部创建一个隔离的账号 home 目录（位于 ~/.local/share/devagent/codex-accounts/<id>/home 下），将其映射回宿主机上的 \\wsl.localhost\<distro>\... 路径以供授权读取，并将启动、热切换以及速率限制拉取都通过所选发行版进行路由。如果目标发行版中没有安装 Codex，Add account（添加账号） 对话框会失败，并给出一条可操作的提示，告诉你哪个发行版缺少该二进制文件。