<?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/ja/tags/tmux/</link>
    <description>ソフトウェアエンジニアリングと開発組織のリーダーシップについて。評価、採用とチームの拡大、CI/CD、DevOps モニタリング、エージェンティック AI。ソウルより。</description>
    <generator>Hugo</generator>
    <language>ja</language>
    <copyright>© 2026 仁才徳</copyright>
    <lastBuildDate>Thu, 19 Nov 2026 00:00:00 +1300</lastBuildDate>
    <atom:link href="https://jared.lynskey.co.nz/ja/tags/tmux/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>Claude Codeのworktreeの使い方：並列エージェントを衝突させずに動かす</title>
      <link>https://jared.lynskey.co.nz/ja/posts/2026/claude-code-git-worktrees/</link>
      <guid isPermaLink="true">https://jared.lynskey.co.nz/ja/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>という新しいブランチをそこにチェックアウトします。以後、そのセッションが編集できるのはこのフォルダの中だけです。別のターミナルで名前を変えて同じコマンドを打てば、お互いのファイルに手を出せないエージェントが2つ並びます。ただし落とし穴があって、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="日本語" default>
    <track kind="subtitles" src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktrees-film_ko.vtt" srclang="ko" label="한국어">
    <track kind="subtitles" src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktrees-film_vi.vtt" srclang="vi" label="Tiếng Việt">
    <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="日本語" default>
    <track kind="subtitles" src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktrees-film_ko.vtt" srclang="ko" label="한국어">
    <track kind="subtitles" src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/worktrees-film_vi.vtt" srclang="vi" label="Tiếng Việt">
    <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">なぜ1つのチェックアウトでは並列エージェントがうまくいかないのか
    <div id="なぜ1つのチェックアウトでは並列エージェントがうまくいかないのか" 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="#%e3%81%aa%e3%81%9c1%e3%81%a4%e3%81%ae%e3%83%81%e3%82%a7%e3%83%83%e3%82%af%e3%82%a2%e3%82%a6%e3%83%88%e3%81%a7%e3%81%af%e4%b8%a6%e5%88%97%e3%82%a8%e3%83%bc%e3%82%b8%e3%82%a7%e3%83%b3%e3%83%88%e3%81%8c%e3%81%86%e3%81%be%e3%81%8f%e3%81%84%e3%81%8b%e3%81%aa%e3%81%84%e3%81%ae%e3%81%8b" aria-label="アンカー">#</a>
    </span>
    
</h2>
<p>9月のある日、私が作っているマーケットプレイスアプリの同じチェックアウトで、Claude Codeのセッションが5つ同時に動いていました。その日、2つのことが起きました。テスト設定ファイルへの1行の修正が、4回のビルド失敗を生き延びたのに、いざコミットしようとしたら消えていたのです。<code>git commit</code>は「working tree clean」と言い、ファイルには別のセッションの内容が入っていました。こういう更新の消失は、gitのどこにも記録が残りません。reflogにもstashにも何もなく、更新日時もごく普通です。同じ日には、作業ツリーからビルドするデプロイスクリプトが、別のセッションの書きかけの変更を本番に出しかけました。</p>
<p>10月には3つ目が起きました。あるセッションが、別のセッションのステージされていない変更の横で自分のファイルをコミットしたところ、pre-commitフックがフックの実行中、ステージされていない変更を<em>すべて</em>stashしました。もう一方のセッションの編集はその間ディスクから消え、型チェッカーはそのセッションの新しいファイルでエラーになり、コミットは中止されました。しかも、どのセッションも私の名前でコミットするので、<code>git log</code>を見ても誰が何をしたのか分かりません。</p>
<p>worktreeを使う理由は一言で言えます。書き手が複数いる作業ツリーは競合状態で、負けた側はそれに気づけません。エージェントごとに作業ツリーを分ければ、競合そのものがなくなります。</p>
<figure class="diagram">
  <div role="img" aria-label="図：コミット、ブランチ、設定、worktreeごとの小さな専用フォルダを持つ共有の.gitディレクトリが、3つの作業ディレクトリにつながっている。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 906" aria-hidden="true" focusable="false">
