#Agent 工作目录

Agent 执行任务时，需要进入一个工作目录。默认工作目录是 Agent 的运行设置，用来决定 Runtime 在哪份代码上工作。它不是空间 Git 仓库，也不会替代 Agent 或空间的仓库配置。

配置入口：打开 Agent 设置，进入 运行设置，再修改 默认工作目录。

和 Agent 对话时，还可以为这一次对话覆盖工作目录，而不改 Agent 的默认设置。详见 与 Agent 对话。

一般建议优先选择 创建临时目录。只有需要复用本机环境时，再选择 指定已有目录。

完整的任务派发和状态变化见 Agent 如何执行任务。仓库从哪里来见 连接代码库。

#创建临时目录

每个任务都会单独创建一个临时目录，并通过 Git worktree 准备一份独立代码工作区。任务之间不会写进同一个工作区，适合并行处理同一套代码。

例如，一个 Agent 在修复登录问题，另一个 Agent 在补充测试。它们可以分别使用自己的 worktree，修改不同文件、运行各自命令，而不需要先协调同一个脏目录。

任务完成后，你可以 review 这个任务对应 worktree 里的改动，再决定保留、合并或丢弃。

#指定已有目录

Agent 会使用电脑上已有的绝对路径。适合代码已经在本机、目录里有特殊依赖或缓存，或不希望每次任务都重新准备代码工作区的场景。

保存 Git 目录时，会出现 如何使用这个目录：

• Worktree 隔离运行（并行）：每个任务独立 checkout 一个 git worktree，不修改原目录；可并行；结果提交到 agent/<Agent名称>/<任务编号> 分支。只支持设置一个目录，选择后不显示「添加路径」。
• 直接该目录运行（串行）：直接读写该目录；人和 Agent 可在同一目录协作；不支持多任务并行，只能排队。可以选择后再「添加路径」。

不是 Git 目录时，只能直接运行。确认按钮是 确定。如果同时添加了 Git 工作区和非 Git 目录，保存后所有目录都会直接运行。保存路径时，界面会说明无法使用隔离 worktree 的原因。

选择直接运行时，可以为一个 Agent 添加多个目录。新任务会先选择空闲目录；如果都在使用，则选择当前最闲的目录。没有可用目录时，任务会进入 等待本地目录。隔离运行只支持一个目录，不要再按多目录设置来理解。

同一任务或对话会继续使用原来的目录。即使该路径后来从默认列表里移除，只要目录仍然可用，这次任务或对话也不会切换到其他路径。

隔离还是原地运行是这个 Agent 的一项设置。修改设置后，已绑定旧目录的任务或对话仍按原规则继续。

#常见问题

#修改默认工作目录后，已有任务会换目录吗？

不会。同一任务或对话会继续使用原来的目录，直到目录不可用。新的任务和对话才使用新的默认工作目录。

#指定已有目录会修改原目录吗？

取决于隔离设置。选择 Worktree 隔离运行（并行） 时，原目录保持不变，结果通过任务分支交付；选择 直接该目录运行（串行） 时，任务会直接修改原目录。

#为什么任务显示「等待本地目录」？

这表示指定目录暂时都不可用，常见原因是多个任务正在直接使用同一个路径，或电脑上的目录不满足运行条件。任务会等待目录释放后继续。

#可以同时添加 Git 和非 Git 目录吗？

可以，但这些目录无法使用隔离 worktree，任务会直接在所选目录中运行。保存设置时，界面会提示这一变化。

#工作目录和代码库配置是什么关系？

工作目录只决定 Agent 在哪里工作，不等于代码库配置。Git 仓库来源仍由 Agent 和空间配置决定，详见 连接代码库。