<?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>Tmux · Nhân Tài Đức</title>
    <link>https://jared.lynskey.co.nz/vi/tags/tmux/</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/tmux/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>Cách tôi dùng Claude Code hằng ngày: tmux, các chế độ cấp quyền và chiếc điện thoại</title>
      <link>https://jared.lynskey.co.nz/vi/posts/2026/2026-10-22-claude-code-day-to-day/</link>
      <guid isPermaLink="true">https://jared.lynskey.co.nz/vi/posts/2026/2026-10-22-claude-code-day-to-day/</guid>
      <pubDate>Thu, 22 Oct 2026 00:00:00 +1300</pubDate>
      <dc:creator>Jared Lynskey</dc:creator>
      <category>Claude Code</category>
      <category>AI Agents</category>
      <category>LLM</category>
      <category>Developer Experience</category>
      <category>DevOps</category>
      <category>tmux</category>
      <category>SSH</category>
      <category>Codex</category>
      <category>Automation</category>
      <description>Claude Code là agent lập trình (coding agent) của Anthropic: các mô hình Claude làm việc ngay trên máy của bạn, với tệp và shell của bạn. Cách tôi dùng nó hằng ngày, kèm số liệu từ chính log của mình: trong terminal bên trong tmux, năm session, gần như luôn bỏ qua các lời hỏi xin quyền, truy cập từ điện thoại qua Remote Control, SSH và một bot chat, và vì sao tôi không thể nói nó so với Codex thế nào.</description>
      <content:encoded><![CDATA[<p>Claude Code là agent lập trình (coding agent) của Anthropic. Nó chạy cùng các mô hình Claude như ứng dụng Claude, nhưng chạy ngay trên máy của bạn, nơi nó có thể đọc tệp, chạy lệnh shell và sửa code của bạn, và nó đi kèm các gói Claude trả phí. Tôi dùng nó trong terminal chứ không dùng extension VS Code hay ứng dụng desktop: năm session nằm trong một session tmux trên laptop, gần như session nào cũng được khởi động với các lời hỏi xin quyền đã tắt, và tôi truy cập được chúng từ điện thoại qua tính năng Remote Control của ứng dụng Claude, qua SSH, hoặc qua một bot chat.</p>
<p>Phần dưới đây kể chi tiết cách thiết lập đó, với số liệu lấy từ chính máy của tôi chứ không phải từ trí nhớ: các tệp cài đặt (settings), bản ghi các session (transcript) mà Claude Code lưu dưới <code>~/.claude/projects</code> (của tôi có từ ngày 28/8), và lịch sử prompt của nó, có từ tháng 2 và chứa 7,323 prompt.</p>

<h2 class="relative group">Claude và Claude Code là hai thứ khác nhau
    <div id="claude-và-claude-code-là-hai-thứ-khác-nhau" 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="#claude-v%c3%a0-claude-code-l%c3%a0-hai-th%e1%bb%a9-kh%c3%a1c-nhau" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<p>Claude là họ mô hình, đồng thời là ứng dụng chat tại claude.ai, trên máy tính và trên điện thoại, nơi bạn trò chuyện với các mô hình đó. Claude Code là một agent được xây trên chính các mô hình ấy. Bạn khởi động nó trong một thư mục dự án, và nó làm việc ở đó theo một vòng lặp: đọc tệp, chạy lệnh, sửa code và chạy kiểm thử, cho đến khi xong việc hoặc cần đến bạn. Hỏi Claude cách sửa một lỗi thì bạn nhận được câu trả lời. Hỏi Claude Code thì bạn nhận được bản sửa, kèm một diff để đọc.</p>
<p>Tôi dùng cả hai. Từ ngày 18/10, một ứng dụng chợ kiêm cộng đồng mà tôi đang làm gửi việc dịch nội dung thẳng tới Claude API từ backend Django, và thay đổi chuyển nó sang cách đó được thực hiện trong một session Claude Code. Trong các transcript của tôi, 94% câu trả lời đến từ Opus 5.5, và trong cài đặt tôi để mức effort ở high.</p>
<p>Trình cài đặt native chỉ cần một dòng lệnh và tự cập nhật:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">curl -fsSL https://claude.ai/install.sh <span class="p">|</span> bash</span></span></code></pre></div></div>
<p>Nó tạo một symlink <code>claude</code> trong <code>~/.local/bin</code> trỏ vào <code>~/.local/share/claude/versions/</code>; bản của tôi tự lên từ 2.1.305 lên 2.1.306 vào ngày 21/10. Claude Code cần một gói Claude trả phí (Pro, Max, Team hoặc Enterprise) hoặc một tài khoản API. Giá thay đổi thường xuyên nên tôi xin nhường phần đó cho <a href="https://claude.com/pricing"  target="_blank" rel="noreferrer">trang bảng giá của Anthropic</a>.</p>

<h2 class="relative group">Một session tmux, bảy cửa sổ
    <div id="một-session-tmux-bảy-cửa-sổ" 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="#m%e1%bb%99t-session-tmux-b%e1%ba%a3y-c%e1%bb%ada-s%e1%bb%95" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<p>Lúc tôi viết bài này, <code>tmux list-panes -a</code> cho thấy trên laptop có một session tên <code>main</code> với bảy cửa sổ. Năm cửa sổ là Claude Code, mỗi dự án một cái: ứng dụng chợ mà tôi đang làm và ứng dụng ước tính chi phí của tôi (cả hai đều được kể trong <a href="https://jared.lynskey.co.nz/vi/posts/2026/2026-07-22-my-current-stack/" >Django trên Fly.io</a>), blog này và hai dự án nhỏ hơn. Profile terminal của tôi mở mọi cửa sổ bằng một login shell tự gắn vào <code>main</code>. Nhờ vậy, mở một tab mới trên laptop hay đăng nhập SSH từ điện thoại thì đều vào đúng những session đó.</p>
<p>Tôi đã thử một trình ghép kênh (multiplexer) khác từ ngày 17/9 đến ngày 8/10 rồi quay lại tmux vì một lý do thực tế: ứng dụng SSH trên điện thoại của tôi ghép kênh bằng tmux, và các nút tắt của nó gửi đúng các phím mặc định của tmux. Những dòng như thế này trong <code>~/.tmux.conf</code> có mặt là vì điện thoại:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="nb">set</span> -g prefix C-a                 <span class="c1"># Ctrl-a prefix</span>
</span></span><span class="line"><span class="cl"><span class="nb">set</span> -g prefix2 C-b                <span class="c1"># stock Ctrl-b too, for apps that send it</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Size each window to the client that used it last, not the smallest one,</span>
</span></span><span class="line"><span class="cl"><span class="c1"># so a phone attached to the same session doesn&#39;t shrink it.</span>
</span></span><span class="line"><span class="cl">setw -g window-size latest
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Copy to the clipboard of whichever terminal is attached (OSC 52),</span>
</span></span><span class="line"><span class="cl"><span class="c1"># so over SSH it lands on the phone&#39;s clipboard too.</span>
</span></span><span class="line"><span class="cl"><span class="nb">set</span> -g set-clipboard on</span></span></code></pre></div></div>
<p>Khi chạy trong tmux, có hai thứ thay đổi. Claude Code chuyển một lệnh đang chạy xuống chạy nền bằng Ctrl+B, mà giờ tổ hợp đó lại là prefix tmux thứ hai của tôi, nên <code>~/.claude/keybindings.json</code> tắt nó đi và dùng Meta+B thay thế:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-json" data-lang="json"><span class="line"><span class="cl"><span class="p">{</span>
</span></span><span class="line"><span class="cl">  <span class="nt">&#34;bindings&#34;</span><span class="p">:</span> <span class="p">[</span>
</span></span><span class="line"><span class="cl">    <span class="p">{</span> <span class="nt">&#34;context&#34;</span><span class="p">:</span> <span class="s2">&#34;Global&#34;</span><span class="p">,</span> <span class="nt">&#34;bindings&#34;</span><span class="p">:</span> <span class="p">{</span> <span class="nt">&#34;ctrl+b&#34;</span><span class="p">:</span> <span class="kc">null</span> <span class="p">}</span> <span class="p">},</span>
</span></span><span class="line"><span class="cl">    <span class="p">{</span> <span class="nt">&#34;context&#34;</span><span class="p">:</span> <span class="s2">&#34;Task&#34;</span><span class="p">,</span> <span class="nt">&#34;bindings&#34;</span><span class="p">:</span> <span class="p">{</span> <span class="nt">&#34;ctrl+b&#34;</span><span class="p">:</span> <span class="kc">null</span><span class="p">,</span> <span class="nt">&#34;meta+b&#34;</span><span class="p">:</span> <span class="s2">&#34;task:background&#34;</span> <span class="p">}</span> <span class="p">}</span>
</span></span><span class="line"><span class="cl">  <span class="p">]</span>
</span></span><span class="line"><span class="cl"><span class="p">}</span></span></span></code></pre></div></div>
<p>Thứ còn lại là xuống dòng. Enter sẽ gửi prompt đi. Tài liệu nêu <code>\</code> rồi Enter, và Ctrl+J, là hai cách dùng được trong mọi terminal; Option+Enter dùng được khi terminal gửi Option dưới dạng Meta; còn Shift+Enter chạy sẵn trong một số terminal, nhưng tmux chỉ chuyển tiếp nó khi bật <code>extended-keys</code>. Máy tôi không bật, nên trong các session của tôi, Shift+Enter sẽ gửi prompt đi. Mà tôi cũng hiếm khi cần đến cách nào trong số đó: chỉ 84 trong 7,323 prompt của tôi có dấu xuống dòng do tôi tự gõ, trong khi 279 prompt có nội dung dán vào, thứ mà Claude Code thu gọn thành một placeholder kiểu <code>[Pasted text #1 +34 lines]</code> nhưng vẫn gửi đi đầy đủ.</p>

<h2 class="relative group">Terminal, extension VS Code hay ứng dụng desktop?
    <div id="terminal-extension-vs-code-hay-ứng-dụng-desktop" 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-extension-vs-code-hay-%e1%bb%a9ng-d%e1%bb%a5ng-desktop" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<p>Cùng một agent nhưng có nhiều lớp vỏ, và các lớp vỏ này đọc chung các tệp cài đặt. Dựa vào điểm khởi chạy (entry point) mà Claude Code ghi lại trong mỗi transcript, các session của tôi chia ra như sau:</p>
<table>
	<thead>
			<tr>
					<th>Giao diện</th>
					<th>Là gì</th>
					<th>Tôi dùng, từ 28/8 đến 21/10</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>CLI trong terminal</td>
					<td><code>claude</code> trong một terminal, bên trong tmux</td>
					<td>128 session</td>
			</tr>
			<tr>
					<td>Ứng dụng desktop, tab Code</td>
					<td>Claude Code bên trong ứng dụng Claude, có phần xem diff và các khung (pane)</td>
					<td>2 session</td>
			</tr>
			<tr>
					<td>Extension VS Code</td>
					<td>một khung chat trong trình soạn thảo</td>
					<td>không dùng; hiện không còn cài, chỉ sót lại phần cài đặt của nó</td>
			</tr>
	</tbody>
</table>
<p>Ứng dụng Claude và claude.ai/code không phải là nơi thứ tư để khởi động một session: chúng điều khiển một session đã chạy sẵn trên laptop của tôi, hoặc một session trên cloud, và phần lớn session của tôi kể từ tháng 10 đều có đường kết nối đó qua Remote Control.</p>
<p>Với tôi thì là terminal, và không phải vì trung thành gì. tmux, thứ mà điện thoại của tôi kết nối vào, cần có terminal, và channels cũng vậy: đây là tính năng đẩy các sự kiện từ bên ngoài vào một session, và tài liệu xếp nó vào nhóm tính năng của CLI.</p>
<p>Nhiều người cũng hỏi Claude Code có cần git không. CLI thì không: thư mục home của tôi không phải là repository, và 208 prompt của tôi được gửi tới các session khởi động ở đó. Tài liệu của ứng dụng desktop nói git là bắt buộc cho cơ chế cô lập session (session isolation), trong đó mỗi session có worktree riêng, còn muốn kéo một session trên cloud về terminal thì cần một bản checkout của cùng repository đó. Bản thân tôi chưa bao giờ gặp thông báo &ldquo;Git is required&rdquo;. Session desktop gần nhất của tôi, vào ngày 20/10, chạy trong một thư mục hoàn toàn không phải repository.</p>

<h2 class="relative group">Các chế độ cấp quyền, và chế độ tôi thật sự dùng
    <div id="các-chế-độ-cấp-quyền-và-chế-độ-tôi-thật-sự-dù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%a1c-ch%e1%ba%bf-%c4%91%e1%bb%99-c%e1%ba%a5p-quy%e1%bb%81n-v%c3%a0-ch%e1%ba%bf-%c4%91%e1%bb%99-t%c3%b4i-th%e1%ba%adt-s%e1%bb%b1-d%c3%b9ng" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<p>Chế độ cấp quyền (permission mode) quyết định Claude Code dừng lại hỏi bạn thường xuyên đến đâu, và Shift+Tab chuyển vòng qua các chế độ. Manual (<code>default</code>) hỏi trước hầu hết các thao tác sửa tệp, chạy lệnh hoặc truy cập mạng. <code>acceptEdits</code> cho các thao tác sửa tệp và các lệnh hệ thống tệp thông dụng đi qua. <code>plan</code> chỉ đọc và đề xuất, không sửa gì. <code>auto</code> dùng một mô hình thứ hai, một bộ phân loại (classifier), để chặn các thao tác rủi ro thay vì hỏi bạn. <code>bypassPermissions</code> gần như không hỏi gì cả. Từ phiên bản 2.1.283, một session trong terminal sẽ khởi động ở chế độ auto trừ khi bạn đặt khác đi trong <code>permissions.defaultMode</code>.</p>
<p>Vậy nên câu trả lời thật lòng của tôi cho câu hỏi &ldquo;làm sao để chạy Claude Code mà nó không xin quyền&rdquo; là tôi khởi động nó như thế này:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">claude --dangerously-skip-permissions</span></span></code></pre></div></div>
<p>62 trong số 69 lệnh <code>claude</code> trong lịch sử shell của tôi có cờ đó, và cả năm session đang chạy lúc này cũng vậy. Trong 1,266 prompt tôi gõ từ ngày 28/8 đến 21/10, 1,179 prompt đi vào các session ở chế độ bypass, 82 prompt ở chế độ auto và năm prompt ở chế độ Manual hoặc accept-edits.</p>
<p>Tài liệu nói rõ chế độ bypass dành cho &ldquo;các môi trường được cô lập như container, máy ảo (VM) hoặc dev container không có kết nối internet, nơi Claude Code không thể gây hại cho hệ thống host của bạn&rdquo;. Laptop của tôi không thuộc loại nào trong số đó, và cài đặt của tôi còn ghi lại việc tôi đã bấm cho qua cảnh báo ấy (<code>&quot;skipDangerousModePermissionPrompt&quot;: true</code>). Nếu bạn cũng làm vậy, hãy biết rằng các quy tắc allow không có tác dụng gì trong chế độ bypass, nên trong các session hằng ngày của tôi, 378 quy tắc allow rải rác trên 19 tệp cài đặt hoàn toàn chẳng làm gì cả. Các quy tắc deny và ask thì vẫn có hiệu lực, và tôi không có quy tắc nào thuộc hai loại đó.</p>
<p>Ngoại lệ là session phải đọc những gì người khác viết. Launcher của nó không truyền cờ đó, nên nó khởi động ở chế độ auto. Toàn bộ 27 sự kiện production và 42 trong 43 tin nhắn chat tới được một session trong khoảng từ ngày 12 đến 20/10 đều đến khi session đang ở chế độ auto, không cái nào đến lúc ở chế độ bypass.</p>
<p>Thứ thật sự giữ cho chế độ bypass không quay lại cắn tôi là vài thói quen, được ghi vào bộ nhớ (memory) của Claude sau một ngày tháng Chín khi hai session trong cùng một bản checkout ghi đè lên việc của nhau và suýt đưa nó lên production (đầu đuôi câu chuyện nằm trong <a href="https://jared.lynskey.co.nz/vi/posts/2026/2026-10-22-agentic-ai-security/#cách-ly-vì-mối-đe-doạ-dễ-xảy-ra-nhất-lại-là-một-agent-khác" >bài về bảo mật agentic AI</a>). Các quy tắc từ đó đến giờ: commit một bản sửa nhỏ ngay khi nó chạy được, stage tệp theo tên và không bao giờ dùng <code>git add -A</code>, xem <code>git status</code> để tìm những thay đổi không phải do mình làm, và khi <code>main</code> đang chứa phần việc chưa triển khai của các session khác thì triển khai từ một worktree đặt ở đúng commit đang chạy thật.</p>

<h2 class="relative group">Truy cập từ điện thoại
    <div id="truy-cập-từ-điện-thoạ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="#truy-c%e1%ba%adp-t%e1%bb%ab-%c4%91i%e1%bb%87n-tho%e1%ba%a1i" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<p>Có ba lối vào, và mỗi lối dẫn tới một thứ khác nhau.</p>
<table>
	<thead>
			<tr>
					<th>Lối vào</th>
					<th>Những gì tôi có trên điện thoại</th>
					<th>Chạy nhờ vào đâu</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>Remote Control, trong ứng dụng Claude</td>
					<td>cuộc hội thoại của một session: gõ prompt, trả lời câu hỏi của nó, đính kèm ảnh</td>
					<td><code>remoteControlAtStartup: true</code>, cộng thông báo đẩy (push notification)</td>
			</tr>
			<tr>
					<td>SSH vào <code>main</code>, từ một ứng dụng SSH trên điện thoại</td>
					<td>chính terminal, mọi cửa sổ</td>
					<td>một mạng riêng, một sshd chạy dưới user của tôi, và một alias ngắn để attach</td>
			</tr>
			<tr>
					<td>Một bot chat</td>
					<td>một session nghe các lỗi production và trả lời tin nhắn</td>
					<td>một plugin channel chính thức của Claude Code và một event channel do tôi tự viết</td>
			</tr>
	</tbody>
</table>
<p>Remote Control kết nối ứng dụng Claude trên điện thoại, hoặc claude.ai/code trên trình duyệt, tới một session vẫn tiếp tục chạy trên laptop, kèm đầy đủ tệp, công cụ và các MCP server. Tôi đã gõ <code>/rc</code> 26 lần từ ngày 13/9 đến 20/10. Giờ thì <code>remoteControlAtStartup</code> đã bật và các session mới tự kết nối: từ đầu tháng 10, 67 trong 77 session tôi khởi động có link Remote Control, so với 3 trên 52 trong nửa cuối tháng 9.</p>
<p>Khi bật <code>agentPushNotifEnabled</code>, Claude có thể gửi thông báo đẩy khi nó thấy cần, mà theo tài liệu thì thường là khi một tác vụ dài đã xong hoặc khi nó cần bạn ra quyết định. Tính năng này cần gói đăng ký claude.ai chứ không phải API key, và vì session chạy trên laptop nên laptop phải luôn thức. Từ ngày 15/10, máy tôi không ngủ kể cả khi gập nắp (<code>sudo pmset -a disablesleep 1</code>).</p>
<p>Chiều ngược lại cũng được. <code>/teleport</code>, hoặc <code>claude --teleport</code>, kéo một session trên cloud đã được khởi động trên web hoặc trong ứng dụng về terminal, kèm theo branch và cuộc hội thoại của nó. Tôi đã làm vậy hai lần, cả hai đều vào tháng 7.</p>
<p>SSH là để dùng khi tôi muốn chính cái terminal. Điện thoại truy cập laptop qua mạng riêng trong <a href="https://jared.lynskey.co.nz/vi/posts/2026/2026-10-01-cloudflare-warp-dev-network/" >bài về mạng riêng của tôi</a>, và một alias gắn nó vào <code>main</code>, nên tôi có thể vuốt qua lại giữa các cửa sổ đã để sẵn trên laptop. Để chiếc Mac trả lời đúng cách cho các ứng dụng trên điện thoại, tôi đã phải sửa bốn chỗ riêng biệt, và chỗ quan trọng với Claude Code là tmux tuyệt đối không được tự khởi động: một ứng dụng mở session để chạy <code>docker ps</code> đã nhận về 72 KB dữ liệu vẽ lại màn hình thay vì kết quả lệnh.</p>
<p>Bot chat dành cho session mà tôi không muốn ngồi canh. Từ ngày 12/10, một session chạy cùng một channel nhỏ do tôi viết, cứ mỗi phút kiểm tra máy chủ của ứng dụng một lần để tìm lỗi production mới và hoạt động mới trên bảng quản lý dự án rồi chuyển chúng cho session, cộng thêm một trong các plugin chat chính thức, để hai người chúng tôi có tên trong danh sách cho phép (allowlist) của nó có thể nhắn tin cho nó. Lệnh khởi động trông như thế này, với các tên đã được đổi thành tên chung chung:</p>
<div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="nb">exec</span> claude <span class="se">\
</span></span></span><span class="line"><span class="cl">  --channels plugin:&lt;chat-plugin&gt;@claude-plugins-official <span class="se">\
</span></span></span><span class="line"><span class="cl">  --dangerously-load-development-channels server:my-events <span class="s2">&#34;</span><span class="nv">$@</span><span class="s2">&#34;</span></span></span></code></pre></div></div>
<p>Một script giám sát (supervisor) giữ cho nó chạy liên tục bên trong tmux. Sau mỗi lần khởi động lại, nó tiếp tục đúng cuộc hội thoại cũ, nên session làm tiếp chứ không tỉnh dậy với đầu óc trống trơn, và script báo mọi lần khởi động lại lên kênh chat. Session này sửa lỗi trong working tree và dừng ở đó, với một ngoại lệ tôi thêm vào ngày 13/10: một lỗi đang thật sự ảnh hưởng tới người dùng trên production thì nó được phép sửa, kiểm thử, commit và triển khai, rồi báo cho chúng tôi biết nó đã làm gì.</p>

<h2 class="relative group">Skill, memory và /goal
    <div id="skill-memory-và-goal" 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="#skill-memory-v%c3%a0-goal" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<p>Không có khóa <code>hooks</code> nào trong các tệp cài đặt của tôi. Thứ gần nhất là <code>/goal</code>, tôi đã dùng đi dùng lại kể từ ngày 11/7. Nó nhận một điều kiện và thiết lập một Stop hook cho session, mà theo lời Claude Code là &ldquo;sẽ chặn việc dừng lại cho đến khi điều kiện được thỏa mãn&rdquo;. Các goal của tôi viết y như cách tôi nói thành lời. Một goal thật từ tháng 7, giữ nguyên cả lỗi chính tả, bảo nó rằng bản build &ldquo;still broken, try a deeper fix and dont stop until&rdquo; (vẫn hỏng, thử sửa sâu hơn và đừng dừng cho tới khi) nó tới tay người kiểm thử. Muốn kiểm tra một lượt chạy dài mà không làm nó chệch hướng thì có <code>/btw</code>, một câu hỏi bên lề không lọt vào cuộc hội thoại chính. Câu của tôi phần lớn là một biến thể nào đó của &ldquo;hows it going?&rdquo; (sao rồi?).</p>
<p>Skill chứa những thứ mà nếu không có thì lần nào tôi cũng phải giải thích lại. Một skill ở cấp người dùng (user-level) đọc báo cáo từ khóa hằng tuần cho các trang web tôi đang lo, trong đó có blog này, rồi áp dụng vào tiêu đề, mô tả và tag. Những câu hỏi mà bài này trả lời đến từ báo cáo của nó cho blog này, ngày 18/10, và tệp skill được quản lý phiên bản trong một repo, nằm cạnh phần code của nó. Repo của ứng dụng chợ có skill riêng: một skill khởi động API trong Docker và chạy smoke test, một skill làm việc với bảng quản lý dự án, và một skill kê khai chi phí cho công ty. Hai plugin tôi đang cài là một plugin language server cho Swift và plugin chat kia.</p>
<p>Memory là nơi lưu các bài học. Tôi có 160 tệp memory trên 17 dự án, 83 tệp trong số đó dành cho ứng dụng chợ, và nhiều tệp kể về một thứ từng bị hỏng. <code>CLAUDE.md</code> của ứng dụng giờ dài gấp khoảng sáu lần so với hồi tháng 6. <code>CLAUDE.md</code> của blog này là một tệp rỗng; còn một bài viết nên có giọng văn thế nào thì nằm trong một tệp memory.</p>
<p>Với những việc lớn hơn, Claude khởi động các subagent, 120 lần trong các session chính của tôi, 40 lần trong số đó là bản fork của cuộc hội thoại. Đó là cách blog này có các phiên bản tiếng Nhật, tiếng Hàn, tiếng Trung và tiếng Việt. Ngày 19 và 20/10, đợt thiết kế lại phần cộng đồng của ứng dụng đã đi qua công cụ Workflow bốn lần: một lượt rà soát (audit) qua bảy góc nhìn cùng một người phản biện (critic), xác nhận khoảng 58 phát hiện; các bản sửa do năm nhóm thực hiện, mỗi nhóm phụ trách các tệp riêng của mình và đều được review; một lượt xử lý những phần còn sót; và một lần kiểm tra độc lập rằng mọi phát hiện đều đã được sửa. Bản thiết kế mới được phát hành vào ngày 20.</p>

<h2 class="relative group">Điều khiển một máy trạm qua SSH
    <div id="điều-khiển-một-máy-trạm-qua-ssh" 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%91i%e1%bb%81u-khi%e1%bb%83n-m%e1%bb%99t-m%c3%a1y-tr%e1%ba%a1m-qua-ssh" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<p><a href="https://jared.lynskey.co.nz/vi/posts/2026/2026-10-01-cloudflare-warp-dev-network/" >Bài về mạng riêng của tôi</a> kể về việc dồn phần việc nặng sang devbox, máy trạm có GPU ở văn phòng, và truy cập nó từ bất cứ đâu. Phần lớn việc truy cập đó là do Claude Code làm. Từ ngày 24/9 đến 19/10, 21 session trên laptop đã chạy 1,470 lệnh trên devbox qua <code>ssh</code> thông thường: <code>kubectl</code> vào cụm Kubernetes chạy trên đó, <code>psql</code> bên trong một pod cơ sở dữ liệu, <code>tmux capture-pane</code> để xem một tác vụ dài đang tiến triển ra sao. Vì <code>ssh devbox</code> tự chuyển sang một tunnel khi không ở trong mạng văn phòng, cùng một session chạy được ở văn phòng, ở nhà hay ở quán cà phê. Và vì laptop không còn ngủ nữa, một session có thể tiếp tục điều khiển devbox trong khi tôi xem nó từ điện thoại.</p>

<h2 class="relative group">Vì sao tôi không thể so nó với Codex
    <div id="vì-sao-tôi-không-thể-so-nó-với-codex" 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="#v%c3%ac-sao-t%c3%b4i-kh%c3%b4ng-th%e1%bb%83-so-n%c3%b3-v%e1%bb%9bi-codex" aria-label="Cọc dấu">#</a>
    </span>
    
</h2>
<p>Dựa trên trải nghiệm của chính mình, tôi không thể nói với bạn Claude Code có tốt hơn Codex hay không, và bảng dưới đây cho thấy lý do:</p>
<table>
	<thead>
			<tr>
					<th></th>
					<th>Codex</th>
					<th>Claude Code</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>Thời gian</td>
					<td>từ 29/11 đến 4/12/2025</td>
					<td>ít nhất từ tháng 11/2025; lịch sử prompt từ tháng 2/2026</td>
			</tr>
			<tr>
					<td>Ở đâu</td>
					<td>extension VS Code</td>
					<td>terminal (128 session), ứng dụng desktop (2)</td>
			</tr>
			<tr>
					<td>Mô hình và effort</td>
					<td><code>gpt-5.1-codex</code>, medium</td>
					<td>Opus 5.5, high</td>
			</tr>
			<tr>
					<td>Phê duyệt</td>
					<td>sandbox <code>workspace-write</code>, tắt mạng, hỏi theo yêu cầu (on request)</td>
					<td>bypass trong 93% số prompt, auto cho session chat</td>
			</tr>
			<tr>
					<td>Mức độ sử dụng</td>
					<td>4 thread</td>
					<td>7,323 prompt kể từ tháng 2</td>
			</tr>
			<tr>
					<td>Ghi chú dự án</td>
					<td>đọc <code>AGENTS.md</code></td>
					<td>đọc <code>CLAUDE.md</code>, cộng các tệp memory</td>
			</tr>
	</tbody>
</table>
<p>Bốn thread trong một tuần, về một câu hỏi liên quan đến hình ảnh, hai thay đổi cho một website và một cảnh 3D, là một lần dùng thử, không phải một phép so sánh. Nhưng có một chi tiết từ đó áp dụng được cho mọi lần chuyển giữa các agent. Dự án 3D giữ các quy tắc của nó trong một tệp <code>claude.md</code>, và câu đầu tiên tôi hỏi Codex ở đó là nó có đọc các tệp của Claude trước khi bắt đầu cuộc hội thoại không. Nó nói là không, và nó chỉ nắm được quy tắc của dự án khi tôi bảo nó đọc tệp đó. Dù bạn chuyển sang agent nào, tệp hướng dẫn sẽ bị bỏ lại phía sau trừ khi bạn tự mang nó theo. Từ đó đến nay tôi chưa mở thread Codex nào. Extension vẫn được nạp trong VS Code vào vài ngày trong khoảng từ 24/9 đến 4/10 mà tôi không hề bắt đầu thread nào, và giờ nó đã được gỡ cài đặt.</p>
<p>Vậy nên kết luận mà tôi dám đứng ra bảo đảm khá hẹp. Claude Code là thứ mà toàn bộ cách thiết lập của tôi xoay quanh, và tôi chưa quay lại xem bây giờ Codex xử lý những việc tương tự ra sao.</p>
<p>Một con số cuối cùng nói về cách tôi dùng nó nhiều hơn mọi thứ ở trên. Trong các session chính trên laptop kể từ cuối tháng 8, Claude Code đã chạy 18,311 lệnh shell và đọc, ghi hoặc sửa tệp 2,331 lần. Tính theo số lượng, phần lớn công việc của nó là chạy những lệnh mà lẽ ra tôi phải tự gõ, trên laptop và qua SSH, từ bất cứ nơi nào tôi đang ở. Còn khi nó thật sự viết code, thứ code đó không phải ở đâu cũng được chào đón, và đó là một câu chuyện riêng trong <a href="https://jared.lynskey.co.nz/vi/posts/2026/2026-10-18-pyhtml2text/" >bài về pyhtml2text</a>.</p>
]]></content:encoded>
      <media:content url="https://jared.lynskey.co.nz/en/posts/2026/2026-10-22-claude-code-day-to-day/featured.jpg" medium="image" type="image/jpeg" />
    </item>
  </channel>
</rss>