<path class="d-group" d="M30,267 V735 M30,435.5 H62 M30,578.5 H62 M30,735 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="192" rx="22"></rect>
<rect class="d-head" x="25" y="105" width="8" height="8" rx="2"></rect>
<text class="d-label" x="46" y="115.8" font-size="19">コミットとオブジェクト</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</text>
<text class="d-label" x="46" y="239.8" font-size="19">とindex）</text>
<text class="d-title" x="62" y="327" font-size="26">3つの作業ディレクトリ</text>
<text class="d-sub" x="62" y="354" font-size="18">ファイル、HEAD、indexはそれぞれ別</text>
<rect class="d-box" x="62" y="372" width="636" height="127" rx="14"></rect>
<text class="d-label d-mono" x="82" y="409.2" font-size="20">~/code/myapp</text>
<rect class="d-panel" x="82" y="424" width="60.1" height="28" rx="14"></rect>
<text class="d-label d-mono" x="94" y="443.4" font-size="15">main</text>
<text class="d-sub" x="154.1" y="444.1" font-size="17">メインのチェックアウト</text>
<path class="d-badge" style="fill:none;stroke-width:2.6" d="M83,474 l4.5,4.5 l9.5,-10"></path>
<text class="d-label" x="107" y="479.6" font-size="17">.env あり</text>
<path class="d-badge" style="fill:none;stroke-width:2.6" d="M205.8,474 l4.5,4.5 l9.5,-10"></path>
<text class="d-label" x="229.8" y="479.6" font-size="17">node_modules 45 MB</text>
<rect class="d-box" x="62" y="515" width="636" height="127" rx="14"></rect>
<text class="d-label d-mono" x="82" y="552.2" font-size="20">~/code/myapp-fix-login</text>
<rect class="d-panel" x="82" y="567" width="105.3" height="28" rx="14"></rect>
<text class="d-label d-mono" x="94" y="586.4" font-size="15">fix-login</text>
<text class="d-sub" x="199.3" y="587.1" font-size="17">git worktree add で作成</text>
<path class="d-line" style="fill:none;stroke-width:2.2" d="M85,611.5 l10,10 M95,611.5 l-10,10"></path>
<text class="d-sub" x="107" y="622.6" font-size="17">.env なし</text>
<path class="d-line" style="fill:none;stroke-width:2.2" d="M206.9,611.5 l10,10 M216.9,611.5 l-10,10"></path>
<text class="d-sub" x="228.9" y="622.6" font-size="17">node_modules なし（npm install までは 84 KB）</text>
<rect class="d-box" x="62" y="658" width="636" height="154" rx="14"></rect>
<text class="d-label d-mono" x="82" y="695.2" font-size="20">~/code/myapp/.claude/worktrees/add-search</text>
<rect class="d-panel" x="82" y="710" width="195.6" height="28" rx="14"></rect>
<text class="d-label d-mono" x="94" y="729.4" font-size="15">worktree-add-search</text>
<text class="d-sub" x="289.6" y="730.1" font-size="17">claude -w add-search で作成</text>
<path class="d-badge" style="fill:none;stroke-width:2.6" d="M83,760 l4.5,4.5 l9.5,-10"></path>
<text class="d-label" x="107" y="765.6" font-size="17">.env（.worktreeinclude がコピー）</text>
<path class="d-line" style="fill:none;stroke-width:2.2" d="M411.6,754.5 l10,10 M421.6,754.5 l-10,10"></path>
<text class="d-sub" x="433.6" y="765.6" font-size="17">node_modules なし</text>
<rect class="d-line" style="fill:none;stroke-width:2" x="84" y="785.5" width="12" height="9" rx="2"></rect>
<path class="d-line" style="fill:none;stroke-width:2" d="M86.5,785.5 v-2.5 a3.5,3.5 0 0 1 7,0 v2.5"></path>
<text class="d-sub" x="107" y="792.6" font-size="17">セッション中はロックされる</text>
<text class="d-sub" x="2" y="850" font-size="16">Claude Codeは、同じリポジトリのworktree間でさらに2つを共有します。「don't ask</text>
<text class="d-sub" x="2" y="874" font-size="16">again」の承認（メインのチェックアウトの .claude/settings.local.json に保存）と、プロ</text>
<text class="d-sub" x="2" y="898" font-size="16">ジェクトスコープのプラグインです。</text>
</svg>
</div><figcaption>1つのリポジトリに3つの作業ディレクトリ。履歴は1か所に保存され、ファイルと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-%e3%81%ae%e4%bd%bf%e3%81%84%e6%96%b9%e3%81%a8%e5%8b%95%e3%81%8d" 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>を最初に打つと「Workspace trust not yet accepted」で失敗します。そこで一度だけ普通に<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の中で「Yes, and don&rsquo;t ask again」と答えた承認は、<em>メインの</em>チェックアウトの<code>.claude/settings.local.json</code>に保存されます。つまりその承認はすべてのworktreeに効き、承認したworktreeを消した後も残ります。便利ですが、承認するコマンドに秘密情報を入れない理由がまた1つ増えたとも言えます。</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="#%e5%be%8c%e7%89%87%e4%bb%98%e3%81%91%e3%81%a8%e6%ae%8b%e3%82%8b%e3%83%ad%e3%83%83%e3%82%af" 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>が「cannot remove a locked working tree, lock reason: claude session add-search」と拒否しています。ドキュメントにもまさにこう書いてあり、後のセッションの古いロックの掃除で外れるか、先に<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%e7%9c%9f%e3%81%a3%e3%81%95%e3%82%89%e3%81%aa%e3%83%81%e3%82%a7%e3%83%83%e3%82%af%e3%82%a2%e3%82%a6%e3%83%88%e3%81%ab%e3%81%aa%e3%81%84%e3%83%95%e3%82%a1%e3%82%a4%e3%83%ab" 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%e3%81%84%e3%81%a1%e3%81%b0%e3%82%93%e9%87%8d%e3%81%84%e3%81%a8%e3%81%93%e3%82%8d" 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 に3つが並び、新しい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>実際のプロジェクトでは数字が深刻になります。私のモバイルアプリのリポジトリには、メインのチェックアウトの横に19個のworktreeがあります。そのうち12個を測ると194 MBから12 GBまであり、大きい4つは、どれも自分の<code>node_modules</code>を持っていた4つでした。今週はノートPCのディスクが96%埋まっているので、掃除するならまずここからです。</p>
<p>選択肢を、単純なものから順に並べます。</p>
<ol>
<li><strong>worktreeごとにインストールする。</strong> 最初にエージェントに<code>npm install</code>を実行させるか、自分でやります。遅くてディスクも食いますが、驚かされることはありません。</li>
<li><strong>ロックファイルが同じチェックアウトからクローンする。</strong> macOSなら、<code>cp -c -R ../myapp/node_modules .</code>でAPFSのクローンが使えます。クローンは、どちらかが変更されるまでデータブロックを共有します。デモの45 MBは0.8秒でした。私は実際のworktreeからのデプロイでもこれを使っています。クローンしていいのはロックファイルが一致するときだけで、ネイティブのビルドフォルダには注意してください。私の場合、メインのチェックアウトのiOSのPodsはworktreeのブランチより古いSDK向けにビルドされていたので、そこだけは入れ直す必要がありました。</li>
<li><strong>pnpmを使う。</strong> パッケージは1つのストアに置かれ、macOSのpnpmは<a href="https://pnpm.io/settings/node-modules#packageimportmethod"  target="_blank" rel="noreferrer">ハードリンクより先にクローンを試します</a>（LinuxとWindowsではハードリンクが先）。デモでは、2つ目の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%e3%81%a7%e4%b8%a6%e5%88%97%e3%82%a8%e3%83%bc%e3%82%b8%e3%82%a7%e3%83%b3%e3%83%88%e3%82%92%e5%8b%95%e3%81%8b%e3%81%99" aria-label="アンカー">#</a>
    </span>
    
