Getting Started

安装与首次使用

安装前准备

Better Codex 需要：

• Codex Desktop
• Node.js 22.5 或更新版本
• macOS Apple Silicon、macOS Intel，或 Windows x64

安装器会先检查 Node.js。缺失或版本过低时，它会询问是否安装当前 LTS；拒绝后安装会终止，已有 Better Codex 安装和数据库不会被修改。

安装正式版

macOS：

curl -fsSL https://raw.githubusercontent.com/Ericwong5021/better-codex/main/scripts/install.sh | bash

Windows PowerShell：

irm https://raw.githubusercontent.com/Ericwong5021/better-codex/main/scripts/install.ps1 | iex

安装器会配置 CLI、Skill、本地 Runtime、系统启动入口和 better-codex MCP。安装过程中需要重新启动 Codex。

第一次打开

1. 退出正在运行的 Codex。
2. 从系统中的 Better Codex 启动入口打开 Codex。
3. 在侧边栏找到 任务看板 与 智能体。
4. 打开任务看板，新建或选择一个项目。
5. 创建第一个任务，填写标题、描述、项目、状态和负责人。
6. 保持手动运行并点击立即开始，或切换到自动运行。

如果入口没有出现，先运行：

better-codex doctor

然后前往故障排查。

推荐的第一个工作流

1. 按产品、客户或长期主题创建项目。
2. 把暂时不执行的想法放进 待规划。
3. 把准备执行的任务移到 待办。
4. 给任务分配用户、默认 Codex Agent 或自定义 Agent。
5. Agent 完成工作后，在 待审核 或 已阻塞 中处理结果。
6. 确认完成后移动到 已完成，不再需要频繁查看的内容可以归档。

安装 Beta

Beta 使用 Preview 更新通道，适合愿意提前验证新功能的用户。

macOS：

curl -fsSL https://raw.githubusercontent.com/Ericwong5021/better-codex/main/scripts/install-beta.sh | bash

Windows PowerShell：

irm https://raw.githubusercontent.com/Ericwong5021/better-codex/main/scripts/install-beta.ps1 | iex

正式版与 Preview 使用相同的本地配置和数据。详细规则见更新通道与 Beta。

暂停与卸载

• better-codex eject：移除页面集成，保留任务数据和已安装组件。
• better-codex uninstall：移除 MCP、后台服务、启动入口、Skill、Agent 配置、本地数据和 CLI bundle。

卸载会删除本地数据。需要保留任务时，先阅读本地数据与隐私。