同じ Claude Code でも、使う人によって結果がまったく違います。
5 時間の制限をあっという間に使い切る人もいれば、余裕だと感じる人もいます。
--> その差は、設定と習慣にあります。
⭐️ ここでは、Claude Code の正しい使い方 12 選を紹介します。 ⭐️
すべてのコマンドとプロンプトを載せているので、そのままコピー＆ペーストして使えます。
--> 一気に読むには少し長いので……まずはブックマークしておくのがおすすめです！
⚠️ 始める前に… バージョンを確認してください ⚠️
この記事で紹介する機能のほとんどは、ここ数ヶ月でリリースされたものです。バージョンが古いとコマンドが動きません。
ターミナルで claude --version を実行して確認し、古ければ claude update を叩くだけです。
本記事のコマンドは、10 月 18 日時点の v2.1.302 に基づいています。
1. サブエージェントごとに Effort（思考深度）を変える
Effort は、回答前に Claude がどれだけ深く考えるかを決める設定です。low、medium、high、xhigh、max から選べますが、使える段階はモデルによって少し異なります。
「高いほど良い」と思い込んで、無条件に Max や XHigh にしている人が多いです。
でも、それは必ずしも正しくありません。
比較のために同じアプリを作らせたところ、Max では 79 分かかりましたが、他の Effort では 16 分で終わりました。
結果はほぼ同じでした。余計な時間とトークンを消費しているだけです。
私の経験からまとめると、こうなります。
--> （核心）🔥 詳細なプロンプトを書けるなら、low でも max でも最終的な結果はだいたい同じになります。 🔥
--> ブレインストーミングでは、むしろ low や medium の方がうまくいきました。
ただし、難しい設計や厄介なバグ、重要なレビューでは、高い Effort が必要なこともあります。
ポイントは「常に low にする」ことではありません。
10 月 7 日から… サブエージェント呼び出し時に Effort を指定可能に！
10 月 7 日のアップデート（v2.1.292）以降、メインの Claude Code からサブエージェントを呼ぶときに Effort を指定できるようになりました。
こんな指示が出せます。
現在のタスクを 3 つの段階に分け、サブエージェントで進めてください。
1. ファイルの場所探しとデータ整理は low effort で
2. 修正方針のメリット・デメリットのレビューは medium effort で
3. 最終コードのバグ発見レビューは high effort で
各サブエージェントに実際にどの effort を与えたかを表示し、
結論と根拠となるファイルパスだけをメインエージェントに返してください。
毎回指示するのが面倒なら、エージェントをファイルとして保存しましょう。
--> たとえば、プロジェクトの .claude/agents/ フォルダに light-research.md として保存します。
name: light-research
description: 関連ファイルと根拠の場所を探すだけの軽い調査
model: haiku
effort: low
呼び出しごとに指定する方法（上のプロンプト）と、ファイルで固定する方法、どちらも使えます！
2. コンテキスト管理とトークン浪費の防止
🤪 Claude Code が急に頭が悪くなる原因は、たいていコンテキストです。
コンテキストとは、Claude が一度に記憶できる作業領域のこと。会話、読み込んだファイル、コマンドの実行結果がすべてここに溜まっていきます。
--> 最近の Claude Code は「デフォルト」で 1M（100 万トークン）のコンテキストを持っています。
問題は、この 1M を完全に埋め尽くしてしまうことです。
これは Claude だけでなく、Codex などあらゆる LLM に共通する限界です。
⭐️ コツ：autocompact を 500〜700k に設定する ⭐️
そこで、自動圧縮のしきい値を前倒しします。
/autocompact 600k
これで、自動圧縮に使われるウィンドウサイズが 600k トークンに減ります。
1M を埋める前に、Claude が会話を要約して自動的に空き容量を作ってくれます。
（デフォルトに戻すには `/autocompact auto` と入力します。）
⚠️ もう一つ注意すべき点：キャッシュの有効期限 ⚠️
1 つのセッションを長く使う場合は、必ず確認してください。
Claude Code はリクエストごとに過去の会話全体を送信し直します。処理済み部分は再計算されないキャッシュのおかげで、速くて安く済んでいます。
しかし、このキャッシュは永遠ではありません。
- Pro または Max プラン（プラン内利用）：メイン会話のキャッシュは 1 時間
- API キーまたは追加利用クレジット：5 分
- サブエージェント：サブスクリプション契約中でも 5 分
以前、画面上で約 852k が uncached（キャッシュなし）になっているのを見ました。この状態では、「continue」と 1 行送るだけでも約 85 万トークンをキャッシュなしで再処理する必要があり、使用量が一気に跳ね上がります。
キャッシュが切れるよくあるケース：
- 長時間放置した巨大なセッションを再開したとき
- セッション途中でモデルを切り替えたとき（キャッシュはモデルごとに独立しています）
- 接続している MCP ツールの設定を変更したとき
対策はシンプルです。
- 離席前に片付ける。キャッシュが生きているうちに `/compact` を使うか、`/clear` で新しく始めましょう。
- 最新版にアップデートする。v2.1.299 以降、200k トークンを超える会話は約 54 分のアイドル後、1 時間のキャッシュが切れる前に自動圧縮されます。（
/configの Idle compaction で無効化できます）
**
3. /doctor prompt-audit で古いガイドラインを一掃する
昔のアドバイスからコピペした CLAUDE.md。ミスをするたびに少しずつ足していったルール。
その多くは、古いモデル向けに書かれたものです。
新しいモデルは、古いモデルよりずっと的確に指示に従います。
⚠️ そのため、かつて「絶対に！！」「決してするな！！」と強調する必要があったルールが、今は過剰に働きすぎているかもしれません。⚠️
現在のコードや他のルールと矛盾するものも溜まっています。
今なら、1 つのコマンドでチェックできます。
1/doctor prompt-audit
9 月下旬のアップデート（v2.1.283）で追加された機能です。
何をチェックするのか？
- プロジェクトおよび親フォルダにある CLAUDE.md、CLAUDE.local.md、AGENTS.md
- ~/.claude/CLAUDE.md（全プロジェクトに適用される自分用のガイドライン）
- .claude/ 内のルール、スキル、カスタムコマンド、サブエージェント定義、出力スタイル
プラグインのスキルやエージェントについては報告のみで、修正提案は行いません。
基準は現在使っているモデルに基づきます。そのモデルにとって古いプロンプトパターンを見つけ出し、修正提案付きのレポートを作成します。
（設定ファイルや .mcp.json など、キーが含まれそうなファイルは読み込みません。）
4. 同じミスを繰り返すときは「作業環境」を直す
⛏️ また AI がめちゃくちゃにしている。1 つの問題に何時間も悩まされている。 ⛏️
同じことを 3 回も指摘しているなら、モデルのせいではなく作業環境のせいです。
私はこの方法を Claude Sonnet 3.7 の時代から 1 年以上使っています。 ざっくり説明すると…
--> 失敗したセッションを AI に分析させ、その原因をプロジェクトのガイドラインと検証方法に反映させる。
⭐️ こうやってください！「Session ID を使ってミスを分析する」 ⭐️
1. ミスが繰り返されたセッションで `/status` と入力し、Session ID を取得してコピーします。
2. 新しい Claude Code セッション（Codex でも可）を開き、これを貼り付けます：
1"<Session ID>" → この Claude Code セッションで 2 回以上失敗した箇所を探して。23私が指摘したのに何度も間違え続けた点と、ボトルネックを特定して。45なぜ起きたのか（間違った前提、コンテキスト不足、コード構造、テスト不足）を分類し、67再発防止のために CLAUDE.md、.claude/rules、スキル、8フック、またはテストに対して行う最小限の修正だけを提案して。
3. 提案を確認し、良いものだけ適用します。
4. 効果を検証します。以前失敗したリクエストをやり直し、今度はうまくいくか確認します。
⚠️ すべてを CLAUDE.md に詰め込まないでください。⚠️
長くなるほどコンテキストを食いつぶし、ルール同士が衝突します！！！
- プロジェクト全体のルールは CLAUDE.md に
- 特定のフォルダ・ファイル向けのルールは .claude/rules/ またはそのフォルダ内の CLAUDE.md に
- 繰り返しの手順は Skills として
- 絶対守るべきルールは Hooks と権限で（コツ #10）
- 同じバグの再発はリグレッションテストで防ぐ
溜まったルールは、たまにコツ #3 の `/doctor prompt-audit` で掃除しましょう。コツ #4 で作り、コツ #3 で片付けます。
**
5. claude-mem でセッションをまたいで作業記憶を保つ
Claude Code はセッションが終わると会話を忘れてしまいます。
**「前回なぜこうしたんだっけ？」
「あのエラーはどうやって直したんだっけ？」**
新しいセッションごとに、また説明し直す必要があります。
私が 1 年間ずっと使い続けている唯一の Claude Code プラグインが、これを解決してくれます。
--> それが claude-mem です。
⭐️ GitHub スターは 10 万を超えています。 ⭐️
標準のメモリ機能と何が違うのか？
Claude Code には標準の Auto Memory があります。違いは次の通りです：
標準の Auto Memory は、Claude が重要だと判断した内容やプロジェクトからの学びをノートに要約します。/memory で確認でき、インストールは不要です。
一方 claude-mem は、過去のセッションでどんなタスクを行い、エラーをどう解決し、なぜその判断をしたのかを自動で記録します。そして次のセッションで必要な記録を引き出してくれます。
私の画面では、最大 87% のトークン節約が表示されました。
インストールはターミナルで 1 行です。
1npx claude-mem install
または、Claude Code 内でプラグインとしてインストールします。
1/plugin marketplace add thedotmack/claude-mem2/plugin install claude-mem
❌ おすすめしないケース ❌
- 主に Codex を使っている
- すでに別のメモリプラグインや独自の引き継ぎシステムがある
機能が重なるツールを追加すると、複雑さとコストが増します。
Claude Code だけを使うのであれば、強くおすすめします。
6. Statusline でモデル・Effort・コンテキスト・使用量を一目で把握する
Claude Code を使っていると、常にこんなことが気になります。
- このセッションは Opus？ Sonnet？ Haiku？
- Effort は何に設定されている？
- コンテキストはどれくらい埋まっている？
- 5 時間制限や週間制限の残りは？
🔥 Statusline を使えば、これらがターミナル下部に表示され続けます。 🔥
作り方は簡単です。`/statusline` の後に希望する形を説明すれば、Claude がスクリプトを生成して適用してくれます。
私が共有した 5 つのデザイン
以前、コピペで使える 5 つの statusline プロンプトを共有しました。
1. Minimal：モデル、effort、プロジェクト、コンテキストを 1 行で表示
2. Pastel Blocks：暗いターミナルに合うパステルカラーのハイライトブロック
3. Nord Powerline：セクション間を滑らかな矢印で区切るデザイン
4. Limit Dot Bar：Pro/Max 向け。5 時間・7 日間の使用量とリセットまでの時間をドットバーで表示
5. Vivid Gauge：ライム色のバッジと斜めのゲージ。コンテキストのトークン数も含む
完全なプロンプトは元の投稿にあります。コピペすれば、すぐに Claude が作ってくれます。
1. Minimal： https://x.com/lucian__03/status/2103173295118098750
2. Pastel Blocks： https://x.com/lucian__03/status/2103173396075065594
3. Nord Powerline： https://x.com/lucian__03/status/2103173518573916178
4. Limit Dot Bar： https://x.com/lucian__03/status/2103173612832444536
5. Vivid Gauge： https://x.com/lucian__03/status/2103173754218258607
7. Claude に直接実行・検証させる
Claude は「実装完了！」と言いますが、動かすと失敗します。ボタンが押せない、画面が崩れる、何も表示されない。
テストは通るのにアプリが動かないことは、想像以上に多いです。
そこで、Claude 自身にアプリを起動して操作させましょう。そのためのコマンドがあります。
- /run：実際にプロジェクトのアプリを起動し、操作して変更を検証します。
- /verify：アプリをビルド・実行し、変更した機能が動くか確認します。テストや型チェックで代用しません。
- /run-skill-generator：このプロジェクトの実行方法（コマンド、環境変数、準備手順）をスキルとして保存します。複雑なプロジェクトでは最初にやりましょう。
- /verify は検証方法をプロジェクトスキル（.claude/skills/verify/）として保存し、再利用できるようにします。
使い方の流れ：
1. 機能を実装し、まずテスト・ビルドを確認する
2. /run でアプリを起動する
3. Web ならクリックや入力、CLI ならサンプルの入出力を試す
4. /verify で目標達成を再確認する
5. 失敗したら修正して再実行。実際のコマンド結果やスクリーンショットを証拠として残す
8. コーディング用 AI とレビュー用 AI を分ける
自分の文章の誤字は気づきにくいものです。AI も同じです。
コーディング中のセッションは「これで合っている」というバイアスがかかっています。
⭐️ だから、まっさらなコンテキストを持つレビュアーを使いましょう。⭐️
- /code-review：変更されたコード、PR、ブランチ、パスのバグや正確性の問題を見つけます。
- /code-review high のように強度を指定できます（low 〜 max）。
（デフォルトは報告のみ。--fix を付けると自動修正します。）
- /security-review：ブランチとリモートのデフォルトブランチの差分について、セキュリティ問題（認証、入力検証、情報漏洩）をチェックします。
- /simplify：重複・非効率・複雑さを整理します。バグ発見用ではありません（それは /code-review の役割）。
おすすめの順番：
1. /simplify でコードを整理する
2. /verify で動作を検証する（コツ #7）
3. /code-review でバグを見つける
4. ログイン・決済・API キー・個人情報に触る場合は /security-review を追加する
毎回 4 つすべてを実行する必要はありません。
⚠️ 小さな修正なら /code-review だけで十分なこともあります。⚠️
より深いレビューが必要なら /code-review ultra（/ultrareview と同じ）を使います。
（クラウドベースの深掘りレビューで、Pro/Max は 3 回まで無料です。）
9. 複雑なコーディングの前に設計と完了条件を決める
複雑なタスクでは、長いコーディング指示ではなく、まず範囲と完了条件を伝えます。
これをしないと、Claude が勝手に範囲を広げてしまいます。
⚠️ 不要なファイルを修正したり、頼んでいない作業を始めたりします。⚠️
Plan Mode の使い方：
Shift+Tab を押すと plan mode on と表示されるか、/plan と入力します。/plan fix login bug のようにタスクを続けることもできます。
（Plan Mode はファイルを読み込んで計画を立てるだけです。承認後にコードを変更します。）
流れ：探索 → 計画 → 承認 → 実装 → 検証。
誤字修正や 1 行の変更なら計画はスキップして OK。公式ドキュメントのルール：1 文で説明できる変更なら plan は不要です。
10. 重要なルールは Hooks で自動的に強制する
CLAUDE.md に「このファイルは触るな」と書いても、Claude が触ってしまうことがあります。
🔥 CLAUDE.md はガイドライン、Hooks は強制力です。 🔥
よく使うトップ 3：
- PreToolUse：ファイル編集やコマンド実行の直前。保護対象ファイルの編集や危険なコマンドをブロックします。
- PostToolUse：実行直後。編集したファイルを自動フォーマット・lint します。
- Stop：Claude が終了しようとしたとき。テストが未完了なら停止を防ぎます。
例：本番設定ファイルの編集をブロックする
Hook の作成は Claude に頼みましょう。
--> 「config/production.env の編集をブロックする PreToolUse hook を作って。」
便利な活用例：
- コードファイル編集時にフォーマッターを自動実行（PostToolUse）
- 重要なフォルダに触る前に確認を求める（PreToolUse）
- テスト未実行なら停止をブロック（Stop）
- 危険なコマンドをブロック（PreToolUse + Bash）
11. Git Worktree で複数の Claude セッションを同時実行する
同じフォルダで 2 つの Claude ウィンドウを動かすとどうなるか？
🚫 同じファイルの編集で競合します。（かなり辛いです…） 🚫
Worktree は、リポジトリをタスクごとに別フォルダ・別ブランチへ分割します。
Claude Code なら 1 コマンドでできます。
2 つのターミナルでそれぞれ実行します。
claude --worktree feature-authclaude --worktree feature-dashboard
短い -w でも OK です。
.claude/worktrees/feature-auth/ が作成され、worktree-feature-auth ブランチで作業します。
--> ⭐️ 2 つのセッションが互いのファイルを触ることはありません。 ⭐️
注意点：
新しい worktree は現在のブランチではなく、リモートのデフォルト（main）から始まります。
claude --worktree "#1234" のように PR 番号を渡すと、その PR から始められます。
セッション終了時に、残った作業を保持するか削除するか尋ねられます。
⚠️ 注意事項：
- Worktree が分離するのはファイルとブランチだけです。ローカル DB、ポート、デプロイ先、API アカウントを共有していると競合します。
- 同じファイルを編集するとマージコンフリクトが起きる可能性があります。
- 密結合なタスクは、インターフェースを定義するか順序を決めましょう。
- 各セッションは個別に使用量を消費します。並列化＝トークン節約ではありません。
12. /goal で目標達成まで検証を繰り返す
Claude は 1 ターンで止まってしまいます。3 つのテストが失敗していても「ほぼ直りました」と言うことがあります。
- Goal は、完了条件を満たすまで Claude に作業を続けさせます（v2.1.139 以降）。
- /goal で現在の目標と状況を表示します。
- /goal clear で目標を解除・停止します。
仕組みは…
各ターンの後、小さくて高速なモデルが条件を満たしたか評価します。満たしていなければ、Claude は次のターンに進みます。
目標には検証方法を含めましょう（例：「テストコマンドと結果を出力する」）。判定モデルにも証拠が必要です。
/loop や Stop hook との違いは？
--> Goal は失敗するとすぐに次のターンを始めます。判定モデルが成功を確認した時点で止まります。
/loop は一定間隔でタスクを繰り返します（例：/loop 5m check deploy）。
Stop hook はターン終了時にカスタムスクリプトを実行して条件をチェックします。
組み合わせると最強です。
1. /plan で範囲と条件を決める（コツ #9）
2. claude -w でタスクを分割する（コツ #11）
3. Hooks でフォーマット・ブロックする（コツ #10）
4. /goal で条件を満たすまで反復する（コツ #12）
5. /run と /verify で確認する（コツ #7）
6. /code-review で新鮮なコンテキストからレビューする（コツ #8）
まとめ
1. タスクごとに Effort を変える。サブエージェントに任せる。
2. コンテキストを満杯にしない。キャッシュ期限に注意する。
3. /doctor prompt-audit で古い CLAUDE.md を掃除する。
4. ミスを繰り返すならモデルではなく環境を直す。
5. claude-mem でセッションをまたぐ記憶を持たせる。
6. statusline でモデル・Effort・コンテキスト・制限を監視する。
7. 「完了」という言葉だけでなく /run と /verify で検証する。
8. コーダーとレビュアーの AI を分ける。
9. 複雑なタスクは先に計画を立てる。
10. 重要なルールは Hooks で強制する。
11. worktree で並列化する。
12. /goal で成功するまで粘る。
Claude Code は急速にアップデートされています。新しいコツが見つかり次第、また共有します。
役に立ったらブックマークして、Claude Code を使っている友人にもシェアしてください。
読んでいただきありがとうございました！
参考にした過去の個別投稿：
サブエージェントの Effort： https://x.com/lucian__03/status/2108194703782916166
Effort、Max が常に最適とは限らない： https://x.com/lucian__03/status/2104641991279874134
autocompact 500〜700k： https://x.com/lucian__03/status/2108589402914177236
852k uncached とキャッシュ期限： https://x.com/lucian__03/status/2106396357527531800
/doctor prompt-audit： https://x.com/lucian__03/status/2104560017407869028
AI による自己改善（Harness アップデート）： https://x.com/lucian__03/status/2081761475560157477
claude-mem： https://x.com/lucian__03/status/2108997241864159442
5 つの statusline デザイン： https://x.com/lucian__03/status/2103173166973718537