</h2>
<p>私はもともとtmuxの中で暮らしているので（レイアウトは<a href="https://jared.lynskey.co.nz/ja/posts/2026/2026-10-22-claude-code-day-to-day/" >日々の使い方の記事</a>に書きました）、worktreeはそのまま収まります。worktreeごとにウィンドウかペインを1つずつ。下は、同じファイルを変更するよう指示した3つのエージェントを同時に起動したところです。</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="3つのペインに分けたtmux：claude -w add-bye、add-greet、add-tests が同時に動き、実行中はペインのタイトルがworktreeの名前に変わる。2つは src/index.js の変更を、1つは新しいテストフォルダを報告し、最後に上のペインでメインのチェックアウトがクリーンなことと、ロックされた3つのworktreeを確認する">
    <source src="https://jared.lynskey.co.nz/en/posts/2026/claude-code-git-worktrees/parallel-agents-tmux.mp4" type="video/mp4">
  </video><figcaption>エージェント3つ、ファイル1つ、衝突なし。メインのチェックアウトはクリーンなままで、それぞれの変更は自分のブランチで待っています。</figcaption>
</figure>

<p>2つのエージェントが同時に<code>src/index.js</code>を編集し、どちらも相手に気づきませんでした。それぞれの<code>src/index.js</code>は、ディスク上では別のファイルだからです。メインのチェックアウトもクリーンなままでした。最後に残るのは、レビューしてマージする3つのブランチで、ここはworktreeが代わりにやってくれない仕事です。2つのエージェントが同じ行を変えれば、やはりマージコンフリクトになります。ただし、黙って上書きされるのではなく、目に見えるマージの場面で出てきます。</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%e3%81%af%e3%82%b9%e3%83%8a%e3%83%83%e3%83%97%e3%82%b7%e3%83%a7%e3%83%83%e3%83%88" aria-label="アンカー">#</a>
    </span>
    
