Codex

Kettu 怎么以 codex app-server 运行你自己的 Codex、怎么登录,以及 Codex 会话里显示什么。

Kettu 把你自己的 codex 以 codex app-server 启动,经 Codex 自己的接口和它通信。Kettu 不为 Codex 安装任何东西,Codex 也不需要 Node.js。Kettu 要求 Codex 0.166.0 或更高版本。

你的 codex 指 PATH 上的那个、在设置 › Harness › Codex 里用**选择可执行文件…**选的程序,或者环境里 CODEX_PATH 指定的程序。用 npm 装的 Codex,Kettu 直接启动包里 Codex 自己的程序。Codex 照旧用自己的目录,和你在终端里运行的 codex 共用。

安装 Codex

找不到 codex 时,打开设置 › Harness › Codex,点安装…,选一种 OpenAI 文档里的装法:官方安装脚本(推荐)、Homebrew 或 npm。Kettu 先显示命令,再替你运行。

登录

打开设置 › Agent › Codex,点在终端中登录。Kettu 在自己的终端里运行 codex login:

方式命令
ChatGPT,在浏览器里登录codex login
ChatGPT(设备码)codex login --device-auth
API key:粘贴后按 Enter 和 Ctrl+Dcodex login --with-api-key

也可以在 API key 那一行点设置…:key 经 Codex 自己的 codex login 保存,Kettu 不留副本。要接别的模型服务商,在这个 Agent 配置目录的 config.toml 里自己配。退出登录会运行 codex logout。想再加一个账号,在设置 › Agent 里点添加 Agent,它会有自己的 CODEX_HOME 目录。

Codex 会话里显示什么

选项可选值
模式只读、工作区访问、自动审查(默认)、完全访问
协作模式默认,或者计划:先做计划再改动
模型和推理强度Codex 为你的账号提供的
快速模式支持的模型才有:1.5 倍速度,用量更多

Codex 的命令在输入框的斜杠菜单里:/plan、/review、/review-branch、/review-commit、/compact、/goal、/rename、/status、/mcp 和 /skills,每个技能显示为 $ 加它的名字。授权请求给出的是 Codex 自己的选项,比如允许,本会话内都允许、拒绝并停止。

设置 › Agent 里显示账号:你的 ChatGPT 套餐和邮箱、OpenAI API key,或者自定义模型服务商。Codex 报出套餐限额时,比如 5 小时和每周的,Agent 菜单和套餐用量里都会显示。

Codex 不报提示缓存能留多久。用 ChatGPT 账号或 OpenAI 的 key 时,Kettu 按 OpenAI 文档里的最短时间估算:GPT-5.5 及以后的模型 30 分钟,更早的 5 分钟,顶栏显示缓存约加剩余时间。用别的服务商时显示未报告缓存时间。

更新

Kettu 每天在 npm 上查一次有没有新版 Codex。有的话,设置 › Harness › Codex 里会出现更新到加版本号,按你装 Codex 的方式更新:重新运行安装脚本、brew upgrade --cask codex,或者 npm install -g @openai/codex@latest。命令会显示出来,你也可以自己运行。Codex 比 Kettu 要的旧时,也是在这里更新。