跳到文章正文
Claude 实用教程

Claude Code怎么用独立工作树?分支、环境准备与退出清理

用--worktree为Claude Code创建独立文件目录和分支,核对基准提交与环境;说明忽…

Claude Code怎么用独立工作树?分支、环境准备与退出清理

两个任务同时修改同一工作目录,可能覆盖文件。Claude Code支持为会话创建Git worktree,隔离文件编辑。它和聊天分叉、子代理并不是同一功能。本文只讲隔离环境的创建与检查,不实际启动并行代理或合并代码。

第一步:记录仓库和基准

worktree需要Git仓库及已有提交。先检查当前分支、提交和未提交修改,保留重要工作,不假定新工作树会自动包含所有本地未提交文件。明确本次任务希望从哪个已确认状态开始。

工作树共享仓库历史与远程,但文件目录和分支独立。数据库、远程服务和外部目录不自动隔离,不能把文件隔离宣传为所有副作用都隔离。

第二步:创建命名工作树

在信任的练习仓库中使用–worktree或-w加名称。官方默认在仓库根.claude/worktrees下创建,对应worktree-名称分支。名称用于辨认任务,不在命令里放密钥或私人信息。

claude --worktree demo-docs

# 进入后首先核对:
# 当前目录、Git分支、基准提交和已有修改

第三步:准备独立环境

新目录可能没有依赖和被Git忽略的配置。先阅读项目说明,按已有授权准备环境,不能因为缺依赖就在主目录和新目录混着安装。敏感.env不应自动复制到所有任务,只有确需且权限合适时才处理。

官方提供.worktreeinclude用于带入忽略文件,但加入前要审阅范围。把整个用户目录或凭据文件列入其中会扩大风险,环境便利不能替代必要授权。

只检查新工作树的README和环境要求,报告缺失依赖与配置;暂不安装、不复制凭据、不连接外部服务。复述当前分支与任务范围后再提出实施计划。

第四步:在正确目录验证改动

运行任务时记录实际路径,检查测试和文件变更都发生在新目录。引用主目录文件或外部缓存时,明确哪些共享,不能凭终端标题就认为完全独立。

完成后查看diff、实际测试结果和未跟踪文件,不能把模型回复已完成当证据。工作树的提交不会自动进入主分支,下一步合并或挑拣提交需要明确策略与授权。

第五步:退出前确认保留与清理

官方退出流程会根据有无变化处理工作树,遇到保留或移除提示先检查真实状态。不要强行删除有未保存工作、运行中任务或所需提交的目录。退出会话与合并改动是两件事。

清理验收:提交和未提交改动已核对;结果文件已保存;后台任务状态明确;是否需要保留分支;工作树目录是否仍存在;主分支是否确实未被意外修改。

第六步:恢复与共享时重新核对

继续任务时选择真实工作树与会话,不用同名新目录代替旧状态。给同事交付提交、验证证据和剩余问题,不只给本机目录地址。不同工具对工作树基准和未提交内容处理不同,不能套用Grok或Codex行为。

官方资料

资料核对日期:2026年11月18日。

本文地址:https://www.163264.com/21717