</h2>
<p>worktreeは古くなります。11月19日、2〜3日前から用意されていたworktreeからOTAアップデートが出たところ、その間に別の場所から出ていた2つの修正を黙って巻き戻してしまいました。その日のうちに気づいて差し替えましたが、worktreeは完璧に隔離されていて、それが問題でした。その修正を一度も見ていなかったのです。gitのコマンド1行で、リリース前に気づけたはずでした。</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には新しいコミット「Fix sign-in token handling」があり、古いworktreeは最初のコミットのまま。git merge-base --is-ancestor main HEAD は「missing the fix: rebase before you ship」と表示し、git rebase main の後は同じチェックが「has the fix」と表示する">
    <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="#%e3%82%b5%e3%83%96%e3%82%a8%e3%83%bc%e3%82%b8%e3%82%a7%e3%83%b3%e3%83%88%e3%81%a8%e3%83%95%e3%83%83%e3%82%af" 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は削除されます。変更があるものは、作業を失わずに消せるようになるまで、定期的な掃除で消されずに残ります。細かい点を1つ。<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="#%e7%b4%a0%e3%81%aegit-worktree-add%e3%81%ae%e3%81%bb%e3%81%86%e3%81%8c%e5%90%91%e3%81%84%e3%81%a6%e3%81%84%e3%82%8b%e5%a0%b4%e9%9d%a2" aria-label="アンカー">#</a>
    </span>
    
</h2>
<p>白状すると、私のアプリのリポジトリの<code>.claude/worktrees</code>フォルダは空です。19個のworktreeはすべて素の<code>git worktree add</code>で、すべてこの1か月の間に作られたもので、半分はdetached HEADです。ノートPCのほかのリポジトリにも、40、40、18、10、3、2、2個あります。しかも作っているのはたいてい私ではありません。このノートPCにあるClaude Codeの会話記録638件のうち85件で、エージェントが<code>git worktree add</code>を実行していて、その回数は合わせて336回です。</p>
<p>素のgitのほうが向いているのは、次のようなときです。</p>
<ul>
<li><strong>既存の特定のブランチが必要なとき。</strong> たとえば、ホットフィックス用に残しているリリースブランチです。<code>baseRef</code>ではできません。</li>
<li><strong>修正を1つだけ出したいとき。</strong> ほかのセッションがまだデプロイしていない変更を<code>main</code>にコミットしていたので、本番で動いているコミットにdetachedのworktreeを作り、自分の修正だけをcherry-pickしてそこからデプロイしました。こうすれば、出ていくのはその修正だけです。</li>
<li><strong>自分でエージェントに指示を書くとき。</strong> 1つのリポジトリで複数のエージェントを動かすとき、私はそれぞれへの指示に、<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="#%e3%81%be%e3%81%a8%e3%82%81" 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は、エージェント同士がファイルを上書きし合うのは防いでくれますが、意見が食い違うのまでは防いでくれません。最後に3つのブランチをレビューするのは、やはりあなたです。</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="#%e5%8f%82%e8%80%83%e3%83%aa%e3%83%b3%e3%82%af" aria-label="アンカー">#</a>
    </span>
    
