<?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 · 인재덕</title>
    <link>https://jared.lynskey.co.nz/ko/tags/developer-tools/</link>
    <description>소프트웨어 엔지니어링과 개발 조직 리더십에 대한 이야기. 성과 리뷰, 채용과 팀 확장, CI/CD, 데브옵스 모니터링, 에이전틱 AI. 서울에서 씁니다.</description>
    <generator>Hugo</generator>
    <language>ko</language>
    <copyright>© 2026 인재덕</copyright>
    <lastBuildDate>Thu, 19 Nov 2026 00:00:00 +1300</lastBuildDate>
    <atom:link href="https://jared.lynskey.co.nz/ko/tags/developer-tools/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>Claude Code worktree 사용법: 병렬 에이전트를 충돌 없이 돌리기</title>
      <link>https://jared.lynskey.co.nz/ko/posts/2026/claude-code-git-worktrees/</link>
      <guid isPermaLink="true">https://jared.lynskey.co.nz/ko/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>Claude Code worktree 사용법. claude -w 동작, .worktreeinclude로 .env 가져오기, node_modules 처리, base ref와 정리, tmux에서 여러 에이전트를 병렬로 돌리는 방법까지.</description>
      <content:encoded><![CDATA[<p>Claude Code를 git worktree에서 실행하려면 <code>claude -w &lt;이름&gt;</code>(긴 형태는 <code>--worktree</code>)으로 시작하면 됩니다. Claude Code는 저장소 루트에 <code>.claude/worktrees/&lt;이름&gt;/</code>을 만들고, 원격의 기본 브랜치에서 딴 <code>worktree-&lt;이름&gt;</code>이라는 새 브랜치를 거기에 체크아웃합니다. 그때부터 그 세션은 이 폴더 안의 파일만 수정할 수 있습니다. 다른 터미널에서 이름만 바꿔 같은 명령을 실행하면, 서로의 파일을 건드릴 수 없는 에이전트 두 개가 나란히 돌아갑니다. 함정은 worktree가 완전히 새 체크아웃이라는 점입니다. <code>.env</code>, <code>node_modules</code>, 그 밖에 git이 무시하는 파일은 직접 복사하거나 설치하기 전까지 없습니다. 제가 worktree에서 겪은 문제는 거의 전부 여기서 나왔습니다.</p>
<p>저는 평소에 에이전트를 여러 개 병렬로 돌리는데, worktree는 꽤 아프게 배운 끝에 쓰게 됐습니다. 이 글에서는 <code>claude -w</code>가 어떻게 동작하는지(2.1.328 버전에서 확인), <code>.worktreeinclude</code>는 무엇을 위한 것인지, <code>node_modules</code>는 어떻게 할지, tmux에서 세션을 어떻게 배치하는지, 그리고 지금도 그냥 <code>git worktree add</code>를 쓰는 때는 언제인지 정리합니다.</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="이 글을 내레이션으로 소개하는 짧은 영상">
    <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="한국어" default>
    <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">
    <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="이 글을 내레이션으로 소개하는 짧은 영상">
    <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="한국어" default>
    <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">
    <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>이 글을 8분짜리 영상으로 만들었습니다. 내레이션은 영어이고 한국어 자막이 나옵니다. 일부 영상 소스는 Coverr 제공입니다.</figcaption>
</figure>


<h2 class="relative group">체크아웃 하나로는 병렬 에이전트가 안 되는 이유
    <div id="체크아웃-하나로는-병렬-에이전트가-안-되는-이유" 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="#%ec%b2%b4%ed%81%ac%ec%95%84%ec%9b%83-%ed%95%98%eb%82%98%eb%a1%9c%eb%8a%94-%eb%b3%91%eb%a0%ac-%ec%97%90%ec%9d%b4%ec%a0%84%ed%8a%b8%ea%b0%80-%ec%95%88-%eb%90%98%eb%8a%94-%ec%9d%b4%ec%9c%a0" aria-label="앵커">#</a>
    </span>
    
</h2>
<p>9월의 어느 날, 제가 만드는 마켓플레이스 앱의 같은 체크아웃에서 Claude Code 세션 다섯 개가 동시에 작업하고 있었고, 두 가지 일이 터졌습니다. 테스트 설정 파일을 고친 한 줄짜리 수정이 빌드 실패 네 번을 버텨 냈는데, 막상 커밋하려고 보니 사라져 있었습니다. <code>git commit</code>은 작업 트리가 깨끗하다고 했고, 파일에는 다른 세션이 쓴 내용이 들어 있었죠. 이런 식으로 사라진 수정은 git 어디에도 기록이 남지 않습니다. reflog에도 stash에도 없고, 수정 시각도 평범합니다. 같은 날, 작업 트리를 그대로 빌드하는 배포 스크립트가 다른 세션의 덜 끝난 작업을 프로덕션에 내보낼 뻔했습니다.</p>
<p>10월에는 세 번째 일이 생겼습니다. 한 세션이 다른 세션의 스테이징되지 않은 변경 옆에서 자기 파일을 커밋했는데, pre-commit 훅이 훅이 도는 동안 스테이징되지 않은 변경을 <em>전부</em> stash했습니다. 다른 세션이 고친 내용은 그동안 디스크에서 사라졌고, 타입 체커는 그 세션의 새 파일에서 실패했고, 커밋은 중단됐습니다. 게다가 모든 세션이 제 이름으로 커밋하니 <code>git log</code>로는 누가 무엇을 했는지 알 수 없습니다.</p>
<p>worktree를 쓰는 이유는 한 줄로 말할 수 있습니다. 쓰는 쪽이 여럿인 작업 트리는 경쟁 상태이고, 진 쪽은 진 줄도 모릅니다. 에이전트마다 작업 트리를 따로 주면 경쟁 자체가 사라집니다.</p>
<figure class="diagram">
  <div role="img" aria-label="다이어그램: 커밋, 브랜치, 설정, worktree마다 있는 작은 전용 폴더를 담은 공유 .git 디렉터리가 세 작업 디렉터리와 연결되어 있다. main 브랜치의 메인 체크아웃(.env와 node_modules 있음), git worktree add로 만든 fix-login 브랜치 체크아웃(둘 다 없음), claude -w로 만든 worktree-add-search 브랜치 체크아웃(.worktreeinclude가 .env를 복사, 세션이 도는 동안 잠김)"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 700 854" aria-hidden="true" focusable="false">
<path class="d-group" d="M30,239 V707 M30,407.5 H62 M30,550.5 H62 M30,707 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">모든 worktree가 공유</text>
<rect class="d-panel" x="2" y="75" width="696" height="164" 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">커밋과 객체</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">브랜치와 태그(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">설정, 원격, 훅</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/: worktree마다 작은 전용 폴더(각자의 HEAD와 index)</text>
<text class="d-title" x="62" y="299" font-size="26">작업 디렉터리 세 개</text>
<text class="d-sub" x="62" y="326" font-size="18">파일, HEAD, index는 각자 따로</text>
<rect class="d-box" x="62" y="344" width="636" height="127" rx="14"></rect>
<text class="d-label d-mono" x="82" y="381.2" font-size="20">~/code/myapp</text>
<rect class="d-panel" x="82" y="396" width="60.1" height="28" rx="14"></rect>
<text class="d-label d-mono" x="94" y="415.4" font-size="15">main</text>
<text class="d-sub" x="154.1" y="416.1" font-size="17">메인 체크아웃</text>
<path class="d-badge" style="fill:none;stroke-width:2.6" d="M83,446 l4.5,4.5 l9.5,-10"></path>
<text class="d-label" x="107" y="451.6" font-size="17">.env 있음</text>
<path class="d-badge" style="fill:none;stroke-width:2.6" d="M201.2,446 l4.5,4.5 l9.5,-10"></path>
<text class="d-label" x="225.2" y="451.6" font-size="17">node_modules 45 MB</text>
<rect class="d-box" x="62" y="487" width="636" height="127" rx="14"></rect>
<text class="d-label d-mono" x="82" y="524.2" font-size="20">~/code/myapp-fix-login</text>
<rect class="d-panel" x="82" y="539" width="105.3" height="28" rx="14"></rect>
<text class="d-label d-mono" x="94" y="558.4" font-size="15">fix-login</text>
<text class="d-sub" x="199.3" y="559.1" font-size="17">git worktree add로 생성</text>
<path class="d-line" style="fill:none;stroke-width:2.2" d="M85,583.5 l10,10 M95,583.5 l-10,10"></path>
<text class="d-sub" x="107" y="594.6" font-size="17">.env 없음</text>
<path class="d-line" style="fill:none;stroke-width:2.2" d="M202.4,583.5 l10,10 M212.4,583.5 l-10,10"></path>
<text class="d-sub" x="224.4" y="594.6" font-size="17">node_modules 없음(npm install 전까지 84 KB)</text>
<rect class="d-box" x="62" y="630" width="636" height="154" rx="14"></rect>
<text class="d-label d-mono" x="82" y="667.2" font-size="20">~/code/myapp/.claude/worktrees/add-search</text>
<rect class="d-panel" x="82" y="682" width="195.6" height="28" rx="14"></rect>
<text class="d-label d-mono" x="94" y="701.4" font-size="15">worktree-add-search</text>
<text class="d-sub" x="289.6" y="702.1" font-size="17">claude -w add-search로 생성</text>
<path class="d-badge" style="fill:none;stroke-width:2.6" d="M83,732 l4.5,4.5 l9.5,-10"></path>
<text class="d-label" x="107" y="737.6" font-size="17">.env(.worktreeinclude가 복사)</text>
<path class="d-line" style="fill:none;stroke-width:2.2" d="M369.6,726.5 l10,10 M379.6,726.5 l-10,10"></path>
<text class="d-sub" x="391.6" y="737.6" font-size="17">node_modules 없음</text>
<rect class="d-line" style="fill:none;stroke-width:2" x="84" y="757.5" width="12" height="9" rx="2"></rect>
<path class="d-line" style="fill:none;stroke-width:2" d="M86.5,757.5 v-2.5 a3.5,3.5 0 0 1 7,0 v2.5"></path>
<text class="d-sub" x="107" y="764.6" font-size="17">세션이 도는 동안 잠김</text>
<text class="d-sub" x="2" y="822" font-size="16">Claude Code는 같은 저장소의 worktree끼리 두 가지를 더 공유합니다. 'don't ask again' 승인(메인</text>
<text class="d-sub" x="2" y="846" font-size="16">체크아웃의 .claude/settings.local.json에 저장)과 프로젝트 범위 플러그인입니다.</text>
</svg>
</div><figcaption>저장소 하나, 작업 디렉터리 셋. 히스토리는 한 곳에 저장되고, 파일과 HEAD와 index는 worktree마다 따로 가집니다.</figcaption>
</figure>


<h2 class="relative group">claude -w 사용법과 동작
    <div id="claude--w-사용법과-동작" 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--w-%ec%82%ac%ec%9a%a9%eb%b2%95%ea%b3%bc-%eb%8f%99%ec%9e%91" aria-label="앵커">#</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="터미널: cat .worktreeinclude가 .env를 보여 주고, claude -w add-search는 worktree-add-search 브랜치에 있다고 답한다. git worktree list에서 새 worktree가 locked로 표시되고, ls를 보면 .env는 복사됐지만 node_modules는 없다. git worktree remove는 이미 끝난 claude 세션의 잠금 때문에 삭제를 거부하고, unlock한 뒤 remove하면 성공한다">
    <source src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/claude-worktree.mp4" type="video/mp4">
  </video><figcaption>버리는 저장소에서 실제로 실행한 모습. 세션이 끝난 뒤에도 잠금이 남아 있는 점을 보세요.</figcaption>
</figure>

<p><a href="https://code.claude.com/docs/en/worktrees"  target="_blank" rel="noreferrer">공식 문서의 worktrees 페이지</a>에 나온 내용과, 제가 직접 돌려 보고 확인한 내용입니다.</p>
<ul>
<li><strong>위치와 브랜치.</strong> <code>claude -w add-search</code>는 <code>.claude/worktrees/add-search/</code>를 <code>worktree-add-search</code>라는 새 브랜치로 만듭니다. 이름을 빼면 <code>bright-running-fox</code> 같은 이름이 자동으로 붙습니다. <code>.claude/worktrees/</code>는 <code>.gitignore</code>에 넣어 두세요. 안 그러면 메인 체크아웃에서 전부 추적되지 않는 파일로 보입니다.</li>
<li><strong>어디서 따는지(base ref).</strong> <code>worktree.baseRef</code>의 기본값은 <code>&quot;fresh&quot;</code>로, 원격의 기본 브랜치(보통 <code>origin/main</code>)에서 땁니다. 최근 24시간 동안 fetch한 적이 없으면 최대 5초 동안 fetch해 줍니다. <code>&quot;head&quot;</code>로 바꾸면 지금 로컬 <code>HEAD</code>에서 따기 때문에 아직 push하지 않은 커밋까지 따라옵니다. 브랜치 이름은 지정할 수 없으니, 특정 브랜치에서 만들고 싶다면 <code>git worktree add</code>를 직접 쓰면 됩니다.</li>
<li><strong>풀 리퀘스트.</strong> <code>claude --worktree &quot;#1234&quot;</code>는 그 PR의 head를 fetch해서 <code>.claude/worktrees/pr-1234</code>를 만듭니다. 따옴표를 빼먹으면 셸이 <code>#</code> 뒤를 주석으로 처리합니다.</li>
<li><strong>신뢰 확인.</strong> Claude를 한 번도 연 적 없는 폴더에서 대화형 <code>claude -w</code>를 처음 실행하면 &ldquo;Workspace trust not yet accepted&quot;라며 실패합니다. 그 폴더에서 그냥 <code>claude</code>를 한 번 실행해 신뢰 대화상자를 수락하면 됩니다. <code>claude -p -w</code>는 이 확인을 건너뜁니다.</li>
<li><strong>울타리.</strong> 세션이 worktree 안에 있는 동안 Claude Code는 메인 체크아웃의 파일 수정, 메인 체크아웃을 작업 디렉터리로 하는 명령, <code>git -C</code>나 <code>--git-dir</code>, <code>GIT_DIR</code>로 메인 쪽을 가리키는 git 명령을 거부합니다. 무엇을 못 막는지도 문서에 분명히 적혀 있습니다. 메인 체크아웃에 쓰는 <code>cp</code>나 셸 리다이렉트는 이 검사로 막히지 않습니다.</li>
</ul>
<p>worktree가 메인 체크아웃과 무엇을 공유하는지도, 무엇을 공유하지 않는지만큼 중요합니다. 모든 worktree가 같은 <code>.git</code>에 쓰기 때문에, 어느 한 곳에서 만든 커밋과 브랜치는 모든 곳에서 보입니다. 프로젝트 범위 플러그인은 어디서나 로드됩니다. 그리고 worktree 안에서 &ldquo;Yes, and don&rsquo;t ask again&quot;으로 답한 승인은 <em>메인</em> 체크아웃의 <code>.claude/settings.local.json</code>에 저장됩니다. 그래서 그 승인은 모든 worktree에 적용되고, 승인한 worktree를 지운 뒤에도 남습니다. 편하긴 한데, 승인하는 명령에 비밀 정보를 넣지 말아야 할 이유가 하나 더 생긴 셈이죠.</p>

<h2 class="relative group">정리, 그리고 남아 있는 잠금
    <div id="정리-그리고-남아-있는-잠금" 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="#%ec%a0%95%eb%a6%ac-%ea%b7%b8%eb%a6%ac%ea%b3%a0-%eb%82%a8%ec%95%84-%ec%9e%88%eb%8a%94-%ec%9e%a0%ea%b8%88" aria-label="앵커">#</a>
    </span>
    
</h2>
<p>대화형 worktree 세션을 끝낼 때 Claude Code는 지우면 사라질 작업이 있는지 확인합니다. 이름 없는 세션의 worktree가 깨끗하면 브랜치까지 자동으로 지웁니다. 이름이 있는 세션은 먼저 물어봅니다. 작업이 남아 있으면 남길지 물어보고, 화면에 출력되는 <code>claude --worktree &lt;이름&gt; --resume</code>으로 나중에 돌아올 수 있습니다.</p>
<p>비대화형 실행은 사정이 다르고, 직접 돌려 보면서 걸린 건 이것 하나였습니다. <code>claude -p</code>에는 종료할 때 묻는 단계가 없으니 정리도 하지 않습니다. 게다가 Claude Code는 세션이 도는 동안 worktree에 <code>git worktree lock</code>을 걸어 두는데, <code>-p</code> 실행이 끝난 뒤에도 이미 없는 프로세스 ID를 단 채로 잠금이 남아 있습니다. 위 녹화에서도 <code>git worktree remove</code>가 &ldquo;cannot remove a locked working tree, lock reason: claude session add-search&quot;라며 거부하죠. 문서에도 정확히 이렇게 나와 있습니다. 나중에 다른 세션이 오래된 잠금을 정리할 때 풀리거나, 먼저 <code>git worktree unlock</code>을 실행하면 됩니다. 알고 나면 별일 아니지만, 처음 보면 조금 놀랍니다.</p>

<h2 class="relative group">.worktreeinclude: 새 체크아웃에 없는 파일
    <div id="worktreeinclude-새-체크아웃에-없는-파일" 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-%ec%83%88-%ec%b2%b4%ed%81%ac%ec%95%84%ec%9b%83%ec%97%90-%ec%97%86%eb%8a%94-%ed%8c%8c%ec%9d%bc" aria-label="앵커">#</a>
    </span>
    
</h2>
<p>worktree에는 추적되는 파일만 들어 있습니다. git이 무시하는 파일도 가져가고 싶다면 저장소 루트에 <code>.worktreeinclude</code>를 두세요. 문법은 <code>.gitignore</code>와 같고, Claude Code는 패턴에 맞으면서 <em>동시에</em> git이 무시하는 파일만 복사합니다. 그래서 추적되는 파일이 중복될 일은 없습니다.</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>이 파일은 Claude Code가 git으로 만드는 모든 worktree에 적용됩니다. <code>claude -w</code>, 서브에이전트 worktree, 데스크톱 앱의 병렬 세션이 다 해당됩니다. <code>git worktree add</code>로 직접 만든 worktree에는 적용되지 않고, <code>WorktreeCreate</code> 훅으로 생성 과정을 바꾸면 아예 처리되지 않습니다.</p>
<p><code>.env</code>만 넣지 말고 더 넣으라고 권하고 싶습니다. 잊어버리기 쉬운 gitignore 대상 파일일수록 요란하게 실패하지 않거든요. 제 앱은 다른 세션의 커밋 안 된 수정이 절대 배포되지 않도록, 배포 스크립트가 깨끗한 worktree에서 빌드하게 바꿨습니다. 그런데 그 깨끗한 작업 트리에는 한 기능이 쓰는 gitignore 대상 서명 인증서가 없었습니다. 이미지는 그대로 빌드됐고, 그 기능은 프로덕션에서 13일 동안 실패했습니다. 스크립트가 인증서를 복사해 넣고 하나라도 없으면 경고하도록 고친 뒤에야 멈췄죠. worktree에서 한 또 다른 배포에서는 gitignore 대상 테마 폴더가 없었는데, 2분짜리 익스포트가 작업 트리를 더럽힌 <em>뒤에야</em> 빌드가 실패했습니다. 배포와 관련된 일을 worktree에 맡기기 전에 메인 체크아웃에서 <code>git status --short --ignored</code>를 실행해 보고, 그중 무엇을 빌드가 읽는지 확인해 두세요.</p>

<h2 class="relative group">node_modules: 가장 비싼 부분
    <div id="node_modules-가장-비싼-부분" 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-%ea%b0%80%ec%9e%a5-%eb%b9%84%ec%8b%bc-%eb%b6%80%eb%b6%84" aria-label="앵커">#</a>
    </span>
    
</h2>
<p><code>.worktreeinclude</code>는 작은 파일용입니다. <code>node_modules</code>에는 도움이 안 되고, Claude Code에도 worktree끼리 이걸 공유하는 기능은 없습니다. 코드를 실행해야 하는 worktree라면 각자 <code>node_modules</code>가 필요합니다.</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="터미널: git worktree add로 새 브랜치의 myapp-fix-login과 origin/main에 detached된 myapp-hotfix를 만든다. git worktree list에 세 개가 보이고, 새 worktree에는 .env도 node_modules도 없다. du로 보면 메인 체크아웃은 45M, worktree는 84K이고, npm install 뒤에는 둘 다 45M">
    <source src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktree-basics.mp4" type="video/mp4">
  </video><figcaption>데모 저장소에서 그냥 git worktree를 쓴 모습. 설치 전에는 84 KB, 설치하면 다시 45 MB 전부.</figcaption>
</figure>

<p>실제 프로젝트에서는 숫자가 커집니다. 제 모바일 앱 저장소에는 메인 체크아웃 옆에 worktree가 19개 있습니다. 그중 12개를 재 보니 194 MB에서 12 GB까지였고, 가장 큰 네 개가 바로 자기 <code>node_modules</code>를 가진 네 개였습니다. 이번 주에는 노트북 디스크가 96% 차 있어서, 정리한다면 여기부터입니다.</p>
<p>방법을 간단한 것부터 순서대로 보면 이렇습니다.</p>
<ol>
<li><strong>worktree마다 설치한다.</strong> 처음에 에이전트에게 <code>npm install</code>을 시키거나 직접 합니다. 느리고 디스크도 먹지만, 놀랄 일은 없습니다.</li>
<li><strong>lockfile이 같은 체크아웃에서 복제한다.</strong> macOS에서는 <code>cp -c -R ../myapp/node_modules .</code>가 APFS 클론을 씁니다. 클론은 어느 한쪽이 바뀌기 전까지 데이터 블록을 공유합니다. 데모의 45 MB는 0.8초 걸렸습니다. 저는 worktree에서 실제로 배포할 때도 이 방법을 썼습니다. 다만 lockfile이 같을 때만 복제하고, 네이티브 빌드 폴더는 조심하세요. 제 경우 메인 체크아웃의 iOS Pods가 worktree 브랜치보다 오래된 SDK용으로 빌드돼 있어서, 그건 새로 설치해야 했습니다.</li>
<li><strong>pnpm을 쓴다.</strong> 패키지는 스토어 한 곳에 모이고, macOS의 pnpm은 <a href="https://pnpm.io/settings/node-modules#packageimportmethod"  target="_blank" rel="noreferrer">하드 링크보다 클론을 먼저 시도합니다</a>(리눅스와 윈도우에서는 하드 링크가 먼저). 데모에서 두 번째 worktree 설치는 5초쯤 걸렸습니다.</li>
<li><strong><code>WorktreeCreate</code> 훅에서 설치한다.</strong> 이 훅은 Claude Code의 기본 git 로직을 대신하므로, <code>git worktree add</code> 다음에 설치까지 돌릴 수 있습니다. 이건 아직 안 해 봤습니다. 해 본다면 <code>.worktreeinclude</code>가 더 이상 처리되지 않으니 <code>.env</code> 복사도 훅에서 해야 한다는 걸 기억하세요.</li>
</ol>

<h2 class="relative group">tmux에서 병렬 에이전트 돌리기
    <div id="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="#tmux%ec%97%90%ec%84%9c-%eb%b3%91%eb%a0%ac-%ec%97%90%ec%9d%b4%ec%a0%84%ed%8a%b8-%eb%8f%8c%eb%a6%ac%ea%b8%b0" aria-label="앵커">#</a>
    </span>
    
</h2>
<p>저는 원래 tmux 안에서 사는 사람이라(<a href="https://jared.lynskey.co.nz/ko/posts/2026/2026-10-22-claude-code-day-to-day/" >매일 쓰는 방식을 정리한 글</a>에 레이아웃이 있습니다), worktree가 그대로 들어맞습니다. worktree 하나에 창이나 패널 하나씩. 아래는 같은 파일을 바꾸라고 지시한 에이전트 세 개를 동시에 띄운 모습입니다.</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: claude -w add-bye, add-greet, add-tests가 동시에 돌고, 도는 동안 패널 제목이 worktree 이름으로 바뀐다. 두 개는 src/index.js 수정을, 하나는 새 테스트 폴더를 보고하고, 마지막에 위쪽 패널에서 메인 체크아웃이 깨끗하고 잠긴 worktree가 세 개 있는 것을 확인한다">
    <source src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/parallel-agents-tmux.mp4" type="video/mp4">
  </video><figcaption>에이전트 셋, 파일 하나, 충돌 없음. 메인 체크아웃은 깨끗하게 남고, 각 변경은 자기 브랜치에서 기다립니다.</figcaption>
</figure>

<p>두 에이전트가 동시에 <code>src/index.js</code>를 고쳤는데 둘 다 상대를 몰랐습니다. 각자의 <code>src/index.js</code>는 디스크에서 서로 다른 파일이기 때문이죠. 메인 체크아웃도 깨끗했습니다. 끝에 남는 건 리뷰하고 머지할 브랜치 세 개이고, 이건 worktree가 대신해 주지 못하는 일입니다. 두 에이전트가 같은 줄을 바꾸면 여전히 머지 충돌이 납니다. 다만 소리 없이 덮어써지는 대신, 눈에 보이는 머지 단계에서 나타납니다.</p>
<p>VS Code에서 worktree는 그냥 폴더입니다. <code>code .claude/worktrees/add-search</code>로 열면 자기 브랜치를 가진 별도 창이 됩니다.</p>

<h2 class="relative group">worktree는 스냅숏이다
    <div id="worktree는-스냅숏이다" 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%eb%8a%94-%ec%8a%a4%eb%83%85%ec%88%8f%ec%9d%b4%eb%8b%a4" aria-label="앵커">#</a>
    </span>
    
</h2>
<p>worktree도 낡습니다. 11월 19일, 2~3일 전부터 준비돼 있던 worktree에서 OTA 업데이트가 나갔는데, 그 사이 다른 곳에서 나간 수정 두 개를 조용히 되돌려 버렸습니다. 그날 바로 잡아서 교체했지만, worktree가 완벽하게 격리돼 있었던 게 바로 문제였습니다. 그 수정을 한 번도 본 적이 없었으니까요. git 명령 한 줄이면 릴리스 전에 잡을 수 있었습니다.</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="터미널: main에는 새 커밋 &#39;Fix sign-in token handling&#39;이 있고, 오래된 worktree는 첫 커밋에 머물러 있다. git merge-base --is-ancestor main HEAD는 &#39;missing the fix: rebase before you ship&#39;을 출력하고, git rebase main 뒤에 같은 검사는 &#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>막 만든 게 아닌 worktree에서 배포하기 전에 돌려야 할 검사입니다.</figcaption>
</figure>

<p><code>baseRef: &quot;fresh&quot;</code>는 새 worktree를 최신으로 유지해 줍니다. 오래된 worktree를 최신으로 유지해 주는 건 없으니, 거기서 릴리스하기 전에 확인하세요.</p>

<h2 class="relative group">서브에이전트와 훅
    <div id="서브에이전트와-훅" 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="#%ec%84%9c%eb%b8%8c%ec%97%90%ec%9d%b4%ec%a0%84%ed%8a%b8%ec%99%80-%ed%9b%85" aria-label="앵커">#</a>
    </span>
    
</h2>
<p>이런 격리를 얻으려고 에이전트마다 터미널을 열 필요는 없습니다. 프런트매터에 <code>isolation: worktree</code>를 넣은 커스텀 서브에이전트는 항상 전용 임시 worktree에서 돕니다.</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><a href="https://code.claude.com/docs/en/worktrees#isolate-subagents-with-worktrees"  target="_blank" rel="noreferrer">문서</a>에 나온 예시 그대로입니다. 서브에이전트가 변경 없이 끝나면 worktree는 지워집니다. 변경이 있는 worktree는 작업을 잃지 않고 지울 수 있을 때까지 주기적 정리에서 살아남습니다. 미묘한 점 하나. <code>.claude/worktrees/</code> 아래 worktree에서 도는 서브에이전트는 지시를 메인 대화에서 이어받고, worktree 루트의 <code>CLAUDE.md</code>는 읽지 않습니다.</p>
<p><code>WorktreeCreate</code>와 <code>WorktreeRemove</code> 훅은 git 로직을 통째로 대신합니다. git이 아닌 버전 관리 시스템을 쓰거나 worktree를 <code>.claude/worktrees/</code> 말고 다른 곳에 두고 싶을 때를 위한 것이지만, 위에서 말한 설치 같은 준비 단계를 넣는 자리이기도 합니다.</p>

<h2 class="relative group">그냥 git worktree add가 더 나은 경우
    <div id="그냥-git-worktree-add가-더-나은-경우" 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="#%ea%b7%b8%eb%83%a5-git-worktree-add%ea%b0%80-%eb%8d%94-%eb%82%98%ec%9d%80-%ea%b2%bd%ec%9a%b0" aria-label="앵커">#</a>
    </span>
    
</h2>
<p>고백하자면 제 앱 저장소의 <code>.claude/worktrees</code> 폴더는 비어 있습니다. worktree 19개는 전부 그냥 <code>git worktree add</code>로 만들었고, 전부 지난 한 달 사이에 생겼고, 절반은 detached HEAD 상태입니다. 노트북의 다른 저장소에도 40, 40, 18, 10, 3, 2, 2개가 더 있습니다. 게다가 대부분은 제가 만든 게 아닙니다. 이 노트북에 있는 Claude Code 대화 기록 638개 중 85개에서 에이전트가 <code>git worktree add</code>를 실행했고, 횟수로는 모두 336번입니다.</p>
<p>그냥 git이 더 나은 건 이럴 때입니다.</p>
<ul>
<li><strong>이미 있는 특정 브랜치가 필요할 때.</strong> 예를 들어 핫픽스용으로 남겨 둔 릴리스 브랜치. <code>baseRef</code>로는 안 됩니다.</li>
<li><strong>수정 하나만 내보내고 싶을 때.</strong> 다른 세션들이 아직 배포하지 않은 작업을 <code>main</code>에 커밋해 둔 상태여서, 프로덕션에서 돌고 있는 커밋에 detached worktree를 만들고 제 수정만 cherry-pick해서 거기서 배포했습니다. 이렇게 하면 나가는 건 그 수정 하나뿐입니다.</li>
<li><strong>에이전트에게 직접 지시를 쓸 때.</strong> 한 저장소에서 에이전트 여러 개를 돌릴 때, 저는 각자에게 주는 지시에 <code>git worktree add --detach &quot;$TMPDIR/&lt;task&gt;-wt&quot; refs/remotes/origin/main</code>으로 자기 worktree를 만들고, <code>git push origin HEAD:main</code>으로 push하고, 충돌하면 rebase하라고 적습니다.</li>
<li><strong>지워지면 안 될 때.</strong> Claude Code의 정리는 <code>git worktree add</code>로 직접 만든 worktree를 절대 지우지 않습니다.</li>
</ul>
<p><code>claude -w</code>가 나은 건 손으로 세션을 시작하면서 브랜치 생성, <code>.env</code> 복사, 메인 체크아웃을 둘러싼 울타리, 정리를 맡기고 싶을 때입니다. 둘을 섞어 써도 괜찮습니다. 어느 쪽으로 만들든 Claude Code는 똑같이 worktree로 다루고, 위에서 말한 메인 체크아웃과의 공유도 똑같습니다.</p>

<h2 class="relative group">요약
    <div id="요약" 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="#%ec%9a%94%ec%95%bd" aria-label="앵커">#</a>
    </span>
    
</h2>
<p>병렬로 돌리는 세션마다 <code>claude -w &lt;이름&gt;</code>을 쓰고, <code>.claude/worktrees/</code>를 <code>.gitignore</code>에 넣으세요. <code>.worktreeinclude</code>에는 <code>.env</code>만이 아니라 빌드에 필요한 gitignore 대상 파일을 전부 적어 두세요. <code>node_modules</code>는 worktree마다 설치할지, 복제할지, pnpm을 쓸지 정해 두세요. <code>-p</code>로 돌린 뒤에는 <code>git worktree unlock</code>이 필요한 잠금이 남아 있을 수 있습니다. 막 만든 게 아닌 worktree에서 배포하기 전에는, 이미 프로덕션에 나간 내용이 들어 있는지 확인하세요. worktree는 에이전트끼리 파일을 덮어쓰는 건 막아 주지만, 서로 생각이 다른 것까지 막아 주지는 않습니다. 마지막에 브랜치 세 개를 리뷰하는 건 결국 사람입니다.</p>

<h2 class="relative group">더 읽을거리
    <div id="더-읽을거리" 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="#%eb%8d%94-%ec%9d%bd%ec%9d%84%ea%b1%b0%eb%a6%ac" aria-label="앵커">#</a>
    </span>
    
</h2>
<p><strong>이 블로그에서:</strong></p>
<ul>
<li><a href="https://jared.lynskey.co.nz/ko/posts/2026/2026-10-22-claude-code-day-to-day/" >제가 매일 Claude Code를 쓰는 방식</a>: tmux, 권한 모드, 폰에서 접속하는 방법</li>
</ul>
<p><strong>외부 자료:</strong></p>
<ul>
<li>Claude Code 문서의 <a href="https://code.claude.com/docs/en/worktrees"  target="_blank" rel="noreferrer">Run parallel sessions with worktrees</a>: 웬만한 문서보다 꼼꼼합니다</li>
<li><a href="https://git-scm.com/docs/git-worktree"  target="_blank" rel="noreferrer">git-worktree</a>: 무엇이 공유되고 무엇이 worktree마다 따로인지</li>
<li><a href="https://pnpm.io/settings/node-modules#packageimportmethod"  target="_blank" rel="noreferrer">pnpm의 <code>packageImportMethod</code></a>: 클론과 하드 링크</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>개발자를 위한 Mac 단축키 모음: 터미널, Vim, VS Code, Chrome 개발자 도구</title>
      <link>https://jared.lynskey.co.nz/ko/posts/2021/2021-12-19-commands/</link>
      <guid isPermaLink="true">https://jared.lynskey.co.nz/ko/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>개발하면서 Mac에서 실제로 쓰는 키보드 단축키를 각 앱의 공식 문서로 확인해 정리했습니다. macOS 윈도우와 Spaces, 터미널, Vim, VS Code, Chrome 개발자 도구(DevTools), Slack.</description>
      <content:encoded><![CDATA[<p>개발하면서 Mac에서 제가 실제로 자주 쓰는 키보드 단축키를 정리했습니다. macOS에서 윈도우와 Spaces 사이를 오가는 법, 터미널, Vim, VS Code, Chrome 개발자 도구(DevTools), Slack까지입니다. 대단한 건 없고 손에 익은 것들 위주입니다. 전부 기본 단축키이고 각 앱의 공식 문서로 확인했으니, 키를 따로 바꿔 두었다면 다를 수 있습니다. 그리고 Mac 키보드는 맨 윗줄이 밝기나 음량 키인 경우가 많아서, <code>F</code> 키를 쓰는 단축키는 <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="앵커">#</a>
    </span>
    
</h2>
<ul>
<li><code>ctrl</code> + <code>←</code> / <code>→</code> — Spaces(데스크탑) 간 이동</li>
<li><code>ctrl</code> + <code>↑</code> — Mission Control 열기</li>
<li><code>cmd</code> + <code>tab</code> — 앱 전환</li>
<li><code>cmd</code> + <code>`</code> — 지금 쓰는 앱의 윈도우 간 전환</li>
<li><code>ctrl</code> + <code>cmd</code> + <code>f</code> — 전체 화면 토글(지원하는 앱에서)</li>
<li><code>cmd</code> + <code>w</code> — 맨 앞 윈도우 닫기(<code>option</code> + <code>cmd</code> + <code>w</code>는 그 앱의 윈도우를 모두 닫기)</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="앵커">#</a>
    </span>
    
</h2>
<ul>
<li><code>vimtutor</code> — Vim 내장 튜토리얼. 셸에서 바로 실행하면 됩니다</li>
<li><code>v</code> — 비주얼 모드(글자 단위 선택)</li>
<li><code>V</code> — 비주얼 모드(줄 단위 선택)</li>
<li><code>ctrl</code> + <code>v</code> — 비주얼 블록 모드(사각형 영역 선택)</li>
<li><code>y</code> — 선택 영역 얀크(복사)</li>
</ul>

<h2 class="relative group">터미널
    <div id="터미널" 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="#%ed%84%b0%eb%af%b8%eb%84%90" aria-label="앵커">#</a>
    </span>
    
</h2>
<ul>
<li><code>sudo !!</code> — 마지막 명령을 sudo로 다시 실행(셸의 히스토리 확장 기능이라 zsh든 bash든, 어떤 터미널 앱에서든 됩니다)</li>
<li><code>cmd</code> + <code>t</code> — 새 탭</li>
<li><code>cmd</code> + <code>n</code> — 새 윈도우</li>
<li><code>cmd</code> + <code>w</code> — 탭 닫기(<code>shift</code> + <code>cmd</code> + <code>w</code>는 윈도우 닫기)</li>
<li><code>ctrl</code> + <code>tab</code> / <code>ctrl</code> + <code>shift</code> + <code>tab</code> — 다음 탭 / 이전 탭</li>
<li><code>cmd</code> + <code>d</code> — 윈도우를 두 개의 패널로 분할</li>
<li><code>shift</code> + <code>cmd</code> + <code>d</code> — 분할 패널 닫기</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="앵커">#</a>
    </span>
    
</h2>
<ul>
<li><code>cmd</code> + <code>p</code> — Quick Open. 파일 이름 일부만 쳐서 바로 열기</li>
<li><code>shift</code> + <code>cmd</code> + <code>p</code> — 명령 팔레트(<code>F1</code>도 됩니다)</li>
<li><code>cmd</code> + <code>d</code> — 선택한 문자열의 다음 항목을 선택에 추가. 멀티 커서로 한꺼번에 고칠 때 씁니다</li>
<li><code>option</code> + 클릭 — 클릭한 곳에 커서 추가(<code>option</code> + <code>cmd</code> + <code>↑</code> / <code>↓</code>는 위아래 줄에 추가)</li>
<li><code>option</code> + <code>↑</code> / <code>↓</code> — 현재 줄을 위아래로 이동</li>
<li><code>shift</code> + <code>option</code> + <code>↑</code> / <code>↓</code> — 현재 줄을 위아래로 복사</li>
<li><code>cmd</code> + <code>/</code> — 줄 주석 토글</li>
<li><code>F12</code> — 정의로 이동</li>
<li><code>ctrl</code> + <code>`</code> — 통합 터미널 열고 닫기</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-%ea%b0%9c%eb%b0%9c%ec%9e%90-%eb%8f%84%ea%b5%acdevtools" aria-label="앵커">#</a>
    </span>
    
</h2>
<ul>
<li><code>option</code> + <code>cmd</code> + <code>i</code> — 마지막으로 쓴 패널로 개발자 도구 열기</li>
<li><code>option</code> + <code>cmd</code> + <code>j</code> — Console 패널 열기</li>
<li><code>shift</code> + <code>cmd</code> + <code>c</code> — 요소 검사. 페이지에서 아무거나 클릭하면 Elements 패널의 해당 위치로 이동합니다</li>
<li><code>shift</code> + <code>cmd</code> + <code>p</code> — 개발자 도구가 열린 상태에서 명령 메뉴 열기(예를 들어 &ldquo;screenshot&quot;을 입력)</li>
<li><code>shift</code> + <code>cmd</code> + <code>r</code> — 강력 새로고침. 캐시를 쓰지 않고 페이지 파일을 다시 받아 옵니다</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="앵커">#</a>
    </span>
    
</h2>
<ul>
<li><code>cmd</code> + <code>k</code> — 대화로 이동. 채널이나 사람 이름 일부를 치고 Enter(최근 버전에서는 같은 창에서 검색도 됩니다)</li>
<li><code>F6</code> — 다음 섹션으로 포커스 이동(<code>shift</code> + <code>F6</code>은 이전 섹션)</li>
<li><code>cmd</code> + <code>/</code> — 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>
