Claude Code 学習メモ

01Claude Code の記憶（メモリ）の3層構造

Claude Code の記憶は、3つの層が組み合わさって動いとる。

① CLAUDE.md（自分で書く・最重要）

Markdownファイルで「Claudeへの永続的な指示」を書く。セッション開始時に自動で読み込まれる。

② Auto Memory（Claudeが勝手にメモる）

v2.1.59以降デフォルトON。ビルドコマンド、デバッグの気づき、アーキテクチャの判断、コードスタイルの好み、作業の習慣などをClaudeが自動で記録。「前回ビルドエラー出たから次は○○する」みたいなことを勝手に覚えてくれる。/memory コマンドで中身が見れる。

③ Session Memory（セッション要約）

セッション開始時に「Recalled X memories」と表示されるあれ。前回の作業内容を要約して引き継いでくれる。~/.claude/projects/<project-hash>/ に保存される。

プロジェクト間で知識を引き継ぐ方法

方法A：グローバル CLAUDE.md に共通方針を書く

~/.claude/CLAUDE.md に書いておけば全プロジェクトで自動読み込み。例：

# Yuzoの開発方針
- Webアプリは Supabase + Cloudflare + GitHub の構成で作る
- 履歴管理は CHANGELOG.md と TODO.md に書く
- バージョン番号は Ver X.Y 形式
- 業務系アプリは最初にローカル版を作り、安定したらネットワーク版へ

方法B：前プロジェクトの CLAUDE.md を import する

新プロジェクトの CLAUDE.md に @ でファイル参照を書く。

# 社有車使用簿APP

参考にする設計：
@~/Documents/Apps/訪看訪問時間管理/CLAUDE.md

このプロジェクトの仕様：
- 利用者ではなく社有車を管理対象とする
- GPS連携・CSV出力の仕様は訪問記録APPと同じ

方法C：手動で「前のプロジェクト見て」と指示

新セッションで：

「~/Documents/Apps/訪看訪問時間管理/ の CLAUDE.md と全体構造を読んでから、
新しい社有車管理アプリを同じ方針で設計して」

Claude Code が該当ディレクトリを読みに行く。一番柔軟。

02ホスティング判断：集約 vs 分散

Netlifyでトークン使い果たした件

これは構造的な問題で、使い方が悪かったわけじゃない。2024〜2025年にかけてNetlifyは無料枠を大幅に絞った。100GB帯域・300分ビルドという制限は、Claude Code で頻繁にpushしてデプロイを回すスタイルとは相性が悪い。

Cloudflareに逃げたんは正解。Cloudflare Pagesは無料枠が桁違いに大きい（500ビルド/月、無制限帯域）。Workersも10万リクエスト/日の無料枠で、小規模業務アプリなら課金ライン到達はほぼ不可能。

集約 vs 分散の本当のトレードオフ

集約のメリット

• 認知負荷が下がる：1個のダッシュボード、1個の請求書、1個のCLI
• ノウハウが蓄積する：トラブルシュート経験が同じ場所で積み上がる
• CLAUDE.md にデプロイ設定を書いてしまえば使い回せる

分散のメリット（過小評価されがち）

• ベンダーロックインの回避：1社の値上げや障害で全停止しない
• 適材適所：Next.jsならVercel、低コスト大量配信ならCloudflare
• コンサル業務との相性：複数プラットフォーム経験は資産になる
• 学習投資：3年後に「あのとき触っといて良かった」になる可能性

提案：「デフォルト + 例外」戦略

03サービスは5層構造で見る

世の中のサービスは、この5層のどこかに収まる。レイヤーを意識すると、新サービスが出てきても瞬時に位置付けられる。

Yuzo の現状マッピング

① Claude Code
② GitHub
③ Supabase
④ Cloudflare（訪問記録APP）/ Vercel（釣行管理APP）
⑤ まだ未使用

競合関係 vs 補完関係を見分ける

04MCPサーバーとは何か

よくある誤解

「Claude Code が既に GitHub に push してくれる = MCP のおかげ」違う。

これは MCP のおかげじゃなくて、ターミナルで普通に動く git コマンドを Claude Code が実行しとるだけ。Yuzo がターミナルで git push 打つのと同じことを代行しとる。

MCP の本質：「CLIで叩けないサービスへの橋」

MCP導入後にできるようになること

例：GitHub MCP

従来: 「コミットしてpushして」
  → Claude Code が git CLI で実行

MCP導入後（GitHub MCP）:
  「未解決のIssue全部見せて、優先度高い順に並べて、
   昨日のコミットで関連する変更を加えたものに『修正済み』ラベル付けて」
  → 構造化APIで一気にやれる

Yuzo に今必要なMCPは4つだけ

05bash / CLI / ターミナルの基礎

3つはレイヤーが違う

ターミナル（窓口アプリ）
  └── シェル（翻訳者：bash / zsh）
        └── CLI ＝ 文字で命令を出す操作スタイル

