Claude Code は何をフォルダごとに持っているか

ひとことで

何が、何の単位で分かれているか

公式ドキュメントと手元の実物を突き合わせた表。右の列は、実際に踏んだことを書いている。

主要な意思決定ログ

気づきにくいこと

スキルと MD ファイルを、どこに置いているか

ここまでは記録の話だった。手順と決まりのほうも、同じように置き場所で役割を分けている。数は 2026-09-23 時点の手元の実数。

スキル（呼ぶと読まれる手順書）

30 日ぶんの会話の記録を数えると、いちばん使っているのは /release で 14 回（Certly 5・Dotpile 4・Bearise 2・DayGrid 2・nzw.jp 1）。次が artifact-design 6 回、dataviz 3 回、claude-api 2 回だった。自分で作ったスキルは、毎回やることが同じで、順番を間違えると外に出てしまうもの（リリース・ストアの画像・匿名化）に寄っている。

MD ファイル（置いただけで読まれるもの、呼ばれて読まれるもの）

書き方の決めごとは 3 つある。

• コードは写さず、手本のファイルを指す。写すと同じものが 2 か所になり、必ず片方が古くなる。app-kit には check_links.sh を置いて、手本を動かしたらリンク切れを見る（2026-09-23 で 149 本・切れ 0）。
• 事故は日付と実測値つきで書く。「気をつける」ではなく「何が起きたか」。app-kit を作ったのも、DayGrid で更新チェックの呼び出しが 2 か月落ちていたのに気づかなかったから。
• 同じ事実を 2 か所に書かない。技術書の発売日は books.json だけが源で、HTML 側の 63 か所へは機械が書き戻す。手で直したときは 24 か所直して 6 か所が古いまま残った。

置き場所の選び方は、結局このノートの表と同じになる。リポジトリの CLAUDE.md とメモリーは、そのフォルダを開いた会話しか読まない。アプリをまたいで効かせたいものは ~/CLAUDE.md か app-kit に置き、そこから各リポジトリの CLAUDE.md が指す。

上限に当たると、開いている会話が全部止まる

使用量の枠は、フォルダにも窓にも紐づいていない。アカウントに 1 つで、開いている会話とサブエージェントがまとめて減らす。止まるときは全部が同時に止まる。

出るメッセージは 4 種類ある（公式ドキュメント）。session limit（数時間で戻る枠）と weekly limit（週の枠）はモデルを変えても戻らない。Opus limit と Sonnet limit はそのモデルだけなので、/model で別のモデルに移れば続けられる。

You've hit your session limit · resets 7:50pm (Asia/Tokyo)
You've hit your weekly limit · resets 5pm (Asia/Tokyo)

この 2 週間で 3 回止まった

3 回ともサブエージェントを並べていたときだった。公式ドキュメントにも「一度の大きなファンアウトが、数時間の枠より先に週の枠を使い切ることがある」と書いてある。1 人で書いている感覚のまま 6 つ走らせると、6 倍の速さで減る。

困るのは残量そのものではなく、途中の作業が宙に浮くことだった。9-19 は 6 つのエージェントが章を直している最中に止まったので、再開後にまず「どの章がどこまで直っているか」を数えるところからやり直している。

いまやっていること

• 長い作業は、途中の結果をその都度ファイルに書く。止まっても消えないようにする。9-15 の調べ物はこの形に変えた。
• エージェントの数を絞る。調べ物は 1 件ずつ。並べるのは、止まっても捨てられる作業だけにする。
• 再開したら、まず現状を数えてから続ける。「どこまで入ったか」を確かめずに続けると、二重に直すか、直し漏らす。
• 先に見ておく。/usage で枠と解除の時刻が出る。ステータス行に rate_limits を置くと残量が常に見える。使い切る前に「85% 使った」の警告も出る。
• 待って自動で続ける仕組みがある。2.1.234 以降は、会話を開いたまま解除を待って、止まったところから自分で続けられる（/rate-limit-options）。手元のターミナルの CLI は 2.1.220 なのでまだ使えない。VS Code の拡張（2.1.272）で出るかは確かめていない。

「実行ファイルが起動できない」と出たとき

VS Code の拡張で、送った瞬間にこのエラーが出ることがある。

