---
title: "Worktree 缺依赖：用桌面 Local environment 的 setup 脚本"
summary: "只给 ChatGPT 桌面 Codex。.worktreeinclude 只拷 ignore 文件，不会 npm install。setup 在新建 worktree 时跑；Actions 走集成终端。"
category: cloud
level: starter
surfaces: [app]
tags: ["worktree", "桌面", "setup"]
canonical: /tips/desktop-worktree-setup-scripts/
---

# Worktree 缺依赖：用桌面 Local environment 的 setup 脚本

只给 ChatGPT 桌面 Codex。.worktreeinclude 只拷 ignore 文件，不会 npm install。setup 在新建 worktree 时跑；Actions 走集成终端。

先在桌面应用切到 Codex，再打开 Settings 配 Local environment。配置写进当前项目根的 `.codex`，可进 Git。monorepo 要打开那个真正放共享 `.codex` 的目录。

新建 Worktree 聊天时会自动跑 setup。TypeScript 项目常见：

```bash
npm install
npm run build
```

按平台覆盖：给 macOS / Windows / Linux 各写一份，覆盖默认脚本。这解决的是「本地能跑、新树没有 node_modules」。它不会拷 `.env`；被 ignore 的本地文件仍走仓库根的 `.worktreeinclude`。

反复点的命令做成 Action（例如 `npm start`、测试套件），出现在顶栏，在集成终端里执行。一次性排错直接开终端，不必先做成 Action。

CLI 自己 `git worktree add` 出来的树、远程 worktree，都不会跑这套桌面 setup。

## 来源

- [OpenAI · Local environments](https://learn.chatgpt.com/docs/environments/local-environment)
- [OpenAI · Worktrees](https://learn.chatgpt.com/docs/environments/git-worktrees)