本地环境与项目操作

本地环境只在桌面应用的 Codex 中可用。先切换到 Codex，再从设置中配置；生成的配置保存在项目根的 .codex 目录，可以提交到仓库供团队共享。多项目仓库应打开包含共享 .codex 的项目目录。

新 worktree 的初始化

新 checkout 可能没有依赖、构建输出或未提交的本地文件。Setup script 在新聊天创建 worktree 时自动执行，用于准备环境。官方 TypeScript 示例：

npm install
npm run build

这是说明脚本用途的示例，实际应使用项目规定的包管理器和构建命令。可分别为 macOS、Windows、Linux 配置脚本，覆盖默认版本。应先确定依赖安装和构建的前提，不要把本地主目录已经可运行当作新 worktree 也可运行的证明。

常用 Actions

Actions 用于测试、启动应用等反复执行的操作，显示在桌面应用顶栏，并在集成终端运行。例如项目支持 npm start 时可以创建对应 Run 动作。动作可选图标，也支持平台特定脚本。

初始化脚本在创建新 worktree 时触发；Action 是后续常用操作的入口。一次性调试命令则可以直接在集成终端运行。

验证与 Git 工具

准备完成后，在新 worktree 中确认依赖、必要配置及测试能运行。差异面板可检查、暂存或撤销文件和区块，并支持提交、推送和创建 pull request；未提供的 Git 操作可在集成终端执行。

需要隔离多个任务时见Worktrees，需要复用忽略文件时先核对该页的 .worktreeinclude 范围。