<?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 · 인재덕</title>
    <link>https://jared.lynskey.co.nz/ko/tags/tmux/</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/tmux/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>제가 매일 Claude Code를 쓰는 방식: tmux, 권한 모드, 그리고 폰</title>
      <link>https://jared.lynskey.co.nz/ko/posts/2026/2026-10-22-claude-code-day-to-day/</link>
      <guid isPermaLink="true">https://jared.lynskey.co.nz/ko/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는 Anthropic의 코딩 에이전트입니다. Claude 모델이 제 기계에서, 제 파일과 셸을 가지고 일하죠. 제 로그의 숫자와 함께 정리한 제 일상 사용법입니다. tmux 안의 터미널에서 세션 다섯 개, 권한 확인은 거의 건너뛰고, 폰에서는 Remote Control, SSH, 채팅 봇으로 닿습니다. 그리고 Codex와의 비교를 제가 말해 줄 수 없는 이유까지요.</description>
      <content:encoded><![CDATA[<p>Claude Code는 Anthropic의 코딩 에이전트입니다. Claude 앱과 같은 Claude 모델로 돌지만 내 기계에서 돌기 때문에, 파일을 읽고 셸 명령을 실행하고 코드를 고칠 수 있습니다. Claude 유료 플랜에 딸려 나오고요. 저는 VS Code 확장이나 데스크톱 앱이 아니라 터미널에서 씁니다. 노트북의 tmux 세션 하나 안에 세션 다섯 개를 띄워 두고, 거의 전부 권한 확인을 끈 채로 시작하며, 폰에서는 Claude 앱의 Remote Control, SSH, 또는 채팅 봇으로 닿습니다.</p>
<p>아래는 그 셋업을 기억이 아니라 제 기계에서 나온 숫자로 자세히 적은 것입니다. 설정 파일들, Claude Code가 <code>~/.claude/projects</code> 아래에 남기는 세션 기록(제 것은 8월 28일부터 있습니다), 그리고 2월부터 쌓여 프롬프트 7,323개가 들어 있는 프롬프트 기록이 출처입니다.</p>

<h2 class="relative group">Claude와 Claude Code는 다른 물건입니다
    <div id="claude와-claude-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="#claude%ec%99%80-claude-code%eb%8a%94-%eb%8b%a4%eb%a5%b8-%eb%ac%bc%ea%b1%b4%ec%9e%85%eb%8b%88%eb%8b%a4" aria-label="앵커">#</a>
    </span>
    
</h2>
<p>Claude는 모델 계열이자, 그 모델과 대화하는 채팅 앱입니다. claude.ai에도, 데스크톱에도, 폰에도 있죠. Claude Code는 그 모델 위에 만든 에이전트입니다. 프로젝트 폴더에서 시작하면 그 자리에서 루프를 돌며 파일을 읽고, 명령을 실행하고, 코드를 고치고, 테스트를 돌립니다. 일이 끝나거나 제가 필요해질 때까지요. Claude에게 뭔가 고치는 법을 물으면 답을 받습니다. Claude Code에게 물으면 고친 결과와, 읽어 볼 diff를 받습니다.</p>
<p>저는 둘 다 씁니다. 제가 만드는 마켓플레이스 겸 커뮤니티 앱은 10월 18일부터 Django 백엔드에서 번역을 Claude API로 바로 보내고 있는데, 그렇게 바꾼 변경도 Claude Code 세션에서 만들었습니다. 제 세션 기록에서 답변의 94%는 Opus 5.5가 했고, 설정의 effort 레벨은 high입니다.</p>
<p>네이티브 설치 프로그램은 한 줄이고, 알아서 최신 상태를 유지합니다.</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>설치하면 <code>~/.local/bin</code>에 <code>~/.local/share/claude/versions/</code> 안을 가리키는 <code>claude</code> 심볼릭 링크가 생깁니다. 제 것은 10월 21일에 혼자서 2.1.305에서 2.1.306으로 올라갔습니다. Claude Code를 쓰려면 Claude 유료 플랜(Pro, Max, Team, Enterprise)이나 API 계정이 필요합니다. 가격은 꽤 자주 바뀌니 <a href="https://claude.com/pricing"  target="_blank" rel="noreferrer">Anthropic 가격 페이지</a>에 맡기겠습니다.</p>

<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%84%b8%ec%85%98-%ed%95%98%eb%82%98-%ec%b0%bd-%ec%9d%bc%ea%b3%b1-%ea%b0%9c" aria-label="앵커">#</a>
    </span>
    
</h2>
<p>이 글을 쓰는 지금 <code>tmux list-panes -a</code>를 치면 노트북에 <code>main</code>이라는 세션 하나가 있고, 창이 일곱 개입니다. 그중 다섯 개가 Claude Code로, 프로젝트마다 하나씩입니다. 제 마켓플레이스 앱과 견적 앱(둘 다 <a href="https://jared.lynskey.co.nz/ko/posts/2026/2026-07-22-my-current-stack/" >Fly.io에서 Django 오토스케일링</a>에서 소개했습니다), 이 블로그, 그리고 자잘한 것 두 개요. 터미널 프로필은 모든 창을 <code>main</code>에 붙는 로그인 셸로 엽니다. 그래서 노트북에서 새 탭을 열든 폰에서 SSH로 로그인하든 같은 세션에 도착합니다.</p>
<p>9월 17일부터 10월 8일까지는 다른 멀티플렉서를 써 봤는데, 현실적인 이유로 tmux로 돌아왔습니다. 폰에서 쓰는 SSH 앱이 tmux로 멀티플렉싱하고, 단축 버튼도 tmux 기본 키를 보내거든요. <code>~/.tmux.conf</code>의 이런 줄들은 폰 때문에 있습니다.</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>tmux 안에서는 두 가지가 달라집니다. Claude Code는 실행 중인 명령을 Ctrl+B로 백그라운드에 보내는데, 이게 이제 제 두 번째 tmux prefix입니다. 그래서 <code>~/.claude/keybindings.json</code>에서 그걸 끄고 대신 Meta+B를 씁니다.</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>다른 하나는 줄바꿈입니다. Enter는 프롬프트를 보냅니다. 문서는 어느 터미널에서나 되는 방법으로 <code>\</code> 다음 Enter, 그리고 Ctrl+J 두 가지를 듭니다. Option+Enter는 터미널이 Option을 Meta로 보내도록 설정하면 되고, Shift+Enter는 일부 터미널에서는 그냥 되지만 tmux는 <code>extended-keys</code>가 켜져 있을 때만 그걸 넘겨줍니다. 제 건 꺼져 있어서, 제 세션에서는 Shift+Enter를 누르면 프롬프트가 보내져 버립니다. 사실 어느 것도 쓸 일이 별로 없습니다. 프롬프트 7,323개 중 제가 직접 친 줄바꿈이 들어간 건 84개이고, 붙여넣기가 들어간 건 279개입니다. 붙여넣은 내용은 Claude Code가 <code>[Pasted text #1 +34 lines]</code> 같은 자리표시자로 접어 두고, 보낼 때는 전부 보냅니다.</p>

<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="#%ed%84%b0%eb%af%b8%eb%84%90-vs-code-%ed%99%95%ec%9e%a5-%eb%8d%b0%ec%8a%a4%ed%81%ac%ed%86%b1-%ec%95%b1-%ec%a4%91-%eb%ac%b4%ec%97%87%ec%9d%84" aria-label="앵커">#</a>
    </span>
    
</h2>
<p>같은 에이전트가 몇 가지 포장으로 나오고, 모두 같은 설정 파일을 읽습니다. Claude Code가 세션 기록마다 남기는 진입점을 기준으로 보면 제 세션은 이렇게 나뉩니다.</p>
<table>
	<thead>
			<tr>
					<th>형태</th>
					<th>무엇인가</th>
					<th>제 사용량, 8월 28일~10월 21일</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>터미널의 CLI</td>
					<td>터미널에서, tmux 안에서 실행하는 <code>claude</code></td>
					<td>세션 128개</td>
			</tr>
			<tr>
					<td>데스크톱 앱의 Code 탭</td>
					<td>Claude 앱 안의 Claude Code, diff 뷰와 패널이 있음</td>
					<td>세션 2개</td>
			</tr>
			<tr>
					<td>VS Code 확장</td>
					<td>에디터 안의 채팅 패널</td>
					<td>없음. 지금은 설치돼 있지 않고 설정만 남아 있습니다</td>
			</tr>
	</tbody>
</table>
<p>Claude 앱과 claude.ai/code는 세션을 시작하는 네 번째 자리가 아닙니다. 노트북에서 이미 돌고 있는 세션(또는 클라우드의 세션)을 조종하는 것이고, 10월 이후 제 세션 대부분이 Remote Control로 그렇게 연결돼 있었습니다.</p>
<p>제 답은 터미널이고, 의리 때문은 아닙니다. 폰이 붙는 tmux가 터미널을 필요로 하고, 외부 이벤트를 세션으로 밀어 넣는 channels도 그렇습니다. 문서에 CLI 기능으로 나와 있거든요.</p>
<p>Claude Code에 git이 필요하냐는 질문도 받습니다. CLI는 필요 없습니다. 제 홈 디렉터리는 저장소가 아닌데, 제 프롬프트 중 208개가 거기서 시작한 세션으로 갔습니다. 데스크톱 앱 문서에는 세션마다 자기 worktree를 받는 세션 격리에 git이 필요하다고 나와 있고, 클라우드 세션을 터미널로 끌어오려면 같은 저장소의 체크아웃이 있어야 합니다. 저는 &ldquo;Git is required&rdquo; 메시지를 직접 본 적이 없습니다. 10월 20일에 쓴 마지막 데스크톱 세션은 아예 저장소가 아닌 폴더에서 돌았습니다.</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="#%ea%b6%8c%ed%95%9c-%eb%aa%a8%eb%93%9c-%ea%b7%b8%eb%a6%ac%ea%b3%a0-%ec%a0%9c%ea%b0%80-%ec%8b%a4%ec%a0%9c%eb%a1%9c-%ec%93%b0%eb%8a%94-%ea%b2%83" aria-label="앵커">#</a>
    </span>
    
</h2>
<p>권한 모드는 Claude Code가 얼마나 자주 멈춰서 물어볼지를 정하고, Shift+Tab으로 모드를 차례로 바꿉니다. Manual(<code>default</code>)은 파일을 고치거나 명령을 실행하거나 네트워크에 접근하는 대부분의 동작 전에 묻습니다. <code>acceptEdits</code>는 파일 수정과 흔한 파일시스템 명령은 통과시킵니다. <code>plan</code>은 읽고 제안만 할 뿐 고치지 않습니다. <code>auto</code>는 두 번째 모델, 즉 분류기가 위험한 동작을 사람에게 묻는 대신 막아 줍니다. <code>bypassPermissions</code>는 거의 아무것도 묻지 않습니다. 버전 2.1.283부터는 <code>permissions.defaultMode</code>로 따로 정해 두지 않으면 터미널 세션이 auto 모드로 시작합니다.</p>
<p>그래서 &ldquo;Claude Code를 권한 확인 없이 돌리려면 어떻게 하나요&quot;에 대한 제 솔직한 답은, 이렇게 시작한다는 겁니다.</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>셸 기록에 남은 <code>claude</code> 명령 69개 중 62개에 이 플래그가 붙어 있고, 지금 돌고 있는 세션 다섯 개도 전부 그렇습니다. 8월 28일부터 10월 21일까지 제가 입력한 프롬프트 1,266개 중 1,179개는 bypass 모드 세션으로, 82개는 auto 모드로, 5개는 Manual이나 accept-edits로 갔습니다.</p>
<p>문서는 bypass 모드가 &ldquo;인터넷 접근이 없는 컨테이너, VM, dev 컨테이너처럼 Claude Code가 호스트 시스템을 망가뜨릴 수 없는 격리된 환경&quot;을 위한 것이라고 분명히 말합니다. 제 노트북은 그 어디에도 해당하지 않고, 제 설정에는 그 경고를 클릭해서 넘겼다는 기록까지 남아 있습니다(<code>&quot;skipDangerousModePermissionPrompt&quot;: true</code>). 같은 길을 가신다면 이건 알아 두세요. bypass 모드에서는 allow 규칙이 아무 효과가 없습니다. 그래서 제 평소 세션에서는 설정 파일 19개에 흩어진 allow 규칙 378개가 하는 일이 전혀 없습니다. deny와 ask 규칙은 여전히 적용되는데, 저는 둘 다 하나도 없습니다.</p>
<p>예외는 다른 사람이 쓴 글을 읽는 세션입니다. 이 세션의 런처는 그 플래그를 넘기지 않아서 auto 모드로 시작합니다. 10월 12일부터 20일 사이에 세션에 도착한 프로덕션 이벤트 27개 전부와 채팅 메시지 43개 중 42개가 auto 모드에서 들어왔고, bypass 모드에서 들어온 건 하나도 없었습니다.</p>
<p>bypass 모드에 실제로 물리지 않게 해 주는 건 몇 가지 습관입니다. 9월의 어느 날 같은 체크아웃에서 돌던 세션 둘이 서로의 작업을 덮어쓰고 그걸 배포할 뻔한 뒤에 Claude 메모리에 적어 둔 것들이죠(자초지종은 <a href="https://jared.lynskey.co.nz/ko/posts/2026/2026-10-22-agentic-ai-security/#격리-가장-그럴듯한-위협은-다른-에이전트" >에이전틱 AI 보안 글</a>에 있습니다). 규칙은 이렇습니다. 작은 수정은 동작하는 순간 커밋한다. 파일은 이름으로 스테이징하고 <code>git add -A</code>는 절대 쓰지 않는다. <code>git status</code>에서 내가 만들지 않은 변경을 살핀다. <code>main</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="#%ed%8f%b0%ec%97%90%ec%84%9c-%eb%8b%bf%ea%b8%b0" aria-label="앵커">#</a>
    </span>
    
</h2>
<p>들어가는 길은 세 가지이고, 각각 닿는 곳이 다릅니다.</p>
<table>
	<thead>
			<tr>
					<th>들어가는 길</th>
					<th>폰에서 얻는 것</th>
					<th>무엇으로 돌아가는지</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>Claude 앱의 Remote Control</td>
					<td>세션 하나의 대화: 입력하고, 질문에 답하고, 사진을 첨부</td>
					<td><code>remoteControlAtStartup: true</code>, 그리고 푸시 알림</td>
			</tr>
			<tr>
					<td>폰의 SSH 앱으로 <code>main</code>에 SSH</td>
					<td>터미널 그 자체, 모든 창</td>
					<td>사설 네트워크, 제 사용자로 도는 sshd, 그리고 붙이는 데 쓰는 짧은 alias</td>
			</tr>
			<tr>
					<td>채팅 봇</td>
					<td>프로덕션 오류를 듣고 메시지에 답하는 세션</td>
					<td>Claude Code 공식 채널 플러그인과 제가 만든 이벤트 채널</td>
			</tr>
	</tbody>
</table>
<p>Remote Control은 폰의 Claude 앱이나 브라우저의 claude.ai/code를 노트북에서 계속 돌고 있는 세션에 연결합니다. 파일, 도구, MCP 서버까지 그대로요. 9월 13일부터 10월 20일 사이에 <code>/rc</code>를 26번 쳤습니다. 지금은 <code>remoteControlAtStartup</code>이 켜져 있어서 새 세션이 알아서 연결됩니다. 10월 초부터 제가 시작한 세션 77개 중 67개에 Remote Control 링크가 있었는데, 9월 후반에는 52개 중 3개였습니다.</p>
<p><code>agentPushNotifEnabled</code>를 켜 두면 Claude가 필요하다고 판단할 때 푸시 알림을 보낼 수 있습니다. 문서에 따르면 보통 긴 작업이 끝났거나 결정이 필요할 때입니다. API 키가 아니라 claude.ai 구독이 있어야 하고, 세션이 노트북에서 도니 노트북이 깨어 있어야 합니다. 10월 15일부터 제 노트북은 덮개를 닫아도 잠들지 않습니다(<code>sudo pmset -a disablesleep 1</code>).</p>
<p>반대 방향도 됩니다. <code>/teleport</code>나 <code>claude --teleport</code>는 웹이나 앱에서 시작한 클라우드 세션을 브랜치와 대화째 터미널로 끌어옵니다. 저는 두 번 해 봤고, 둘 다 7월이었습니다.</p>
<p>SSH는 터미널 그 자체가 필요할 때 씁니다. 폰은 <a href="https://jared.lynskey.co.nz/ko/posts/2026/2026-10-01-cloudflare-warp-dev-network/" >사설 네트워크 글</a>에서 다룬 사설 네트워크를 거쳐 노트북에 닿고, alias 하나가 <code>main</code>에 붙여 주니 노트북에 열어 둔 창들 사이를 스와이프로 오갈 수 있습니다. Mac이 폰 앱에 제대로 답하게 만드는 데는 서로 다른 수정이 네 번 들었는데, Claude Code와 관련해 중요한 건 tmux가 절대 저절로 시작돼서는 안 된다는 점입니다. <code>docker ps</code>를 돌리려고 세션을 연 앱이 결과 대신 72 KB짜리 화면 다시 그리기를 돌려받았거든요.</p>
<p>채팅 봇은 앉아서 지켜보고 싶지 않은 세션용입니다. 10월 12일부터 세션 하나가 제가 만든 작은 채널을 달고 돌고 있습니다. 이 채널은 1분에 한 번 앱 서버에서 새 프로덕션 오류와 프로젝트 보드 활동을 확인해 세션에 넘깁니다. 여기에 공식 채팅 플러그인 하나도 붙어 있어서, allowlist에 있는 저희 두 사람이 세션에 메시지를 보낼 수 있습니다. 실행 줄은 이름만 일반적으로 바꾸면 이렇습니다.</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>슈퍼바이저 스크립트가 tmux 안에서 이 세션을 계속 살려 둡니다. 재시작하면 같은 대화를 이어 가니, 세션이 백지 상태로 깨어나는 게 아니라 하던 일을 계속하고, 재시작할 때마다 채팅에 알립니다. 이 세션은 작업 트리에서 고치는 데까지만 하고 멈춥니다. 예외가 하나 있는데, 10월 13일에 추가했습니다. 프로덕션에서 실제로 사용자에게 피해를 주고 있는 버그라면 고치고, 테스트하고, 커밋하고, 배포한 다음 무엇을 했는지 저희에게 알려도 됩니다.</p>

<h2 class="relative group">스킬, 메모리, 그리고 /goal
    <div id="스킬-메모리-그리고-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="#%ec%8a%a4%ed%82%ac-%eb%a9%94%eb%aa%a8%eb%a6%ac-%ea%b7%b8%eb%a6%ac%ea%b3%a0-goal" aria-label="앵커">#</a>
    </span>
    
</h2>
<p>제 설정 파일 어디에도 <code>hooks</code> 키는 없습니다. 가장 가까운 건 <code>/goal</code>로, 7월 11일부터 수도 없이 썼습니다. 조건을 하나 받아서 그 세션에 Stop hook을 거는데, Claude Code의 표현을 빌리면 이 hook은 &ldquo;will block stopping until the condition holds&rdquo;(조건이 충족될 때까지 멈추지 못하게 막는다)입니다. 제 goal은 제가 소리 내어 말하는 그대로 적혀 있습니다. 7월에 실제로 쓴 것 하나는 오타까지 그대로 옮기면 빌드가 &ldquo;still broken, try a deeper fix and dont stop until&rdquo;(아직도 안 돼, 더 근본적으로 고치고 ~까지 멈추지 마) 테스터에게 나갈 때까지라고 했습니다. 긴 실행을 방해하지 않고 상황을 보고 싶을 땐 <code>/btw</code>가 있습니다. 대화에 섞이지 않는 곁가지 질문이죠. 제 건 대부분 &ldquo;hows it going?&quot;(잘 돼 가?)의 변주입니다.</p>
<p>스킬에는 그게 없었으면 매번 설명했을 것들이 들어 있습니다. 사용자 레벨 스킬 하나는 이 블로그를 포함해 제가 관리하는 사이트들의 주간 키워드 보고서를 읽고, 그 내용을 제목, 설명, 태그에 반영합니다. 이 글이 답하는 질문들도 이 스킬이 10월 18일자로 낸 이 블로그의 보고서에서 왔고, 스킬 파일은 저장소에서 코드와 함께 버전 관리됩니다. 마켓플레이스 앱 저장소에도 자체 스킬이 있습니다. 하나는 Docker에서 API를 띄우고 스모크 테스트를 돌리고, 하나는 프로젝트 보드를 다루고, 하나는 회사 경비를 처리합니다. 설치해 둔 플러그인 두 개는 Swift 언어 서버 플러그인과 그 채팅 플러그인입니다.</p>
<p>메모리는 교훈이 쌓이는 곳입니다. 프로젝트 17개에 걸쳐 메모리 파일이 160개 있고, 그중 83개가 마켓플레이스 앱 것이며, 상당수가 뭔가 고장 났던 이야기입니다. 앱의 <code>CLAUDE.md</code>는 이제 6월보다 여섯 배쯤 길어졌습니다. 이 블로그의 <code>CLAUDE.md</code>는 빈 파일입니다. 글이 어떤 목소리여야 하는지는 그 대신 메모리 파일에 들어 있습니다.</p>
<p>큰 일에는 Claude가 서브에이전트를 띄웁니다. 제 메인 세션에서 120번이었고, 그중 40번은 대화를 포크한 것이었습니다. 이 블로그의 일본어, 한국어, 중국어, 베트남어 버전도 그렇게 만들어집니다. 10월 19일과 20일에는 앱 커뮤니티 섹션의 리디자인이 Workflow 도구를 네 번 거쳤습니다. 일곱 가지 관점과 비평가 하나로 감사를 돌려 발견 사항 약 58개를 확정했고, 각자 자기 파일을 맡은 다섯 그룹이 수정한 뒤 그룹마다 리뷰를 받았고, 남은 것들을 한 번 더 훑었고, 마지막으로 모든 발견 사항이 고쳐졌는지 독립적으로 확인했습니다. 리디자인은 20일에 배포됐습니다.</p>

<h2 class="relative group">SSH로 워크스테이션 부리기
    <div id="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="#ssh%eb%a1%9c-%ec%9b%8c%ed%81%ac%ec%8a%a4%ed%85%8c%ec%9d%b4%ec%85%98-%eb%b6%80%eb%a6%ac%ea%b8%b0" aria-label="앵커">#</a>
    </span>
    
</h2>
<p><a href="https://jared.lynskey.co.nz/ko/posts/2026/2026-10-01-cloudflare-warp-dev-network/" >사설 네트워크 글</a>은 무거운 일을 GPU가 달린 사무실 워크스테이션 devbox에 맡기고, 어디서든 거기에 닿는 이야기입니다. 그 닿는 일은 대부분 Claude Code가 합니다. 9월 24일부터 10월 19일까지 노트북의 세션 21개가 평범한 <code>ssh</code>로 devbox에서 명령 1,470개를 실행했습니다. 거기서 도는 클러스터에 <code>kubectl</code>을 날리고, 데이터베이스 pod 안에서 <code>psql</code>을 돌리고, 긴 작업이 어떻게 돼 가는지 보려고 <code>tmux capture-pane</code>을 쓰는 식이죠. <code>ssh devbox</code>는 사무실 네트워크 밖에서는 터널로 넘어가니, 같은 세션이 사무실에서도, 집에서도, 카페에서도 동작합니다. 게다가 노트북이 이제 잠들지 않으니, 세션이 devbox를 계속 부리는 동안 저는 폰으로 들여다보면 됩니다.</p>

<h2 class="relative group">Codex와 비교할 수 없는 이유
    <div id="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="#codex%ec%99%80-%eb%b9%84%ea%b5%90%ed%95%a0-%ec%88%98-%ec%97%86%eb%8a%94-%ec%9d%b4%ec%9c%a0" aria-label="앵커">#</a>
    </span>
    
</h2>
<p>Claude Code가 Codex보다 나은지는 제 사용 경험으로는 말씀드릴 수 없습니다. 이유는 표를 보시면 압니다.</p>
<table>
	<thead>
			<tr>
					<th></th>
					<th>Codex</th>
					<th>Claude Code</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>언제</td>
					<td>2025년 11월 29일~12월 4일</td>
					<td>적어도 2025년 11월부터. 프롬프트 기록은 2026년 2월부터</td>
			</tr>
			<tr>
					<td>어디서</td>
					<td>VS Code 확장</td>
					<td>터미널(세션 128개), 데스크톱 앱(2개)</td>
			</tr>
			<tr>
					<td>모델과 effort</td>
					<td><code>gpt-5.1-codex</code>, medium</td>
					<td>Opus 5.5, high</td>
			</tr>
			<tr>
					<td>승인</td>
					<td><code>workspace-write</code> 샌드박스, 네트워크 꺼짐, 요청 시 확인</td>
					<td>프롬프트의 93%가 bypass, 채팅 세션은 auto</td>
			</tr>
			<tr>
					<td>사용량</td>
					<td>스레드 4개</td>
					<td>2월부터 프롬프트 7,323개</td>
			</tr>
			<tr>
					<td>프로젝트 노트</td>
					<td><code>AGENTS.md</code>를 읽음</td>
					<td><code>CLAUDE.md</code>와 메모리 파일을 읽음</td>
			</tr>
	</tbody>
</table>
<p>이미지 질문 하나, 웹사이트 수정 두 건, 3D 장면 하나에 쓴 일주일간의 스레드 네 개는 비교가 아니라 맛보기입니다. 그래도 거기서 나온 한 가지는 에이전트를 갈아타는 누구에게나 해당됩니다. 그 3D 프로젝트는 규칙을 <code>claude.md</code>에 두고 있었고, 거기서 Codex에게 던진 첫 질문은 대화를 시작하기 전에 Claude의 파일을 읽느냐는 것이었습니다. 읽지 않는다고 했고, 제가 그 파일을 읽으라고 시키고 나서야 프로젝트 규칙을 파악했습니다. 어느 에이전트로 옮기든, 지시 파일은 직접 챙겨 가지 않으면 그 자리에 남습니다. 그 뒤로 Codex 스레드는 열지 않았습니다. 9월 24일부터 10월 4일 사이 며칠은 제가 아무것도 시작하지 않았는데도 확장이 VS Code에서 로드됐고, 지금은 제거했습니다.</p>
<p>그러니 제가 책임질 수 있는 결론은 좁습니다. 제 셋업은 Claude Code를 중심으로 짜여 있고, Codex가 지금 같은 일을 어떻게 처리하는지는 다시 확인해 보지 않았습니다.</p>
<p>마지막 숫자 하나가 위의 어떤 내용보다 제가 이걸 어떻게 쓰는지 잘 보여 줍니다. 8월 말부터 노트북의 메인 세션에서 Claude Code는 셸 명령을 18,311개 실행했고, 파일을 읽거나 쓰거나 고친 건 2,331번이었습니다. 횟수로 보면 일의 대부분은 원래 제가 쳤을 명령을 대신 실행하는 것입니다. 노트북에서도, SSH 너머에서도, 제가 어디에 있든요. 정작 코드를 쓸 때는 그 코드가 어디서나 환영받지는 않는데, 그건 <a href="https://jared.lynskey.co.nz/ko/posts/2026/2026-10-18-pyhtml2text/" >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>
