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+D | codex 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 要的旧时,也是在这里更新。