ReferenceError: Claude Code native binary at /Users/nzw/.vscode/extensions/
anthropic.claude-code-2.1.278-darwin-arm64/resources/native-binary/claude exists
but failed to launch. This usually means the binary does not match this system's
libc — e.g. spawning a musl-linked binary on a glibc Linux host fails because
the musl dynamic loader (/lib/ld-musl-*) is missing. Specify a matching binary
with options.pathToClaudeCodeExecutable.

文面は libc の話をしているが、実際に起きていたのは「その窓が開いているフォルダが無い」だった。2026-09-22 に game を nukero へ改名したあと、古い名前のまま開いていた窓だけがこれを出していた。拡張は毎回、その窓のフォルダを作業場所にして本体を起動するので、フォルダが無いと起動そのものが失敗する。メッセージが実行ファイルのパスを指すので、実行ファイルが壊れたように読める。

直すときの順番。

• その窓が開いているフォルダがあるか見る。拡張のログ（~/Library/Application Support/Code/logs/<起動時刻>/window<番号>/exthost/Anthropic.claude-code/Claude VSCode.log）に Spawning Claude with SDK query function - cwd: … の行があり、作業場所が書いてある。そのパスを ls する。
• 無ければ、その窓を閉じて、いまある名前のフォルダを開き直す。拡張や実行ファイルを入れ直しても直らない。
• 本当に実行ファイル側の問題だったときだけ、別に入れた claude を使わせる。メッセージが案内する options.pathToClaudeCodeExecutable は SDK の引数で、VS Code の設定には無い。拡張側の設定は claudeCode.claudeProcessWrapper。

これから（いま開いている穴）

• 日本語で返す規則が、フォルダをまたいで効いていない。2026-09-19〜20 に Certly の会話で最後の報告が英語になり、3 回言い直した。
  そのときの注意は Certly のメモリーに書いた。
  2026-09-22 の NUKERO! の会話では、ツールの合間に出す途中経過 62 件のうち 37 件が、書き出しに日本語を 1 文字も含んでいなかった（前日は 104 件中 1 件）。
  NUKERO! のメモリーは空で、Certly の注意は読まれていない。ただ ~/CLAUDE.md の「返答は必ず日本語」はどちらの会話でも読まれているので、メモリーをそろえれば直るとも言えない。
  どこに何を書けば効くのかは、まだ分かっていない。
• 並走の規則は、DayGrid のメモリーにしか無い。同じ型の事故は Certly でも起きているが、そちらで開いた会話ではこの規則は読まれない。
• Engly のリリーススキルを、まだ直していない。update.json と APK_BUILD の手順が無いまま、決まりの上ではこちらが正になっている。
• /cd を試していない。動いている会話の作業フォルダを移すコマンドで、会話ごと新しいフォルダの記録へ移る（公式ドキュメント）。今回はこれを使わずに mv で移した。次に改名するときは、フォルダを変えたあと、動いている会話で /cd を使うほうを試す。

関連

• 大量の文章と問題文をどうテストするか — 出典に「確かめた日」を持たせる考え方
• Claude Code と働く1年目の教科書 — Claude Code と働く側の手引き。このノートはその手元の実例
• Manage sessions（公式） — 会話の記録の置き場所、再開のときの探し方、30 日の保存期間、/cd
• How Claude remembers your project（公式） — メモリーがリポジトリごとに分かれること
• Extend Claude with skills（公式） — 同じ名前のスキルがあるとき、どれが動くか

仕組みの説明は、2026-09-22 に確認した公式ドキュメントと、手元の Claude Code（VS Code 拡張 2.1.272・CLI 2.1.220）の実物に基づきます。

版によって変わります。件数は 2026-09-22 と 2026-09-23 に手元で数えたものです。

Claude 認定資格の対策アプリ Certly

Claude 認定資格（CCAR-F / CCAR-P）の対策アプリ。間隔反復（FSRS-5）で忘れる直前に出し、選択肢ごとに「なぜ誤りか」まで解説する。

このノートで扱ったスキルの置き場所・--resume・会話の保存期間（cleanupPeriodDays）も、CCAR-F の問題と教科書に入っている。

アプリの概要 App Store（iOS） Android（APK）

Certly は Anthropic 非公式の学習ツールです。問題は公開されている試験ガイドと公式ドキュメントをもとに作ったオリジナルで、実際の試験問題ではありません。