</h2>
<p><strong>このサイト内：</strong></p>
<ul>
<li><a href="https://jared.lynskey.co.nz/ja/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/ja/posts/2026/2026-10-22-claude-code-day-to-day/</link>
      <guid isPermaLink="true">https://jared.lynskey.co.nz/ja/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-%e3%81%a8-claude-code-%e3%81%af%e5%88%a5%e7%89%a9" 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="#%e3%81%b2%e3%81%a8%e3%81%a4%e3%81%ae-tmux-%e3%82%bb%e3%83%83%e3%82%b7%e3%83%a7%e3%83%b3%e3%81%ab%e4%b8%83%e3%81%a4%e3%81%ae%e3%82%a6%e3%82%a3%e3%83%b3%e3%83%89%e3%82%a6" aria-label="アンカー">#</a>
    </span>
    
</h2>
<p>これを書いている今、<code>tmux list-panes -a</code> を実行すると、ラップトップには <code>main</code> というセッションがひとつあり、ウィンドウが七つあります。そのうち五つが Claude Code で、プロジェクトごとにひとつずつです。私が作っているマーケットプレイスアプリと見積もりアプリ(どちらも<a href="https://jared.lynskey.co.nz/ja/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 プレフィックスです。そこで <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="#%e3%82%bf%e3%83%bc%e3%83%9f%e3%83%8a%e3%83%abvs-code-%e6%8b%a1%e5%bc%b5%e3%83%87%e3%82%b9%e3%82%af%e3%83%88%e3%83%83%e3%83%97%e3%82%a2%e3%83%97%e3%83%aa%e3%81%ae%e3%81%a9%e3%82%8c%e3%81%ab%e3%81%99%e3%82%8b%e3%81%8b" 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 にはターミナルが必要ですし、チャンネルもそうです。チャンネルは外部のイベントをセッションに流し込む仕組みで、ドキュメントでは CLI の機能として挙げられています。</p>
<p>Claude Code に git は必要か、ともよく聞かれます。CLI には要りません。私のホームディレクトリはリポジトリではありませんが、私のプロンプトのうち 208 件は、そこで起動したセッションに送ったものです。デスクトップアプリのドキュメントには、セッションごとに専用の worktree を持たせるセッションの分離に git が必要だと書かれていますし、クラウドのセッションをターミナルに引き込むには同じリポジトリのチェックアウトが要ります。私自身は「Git is required」というメッセージを見たことがありません。最後にデスクトップアプリを使ったのは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="#%e3%83%91%e3%83%bc%e3%83%9f%e3%83%83%e3%82%b7%e3%83%a7%e3%83%b3%e3%83%a2%e3%83%bc%e3%83%89%e3%81%a8%e5%ae%9f%e9%9a%9b%e3%81%ab%e4%bd%bf%e3%81%a3%e3%81%a6%e3%81%84%e3%82%8b%e3%82%82%e3%81%ae" 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>なので「Claude 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">claude --dangerously-skip-permissions</span></span></code></pre></div></div>
<p>シェルの履歴にある 69 回の <code>claude</code> コマンドのうち 62 回にこのフラグが付いていて、今動いている五つのセッションもすべてそうです。8月28日から10月21日までに打った 1,266 件のプロンプトのうち、1,179 件は bypass モードのセッションに、82 件は auto モードに、5 件は Manual か accept-edits に送ったものでした。</p>
<p>ドキュメントははっきり書いていて、bypass モードは「インターネットにアクセスできないコンテナ、VM、dev コンテナのような、Claude Code がホストシステムを壊しようのない隔離された環境」向けだとしています。私のラップトップはそのどれでもなく、設定にはその警告をクリックで通過した記録が残っています(<code>&quot;skipDangerousModePermissionPrompt&quot;: true</code>)。同じことをするなら、bypass モードでは allow ルールが効かないことは知っておいてください。つまり私の普段のセッションでは、19 個の設定ファイルに散らばった 378 個の allow ルールは、何ひとつ仕事をしていません。deny と ask のルールは bypass モードでも効きますが、私はどちらも一つも書いていません。</p>
<p>例外は、ほかの人の言葉を読むセッションです。そのランチャーはこのフラグを渡さないので、auto モードで始まります。10月12日から20日までにセッションに届いた本番イベント 27 件はすべて、チャットのメッセージは 43 件のうち 42 件が auto モードで受け取ったもので、bypass で受け取ったものはひとつもありません。</p>
<p>bypass モードで実際に痛い目を見ずに済んでいるのは、いくつかの習慣のおかげです。9月のある日、同じチェックアウトで動いていた二つのセッションが互いの作業を上書きし、危うくそれをデプロイしかけたあとで、Claude のメモリに書き込んだものです(顛末は<a href="https://jared.lynskey.co.nz/ja/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="#%e3%82%b9%e3%83%9e%e3%83%9b%e3%81%8b%e3%82%89%e5%b1%8a%e3%81%8f" 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、アタッチ用の短いエイリアス</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> を使うと、Web やアプリで始めたクラウドのセッションを、ブランチと会話ごとターミナルに引き下ろせます。私がやったのは二回で、どちらも7月です。</p>
<p>SSH は、ターミナルそのものが欲しいときに使います。スマホは<a href="https://jared.lynskey.co.nz/ja/posts/2026/2026-10-01-cloudflare-warp-dev-network/" >プライベートネットワークの記事</a>で書いたプライベートネットワーク越しにラップトップに届き、エイリアスひとつで <code>main</code> にアタッチするので、ラップトップに置いてきたウィンドウをスワイプで行き来できます。Mac がスマホのアプリにちゃんと応答するようになるまでには四つの別々の修正が必要でしたが、Claude Code に関係があるのは、tmux を決して勝手に起動させないことです。<code>docker ps</code> を実行しようとセッションを開いたアプリが、結果の代わりに 72 KB 分の画面の再描画を受け取っていたのです。</p>
<p>チャットボットは、座って見張っていたくないセッションのためのものです。10月12日から、あるセッションを、自分で書いた小さなチャンネルと一緒に動かしています。このチャンネルはアプリのサーバーを一分ごとに確認し、新しい本番エラーやプロジェクトボードの動きがあればセッションに渡します。そこに公式のチャットプラグインのひとつも組み合わせているので、許可リストに載っている私たち二人がメッセージを送れます。起動の行は、名前を一般的なものにするとこんな形です。</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="#%e3%82%b9%e3%82%ad%e3%83%ab%e3%83%a1%e3%83%a2%e3%83%aagoal" aria-label="アンカー">#</a>
    </span>
    
</h2>
<p>私の設定ファイルには、どれにも <code>hooks</code> キーがありません。いちばん近いのは <code>/goal</code> で、7月11日から何度となく使っています。条件を受け取って、そのセッションに Stop フックを設定するもので、Claude Code の言葉を借りれば「条件が満たされるまで停止をブロックする」ものです。私のゴールは、口に出して言うときのままの文面です。7月の実例をひとつ挙げると、タイプミスもそのままに、ビルドが &ldquo;still broken, try a deeper fix and dont stop until&rdquo;(まだ壊れてる、もっと根っこから直して、止まらないで)、テスターの手に届くまで、と書いていました。長い実行を脱線させずに様子を見るには <code>/btw</code> があります。会話の本筋には残らない、横からの質問です。私のはたいてい &ldquo;hows it going?&quot;(調子どう?)のバリエーションです。</p>
<p>スキルには、そうでなければ毎回説明することになるものを入れています。あるユーザーレベルのスキルは、このブログを含め私が面倒を見ているサイトの週次キーワードレポートを読み、タイトル、description、タグに反映します。この記事が答えている質問は、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-%e3%81%a7%e3%83%af%e3%83%bc%e3%82%af%e3%82%b9%e3%83%86%e3%83%bc%e3%82%b7%e3%83%a7%e3%83%b3%e3%82%92%e5%8b%95%e3%81%8b%e3%81%99" aria-label="アンカー">#</a>
    </span>
    
</h2>
<p><a href="https://jared.lynskey.co.nz/ja/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-%e3%81%a8%e6%af%94%e3%81%b9%e3%82%89%e3%82%8c%e3%81%aa%e3%81%84%e7%90%86%e7%94%b1" 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>一週間で四スレッド、それも画像についての質問、Web サイトへの二つの変更、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/ja/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>
