<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:media="http://search.yahoo.com/mrss/">
  <channel>
    <title>Developer Tools · Nhân Tài Đức</title>
    <link>https://jared.lynskey.co.nz/vi/tags/developer-tools/</link>
    <description>Những câu chuyện ngắn về kỹ thuật phần mềm và lãnh đạo đội ngũ kỹ sư — performance review, tuyển dụng và mở rộng team, CI/CD, giám sát DevOps và AI agent. Viết từ Seoul.</description>
    <generator>Hugo</generator>
    <language>vi</language>
    <copyright>© 2026 Nhân Tài Đức</copyright>
    <lastBuildDate>Thu, 19 Nov 2026 00:00:00 +1300</lastBuildDate>
    <atom:link href="https://jared.lynskey.co.nz/vi/tags/developer-tools/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>Cách dùng worktree trong Claude Code: chạy nhiều agent song song mà không giẫm chân nhau</title>
      <link>https://jared.lynskey.co.nz/vi/posts/2026/claude-code-git-worktrees/</link>
      <guid isPermaLink="true">https://jared.lynskey.co.nz/vi/posts/2026/claude-code-git-worktrees/</guid>
      <pubDate>Thu, 19 Nov 2026 00:00:00 +1300</pubDate>
      <dc:creator>Jared Lynskey</dc:creator>
      <category>Claude Code</category>
      <category>AI Agents</category>
      <category>Git</category>
      <category>Git Worktree</category>
      <category>tmux</category>
      <category>Developer Tools</category>
      <category>Parallel Development</category>
      <description>Cách dùng worktree trong Claude Code: lệnh claude -w, mang .env theo bằng .worktreeinclude, xử lý node_modules, base ref, dọn dẹp và chạy nhiều agent song song trong tmux.</description>
      <content:encoded><![CDATA[<p>Muốn chạy Claude Code trong một git worktree, bạn chỉ cần khởi động bằng <code>claude -w &lt;tên&gt;</code> (dạng đầy đủ là <code>--worktree</code>). Claude Code sẽ tạo thư mục <code>.claude/worktrees/&lt;tên&gt;/</code> ở gốc kho mã (repository), checkout vào đó một nhánh mới tên <code>worktree-&lt;tên&gt;</code>, tách ra từ nhánh mặc định trên remote. Từ lúc đó, phiên làm việc này chỉ được sửa file bên trong thư mục ấy. Mở terminal thứ hai, chạy lại đúng lệnh đó với một tên khác, là bạn có hai agent không thể đụng vào file của nhau. Cái bẫy nằm ở chỗ worktree là một bản checkout hoàn toàn mới: <code>.env</code>, <code>node_modules</code> và mọi thứ git bỏ qua sẽ không có ở đó cho tới khi bạn tự sao chép hoặc cài đặt. Gần như mọi rắc rối tôi từng gặp với worktree đều bắt nguồn từ đúng điểm này.</p>
<p>Tôi thường chạy nhiều agent song song, và tôi đến với worktree sau vài lần trả giá. Bài này nói về cách <code>claude -w</code> thực sự hoạt động (tôi kiểm tra trên phiên bản 2.1.328), <code>.worktreeinclude</code> dùng để làm gì, xử lý <code>node_modules</code> ra sao, tôi sắp xếp các phiên trong tmux thế nào, và khi nào tôi vẫn dùng <code>git worktree add</code> thuần.</p>
<figure><div class="film-pair">
  <div class="mc-film film-dark">
  <video
    class="my-0 rounded-md"
    controls playsinline preload="none"
    poster="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktrees-film-poster.jpg" style="background:url('data:image/webp;base64,UklGRoQAAABXRUJQVlA4IHgAAABwBQCdASogABIAPw1wq0omIyGYDAQAYxDE9IBn0BuOmrQv+whr1JowkP2GvdEWiylHGHsAAP7r1B494gmKZxYarGSLJSBCQLucUwJnafSMMs2DcN8Xi7b7w/dBQJDESVxNVTjZ96FIOv3VtbbF3xp3++/ULAEhgAA=') center/cover no-repeat"
    width="1280"
    height="720"
    aria-label="Video ngắn có lời dẫn kể lại bài viết này">
    <source src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktrees-film.webm" type="video/webm">
    <track kind="subtitles" src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktrees-film_en.vtt" srclang="en" label="English">
    <track kind="subtitles" src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktrees-film_ja.vtt" srclang="ja" label="日本語">
    <track kind="subtitles" src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktrees-film_ko.vtt" srclang="ko" label="한국어">
    <track kind="subtitles" src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktrees-film_vi.vtt" srclang="vi" label="Tiếng Việt" default>
    <track kind="subtitles" src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktrees-film_zh-cn.vtt" srclang="zh-cn" label="简体中文">
  </video>
  </div>
  <div class="mc-film film-light">
  <video
    class="my-0 rounded-md"
    controls playsinline preload="none"
    poster="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktrees-film-light-poster.jpg" style="background:url('data:image/webp;base64,UklGRoIAAABXRUJQVlA4IHYAAADQBACdASogABIAPw1uqUemIyIYBABjEMT0gAc4DbW6V3D/YCrZgv8AsVgfEQtYAAD+77ncv/xfKWHnvcUR0S+hsPg7hFdUPAZo9hZKq5p8p/3q6SK+cmbz04KNDvyW45u0Ws/43dQYB5jO2XsnWh2nnV30wAAA') center/cover no-repeat"
    width="1280"
    height="720"
    aria-label="Video ngắn có lời dẫn kể lại bài viết này">
    <source src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktrees-film-light.webm" type="video/webm">
    <track kind="subtitles" src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktrees-film_en.vtt" srclang="en" label="English">
    <track kind="subtitles" src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktrees-film_ja.vtt" srclang="ja" label="日本語">
    <track kind="subtitles" src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktrees-film_ko.vtt" srclang="ko" label="한국어">
    <track kind="subtitles" src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktrees-film_vi.vtt" srclang="vi" label="Tiếng Việt" default>
    <track kind="subtitles" src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktrees-film_zh-cn.vtt" srclang="zh-cn" label="简体中文">
  </video>
  </div>
  <script>(function(){if(window.mcFilm)return window.mcFilm();var a={play:'<path d="M8 5.6v12.8a1 1 0 0 0 1.52.85l10.2-6.4a1 1 0 0 0 0-1.7L9.52 4.75A1 1 0 0 0 8 5.6z"/>',pause:'<rect x="6.5" y="5" width="4" height="14" rx="1.2"/><rect x="13.5" y="5" width="4" height="14" rx="1.2"/>',volume:'<path d="M4 9.5v5a1 1 0 0 0 1 1h3l4.4 3.6a.6.6 0 0 0 1-.47V5.37a.6.6 0 0 0-1-.47L8 8.5H5a1 1 0 0 0-1 1z"/><path d="M16.5 8.5a5 5 0 0 1 0 7M19 6a8.5 8.5 0 0 1 0 12" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"/>',muted:'<path d="M4 9.5v5a1 1 0 0 0 1 1h3l4.4 3.6a.6.6 0 0 0 1-.47V5.37a.6.6 0 0 0-1-.47L8 8.5H5a1 1 0 0 0-1 1z"/><path d="M16.5 9.5l5 5m0-5l-5 5" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"/>',cc:'<rect x="3" y="5.5" width="18" height="13" rx="3" fill="none" stroke="currentColor" stroke-width="1.8"/><path d="M10.5 10.3a2.2 2.2 0 1 0 0 3.4M17 10.3a2.2 2.2 0 1 0 0 3.4" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/>',full:'<path d="M4.5 9V5.5a1 1 0 0 1 1-1H9M15 4.5h3.5a1 1 0 0 1 1 1V9M19.5 15v3.5a1 1 0 0 1-1 1H15M9 19.5H5.5a1 1 0 0 1-1-1V15" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round"/>',exit:'<path d="M9 4.5V8a1 1 0 0 1-1 1H4.5M19.5 9H16a1 1 0 0 1-1-1V4.5M15 19.5V16a1 1 0 0 1 1-1h3.5M4.5 15H8a1 1 0 0 1 1 1v3.5" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round"/>'},s={en:["Play","Pause","Mute","Unmute","Subtitles","Off","Full screen","Exit full screen","Seek"],ko:["재생","일시정지","음소거","음소거 해제","자막","끄기","전체 화면","전체 화면 종료","탐색"],ja:["再生","一時停止","ミュート","ミュート解除","字幕","オフ","全画面","全画面を終了","シーク"],zh:["播放","暂停","静音","取消静音","字幕","关闭","全屏","退出全屏","进度"],vi:["Phát","Tạm dừng","Tắt tiếng","Bật tiếng","Phụ đề","Tắt","Toàn màn hình","Thoát toàn màn hình","Tua"]},r=(document.documentElement.lang||"en").toLowerCase().slice(0,2),e=s[r]||s.en,t=function(e){return'<svg viewBox="0 0 24 24" aria-hidden="true" focusable="false">'+a[e]+"</svg>"},o={},i=function(e,t){if(o[e]||typeof window.gtag!="function")return;o[e]=!0;var n=(t.currentSrc||(t.querySelector("source")||{}).src||"").split("/").pop();window.gtag("event",e,{film:n.replace(/-light(?=\.)/,"")})},n=function(e){(!isFinite(e)||e<0)&&(e=0),e=Math.floor(e);var t=Math.floor(e/3600),n=Math.floor(e%3600/60),s=String(e%60).padStart(2,"0");return t?t+":"+String(n).padStart(2,"0")+":"+s:n+":"+s};function c(s){var a,r,c,d,u,m,p,g,v,b,j,_,w,O,C,E,k,A,o=s.querySelector("video");if(!o)return;s.classList.add("is-ready"),o.controls=!1,o.removeAttribute("controls"),s.insertAdjacentHTML("beforeend",'<button type="button" class="mc-film__big" aria-label="'+e[0]+'">'+t("play")+'</button><div class="mc-film__bar"><button type="button" class="mc-film__btn" data-act="play" aria-label="'+e[0]+'">'+t("play")+'</button><span class="mc-film__time"><span data-cur>0:00</span><span class="mc-film__of"> / </span><span data-dur>0:00</span></span><input class="mc-film__seek" type="range" min="0" max="1000" step="1" value="0" aria-label="'+e[8]+'"><span class="mc-film__cc"><button type="button" class="mc-film__btn" data-act="cc" aria-label="'+e[4]+'" aria-haspopup="true" aria-expanded="false">'+t("cc")+'</button><span class="mc-film__menu" role="menu" hidden></span></span><button type="button" class="mc-film__btn" data-act="mute" aria-label="'+e[2]+'">'+t("volume")+'</button><button type="button" class="mc-film__btn" data-act="full" aria-label="'+e[6]+'">'+t("full")+"</button></div>"),A=s.querySelector(".mc-film__big"),a=s.querySelector(".mc-film__bar"),j=a.querySelector('[data-act="play"]'),p=a.querySelector('[data-act="mute"]'),u=a.querySelector('[data-act="full"]'),d=a.querySelector('[data-act="cc"]'),r=a.querySelector(".mc-film__menu"),c=a.querySelector(".mc-film__seek"),w=a.querySelector("[data-cur]"),O=a.querySelector("[data-dur]"),g=!1,v=0,b=function(){return Array.prototype.filter.call(o.textTracks,function(e){return e.kind==="subtitles"||e.kind==="captions"})},b().length||(d.parentNode.hidden=!0),_=null;function f(e){var n,i,t=!s.classList.contains("is-idle")&&s.classList.contains("is-started");if(e!==!0&&t===_)return;_=t,n=o.clientHeight,i=n?Math.max(40,100-(a.offsetHeight+22)/n*100):85,b().forEach(function(e){if(e.mode!=="showing"||!e.cues)return;for(var n,s=0;s<e.cues.length;s++)n=e.cues[s],t?(n.snapToLines=!1,n.line=i,n.lineAlign="end"):(n.snapToLines=!0,n.line="auto",n.lineAlign="start")})}m=function(){f(!0)},window.addEventListener("resize",m),Array.prototype.forEach.call(o.querySelectorAll("track"),function(e){e.addEventListener("load",m)});function y(){o.paused||o.ended?o.play().catch(function(){}):o.pause()}function l(){s.classList.remove("is-idle"),f(),clearTimeout(v),v=setTimeout(function(){!o.paused&&r.hidden&&!a.querySelector(":focus-visible")&&(s.classList.add("is-idle"),f())},2600)}function M(){clearTimeout(v),h(),s.classList.add("is-idle"),f()}function h(){r.hidden=!0,d.setAttribute("aria-expanded","false")}function F(){var t=b(),n=t.filter(function(e){return e.mode==="showing"})[0];r.innerHTML="",[null].concat(t).forEach(function(s){var o=document.createElement("button");o.type="button",o.setAttribute("role","menuitemradio"),o.setAttribute("aria-checked",String(s?s===n:!n)),o.textContent=s?s.label||s.language:e[5],o.addEventListener("click",function(){t.forEach(function(e){e.mode=e===s?"showing":"disabled"}),h(),setTimeout(m,0),l()}),r.appendChild(o)}),r.hidden=!1,d.setAttribute("aria-expanded","true")}function x(){var n=!o.paused&&!o.ended;s.classList.toggle("is-playing",n),j.innerHTML=t(n?"pause":"play"),j.setAttribute("aria-label",n?e[1]:e[0]),n||l()}function S(){if(w.textContent=n(o.currentTime),!g&&o.duration){var e=o.currentTime/o.duration*1e3;c.value=e,c.style.setProperty("--p",e/10+"%")}}A.addEventListener("click",function(){o.play().catch(function(){})}),C="mouse",s.addEventListener("pointerdown",function(e){C=e.pointerType}),o.addEventListener("click",function(){if(!s.classList.contains("is-started"))return o.play().catch(function(){});if(C==="mouse")return y();s.classList.contains("is-idle")?l():M()}),j.addEventListener("click",y),o.addEventListener("play",function(){s.classList.contains("is-started")||i("film_play",o),s.classList.add("is-started"),x(),l()}),"IntersectionObserver"in window&&(E=new IntersectionObserver(function(e){if(!e.some(function(e){return e.isIntersecting}))return;E.disconnect(),i("film_view",o)},{threshold:.5}),E.observe(s)),o.addEventListener("pause",x),o.addEventListener("ended",x),o.addEventListener("timeupdate",S),o.addEventListener("durationchange",function(){O.textContent=n(o.duration),S()}),o.addEventListener("loadedmetadata",function(){O.textContent=n(o.duration)}),o.addEventListener("volumechange",function(){p.innerHTML=t(o.muted?"muted":"volume"),p.setAttribute("aria-label",o.muted?e[3]:e[2])}),p.addEventListener("click",function(){o.muted=!o.muted}),c.addEventListener("input",function(){g=!0,c.style.setProperty("--p",c.value/10+"%"),o.duration&&(o.currentTime=c.value/1e3*o.duration,w.textContent=n(o.currentTime))}),c.addEventListener("change",function(){g=!1}),d.addEventListener("click",function(e){e.stopPropagation(),r.hidden?F():h()}),document.addEventListener("click",function(e){!r.hidden&&!r.contains(e.target)&&h()}),u.addEventListener("click",function(){document.fullscreenElement||document.webkitFullscreenElement?(document.exitFullscreen||document.webkitExitFullscreen).call(document):s.requestFullscreen?s.requestFullscreen().catch(function(){}):s.webkitRequestFullscreen?s.webkitRequestFullscreen():o.webkitEnterFullscreen&&o.webkitEnterFullscreen()}),k=function(){var n=(document.fullscreenElement||document.webkitFullscreenElement)===s;s.classList.toggle("is-fullscreen",n),u.innerHTML=t(n?"exit":"full"),u.setAttribute("aria-label",n?e[7]:e[6])},document.addEventListener("fullscreenchange",k),document.addEventListener("webkitfullscreenchange",k),s.addEventListener("pointermove",function(e){e.pointerType==="mouse"&&l()}),s.addEventListener("focusin",l),s.addEventListener("keydown",function(e){if(e.target===c&&/^Arrow/.test(e.key))return;var t=e.key.toLowerCase();if(t==="k"||t===" "&&e.target===o)y();else if(t==="arrowleft")o.currentTime=Math.max(0,o.currentTime-5);else if(t==="arrowright")o.currentTime=Math.min(o.duration||0,o.currentTime+5);else if(t==="m")o.muted=!o.muted;else if(t==="f")u.click();else if(t==="escape"&&!r.hidden)h();else return;e.preventDefault(),l()}),o.tabIndex=0}window.mcFilm=function(){document.querySelectorAll(".mc-film:not(.is-ready)").forEach(c)},window.mcFilm()})()</script></div>
  <script>
  new MutationObserver(() => {
    const dark = document.documentElement.classList.contains("dark");
    document.querySelectorAll(".film-pair").forEach((pair) => {
      const from = pair.querySelector(dark ? ".film-light video" : ".film-dark video");
      const to = pair.querySelector(dark ? ".film-dark video" : ".film-light video");
      if (!from || !to || !from.currentTime) return;
      const playing = !from.paused;
      from.pause();
      to.currentTime = from.currentTime;
      [...from.textTracks].forEach((track, i) => { if (to.textTracks[i]) to.textTracks[i].mode = track.mode; });
      if (playing) to.play().catch(() => {});
    });
  }).observe(document.documentElement, { attributes: true, attributeFilter: ["class"] });
  </script><figcaption>Bài viết này dưới dạng video dài tám phút. Lời dẫn bằng tiếng Anh, có phụ đề tiếng Việt. Một số cảnh quay lấy từ Coverr.</figcaption>
</figure>


<h2 class="relative group">Git worktree là gì, và vì sao một bản checkout không đủ cho nhiều agent
    <div id="git-worktree-là-gì-và-vì-sao-một-bản-checkout-không-đủ-cho-nhiều-agent" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#git-worktree-l%c3%a0-g%c3%ac-v%c3%a0-v%c3%ac-sao-m%e1%bb%99t-b%e1%ba%a3n-checkout-kh%c3%b4ng-%c4%91%e1%bb%a7-cho-nhi%e1%bb%81u-agent" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<p>Git worktree là một thư mục làm việc riêng, có file và nhánh riêng, nhưng dùng chung lịch sử và remote với bản checkout chính. Nghe thì đơn giản, nhưng tôi chỉ thấy hết giá trị của nó sau khi chuyện xảy ra.</p>
<p>Một ngày tháng Chín, tôi để năm phiên Claude Code cùng làm việc trong một bản checkout duy nhất của ứng dụng marketplace tôi đang xây, và hai chuyện đã xảy ra. Một bản sửa một dòng trong file cấu hình kiểm thử đã sống sót qua bốn lần build thất bại, nhưng đến lúc commit thì biến mất: <code>git commit</code> báo working tree sạch, còn trong file là nội dung do một phiên khác viết. Kiểu cập nhật bị mất này không để lại dấu vết nào trong git: không có trong reflog, không có trong stash, thời gian sửa đổi cũng hoàn toàn bình thường. Cùng ngày hôm đó, một script triển khai (deploy) build thẳng từ working tree suýt đưa phần việc còn dang dở của một phiên khác lên production.</p>
<p>Sang tháng Mười thì có chuyện thứ ba. Một phiên commit file của mình ngay cạnh những thay đổi chưa stage của một phiên khác, và hook pre-commit đã stash <em>toàn bộ</em> những thay đổi chưa stage trong lúc hook chạy. Phần sửa của phiên kia biến khỏi ổ đĩa trong khoảng thời gian đó, trình kiểm tra kiểu (type checker) báo lỗi trên các file mới của nó, và lần commit bị huỷ. Thêm nữa, phiên nào cũng commit dưới tên tôi, nên nhìn <code>git log</code> cũng không biết ai đã làm gì.</p>
<p>Lý do dùng worktree gói gọn trong một câu: một working tree có nhiều người cùng ghi là một cuộc tranh chấp (race condition), và bên thua thậm chí không biết mình thua. Cho mỗi agent một working tree riêng là cuộc tranh chấp biến mất.</p>
<figure class="diagram">
  <div role="img" aria-label="Sơ đồ: một thư mục .git dùng chung, chứa commit, nhánh, cấu hình và một thư mục riêng nhỏ cho mỗi worktree, nối với ba thư mục làm việc: bản checkout chính trên nhánh main (có .env và node_modules), bản checkout tạo bằng git worktree add trên nhánh fix-login (không có cả hai), và bản checkout tạo bằng claude -w trên nhánh worktree-add-search (.env do .worktreeinclude sao chép, bị khoá khi phiên đang chạy)"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 700 933" aria-hidden="true" focusable="false">
<path class="d-group" d="M30,267 V762 M30,435.5 H62 M30,592 H62 M30,762 H62"></path>
<text class="d-title d-mono" x="2" y="30" font-size="28">.git</text>
<text class="d-sub" x="2" y="57" font-size="18">mọi worktree dùng chung</text>
<rect class="d-panel" x="2" y="75" width="696" height="192" rx="22"></rect>
<rect class="d-head" x="25" y="105" width="8" height="8" rx="2"></rect>
<text class="d-label" x="46" y="115.8" font-size="19">commit và object</text>
<rect class="d-head" x="25" y="137" width="8" height="8" rx="2"></rect>
<text class="d-label" x="46" y="147.8" font-size="19">branch và tag (refs/)</text>
<rect class="d-head" x="25" y="169" width="8" height="8" rx="2"></rect>
<text class="d-label" x="46" y="179.8" font-size="19">cấu hình, remote, hook</text>
<rect class="d-head" x="25" y="201" width="8" height="8" rx="2"></rect>
<text class="d-label" x="46" y="211.8" font-size="19">worktrees/: mỗi worktree một thư mục riêng nhỏ (HEAD và index</text>
<text class="d-label" x="46" y="239.8" font-size="19">của nó)</text>
<text class="d-title" x="62" y="327" font-size="26">Ba thư mục làm việc</text>
<text class="d-sub" x="62" y="354" font-size="18">mỗi thư mục có file, HEAD và index riêng</text>
<rect class="d-box" x="62" y="372" width="636" height="127" rx="14"></rect>
<text class="d-label d-mono" x="82" y="409.2" font-size="20">~/code/myapp</text>
<rect class="d-panel" x="82" y="424" width="60.1" height="28" rx="14"></rect>
<text class="d-label d-mono" x="94" y="443.4" font-size="15">main</text>
<text class="d-sub" x="154.1" y="444.1" font-size="17">bản checkout chính</text>
<path class="d-badge" style="fill:none;stroke-width:2.6" d="M83,474 l4.5,4.5 l9.5,-10"></path>
<text class="d-label" x="107" y="479.6" font-size="17">có .env</text>
<path class="d-badge" style="fill:none;stroke-width:2.6" d="M191.5,474 l4.5,4.5 l9.5,-10"></path>
<text class="d-label" x="215.5" y="479.6" font-size="17">node_modules 45 MB</text>
<rect class="d-box" x="62" y="515" width="636" height="154" rx="14"></rect>
<text class="d-label d-mono" x="82" y="552.2" font-size="20">~/code/myapp-fix-login</text>
<rect class="d-panel" x="82" y="567" width="105.3" height="28" rx="14"></rect>
<text class="d-label d-mono" x="94" y="586.4" font-size="15">fix-login</text>
<text class="d-sub" x="199.3" y="587.1" font-size="17">tạo bằng git worktree add</text>
<path class="d-line" style="fill:none;stroke-width:2.2" d="M85,611.5 l10,10 M95,611.5 l-10,10"></path>
<text class="d-sub" x="107" y="622.6" font-size="17">không có .env</text>
<path class="d-line" style="fill:none;stroke-width:2.2" d="M85,638.5 l10,10 M95,638.5 l-10,10"></path>
<text class="d-sub" x="107" y="649.6" font-size="17">không có node_modules (84 KB cho đến khi npm install)</text>
<rect class="d-box" x="62" y="685" width="636" height="154" rx="14"></rect>
<text class="d-label d-mono" x="82" y="722.2" font-size="20">~/code/myapp/.claude/worktrees/add-search</text>
<rect class="d-panel" x="82" y="737" width="195.6" height="28" rx="14"></rect>
<text class="d-label d-mono" x="94" y="756.4" font-size="15">worktree-add-search</text>
<text class="d-sub" x="289.6" y="757.1" font-size="17">tạo bằng claude -w add-search</text>
<path class="d-badge" style="fill:none;stroke-width:2.6" d="M83,787 l4.5,4.5 l9.5,-10"></path>
<text class="d-label" x="107" y="792.6" font-size="17">.env (do .worktreeinclude sao chép)</text>
<path class="d-line" style="fill:none;stroke-width:2.2" d="M85,808.5 l10,10 M95,808.5 l-10,10"></path>
<text class="d-sub" x="107" y="819.6" font-size="17">không có node_modules</text>
<rect class="d-line" style="fill:none;stroke-width:2" x="331.4" y="812.5" width="12" height="9" rx="2"></rect>
<path class="d-line" style="fill:none;stroke-width:2" d="M333.9,812.5 v-2.5 a3.5,3.5 0 0 1 7,0 v2.5"></path>
<text class="d-sub" x="354.4" y="819.6" font-size="17">bị khoá khi phiên đang chạy</text>
<text class="d-sub" x="2" y="877" font-size="16">Claude Code còn dùng chung hai thứ giữa các worktree của một repository: các phê</text>
<text class="d-sub" x="2" y="901" font-size="16">duyệt “don't ask again” (lưu trong .claude/settings.local.json của bản checkout chính)</text>
<text class="d-sub" x="2" y="925" font-size="16">và plugin cấp dự án.</text>
</svg>
</div><figcaption>Một repository, ba thư mục làm việc. Lịch sử chỉ lưu một chỗ; file, HEAD và index thì mỗi worktree có riêng.</figcaption>
</figure>


<h2 class="relative group">Cách dùng claude -w và cách nó hoạt động
    <div id="cách-dùng-claude--w-và-cách-nó-hoạt-động" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#c%c3%a1ch-d%c3%b9ng-claude--w-v%c3%a0-c%c3%a1ch-n%c3%b3-ho%e1%ba%a1t-%c4%91%e1%bb%99ng" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<figure><video
    class="my-0 rounded-md"
    autoplay loop muted playsinline preload="metadata"
    poster="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/claude-worktree.jpg" style="background:url('data:image/webp;base64,UklGRkoAAABXRUJQVlA4ID4AAACQAwCdASogABIAPw16sU+mI6IhKAgAxiGJ6QDC+BPdNCPmtcKAAP7ozOlPLz658ebe527EEQOHuoyZaAAAAA==') center/cover no-repeat"
    width="1280"
    height="720"
    aria-label="Terminal: cat .worktreeinclude hiện .env; claude -w add-search trả lời rằng nó đang ở nhánh worktree-add-search; git worktree list cho thấy worktree mới bị locked; ls cho thấy .env đã được sao chép nhưng không có node_modules; git worktree remove từ chối xoá vì worktree đang bị khoá bởi một phiên claude mà tiến trình đã thoát; unlock rồi remove thì thành công">
    <source src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/claude-worktree.mp4" type="video/mp4">
  </video><figcaption>Chạy thật trong một repository dùng xong là bỏ. Để ý cái khoá vẫn còn sau khi phiên đã kết thúc.</figcaption>
</figure>

<p>Dưới đây là những gì <a href="https://code.claude.com/docs/en/worktrees"  target="_blank" rel="noreferrer">trang worktrees trong tài liệu chính thức</a> viết, cộng với những gì tôi thấy khi tự chạy thử:</p>
<ul>
<li><strong>Vị trí và nhánh.</strong> <code>claude -w add-search</code> tạo <code>.claude/worktrees/add-search/</code> trên nhánh mới <code>worktree-add-search</code>. Nếu bỏ trống tên, bạn sẽ nhận một tên tự sinh kiểu <code>bright-running-fox</code>. Nhớ thêm <code>.claude/worktrees/</code> vào <code>.gitignore</code>, nếu không bản checkout chính sẽ hiện toàn bộ chỗ đó là file chưa được theo dõi (untracked).</li>
<li><strong>Tách từ đâu (base ref).</strong> Mặc định <code>worktree.baseRef</code> là <code>&quot;fresh&quot;</code>: tách từ nhánh mặc định trên remote, thường là <code>origin/main</code>. Nếu repository chưa fetch trong 24 giờ qua, Claude Code sẽ fetch trước, tối đa năm giây. Đặt thành <code>&quot;head&quot;</code> thì worktree mới tách từ <code>HEAD</code> hiện tại ở máy bạn, kèm cả những commit chưa push. Không thể đặt nó thành tên một nhánh cụ thể; muốn tạo từ một nhánh có sẵn thì tự dùng <code>git worktree add</code>.</li>
<li><strong>Pull request.</strong> <code>claude --worktree &quot;#1234&quot;</code> sẽ fetch head của PR đó và tạo <code>.claude/worktrees/pr-1234</code>. Nhớ đặt trong dấu nháy, nếu không shell sẽ coi <code>#</code> là bắt đầu một chú thích.</li>
<li><strong>Xác nhận tin cậy.</strong> Lần đầu chạy <code>claude -w</code> ở chế độ tương tác trong một thư mục chưa từng mở Claude, lệnh sẽ báo lỗi &ldquo;Workspace trust not yet accepted&rdquo;. Hãy chạy <code>claude</code> bình thường ở đó một lần và chấp nhận hộp thoại tin cậy. <code>claude -p -w</code> thì bỏ qua bước kiểm tra này.</li>
<li><strong>Hàng rào.</strong> Khi phiên đang ở trong worktree, Claude Code từ chối sửa file trong bản checkout chính, từ chối lệnh có thư mục làm việc là bản checkout chính, và từ chối lệnh git trỏ ngược về đó qua <code>git -C</code>, <code>--git-dir</code> hay <code>GIT_DIR</code>. Tài liệu cũng nói rõ những gì nó không chặn: một lệnh <code>cp</code> hay chuyển hướng shell ghi vào bản checkout chính sẽ không bị các bước kiểm tra này từ chối.</li>
</ul>
<p>Worktree dùng chung gì với bản checkout chính cũng quan trọng không kém những gì nó không dùng chung. Mọi worktree đều ghi vào cùng một <code>.git</code>, nên commit và nhánh tạo ở một worktree thì worktree nào cũng thấy. Plugin cấp dự án được nạp ở mọi nơi. Và một câu trả lời &ldquo;Yes, and don&rsquo;t ask again&rdquo; trong worktree sẽ được lưu vào <code>.claude/settings.local.json</code> của bản checkout <em>chính</em>, nghĩa là phê duyệt đó áp dụng cho mọi worktree và vẫn còn sau khi worktree nơi bạn phê duyệt bị xoá. Tiện thật, nhưng cũng thêm một lý do để đừng bao giờ đưa bí mật (secret) vào những lệnh bạn phê duyệt.</p>

<h2 class="relative group">Dọn dẹp, và cái khoá còn sót lại
    <div id="dọn-dẹp-và-cái-khoá-còn-sót-lại" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#d%e1%bb%8dn-d%e1%ba%b9p-v%c3%a0-c%c3%a1i-kho%c3%a1-c%c3%b2n-s%c3%b3t-l%e1%ba%a1i" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<p>Khi bạn thoát một phiên worktree ở chế độ tương tác, Claude Code kiểm tra xem xoá đi có mất gì không. Phiên không đặt tên mà worktree sạch thì bị xoá tự động, kể cả nhánh. Phiên có đặt tên thì sẽ hỏi trước. Nếu còn việc dang dở bên trong, bạn sẽ được hỏi có giữ lại không, và có thể quay lại sau bằng lệnh <code>claude --worktree &lt;tên&gt; --resume</code> mà nó in ra.</p>
<p>Chạy không tương tác thì khác, và đây là chỗ duy nhất làm tôi khựng lại khi thử. <code>claude -p</code> không có bước hỏi khi thoát, nên nó không dọn dẹp. Ngoài ra, Claude Code giữ một <code>git worktree lock</code> trên worktree trong lúc phiên chạy, và sau một lần chạy <code>-p</code>, cái khoá đó vẫn còn với một mã tiến trình (PID) không còn tồn tại. Bạn có thể thấy trong bản ghi ở trên: <code>git worktree remove</code> từ chối với thông báo &ldquo;cannot remove a locked working tree, lock reason: claude session add-search&rdquo;. Tài liệu mô tả đúng như vậy: một phiên sau đó sẽ dọn các khoá cũ, hoặc bạn chạy <code>git worktree unlock</code> trước. Biết rồi thì vô hại, nhưng lần đầu nhìn thấy cũng hơi giật mình.</p>

<h2 class="relative group">.worktreeinclude: những file một bản checkout mới không có
    <div id="worktreeinclude-những-file-một-bản-checkout-mới-không-có" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#worktreeinclude-nh%e1%bb%afng-file-m%e1%bb%99t-b%e1%ba%a3n-checkout-m%e1%bb%9bi-kh%c3%b4ng-c%c3%b3" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<p>Worktree chỉ chứa các file được git theo dõi. Muốn mang theo cả file bị git bỏ qua, hãy đặt một file <code>.worktreeinclude</code> ở gốc repository. File này dùng cú pháp của <code>.gitignore</code>, và Claude Code chỉ sao chép những file vừa khớp mẫu <em>vừa</em> bị git bỏ qua, nên file đã được theo dõi sẽ không bị sao chép trùng:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl"># .worktreeinclude
</span></span><span class="line"><span class="cl">.env
</span></span><span class="line"><span class="cl">.env.local
</span></span><span class="line"><span class="cl">config/secrets.json</span></span></code></pre></div></div>
<p>Nó áp dụng cho mọi worktree mà Claude Code tạo bằng git: <code>claude -w</code>, worktree của subagent và các phiên song song trong ứng dụng desktop. Nó không áp dụng cho worktree bạn tự tạo bằng <code>git worktree add</code>, và bị bỏ qua hoàn toàn nếu bạn thay quá trình tạo worktree bằng hook <code>WorktreeCreate</code>.</p>
<p>Tôi khuyên bạn đừng chỉ ghi mỗi <code>.env</code>, vì những file bị bỏ qua mà ta hay quên thường không báo lỗi ầm ĩ. Ứng dụng của tôi từng đổi script triển khai sang build từ một worktree sạch, để những sửa đổi chưa commit của các phiên khác không bao giờ lọt lên production. Nhưng working tree sạch đó lại thiếu các chứng chỉ ký (signing certificate) bị git bỏ qua mà một tính năng cần. Image vẫn build thành công, và tính năng đó lỗi trên production suốt 13 ngày, cho tới khi script được sửa để sao chép chứng chỉ vào và cảnh báo nếu thiếu cái nào. Một lần triển khai khác từ worktree thì thiếu một thư mục theme bị bỏ qua, và build chỉ thất bại <em>sau khi</em> một bước export mất hai phút đã làm bẩn working tree. Trước khi giao cho worktree bất cứ việc gì liên quan đến phát hành, hãy chạy <code>git status --short --ignored</code> trong bản checkout chính và xem trong đó có file nào mà quá trình build cần đọc.</p>

<h2 class="relative group">node_modules: phần tốn kém nhất
    <div id="node_modules-phần-tốn-kém-nhất" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#node_modules-ph%e1%ba%a7n-t%e1%bb%91n-k%c3%a9m-nh%e1%ba%a5t" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<p><code>.worktreeinclude</code> dành cho file nhỏ. Nó không giúp được gì với <code>node_modules</code>, và Claude Code cũng không có cơ chế dùng chung nó giữa các worktree, nên worktree nào cần chạy code thì phải có <code>node_modules</code> riêng.</p>
<figure><video
    class="my-0 rounded-md"
    autoplay loop muted playsinline preload="metadata"
    poster="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktree-basics.jpg" style="background:url('data:image/webp;base64,UklGRkgAAABXRUJQVlA4IDwAAADQAwCdASogABIAPw18sk+mI6IhKAgAxiGJ6QC/OBPdOMkqQtYu1AAA/ujR5WBjJmvERft5/vglvvCMAAA=') center/cover no-repeat"
    width="1280"
    height="720"
    aria-label="Terminal: git worktree add tạo myapp-fix-login trên một nhánh mới và myapp-hotfix ở trạng thái detached tại origin/main; git worktree list hiện cả ba; worktree mới không có .env cũng không có node_modules; du cho thấy bản checkout chính 45M, worktree 84K, rồi cả hai đều 45M sau npm install">
    <source src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktree-basics.mp4" type="video/mp4">
  </video><figcaption>Git worktree thuần trong một repository demo: 84 KB cho đến khi cài đặt, rồi lại đủ 45 MB.</figcaption>
</figure>

<p>Với dự án thật, con số bắt đầu đáng ngại. Repository ứng dụng di động của tôi có 19 worktree bên cạnh bản checkout chính. Tôi đo 12 cái: từ 194 MB đến 12 GB, và bốn cái lớn nhất chính là bốn cái có <code>node_modules</code> riêng. Tuần này ổ đĩa laptop của tôi đã đầy 96%, nên nếu dọn thì nên bắt đầu từ chúng.</p>
<p>Các lựa chọn, từ đơn giản đến khéo léo:</p>
<ol>
<li><strong>Cài riêng cho từng worktree.</strong> Bảo agent chạy <code>npm install</code> ngay từ đầu, hoặc tự làm. Chậm, tốn ổ đĩa, nhưng không bao giờ gây bất ngờ.</li>
<li><strong>Clone từ một bản checkout có cùng lockfile.</strong> Trên macOS, <code>cp -c -R ../myapp/node_modules .</code> dùng cơ chế clone của APFS, hai bên dùng chung khối dữ liệu cho tới khi một bên thay đổi. Clone 45 MB trong demo mất 0,8 giây. Tôi đã dùng cách này cho các lần triển khai thật từ worktree. Chỉ clone khi lockfile giống nhau, và cẩn thận với các thư mục build native: trong trường hợp của tôi, thư mục Pods của iOS trong bản checkout chính được build cho một SDK cũ hơn nhánh của worktree, nên phần đó phải cài lại từ đầu.</li>
<li><strong>Dùng pnpm.</strong> Các package nằm chung trong một store, và trên macOS pnpm <a href="https://pnpm.io/settings/node-modules#packageimportmethod"  target="_blank" rel="noreferrer">thử clone trước rồi mới tới hard link</a> (trên Linux và Windows thì hard link trước). Trong demo, lần cài cho worktree thứ hai mất khoảng năm giây.</li>
<li><strong>Cài trong hook <code>WorktreeCreate</code>.</strong> Hook này thay thế logic git mặc định của Claude Code, nên có thể chạy <code>git worktree add</code> rồi chạy luôn bước cài đặt. Cách này tôi chưa thử. Nếu bạn thử, nhớ rằng <code>.worktreeinclude</code> sẽ không còn được xử lý, và hook phải tự sao chép cả <code>.env</code>.</li>
</ol>

<h2 class="relative group">Chạy nhiều agent song song trong tmux
    <div id="chạy-nhiều-agent-song-song-trong-tmux" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#ch%e1%ba%a1y-nhi%e1%bb%81u-agent-song-song-trong-tmux" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<p>Tôi vốn đã sống trong tmux (bố cục nằm ở <a href="https://jared.lynskey.co.nz/vi/posts/2026/2026-10-22-claude-code-day-to-day/" >bài viết về cách tôi dùng Claude Code hằng ngày</a>), nên worktree khớp vào ngay: mỗi worktree một cửa sổ, hoặc một pane. Dưới đây là ba agent được khởi động cùng lúc, mỗi agent được yêu cầu sửa cùng một file:</p>
<figure><video
    class="my-0 rounded-md"
    autoplay loop muted playsinline preload="metadata"
    poster="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/parallel-agents-tmux.jpg" style="background:url('data:image/webp;base64,UklGRlQAAABXRUJQVlA4IEgAAACQBACdASogABIAPw10rE0mIyIhKAqoxiGJ6QDImBPdLsmKk7T7Naw9bcwBsAAA/ui+5wOzf0YXxkY1UgYA04COTxtokeJAAAA=') center/cover no-repeat"
    width="1280"
    height="720"
    aria-label="tmux chia ba pane: claude -w add-bye, add-greet và add-tests chạy cùng lúc; trong lúc chạy, tiêu đề mỗi pane đổi thành tên worktree; hai agent báo đã sửa src/index.js, một agent báo thêm thư mục test; cuối cùng pane trên cùng cho thấy bản checkout chính vẫn sạch và có ba worktree đang bị khoá">
    <source src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/parallel-agents-tmux.mp4" type="video/mp4">
  </video><figcaption>Ba agent, một file, không xung đột. Bản checkout chính vẫn sạch, mỗi thay đổi nằm chờ trên nhánh riêng.</figcaption>
</figure>

<p>Hai trong số đó sửa <code>src/index.js</code> cùng một lúc mà không hề biết đến nhau, vì <code>src/index.js</code> của mỗi agent là một file khác nhau trên ổ đĩa. Bản checkout chính vẫn sạch. Thứ còn lại ở cuối là ba nhánh cần review và merge, và đó là phần việc worktree không làm thay bạn được: nếu hai agent sửa cùng một dòng, bạn vẫn gặp xung đột khi merge. Chỉ khác là nó xuất hiện ở bước merge, nơi bạn nhìn thấy được, thay vì bị ghi đè trong im lặng.</p>
<p>Trong VS Code, worktree chỉ là một thư mục: <code>code .claude/worktrees/add-search</code> sẽ mở nó trong một cửa sổ riêng, trên nhánh riêng của nó.</p>

<h2 class="relative group">Worktree là một bản chụp
    <div id="worktree-là-một-bản-chụp" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#worktree-l%c3%a0-m%e1%bb%99t-b%e1%ba%a3n-ch%e1%bb%a5p" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<p>Worktree cũng cũ đi. Ngày 19 tháng 11, một bản cập nhật OTA được phát hành từ một worktree đã chuẩn bị sẵn từ hai, ba ngày trước, và nó lặng lẽ hoàn tác hai bản sửa lỗi đã được phát hành từ chỗ khác trong khoảng thời gian đó. Lỗi được phát hiện và thay thế ngay trong ngày, nhưng chính sự cô lập hoàn hảo của worktree là vấn đề: nó chưa bao giờ nhìn thấy hai bản sửa ấy. Chỉ một dòng lệnh git là đã bắt được lỗi trước khi phát hành:</p>
<figure><video
    class="my-0 rounded-md"
    autoplay loop muted playsinline preload="metadata"
    poster="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/stale-worktree-check.jpg" style="background:url('data:image/webp;base64,UklGRkgAAABXRUJQVlA4IDwAAACwAwCdASogABIAPw16sk+mI6IhKAgAxiGJ6QDEJBPdNJGDbpnawAD+6TSngiBlgQG6+gLgAZ5HH8TQAAA=') center/cover no-repeat"
    width="1280"
    height="720"
    aria-label="Terminal: main có commit mới &#39;Fix sign-in token handling&#39;; một worktree cũ vẫn đứng ở commit đầu tiên; git merge-base --is-ancestor main HEAD in ra &#39;missing the fix: rebase before you ship&#39;; sau git rebase main, cùng phép kiểm tra in ra &#39;has the fix&#39;">
    <source src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/stale-worktree-check.mp4" type="video/mp4">
  </video><figcaption>Phép kiểm tra nên chạy trước khi phát hành từ một worktree không phải vừa mới tạo.</figcaption>
</figure>

<p><code>baseRef: &quot;fresh&quot;</code> giữ cho worktree mới luôn cập nhật. Không có gì giữ cho worktree cũ cập nhật cả, nên hãy kiểm tra trước khi phát hành từ chúng.</p>

<h2 class="relative group">Subagent và hook
    <div id="subagent-và-hook" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#subagent-v%c3%a0-hook" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<p>Bạn không cần mở một terminal cho mỗi agent để có được sự cô lập này. Một subagent tuỳ chỉnh có <code>isolation: worktree</code> trong front matter sẽ luôn chạy trong một worktree tạm của riêng nó:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-markdown" data-lang="markdown"><span class="line"><span class="cl"><span class="nn">---</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">refactorer</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">description</span><span class="p">:</span><span class="w"> </span><span class="l">Applies mechanical refactors across many files</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">isolation</span><span class="p">:</span><span class="w"> </span><span class="l">worktree</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nn">---</span><span class="w">
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">Apply the requested refactor across every affected file, then run the tests
</span></span><span class="line"><span class="cl">and report the results.</span></span></code></pre></div></div>
<p>Đây là ví dụ lấy từ <a href="https://code.claude.com/docs/en/worktrees#isolate-subagents-with-worktrees"  target="_blank" rel="noreferrer">tài liệu</a>. Worktree sẽ bị xoá nếu subagent kết thúc mà không thay đổi gì; worktree có thay đổi thì được giữ lại cho tới khi đợt dọn dẹp định kỳ có thể xoá mà không làm mất việc. Một chi tiết nhỏ: subagent chạy trong worktree nằm dưới <code>.claude/worktrees/</code> nhận chỉ dẫn từ cuộc hội thoại chính, và không nạp file <code>CLAUDE.md</code> ở gốc worktree.</p>
<p>Hook <code>WorktreeCreate</code> và <code>WorktreeRemove</code> thay thế hoàn toàn logic git. Chúng dành cho các hệ thống quản lý phiên bản khác, hoặc khi bạn muốn đặt worktree ở chỗ khác ngoài <code>.claude/worktrees/</code>, nhưng cũng là nơi hợp lý cho các bước chuẩn bị như cài đặt ở trên.</p>

<h2 class="relative group">Khi nào git worktree add thuần lại tốt hơn
    <div id="khi-nào-git-worktree-add-thuần-lại-tốt-hơn" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#khi-n%c3%a0o-git-worktree-add-thu%e1%ba%a7n-l%e1%ba%a1i-t%e1%bb%91t-h%c6%a1n" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<p>Thú thật, thư mục <code>.claude/worktrees</code> trong repository ứng dụng của tôi đang trống. Cả 19 worktree đều được tạo bằng <code>git worktree add</code> thuần, tất cả trong một tháng qua, và một nửa đang ở trạng thái detached HEAD. Các repository khác trên laptop còn có thêm 40, 40, 18, 10, 3, 2 và 2 cái nữa. Mà phần lớn không phải do tôi tạo: trong 638 bản ghi hội thoại Claude Code trên chiếc laptop này, có 85 bản ghi mà agent chạy <code>git worktree add</code>, tổng cộng 336 lần.</p>
<p>Git thuần tốt hơn khi:</p>
<ul>
<li><strong>Bạn cần một nhánh cụ thể đã có sẵn,</strong> ví dụ nhánh release giữ lại để vá nóng (hotfix). <code>baseRef</code> không làm được việc này.</li>
<li><strong>Bạn chỉ muốn phát hành đúng một bản sửa.</strong> Các phiên khác đã commit lên <code>main</code> những phần việc chưa được triển khai, nên tôi tạo một worktree detached tại đúng commit đang chạy trên production, cherry-pick riêng bản sửa của mình vào đó và triển khai từ đó. Nhờ vậy, thứ được phát hành chỉ có bản sửa ấy.</li>
<li><strong>Bạn tự viết chỉ dẫn cho agent.</strong> Khi khởi động nhiều agent trên một repository, trong chỉ dẫn cho mỗi agent tôi đều ghi: tạo worktree riêng bằng <code>git worktree add --detach &quot;$TMPDIR/&lt;task&gt;-wt&quot; refs/remotes/origin/main</code>, push bằng <code>git push origin HEAD:main</code>, và rebase khi có xung đột.</li>
<li><strong>Bạn muốn giữ nó lại.</strong> Đợt dọn dẹp của Claude Code không bao giờ xoá worktree mà bạn tự tạo bằng <code>git worktree add</code>.</li>
</ul>
<p><code>claude -w</code> tốt hơn khi bạn tự tay mở một phiên và muốn nó lo hết việc tạo nhánh, sao chép <code>.env</code>, dựng hàng rào quanh bản checkout chính và dọn dẹp. Dùng lẫn cả hai cũng không sao: tạo bằng cách nào thì Claude Code cũng coi đó là worktree, và những thứ dùng chung với bản checkout chính như đã nói ở trên vẫn y nguyên.</p>

<h2 class="relative group">Tóm tắt
    <div id="tóm-tắt" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#t%c3%b3m-t%e1%ba%aft" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<p>Mỗi phiên chạy song song dùng một <code>claude -w &lt;tên&gt;</code>, và thêm <code>.claude/worktrees/</code> vào <code>.gitignore</code>. Trong <code>.worktreeinclude</code>, đừng chỉ ghi <code>.env</code>, hãy liệt kê mọi file bị bỏ qua mà quá trình build cần. Tính trước chuyện <code>node_modules</code>: cài riêng từng worktree, clone, hay dùng pnpm. Sau một lần chạy <code>-p</code>, có thể còn lại một cái khoá cần <code>git worktree unlock</code>. Trước khi phát hành từ một worktree không phải vừa tạo, hãy kiểm tra nó đã có những gì đang chạy trên production chưa. Worktree ngăn các agent ghi đè file của nhau, nhưng không ngăn chúng bất đồng ý kiến, nên cuối cùng người ngồi review ba nhánh vẫn là bạn.</p>

<h2 class="relative group">Đọc thêm
    <div id="đọc-thêm" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#%c4%91%e1%bb%8dc-th%c3%aam" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<p><strong>Trên blog này:</strong></p>
<ul>
<li><a href="https://jared.lynskey.co.nz/vi/posts/2026/2026-10-22-claude-code-day-to-day/" >Cách tôi dùng Claude Code hằng ngày</a>: tmux, các chế độ cấp quyền và cách dùng từ điện thoại</li>
</ul>
<p><strong>Nguồn khác:</strong></p>
<ul>
<li><a href="https://code.claude.com/docs/en/worktrees"  target="_blank" rel="noreferrer">Run parallel sessions with worktrees</a> trong tài liệu Claude Code, kỹ hơn phần lớn các trang tài liệu khác</li>
<li><a href="https://git-scm.com/docs/git-worktree"  target="_blank" rel="noreferrer">git-worktree</a>: cái gì dùng chung, cái gì mỗi worktree có riêng</li>
<li><a href="https://pnpm.io/settings/node-modules#packageimportmethod"  target="_blank" rel="noreferrer"><code>packageImportMethod</code> của pnpm</a>: clone và hard link</li>
</ul>
]]></content:encoded>
      <media:content url="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/featured.jpg" medium="image" type="image/jpeg" />
    </item>
    <item>
      <title>Phím tắt Mac cho lập trình viên: Terminal, Vim, VS Code và Chrome DevTools</title>
      <link>https://jared.lynskey.co.nz/vi/posts/2021/2021-12-19-commands/</link>
      <guid isPermaLink="true">https://jared.lynskey.co.nz/vi/posts/2021/2021-12-19-commands/</guid>
      <pubDate>Sun, 19 Dec 2021 11:30:03 +0000</pubDate>
      <dc:creator>Jared Lynskey</dc:creator>
      <category>Keyboard Shortcuts</category>
      <category>macOS</category>
      <category>Terminal</category>
      <category>Vim</category>
      <category>VS Code</category>
      <category>Chrome DevTools</category>
      <category>Productivity</category>
      <category>Developer Tools</category>
      <description>Những phím tắt (keyboard shortcut) tôi thật sự dùng khi lập trình trên Mac, đã đối chiếu với tài liệu chính thức: cửa sổ và không gian trên macOS, Terminal, Vim, VS Code, Chrome DevTools và Slack.</description>
      <content:encoded><![CDATA[<p>Đây là những phím tắt (keyboard shortcut) tôi dùng nhiều nhất khi lập trình trên Mac: chuyển qua lại giữa các cửa sổ và không gian (Spaces) trên macOS, Terminal, Vim, VS Code, công cụ dành cho nhà phát triển của Chrome (Chrome DevTools) và Slack. Chẳng có gì cao siêu, chỉ là mấy cái đã thật sự quen tay. Tất cả đều là phím tắt mặc định, tôi đã đối chiếu với tài liệu chính thức của từng ứng dụng, nên nếu bạn đã đổi lại phím thì có thể sẽ khác. Thêm một điều: trên nhiều bàn phím Mac, hàng phím trên cùng mặc định dùng để chỉnh độ sáng và âm lượng, nên với những phím tắt có phím <code>F</code> bạn có thể phải giữ thêm <code>fn</code>.</p>

<h2 class="relative group">Mac
    <div id="mac" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#mac" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<ul>
<li><code>ctrl</code> + <code>←</code> / <code>→</code> — chuyển qua lại giữa các không gian (màn hình nền)</li>
<li><code>ctrl</code> + <code>↑</code> — mở Mission Control</li>
<li><code>cmd</code> + <code>tab</code> — chuyển giữa các ứng dụng</li>
<li><code>cmd</code> + <code>`</code> — chuyển giữa các cửa sổ của ứng dụng đang dùng</li>
<li><code>ctrl</code> + <code>cmd</code> + <code>f</code> — bật/tắt chế độ toàn màn hình (với ứng dụng có hỗ trợ)</li>
<li><code>cmd</code> + <code>w</code> — đóng cửa sổ phía trước (<code>option</code> + <code>cmd</code> + <code>w</code> đóng mọi cửa sổ của ứng dụng đó)</li>
</ul>

<h2 class="relative group">Vim
    <div id="vim" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#vim" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<ul>
<li><code>vimtutor</code> — bài hướng dẫn có sẵn của Vim, chạy thẳng từ shell</li>
<li><code>v</code> — chế độ chọn trực quan (visual mode), chọn theo từng ký tự</li>
<li><code>V</code> — chế độ chọn trực quan, chọn theo cả dòng</li>
<li><code>ctrl</code> + <code>v</code> — chọn theo khối (visual block), chọn một vùng hình chữ nhật</li>
<li><code>y</code> — yank (sao chép) vùng đang chọn</li>
</ul>

<h2 class="relative group">Terminal
    <div id="terminal" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#terminal" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<ul>
<li><code>sudo !!</code> — chạy lại lệnh vừa gõ với quyền sudo (đây là tính năng mở rộng lịch sử lệnh của shell, nên dùng được trong zsh hay bash, ở bất kỳ ứng dụng terminal nào)</li>
<li><code>cmd</code> + <code>t</code> — mở thẻ (tab) mới</li>
<li><code>cmd</code> + <code>n</code> — mở cửa sổ mới</li>
<li><code>cmd</code> + <code>w</code> — đóng thẻ; <code>shift</code> + <code>cmd</code> + <code>w</code> đóng cả cửa sổ</li>
<li><code>ctrl</code> + <code>tab</code> / <code>ctrl</code> + <code>shift</code> + <code>tab</code> — sang thẻ kế tiếp / quay lại thẻ trước</li>
<li><code>cmd</code> + <code>d</code> — chia cửa sổ thành hai khung (pane)</li>
<li><code>shift</code> + <code>cmd</code> + <code>d</code> — đóng khung vừa chia</li>
</ul>

<h2 class="relative group">VS Code
    <div id="vs-code" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#vs-code" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<ul>
<li><code>cmd</code> + <code>p</code> — Quick Open: gõ một phần tên tệp là mở được ngay</li>
<li><code>shift</code> + <code>cmd</code> + <code>p</code> — bảng lệnh (Command Palette), bấm <code>F1</code> cũng được</li>
<li><code>cmd</code> + <code>d</code> — thêm chỗ xuất hiện tiếp theo của đoạn đang chọn vào vùng chọn, để sửa cùng lúc bằng nhiều con trỏ (multi-cursor)</li>
<li><code>option</code> + bấm chuột — thêm một con trỏ ở chỗ vừa bấm (<code>option</code> + <code>cmd</code> + <code>↑</code> / <code>↓</code> thêm con trỏ ở dòng trên hoặc dưới)</li>
<li><code>option</code> + <code>↑</code> / <code>↓</code> — chuyển dòng hiện tại lên hoặc xuống</li>
<li><code>shift</code> + <code>option</code> + <code>↑</code> / <code>↓</code> — nhân bản dòng hiện tại lên trên hoặc xuống dưới</li>
<li><code>cmd</code> + <code>/</code> — bật/tắt chú thích (comment) cho dòng</li>
<li><code>F12</code> — đi tới định nghĩa (Go to Definition)</li>
<li><code>ctrl</code> + <code>`</code> — hiện hoặc ẩn terminal tích hợp</li>
</ul>

<h2 class="relative group">Chrome DevTools
    <div id="chrome-devtools" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#chrome-devtools" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<ul>
<li><code>option</code> + <code>cmd</code> + <code>i</code> — mở DevTools ở bảng (panel) bạn dùng lần trước</li>
<li><code>option</code> + <code>cmd</code> + <code>j</code> — mở thẳng bảng Console</li>
<li><code>shift</code> + <code>cmd</code> + <code>c</code> — kiểm tra phần tử (inspect element): bấm vào bất cứ thứ gì trên trang là nhảy tới đúng chỗ đó trong bảng Elements</li>
<li><code>shift</code> + <code>cmd</code> + <code>p</code> — khi DevTools đang mở, gọi Command Menu (ví dụ gõ &ldquo;screenshot&rdquo;)</li>
<li><code>shift</code> + <code>cmd</code> + <code>r</code> — tải lại cứng (hard reload): tải lại các tệp của trang thay vì lấy từ bộ nhớ đệm</li>
</ul>

<h2 class="relative group">Slack
    <div id="slack" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#slack" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<ul>
<li><code>cmd</code> + <code>k</code> — nhảy tới một cuộc trò chuyện: gõ một phần tên kênh hoặc tên người rồi nhấn Enter (ở các phiên bản gần đây, ô này cũng tìm kiếm luôn)</li>
<li><code>F6</code> — chuyển tiêu điểm sang mục kế tiếp (<code>shift</code> + <code>F6</code> để quay lại)</li>
<li><code>cmd</code> + <code>/</code> — xem toàn bộ phím tắt của Slack</li>
</ul>
]]></content:encoded>
      <media:content url="https://jared.lynskey.co.nz/en/posts/2021/2021-12-19-commands/featured.jpeg" medium="image" type="image/jpeg" />
    </item>
  </channel>
</rss>