用語ひとつずつ

CLI（Command Line Interface）

「文字を打って命令を出すスタイル全般」のこと。Command Line Interfaceの略。

対義語はGUI（Graphical User Interface）＝マウスでアイコンをクリックする世界。

bash（バッシュ）/ zsh（ズィーシェル）

CLIで打った命令を実際に解釈して実行するプログラム。「シェル」と呼ばれるカテゴリの一種。

• bash：Linux/旧Macの標準
• zsh：今のMacのデフォルト（Yuzoが使っとるのはたぶんこっち）
• PowerShell：Windowsの標準

世間では総称して「bash」と呼んでしまうことが多いけど、実体は zsh のことも多い。

ターミナル

シェルが動く窓口アプリ。Macに最初から入っとる「ターミナル」アプリがそれ。

Yuzo の実体験で置き換える

1. Macの「ターミナル」アプリを開く    ← ターミナル
2. 黒い画面で文字が打てる状態になる    ← ここで zsh が待機中
3. 「claude」と打って Enter          ← この瞬間が CLI 操作
4. Claude Code が起動               ← Claude Code 自体もCLIツール

06なぜClaude CodeはCLIなのか

① 開発者は既にターミナルに住んどる

プログラマーが普段やる仕事 ── テスト実行、git操作、デプロイ、ログ確認 ── 全部ターミナルで動いとる。「いつも開いとるターミナルの中で、そのままClaudeが動く」方が自然。

② CLIは他のCLIと自由に組み合わせられる

git log の結果 → grep でフィルタ → claude にレビュー依頼

これが1行で書ける。GUIアプリだと「ファイルにエクスポート → 別アプリで開く → 結果をまたエクスポート」と手間が増える。

③ ファイルが「共通言語」になる

プログラミングプロジェクトの正体は「フォルダの中のテキストファイルの集合」。CLIツールはファイルを直接読み書きできる。GUIだとそのまわりに大量のUIを作り込む必要がある。

④ 透明性が学習の助けになる（Yuzo に効くポイント）

GUI は便利な代わりに、裏で何が起こっとるかが見えない。CLI の Claude Code はこう報告する：

• 「git add . を実行します」
• 「src/App.jsx を編集しました（行数: +12 -3）」
• 「npm run build を実行...エラー：（詳細）」

全部見える形で実況してくれる。これが、コードが書けないYuzoが「何が起こっとるか」を自然に学ぶ補助輪になっとる。

⑤ 自動化に組み込める

毎朝6時に → Claude Code に「昨日のコミットを要約して」 → Slack投稿

こういう無人運転がCLIなら数行で組める。GUIアプリは「人間が画面を見てクリックする」前提やけん自動化に組み込めない。

哲学を一言で

• CLI = 小さい道具を組み合わせる文化（UNIX哲学）
• GUI = 全部入りパッケージの文化

Claude Code が CLI で来たのは、既存の道具全部と仲良くできるから。「黒い画面の中にいる」のは制約じゃなくて、そこが一番強い場所だから。

07主要なCLIツール

git（ギット）

コードファイルの変更履歴を1行単位で記録するツール。誰がいつ何をどう変えたかが全部残る。2005年にLinus TorvaldsがLinux開発のために作った。今や世界中のソフトウェア開発の標準。

npm（エヌピーエム）

JavaScript用のパッケージマネージャ（Node Package Manager）。「使いたいライブラリ名を指定すると、自動でダウンロードして組み込んでくれる」仕組み。

npm install dayjs   ← 日付処理ライブラリをインストール

訪問記録APPの中の package.json に、使っとるライブラリ一覧が書かれとる。Supabase連携、React、地図表示、CSV出力 ── 全部、誰かが作って npm に公開したライブラリ。

docker（ドッカー）

アプリを「どこで動かしても同じように動く箱（コンテナ）」に詰めるための道具。

「うちのPCでは動いたのに本番サーバーでは動かん」という伝統的な悩みを解決する。アプリと、それを動かすのに必要な環境一式をコンテナに閉じ込めて、丸ごと運ぶ。

wrangler（ラングラー）

Cloudflare専用のCLIツール。Yuzoがおととい Cloudflare に引っ越したばっかりやけん、これからお世話になる。

できること：

• Cloudflare Workers（サーバーレス関数）のデプロイ
• D1（Cloudflareのデータベース）の操作
• R2（ストレージ）の管理
• DNS設定の変更
• ログの確認

Claude Code がデプロイするときに、裏で wrangler deploy を叩いとる可能性が高い。Yuzo が直接 wrangler を打たんでも、Claude Code 経由で動かしとる。

ちなみに Vercel にも同じような CLI（vercel コマンド）がある。各クラウドサービスは自社専用のCLIをそれぞれ提供しとる。

08クイックリファレンス

3つの記憶層（再掲）

5層 × 集約原則

CLIツールの使い分け