この記事でわかること
- 自分の OS でインストールからログインまで、実際に打つコマンドの並び
- 最初のセッションで何をどう書くか。公式が例示している最初の3プロンプト
CLAUDE.mdの置き場所4スコープと、最初の1本に書く項目- 手元31リポジトリの
CLAUDE.mdの実測行数分布と、公式の「200行以下」との差 command not foundなど、エラーメッセージ別の対処
最初に結論だけ書きます。インストールから CLAUDE.md の初版を整えるまでは、curl -fsSL https://claude.ai/install.sh | bash → claude --version → プロジェクトへ cd → claude → ブラウザでログイン → 質問を1つ投げる → /init で CLAUDE.md を生成 → 手で削る、の8手です。macOS・Linux・WSL はこの1行で入り、Windows は PowerShell なら irm https://claude.ai/install.ps1 | iex に置き換わります(Claude Code Docs「クイックスタート」 2026-09-13確認)。
そのうえで、この記事が上位ページと違うのは後半です。CLAUDE.md は「書け」で終わっている解説がほとんどですが、実際に何本も運用すると何行に落ち着くのかという記録が見当たりません。手元の31本を数えたところ、中央値は41行、平均76.0行で、公式が挙げる200行を超えていたのは2本だけでした。ただし、同時に読み込まれる祖先ディレクトリの CLAUDE.md を足すと、200行を超える組み合わせは6本に増えます(§7)。
1. 一次資料の対応表と検証環境
本文の事実はすべて以下から取りました。ローカルの実測は末尾2行です。
| 主張 | 一次資料 | 種別 | 確認日 |
|---|---|---|---|
| インストールコマンド・対応OS・WSL とネイティブの差 | 高度なセットアップ | 公式ドキュメント | 2026-09-13 |
CLAUDE.md の4スコープ・200行の目安・.claude/rules/ | Claude があなたのプロジェクトを記憶する方法 | 公式ドキュメント | 2026-09-13 |
/usage の内訳・キャッシュミス・コスト平均値 | コストを効果的に管理する | 公式ドキュメント | 2026-09-13 |
| 最初の8ステップ・必須コマンド・権限モード | クイックスタート | 公式ドキュメント | 2026-09-13 |
| サーフェス一覧・できること | 概要 | 公式ドキュメント | 2026-09-13 |
CLAUDE.md 31本の行数分布と記載カテゴリ | ~/<workspace>/*/CLAUDE.md(作業ディレクトリの実パスは伏せ、本稿では ~/<workspace> と表記) | 手元の実測 | 2026-09-13 |
| 権限設定の肥大化 | ~/.claude/settings.json | 手元の実測 | 2026-09-13 |
検証環境は次のとおりです。
| 項目 | 値 |
|---|---|
| OS | Ubuntu 系 Linux(カーネル 6.14 系、aarch64 / ARM64) |
| ハードウェア | DGX Spark(NVIDIA GB10) |
| GPU / VRAM | 該当なし。Claude Code はクラウド側で推論するため GPU に依存しません |
| Claude Code バージョン | claude --version の出力は 2.1.263 (Claude Code)(2026-09-13 訂正時に実行して確認)。~/.local/share/claude/versions/ には 2.1.251 / 2.1.260 / 2.1.263 が残る |
| 棚卸し対象 | ~/<workspace> 配下のプロジェクト CLAUDE.md 31本+祖先1本 |
| 検証日 | 2026-09-13 |
この記事で実測したのは既存の CLAUDE.md 31本と設定ファイルの棚卸しです。インストールからコミットまでの手順は公式資料との照合で、通しの動作検証はしていません。
バージョンについて正直に書きます。執筆時は本稿を書いた環境でシェルを実行できず、claude --version の出力そのものは貼れませんでした。代わりにネイティブインストーラがバージョンごとに作るディレクトリを直接見ています。公式は claude --version が 2.1.211 (Claude Code) のような形で出ると説明しています。
GPU 非依存である点は誤解が多いので明記します。ローカル LLM を動かす話ではないので、VRAM の要件はありません。公式のハードウェア要件は「4 GB 以上の RAM、x64 または ARM64 プロセッサ」だけです。
2. Claude Code とは(3分で)
Claude Code は、コードベースを読み、ファイルを編集し、コマンドを実行する agentic coding ツールです。ターミナル、VS Code / Cursor 拡張、デスクトップアプリ、Web、JetBrains プラグインの5サーフェスで動き、どれも同じエンジンに接続します。そのため CLAUDE.md や設定、MCP サーバーはサーフェスをまたいで共通に効きます(概要)。
チャット版の Claude との違いは、ファイルとコマンドへの到達手段を持っているかどうかです。チャット版の Claude もファイルのアップロードやプロジェクトの資料を参照できます。違いは、開発環境の中でファイルを探して読み、編集し、コマンドを実行し、git commit まで連続して行える点です。
プランは必要です。公式は「Pro、Max、Team、Enterprise、または Console アカウントが必要」とし、「無料の Claude.ai プランには Claude Code アクセスは含まれていません」と明記しています。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry 経由でも使えます。
3. できること・できないこと
公式が挙げる用途は、テスト作成、リントエラー修正、マージコンフリクト解決、依存関係更新、リリースノート作成、そして機能実装とバグ修正です。git 操作も会話で回せます。
できないこと・向かないことも書いておきます。CLAUDE.md の指示は強制力を持ちません。公式は「Claude はこれらをコンテキストとして扱い、強制的な設定ではありません。アクションをブロックするには、Claude の判断に関わらず PreToolUse hook を使用してください」と書いています。つまり「絶対に X するな」と書いても、確率的に守られるだけです。確実に止めたいものは hook か permissions.deny で止めます。
他ツールとの比較は本記事の範囲外です。Codex CLI や Gemini CLI との違いは Claude Code vs Codex CLI vs Gemini CLI の比較記事にまとめてあります。
4. インストールとログイン
ステップ1: インストールする
macOS / Linux / WSL:
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
Windows CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Homebrew、WinGet、apt / dnf / apk、npm も使えます。Homebrew の cask は2種類あり、claude-code が安定チャネル(約1週間遅れ)、claude-code@latest が最新チャネルです。ネイティブインストールと npm グローバルインストールはバックグラウンドで自動更新され、Homebrew・WinGet・Linux パッケージマネージャーは手動更新になります(Homebrew と WinGet は CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 でオプトインできます)(高度なセットアップ 2026-09-13確認)。
ステップ2: 入ったことを確認する
claude --version
成功していれば 2.1.211 (Claude Code) のようにバージョン番号と (Claude Code) が出ます。もっと詳しく見るなら claude doctor が、インストールの正常性と設定ファイルの検証エラーを読み取り専用で出します。
ステップ3: プロジェクトで起動してログインする
cd /path/to/your/project
claude
初回はブラウザが開いて認証を求められます。ANTHROPIC_API_KEY を設定済みなら、ブラウザではなくキーを承認するプロンプトが1回出ます。起動後の画面上部にはバージョン・現在のモデル・作業ディレクトリが表示されます。アカウントを切り替えるときはセッション内で /login です。
OS 別の注意点
Windows はネイティブと WSL で挙動が分かれます。公式の表によると、サンドボックスが使えるのは WSL 2 だけで、ネイティブ Windows と WSL 1 はサポート対象外です。ネイティブ Windows で Git for Windows が入っていない場合、シェルツールは Bash ではなく PowerShell になります。
Alpine など musl 系は素の手順では失敗します。公式が明記しているとおり、Alpine は既定で bash と curl を含まないため、記載どおりのインストールコマンドが not found で落ちます。先に依存を入れます。
apk add bash curl libgcc libstdc++ ripgrep
そのうえで settings.json の env に USE_BUILTIN_RIPGREP を "0" で設定します。
5. 最初のセッション:指示の出し方
公式クイックスタートが例示している順番は、「コードベースを理解させる → 小さな変更をさせる → git を触らせる」です。最初に打つ3つはこれで足ります。
what does this project do?
where is the main entry point?
add a hello world function to the main file
3つ目でファイル編集が走ります。Pro / Max / Team のインタラクティブセッションでは Auto モードが既定で、分類器が代わりにアクションを審査するため、ほとんどの編集は確認なしに進みます。それ以外のプランでは Manual モードが既定です。Shift+Tab でいつでも権限モードを切り替えられます。
粒度のコツは公式が1行でまとめています。「バグを修正してください」ではなく「ユーザーが間違った認証情報を入力した後に空白の画面が表示されるログインバグを修正してください」と書く、という対比です。複雑なものは箇条書きで手順に割ってから渡します。
覚えるコマンドは最初は3つで足ります。/clear(会話履歴をクリア)、/help(コマンド一覧)、/exit(終了)です。
6. CLAUDE.md を書く
CLAUDE.md はセッション開始時に読み込まれるマークダウンで、置き場所ごとにスコープが決まります。
| スコープ | 場所 | 共有対象 |
|---|---|---|
| 管理ポリシー | Linux / WSL は /etc/claude-code/CLAUDE.md、macOS は /Library/Application Support/ClaudeCode/CLAUDE.md | 組織の全ユーザー |
| ユーザー指示 | ~/.claude/CLAUDE.md | 自分の全プロジェクト |
| プロジェクト指示 | ./CLAUDE.md または ./.claude/CLAUDE.md | git 経由でチーム |
| ローカル指示 | ./CLAUDE.local.md | 自分のみ・.gitignore 推奨 |
最初の1本は /init で作れます。Claude がコードベースを解析し、ビルドコマンド・テスト手順・規約を含むファイルを生成します。既に CLAUDE.md があれば上書きせず改善提案に切り替わります。
書く内容は公式が具体例で線を引いています。「コードを適切にフォーマットする」ではなく「2スペースのインデントを使用する」、「変更をテストする」ではなく「コミット前に npm test を実行する」です。検証できる粒度まで下ろす、というのが基準です。
逆に、複数ステップの手順やコードベースの一部にしか関係しない内容は CLAUDE.md に置かず、skill か .claude/rules/ のパススコープルールへ移します。ルールは paths フロントマターで対象を絞れます。
---
paths:
- "src/api/**/*.ts"
---
そして重要なのが読み込み順です。Claude Code は作業ディレクトリからディレクトリツリーを上へ歩き、途中の各ディレクトリの CLAUDE.md を全部読みます。上書きではなく連結です。この挙動が、次の実測で効いてきます。
7. 実測:CLAUDE.md 31本の棚卸し
~/<workspace> 配下でプロジェクトルートに CLAUDE.md を持つリポジトリは31本ありました。全ファイルの行数を数えた結果が次のとおりです(2026-09-13 訂正時に wc -l で再計測、空行を含む物理行数)。
| 指標 | 値 |
|---|---|
| 本数 | 31 |
| 合計行数 | 2,355 |
| 平均 | 76.0 行 |
| 中央値 | 41 行 |
| 標準偏差 | 80.7 行 |
| 最小 | 17 行 |
| 最大 | 423 行 |
| 200行超 | 2本(6.5%) |
平均と標準偏差の定義は次のとおりです。
$$ \bar{x} = \frac{1}{n}\sum_{i=1}^{n} x_i = \frac{2355}{31} \approx 76.0, \qquad \sigma = \sqrt{\frac{1}{n}\sum_{i=1}^{n}(x_i - \bar{x})^2} \approx 80.7 $$標準偏差が平均を上回っています。行数は0未満にならないので、これは右に長い裾を示唆しますが、それだけで分布の形は決まりません。根拠はヒストグラムと、最大423行という観測値のほうです。実際、1本の外れ値が全体を引っ張る形になりました。
| 行数帯 | 本数 | 分布 |
|---|---|---|
| 1〜49 | 17 | █████████████████ |
| 50〜99 | 7 | ███████ |
| 100〜149 | 2 | ██ |
| 150〜199 | 3 | ███ |
| 200〜249 | 1 | █ |
| 250〜399 | 0 | |
| 400〜449 | 1 | █ |
31本中17本、つまり過半数が50行未満です。最大の423行は1本で全体の18.0%を占めます。
記載カテゴリの内訳
31本の中身を読んで、扱っている項目を分類しました。判定基準は「見出しまたは箇条書きで明示的に扱っているか」です。
| 記載カテゴリ | 該当本数 | 割合 |
|---|---|---|
| 実行コマンド(起動・生成・テスト) | 26 | 83.9% |
| ドキュメント等のファイル命名規則 | 25 | 80.6% |
| してはいけない操作の明示 | 21 | 67.7% |
| git 運用(push 可否・コミット規約) | 20 | 64.5% |
| 仮想環境の必須指定 | 14 | 45.2% |
| 秘密情報・外部送信の扱い | 14 | 45.2% |
| 確認を取る/取らないの粒度 | 12 | 38.7% |
上位2つが「コマンド」と「命名規則」である点は、公式が挙げる用途(ビルドコマンド、規約、プロジェクトレイアウト)とほぼ一致しました。一方で4割弱に「どこまで確認なしで進めてよいか」の記述があるのは、公式ドキュメントの推奨項目には出てこない実務由来の項目です。
単一ファイルの行数と、同時に読み込まれる合計は別の指標
ここが本稿でいちばん言いたい点です。公式の目安は「CLAUDE.md ファイルあたり200行以下」であり、単位は1ファイルです。ところが実際にコンテキストへ載るのは、ツリーを遡って見つかった全ファイルの連結です。
手元では ~/<workspace>/CLAUDE.md という祖先ファイルが95行あり、その配下にある各リポジトリで自動的に読み込まれます。棚卸し対象である「CLAUDE.md を置いている31リポジトリ」も、すべてこの祖先の下にあります(Claude があなたのプロジェクトを記憶する方法 2026-09-13確認)。各リポジトリの CLAUDE.md と祖先を足した合計行数を $y_i = x_i + 95$ とします。これは筆者独自の参考指標です。確認した2ファイルの物理行数の合計であり、@path インポートや自動メモリを含むコンテキスト総量ではありません。この合計で見ると平均は171.0行になり、200行を超える組み合わせは2本から6本(19.4%)へ増えます(104行の1本は199行で境界上です)。ファイル単位の長さに加えて、同時に読み込まれる指示の合計も確認する、というのがこの数字から言えることです。
200行を超えた2本は何で膨らんだか
400行超のリポジトリを読むと、内訳の多くが日付つきの障害記録でした。たとえば「複数件の並列処理は『単一ライタープロトコル』で行う(2026-07-24 恒久対策)」のような引用ブロックが、当時の原因分析と恒久対策をそのまま抱えています。指示ではなく経緯の記録です。200行規模のもう1本は、関数名や正規表現の変数名まで含む実装メモで、コードを読めば分かる内容が大半でした。
公式もこの傾向を想定しています。/doctor のチェックアップは「Claude がコードベースから導き出せるコンテンツ(ディレクトリレイアウト、依存関係リスト、アーキテクチャの概要など)を削除し、ツールのデフォルトと異なるピットフォール、根拠、および規約を保持する」トリムを提案します。手元の2本はまさにその対象です。
公式の規定と手元の運用のずれ
| 公式が書いていること | 手元で実際どうなったか | 差が出た理由 |
|---|---|---|
CLAUDE.md は4スコープ(管理ポリシー / ユーザー / プロジェクト / ローカル) | 棚卸しした31本はいずれもプロジェクトスコープ。筆者が確認した範囲では ~/.claude/CLAUDE.md は使っておらず、管理ポリシーも未設定 | 個人の好みは自動メモリ ~/.claude/projects/<project>/memory/ に寄せているため |
.claude/rules/ の paths: で指示をファイル種別ごとにスコープできる | 棚卸しした31本では該当ディレクトリを確認できなかった | 中央値41行の規模では分割の必要が生じていない |
/init が初版を生成し、そこから改善する | 31本は初版の面影がなく、セッション中の追記が積層している | 追記する仕組みはあるが、削る仕組みが運用に組み込まれていない |
AGENTS.md があれば @AGENTS.md でインポートする | 筆者が確認した範囲では AGENTS.md を置いているリポジトリは見当たらず、代わりに祖先の CLAUDE.md が共通レイヤになっている | ディレクトリ階層の自動読み込みで用が足りてしまった |
付録: 31本の行数一覧(元データ)
再検証できるように、匿名 ID 付きで元データを載せます。数え方は wc -l(改行の数=空行を含む物理行数)で、対象は ~/<workspace> 直下のディレクトリのうちルートに CLAUDE.md を持つ31本、祖先は ~/<workspace>/CLAUDE.md(95行)です。2026-09-13 の訂正時に再計測した値で、執筆時の集計(合計2,385・中央値42・祖先込み7本)は同じファイルから再現できなかったため、この表の値に差し替えました。
| ID | 行数 | ID | 行数 | ID | 行数 |
|---|---|---|---|---|---|
| R01 | 17 | R12 | 32 | R23 | 90 |
| R02 | 17 | R13 | 33 | R24 | 91 |
| R03 | 20 | R14 | 33 | R25 | 104 |
| R04 | 22 | R15 | 38 | R26 | 123 |
| R05 | 23 | R16 | 41 | R27 | 153 |
| R06 | 26 | R17 | 45 | R28 | 165 |
| R07 | 29 | R18 | 50 | R29 | 165 |
| R08 | 29 | R19 | 57 | R30 | 208 |
| R09 | 31 | R20 | 68 | R31 | 423 |
| R10 | 32 | R21 | 73 | ||
| R11 | 32 | R22 | 85 |
8. つまずいた箇所と対処
公式ドキュメントに記載のあるエラーと、手元で実際に踏んだものを分けて並べます。
| 症状 | 原因 | 対処 |
|---|---|---|
claude: command not found | PATH が通っていない、または別インストールが残っている | まず新しいターミナルを開き直し、~/.local/bin が PATH に入っているかを確認する(手順は公式トラブルシュートの Verify your PATH)。claude --version が通るようになってから claude doctor と競合インストールの確認へ進む |
syntax error near unexpected token '<' / 403 | インストールコマンドの取得に失敗している | インストールのトラブルシューティングでエラーを照合し、代替方法へ切り替える |
The token '&&' is not a valid statement separator | CMD 用コマンド(&& でつないだもの)を PowerShell で実行している(Windows PowerShell は && を文の区切りとして解釈しない) | プロンプトが PS C:\ なら PowerShell 用の irm … | iex、C:\ なら CMD 用に替える。逆に PowerShell 用を CMD で打つと irm が認識されないエラーになる |
Alpine で not found | bash と curl が既定で入っていない | apk add bash curl libgcc libstdc++ ripgrep を先に実行する |
apt update が NO_PUBKEY BAA929FF1A7ECACE | 署名キーのダウンロードに失敗している | キーを取り直し、gpg --show-keys で指紋が 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE と一致することを確認する |
npm で EBADENGINE 警告 | Node.js が 22 未満 | 警告のままでもバイナリは動くが、Node.js 22 以上への更新を推奨 |
| 権限確認が出っぱなし | Manual モードで動いている | Shift+Tab でモードを切り替える。恒久化は設定側で行う |
| 指示を途中で忘れる | ネストした CLAUDE.md やパススコープルールが再読み込みされていない | /context で Memory files を確認する。プロジェクトルートの CLAUDE.md は圧縮後に再注入される |
手元で実際に踏んだのは次の2つです。1つ目はバージョンの確定です。執筆時はシェルを実行できない環境だったため ~/.local/share/claude/versions/ の最大番号から 2.1.263 と推定しましたが、保存されている最大の版と実際に起動する版は一致するとは限りません。訂正時に claude --version を実行し、2.1.263 (Claude Code) と一致することを確認しました。確定は --version で行うべきです。2つ目は .claude/rules/ を探したら1つも無かったことです。指示が効かないと感じたときに真っ先に疑うべきは、設定していないはずのファイルではなく、祖先ディレクトリから勝手に載っているファイルのほうでした。
9. 料金と使用量の見かた
プラン表と自分の消費は別物です。見るのは /usage です。
セッションブロックには、そのセッションのトークン統計が出ます。
Total cost: $0.55
Total duration (API): 6m 20s
Total code changes: 0 lines added, 0 lines removed
この数値はローカル計算の推定値で、/clear でリセットされます。サブスクリプション契約なら請求とは無関係で、代わりに同じ画面のプラン使用量バーを見ます。
プラン使用量の内訳では3種類が見えます。スキル・サブエージェント・プラグイン・MCP サーバーごとの属性、長いコンテキストやキャッシュミスのように最近の使用量の10%以上を占める動作フラグ、そして負荷の高い /loop などのループの行です。d と w で24時間と7日間を切り替えます。
長時間セッションで消費が伸びる理由も公式が明示しています。Claude Code は毎リクエストで会話全体を送るため、開きっぱなしのセッションでは1行の質問でも会話全体ぶんの使用量が発生します。さらにキャッシュライフタイムを超えて放置すると、次のメッセージがキャッシュミスして全コンテキストを再処理します。ライフタイムはサブスクリプションで1時間、使用クレジット利用中は5分、API キーやクラウドプロバイダーでは既定5分です。
金額の目安として、公式はエンタープライズ展開での平均を「開発者1人あたり1日約13ドル、月額150〜250ドル」とし、「90%のユーザーの1日あたりのコストは30ドル以下」と書いています。これは API 従量課金を含む展開全体の数値で、個人のサブスク契約にそのまま当てはまるものではありません。アイドル時のバックグラウンド消費は「通常はセッションあたり0.04ドル未満」とされています。
削減策で効くのは、関係ないタスクに移るとき /clear を打つこと、タスクに合わせて /model を切り替えること、CLAUDE.md の詳細手順を skill へ移すことの3つです。3つ目について公式は「CLAUDE.md を200行以下に保つことを目指し、必須のみを含めます」と書いています。
10. 権限とセキュリティ
「勝手にファイルを消さないか」「コードが外に出ないか」は分けて考えます。
ファイル操作は権限モードと設定で制御します。技術的に止めたいものは CLAUDE.md ではなく permissions.deny、サンドボックス分離は sandbox.enabled です。公式は「設定ルールはクライアントによって強制され、Claude が何をするかに関係なく」効くと書いており、CLAUDE.md の指示とは別レイヤだと明言しています。
「コードが外に出ないか」は、推論のための送信と、学習への利用に分けて考えます。Claude Code はローカルで動きますが、プロンプトとモデル出力(読み込んだコードを含む)は TLS で暗号化して Anthropic へ送られます。学習への利用は契約で異なります。個人プラン(Free / Pro / Max)は claude.ai の設定がオンなら Claude Code の利用分も学習に使われ、設定は claude.ai/settings/data-privacy-controls で変えられます。Team / Enterprise / API などの商用契約では、明示的に提供を選ばない限り学習に使われません。保持期間は個人プランで学習許可ありなら5年・なしなら30日、商用契約は標準30日です。ローカルにもセッション記録が ~/.claude/projects/ に既定30日残ります(Claude Code Docs「Data usage」 2026-09-13確認)。
外部インポートには承認ダイアログがあります。プロジェクトの CLAUDE.md がワーキングディレクトリ外へ解決されるパスをインポートしていると、初回にファイル一覧つきの確認が出ます。共有リポジトリに他人がコミットしたファイルから守るための仕組みです。
ここで手元の実測を1つ。~/.claude/settings.json の permissions.allow は336件まで膨らんでいました。additionalDirectories は12件、deny は0件、hook の記述はありません。中には Bash(sudo mv:*)、Bash(sudo chown:*)、Bash(git push:*) のような広い許可も混ざっています。権限プロンプトの選択肢には、その場だけの許可、セッション中だけの許可、恒久保存される「今後確認しない」があります。恒久保存分は通常、リポジトリの .claude/settings.local.json に書かれます(Bash はリポジトリとコマンドごとに恒久、ファイル編集はセッション終了まで。Claude Code Docs「Configure permissions」 2026-09-13確認)。手元の336件はユーザー設定側に書かれたもので、どの経路で増えたかは記録していません。ただ、恒久許可を減らす仕組みは自分で回すしかない点は同じです。定期的に読み返す運用がないなら、危ないものは deny 側に明示して打ち消すべきです。
フックが攻撃経路になった実例もあります。npm パッケージ乗っ取りで .claude/settings.json に SessionStart フックが仕込まれた事案を別記事で扱っています。設定ファイルは実行可能な資産だと考えてください。
11. ケース別の使い方
- コードベースの把握: 新しいリポジトリで
what does this project do?とexplain the folder structureを投げる。手動でコンテキストを足す必要はなく、必要なファイルは自分で読みます - コミットと PR:
commit my changes with a descriptive messageのように日本語でも英語でも指示できます。ブランチ作成やコンフリクト解消も会話で進みます - コードレビュー: 変更差分に対して観点を指定してレビューさせる使い方です。マルチエージェントで走らせる仕組みについてはコードレビュー機能の記事を参照してください
- スクリプトから呼ぶ:
tail -200 app.log | claude -p "summarize the anomalies"のようにパイプで渡せます。CI で回す用途はこの形になります
12. よくある質問
無料プランで使えますか
使えません。公式は「無料の Claude.ai プランには Claude Code アクセスは含まれていません」と明記しています。Pro、Max、Team、Enterprise、Console のいずれか、または Bedrock などのクラウドプロバイダー経由が必要です。
Windows ネイティブと WSL、どちらを選ぶべきですか
サンドボックスを使いたいなら WSL 2 一択です。公式の表では、ネイティブ Windows と WSL 1 はサンドボックス非対応とされています。Windows ネイティブのプロジェクトとツールを扱うならネイティブでよく、その場合は Git for Windows を入れると Bash ツールが有効になります。
CLAUDE.md が200行を超えたらどうしますか
3つの選択肢があります。パススコープルールへ分割する、常時は不要な内容を skill へ移す、コードから導けるコンテンツを削る、です。@path でのインポートは整理には役立ちますが、インポート先も起動時に読み込まれるためコンテキストは減りません。手元の423行の例では、削るべきは障害の経緯記録でした。
AGENTS.md を使っているリポジトリではどうしますか
Claude Code は AGENTS.md を読みません。CLAUDE.md を作って先頭に @AGENTS.md と書き、その下に Claude 固有の指示を足すのが公式の推奨です。シンボリックリンクでも動きますが、Windows では管理者権限か開発者モードが必要なためインポート記法が無難です。
13. 後片付け・アンインストール
macOS / Linux / WSL のネイティブインストールの削除は2行です。
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
Homebrew は brew uninstall --cask claude-code、WinGet は winget uninstall Anthropic.ClaudeCode、npm は npm uninstall -g @anthropic-ai/claude-code です。設定とセッション履歴まで消すなら ~/.claude と ~/.claude.json も削除しますが、VS Code 拡張やデスクトップアプリが残っていると次回起動時に再作成されます。Windows ネイティブ版の削除手順は公式セットアップのアンインストール節を参照してください。
14. まとめ
- インストールから
CLAUDE.mdの初版整備までは8手。macOS / Linux / WSL はcurl -fsSL https://claude.ai/install.sh | bashの1行で入ります CLAUDE.mdは「検証できる粒度」で書きます。公式の目安は1ファイル200行以下です- 手元31本の実測は中央値41行・平均76.0行。単一ファイルで200行を超えたのは2本でした
- ただし祖先ディレクトリの
CLAUDE.mdが連結されるため、祖先の95行を足した合計では6本(19.4%)が200行を超えます(筆者独自の参考指標です)。ファイル単位の長さに加えて、同時に読み込まれる指示の合計も確認する運用が必要です - 膨らんだファイルの中身は障害の経緯記録と実装メモでした。追記の仕組みはあっても、削る仕組みは自分で作る必要があります
- 恒久許可は自動では減りません。手元の
allowは336件、denyは0件でした
2026-09-13 訂正: 外部レビューを受け、§7 の実測値を wc -l で再計測した値に差し替え(合計 2,385→2,355、中央値 42→41、祖先込み 200 行超 7→6 本)、§8 の && エラーの原因の向き、command not found の対処順、§2 のチャット版の説明、§10 のデータ送信・学習利用の説明を修正しました。
15. 関連記事
- Claude Code vs Codex CLI vs Gemini CLI──2026年4月版AIコーディングエージェント徹底比較 — 他ツールとの比較で迷っている場合はこちら
- 署名は正規のままマルウェアが通った──keyv乗っ取りで.claude/settings.jsonにSessionStartフックが仕込まれた4時間 — 設定ファイルが攻撃経路になった実例
- AnthropicがAIコードレビュー機能を発表:Claude Codeがもたらす開発革命 — レビュー用途での使い方