[AI書房] 第40章 Claude Code v2.1.86 完全リファレンス
Claude Code完全攻略
第10部
第40章 Claude Code v2.1.86 完全リファレンス
金京鎮
導入
前章では、Claude Code で何ができるかを十の事例を通じて解説しました。今章では、ツール自体を体系的に整理します。キーボードショートカットから始まり、コマンドライン方式の命令とフラグ、セッション内で使用するスラッシュコマンド、スキルとエージェントエコシステム、そしてこれらすべてが交差する上級者向けワークフローまで、順を追って概観します。基準バージョンは、2026年4月現在の v2.1.86 です。
一度通読すれば、全体の構造が頭に入ります。机の脇に広げておき、必要に応じて参照しても構いません。毎日使用する機能は十個を超えませんが、残りの機能があることを知っておけば、行き詰まった際に引き出せるカードが生まれます。
Claude Code 一目でわかる要約
Claude Code の構成は、大きく六つの要素に分かれます。キーボード、MCP、スラッシュコマンド、メモリ、ワークフロー、スキル/エージェント、そしてコマンドライン方式です。このうち、初めて入門する方が覚えるべきは、たった三つだけです。
Ctrl+C で生成を停止し、Ctrl+L で画面を整理し、/clear で会話を初期化します。
この三つがあればとりあえず始められます。残りは使いながら必要になった時点で一つずつ調べて覚えていけば大丈夫です。
六つの領域それぞれの核心を一行ずつ整理します。
キーボード操作:Ctrl+C で停止、Ctrl+L で画面整理、Ctrl+D で終了、Shift+Tab でモード切り替え、Alt+T で深層推論、特殊プレフィックスはスラッシュ (/)、感嘆符 (!)、アットマーク (@) の三つです。
MCP は外部ツール接続規格です。--transport オプションで http、stdio、sse の三つの接続方式をサポートし、管理範囲はローカル、プロジェクト、ユーザーの三層で構成されます。/mcp コマンドが管理 UI であり、Elicitation(対話形式のツール呼び出し)もサポートしています。
スラッシュコマンド:セッション内で入力するコマンドです。/clear、/compact、/resume で会話を管理し、/plan、/voice、/loop でモードを切り替え、/init でプロジェクトを初期化し、/memory で指示書を変更します。/btw、/rc、/schedule は v2.1 シリーズで新たに追加された、または強化されたコマンドです。
メモリ:CLAUDE.md がプロジェクト指示の本体であり、rules/*.md が詳細ルールです。@path 形式でファイルを呼び出し、memory フォルダには約 25KB の自動メモりが保存されます。
ワークフロー:Plan Mode でまず計画を立て、ultrathink で最強の思考モードを一度実行し、/batch でワークツリーを並列処理し、/compact でコンテキストを圧縮します。
設定ファイル:settings.json が動作設定の本体であり、ANTHROPIC_API_KEY 環境変数は必須です。managed-settings.d フォルダを設けると、管理者が配布した設定が適用され、hooks は条件付きで実行されるトリガーです。
スキル/エージェント:.claude/skills/ 内に SKILL.md を作成してカスタムスキルを定義します。内蔵エージェントは Explore、Plan、General、Bash の 4 種類で、initialPrompt と SendMessage は v2.1 シリーズの新機能です。
コマンドライン方式:claude -p で非対話型実行、claude -c で直前の対話を継続、--bare は最小限の実行、--channels は権限の継承、--permission-mode plan は計画モードの強制です。
これらすべてを一つの画面にまとめると、ターミナルに定着したアシスタントが、ショートカットキーで動き、スラッシュコマンドで作業を切り替え、MCP で外部ツールを呼び出し、スキルで専門知識を引き出し、コマンドライン方式で自動化パイプラインに接続される構造です。各機能は互いに重複せず、役割が明確に区別されています。ここからは一つずつ詳しく見ていきましょう。
キーボードショートカット
Claude Code はターミナル内で動作するツールであるため、キーボードショートカットがマウス操作に代わります。これを覚えておけば、手をキーボードから離さずにセッションを指揮できます。
一般的な制御は、Ctrl キーを組み合わせた 5 つのショートカットに整理されています。Ctrl+C は生成を停止します。Claude が間違った方向へコードを書き始めたり、ファイルを誤って読み込んでいたり、応答が長引いているのに必要な回答が既に得られている場合に即座に押します。押すと直ちに停止し、モデルが生成する文字の無駄がその時点で止まります。Ctrl+D はセッションを終了します。Ctrl+L は画面をきれいに整理します。
スクロールして過去の出力を確認するよりも、一度消して新しく始める方が速いです。Ctrl+O は会話履歴ビューアを開きます。以前共有した会話を再度確認したい場合や、Claude がどの段階でどのような判断を行ったか振り返りたい場合に使用します。
v2.1 シリーズでは、Ctrl+O の役割は一般詳細トランスクリプトの切り替えに限定され、フォーカスビューは別途 /focus コマンドに移動しました。Ctrl+B はバックグラウンド実行です。長時間かかる処理を裏で実行し、他の作業を続ける際に便利です。
モード切替は、Shift+Tab と Alt キーの組み合わせの三つに分かれています。Shift+Tab は、一般モードから自動承認モード、そして計画モードへと順次切り替えます。コードを素早く作成する際は自動承認モードに、設計が重要な作業の前には計画モードに切り替え、Claude に計画書のみを作成させます。Alt+P はモデル変更です。
Haiku、Sonnet、Opus の間を即座に切り替えることができます。軽い質問には Haiku を使用してコストを節約し、複雑なリファクタリングには Opus を使用します。Alt+T は深層推論(Thinking)の切り替えです。複雑な判断が必要な時にオンにし、単純なファイル修正時にはオフにします。Alt+O は高速応答モードのオンオフを切り替えます。
特殊接頭辞は三つだけです。スラッシュ(/)は内蔵スラッシュコマンドを呼び出します。感嘆符(!)はターミナルコマンドを直接実行します。コード内で「!ls -la」と入力すると、ファイル一覧が即座に表示されます。アットマーク(@)はファイルを呼び出して会話に含めます。「@src/auth.py このファイルをリファクタリングしてください」のように使用します。この三つの接頭辞が、ほぼすべての高度な対話への入口となります。
複数行の入力は、バックスラッシュ+Enter、またはCtrl+Jで行えます。長い指示を入力する際、Enterキーで即座に送信されるデフォルト動作を回避できます。
セッションセレクターには専用のキーが割り当てられています。上下矢印キーでリストを移動し、Pでプレビュー、Rで名前変更、スラッシュで検索、Bで現在のブランチのみをフィルタリングします。この画面は、claude --resumeを実行するか、/resumeと入力した際に表示されます。
会話履歴ビューアでは、Ctrl+Oでビューアを開き、スラッシュで検索(v2.1シリーズで新たに追加)、NまたはShift+Nで検索結果間を移動、Ctrl+Eで全体を展開、QまたはEscで閉じます。
ショートカットキーは覚えようとすればきりがありませんが、実際にはCtrl+C、Ctrl+L、Shift+Tab、Alt+Tの4つが全体の90%を占めています。残りは、行き詰まった際に思い出して使えば十分です。
コマンドライン方式の命令とフラグ
ターミナルで「claude」と入力すると対話モードが開始されます。ただし、このコマンドの後に何を追加するかによって、全く異なるツールとして機能します。
主要なコマンドは5つあります。
claude # 対話モードの開始 claude "質問" # 即座に質問して開始 claude -p "質問" # 非対話型実行(自動化用) claude -c # 最後の対話を継続 claude -r "セッション名" # セッション名で開く claude update # 最新バージョンに更新
このうち日常的に使用するのは「claude」と「claude -c」の2つです。自動化パイプラインを構築する際には「claude -p」が中心となります。-pはprintの略で、対話型UIを表示せず、結果のみを出力して終了します。シェルスクリプトに埋め込んだり、GitHub ActionsなどのCIで呼び出す際に必須です。
主要なフラグは2つのグループに分かれています。
実務でよく使われる基本フラグは約8つあります。
-w # Gitワークツリーの作成 -n, --name # セッション名の指定
高度なフラグはv2.1シリーズで多数追加されました。
実践的な組み合わせの例を3つ見ていただくと、イメージがつかめるでしょう。
claude -p「エラー分析をお願いします」--model claude-haiku-4-5 --output-format json
claude --permission-mode plan --add-dir ./src
cat error.log | claude -p「原因を探して」--max-budget-usd 1
3 つ目の例は特に面白いです。UNIX のパイプを1 行使うだけでログ分析の結果を受け取ることができ、1 ドル以内で回答できない場合は自動的に停止します。このような組み合わせが可能であることが、コマンドラインツールの威力です。
スラッシュコマンド完全ガイド
セッション内でスラッシュ (/) を入力すると、内蔵コマンドの一覧が表示されます。スラッシュのみを入力しても自動補完リストが表示されるため、コマンド名を覚えていなくても検索できます。すべてのコマンドは4 つのカテゴリーに分類されています。
セッション管理は8つのコマンドで構成されています。
/clear # 会話の初期化(コンテキストのクリア) /compact # 会話の圧縮(コンテキストが60%以上埋まった場合) /resume # 以前のセッションを再開 /rename # セッション名の指定 /branch # 会話の分岐 /cost # モデルが計算するトークン単価の確認 /rewind # 過去の会話地点へ戻す /export # エクスポート
/clearは作業内容が変わる際に使用します。議事録の整理からコードレビューへ移行する場合、以前の会話内容が残っていると邪魔になるためです。/clearで初期化し、新たに開始します。/compactは、一つのセッションで長時間作業する際に使用する圧縮機能です。コンテキストがいっぱいになるタイミングで自動的に作動することもありますが、明示的に呼び出して「この情報だけを残して圧縮してください」と指示することも可能です。
/rewindは間違った方向へ進んでしまった会話を、以前の地点まで戻します。/branchは、一つの会話から複数の分岐を作って実験を行う際に便利です。「この方法で試してみて、気に入らなければ元に戻す」という実験的な探索に用います。
設定関連のコマンドは8つあります。
/config # 設定画面を開く /model # モデルを切り替える /fast # 高速モードのオン/オフ /effort # 品質(努力)を調整する /theme # テーマを変更する /permissions # 権限を管理する /keybindings # ショートカットキーを設定する
/effort は、コマンドラインの --effort と同じ役割をセッション内で果たすコマンドです。現在の作業の難易度に合わせて努力レベルを変更します。/permissions は権限管理の UI です。どのツールを許可し、どのコマンドは毎回確認するか、どのコマンドは絶対に許可しないかを細かく設定できます。
「git commit は自動許可、rm -rf は拒否、ネットワークリクエストは毎回確認」のようなルールをここで作成します。
ツール管理コマンドは全部で八つあります。
/init # CLAUDE.md の生成 /memory # ガイドラインの編集 /mcp # MCP 接続サーバーの管理 /hooks # フックの設定 /skills # スキル一覧の表示 /agents # エージェントの管理 /add-dir # 作業フォルダの追加
/init は、新しいプロジェクトを開始する際に最初に実行するコマンドです。Claude が現在のフォルダの構造を分析し、CLAUDE.md の草案を自動的に生成します。このファイルはプロジェクトのガイドラインとなり、以降のセッションでは毎回自動的に読み込まれます。/memory は、このガイドラインを編集するためのインターフェースです。
「このプロジェクトでは Python 3.12 を使用する」「PEP 8 を厳格に遵守する」「検証カバレッジは 80% 以上を維持する」といったルールをここに記載します。
/mcp は、MCP 接続サーバーを管理する画面です。どのサーバーが接続されており、各サーバーがどのようなツールを提供しているかを一目で確認できます。問題が発生したサーバーの再起行、新規追加、または一時的な無効化などの操作は、ここで行います。/hooks は、フック設定の UI です。特定のイベント(ファイル修正前、ツール使用前、セッション終了時など)に自動的に実行するシェルコマンドを設定します。
特殊コマンドのカテゴリには、比較的新しく追加されたものが多く含まれています。
/btw # コンテキストを消費せずに質問する /plan # プランニングモード /loop # 反復予約実行 /voice # 音声モード /doctor # 診断 /remote-control # リモート制御 (NEW) /schedule # クラウド予約 (Routines) /security-review # セキュリティレビュー
/btw は「by the way」の略で、現在の作業の文脈を消費せずに短い質問をする際に使用します。「それより、PostgreSQL と MySQL のどちらがこの場合に適しているでしょうか?」といった横道にそれる質問をする必要がある場合、/btw で尋ねれば、現在進行中のコード作業の文脈が保持されます。/plan は Shift+Tab でアクセスする計画モードと同様の機能です。
/loop はセッション内で反復作業を予約します。「/loop 5m CI 状態確認」と入力すると、5 分ごとに CI の状態を確認し、変更があれば通知します。/voice は音声モードです。スペースキーを押しながら話すと、自動的にテキストに変換されてコマンドとして実行されます。20 言語に対応しており、韓国語も含まれています。
/doctor は環境診断コマンドです。Node.js のバージョンが正しいか、API キーが設定されているか、MCP 接続サーバーが応答しているか、必要な権限があるかを一度に確認します。インストール直後に何か問題がある場合、最初に試すべきコマンドです。
/schedule は 2026 年 4 月 14 日にリリースされた Routines を制御します。ローカルで動作する /loop と異なり、/schedule で作成されたタスクは Anthropic のクラウド上で実行されるため、ノートパソコンを閉じていても実行されます。毎朝 7 時のブリーフィング、毎週月曜日の 9 時の週次報告、毎月 1 日の費用精算などのルーチンをここに登録します。
/security-review はコードベース全体を走査してセキュリティ上の脆弱性を検出するコマンドです。OWASP Top 10 の基準に基づき、SQL インジェクション、XSS、ハードコードされた機密情報などの問題を特定します。リリース前に必ず実行する習慣をつけることで、重大な事故を未然に防ぐことができます。
スキルとエージェントエコシステム
スラッシュコマンドが組み込み機能であるのに対し、スキルはユーザーが直接作成する機能です。同じ指示を繰り返し行うよりも、スキルとして保存して一度に呼び出す方が効率的です。スキルとスラッシュコマンドは v2.1 シリーズで統合され、同じエンジンで動作します。.claude/commands/deploy.md ファイルと .claude/skills/deploy/SKILL.md ファイルの両方が、/deploy コマンドを作成します。
まずは組み込みスキルから見ていきましょう。Claude Code のインストール直後から使用できるものが 5 つあります。
/simplify # コードレビュー(AI エージェント 3 基並列)/batch # 大量変更(5〜30 のワークツリー)/debug # ログ分析/loop # 反復予約実行/claude-api # Claude API/SDK 参照ロード
/simplify はコードレビューに特化したスキルです。3 つのエージェントが並列で動作し、コードを品質、セキュリティ、可読性の異なる観点からそれぞれレビューします。/batch はワークツリー機能と連携し、5 から 30 の独立した作業空間で同時に変更作業を実行します。ライブラリ全体に型ヒントを追加したり、複数のファイルで一貫したリファクタリングを行ったりする際に使用します。
/debug コマンドはログファイルを丸ごと読み込み、エラーの原因を特定します。/claude-api コマンドは、Claude API および SDK の公式ドキュメントをコンテキストとして取り込み、API 関連の作業時に参照できるようにします。
スキルの保存場所は 2 箇所あります。
.claude/skills/<名前>/ # プロジェクトスキル(チーム共有) ~/.claude/skills/<名前>/ # 個人スキル(全プロジェクトに適用)
プロジェクトフォルダに配置したスキルは Git にコミットされ、チーム全体で共有されます。ホームディレクトリに配置したスキルは、該当ユーザーのみが使用するグローバルスキルです。会社共通のデプロイルールはプロジェクトスキルとして、個人のメモ整理ルーチンは個人スキルとして管理する分け方が自然です。
SKILL.md ファイルの構造は、YAML フロンットマターと Markdown 本文に分かれています。フロンットマターのフィールドを一つずつ見ていきましょう。
name: deploy description: プロダクションへのデプロイ。ユーザーがデプロイを要求するか、deploy に言及した際に使用されます。allowed-tools: [Bash, Edit] model: claude-haiku-4-5 effort: low paths: [src/**] context: fork disable-model-invocation: true
name はスキルの識別子です。小文字とハイフンのみを使用でき、最大 64 文字までです。description は、Claude がいつこのスキルを呼び出すかを判断する根拠となります。最も重要なフィールドです。「何を、いつ行うべきか」を具体的に記述します。「コードを支援します」のような曖昧な説明では、スキルが発動しないか、不適切な場所で発動してしまいます。
allowed-tools は、このスキルが実行される際に Claude が使用できるツールを制限します。読み取り専用のスキルには [Read, Grep, Glob] を、デプロイ用のスキルには [Bash, Edit] を指定します。この制限が安全装置の役割を果たします。model は、スキル実行に使用するモデルを強制します。複雑な分析には claude-opus-4-6 を、単純な反復作業には claude-haiku-4-5 を指定します。
effort は v2.1 シリーズでスキルに追加されたフィールドです。low、med、high、max のいずれかを指定すると、このスキルが発動された際に Claude の思考の努力レベルがその値に設定されます。paths は、このスキルがどのファイルパターンに対して有効化されるかを定義します。[src/**] と指定すると、src フォルダ内のファイルを扱う際のみ、このスキルが候補として挙がります。
context: fork は重要なオプションです。これは、このスキルを補助エージェントの独立したコンテキストで実行することを意味します。大量の探索結果がメインの会話に流れ込むのを防ぎます。一冊分のコードベースをスキャンするようなスキルは、ほとんどが context: fork で実行する方が安全です。
disable-model-invocation: true は、このスキルが Claude によって自動的に呼び出されるのを防ぎます。ユーザーが明示的に /deploy と入力した場合のみ実行されます。デプロイ、コミット、外部へのメッセージ送信など、結果を元に戻しにくい作業には、必ずこの安全装置を設けるべきです。
本文のマークダウンでは、以下の 3 つの特殊文法が使用されます。
$ARGUMENTS # スキル呼び出し時にユーザーが渡した引数 ${CLAUDE_SKILL_DIR} # スキルフォルダの絶対パス ! cmd # 動的コンテキストの注入(シェルコマンド実行後の結果を文脈に含める)
$ARGUMENTS を使用すると、スキルは関数として動作します。/analyze-file src/auth.js と入力すると、src/auth.js が $ARGUMENTS に格納され、スキル本文に挿入されます。${CLAUDE_SKILL_DIR} はスキルフォルダの絶対パスを返します。このパスを利用して、スキルと共にデプロイされたスクリプトを実行します。
! date のように、感嘆符とバックティックを組み合わせた構文は、スキルロード時にシェルコマンドを実行し、その結果をコンテキストに注入します。現在の日付、ブランチ名、直近のコミットハッシュなどの動的な情報をスキルに含める際に使用します。
内蔵エージェントは4種類あります。
Explore # 高速探索専用(Haikuベース、読み取り専用ツールに最適化)Plan # 計画モード調査用 General # 汎用(全ツールアクセス可能)Bash # ターミナル独立実行
Exploreは軽量で高速なエージェントです。コードベースの構造把握や「この関数がどこで呼ばれているか」といった調査に使用します。Haikuモデルを採用しているためコストが低く、速度も速いです。PlanはPlan Mode内で活動します。Generalはすべてのツールにアクセス可能な汎用エージェントです。Bashはターミナル作業を独立したプロセスで実行するエージェントで、長い構築や検証をバックグラウンドで実行する際に便利です。
エージェントのフロントマターには、スキルよりも多くのオプションがあります。
permissionMode: default/plan/bypass isolation: worktree # 独立ワークツリーで実行 memory: user|project # 記憶保存範囲 background: true # バックグラウンド実行 maxTurns: 10 # 行動回数制限 initialPrompt: ...
# 自動初回質問(NEW)SendMessage # エージェントの再開(resume 代替、NEW)
initialPrompt は v2.1 系列の新機能です。エージェントが生成されると同時に、このプロンプトが自動的に実行されます。「現在の PR の変更点を要約せよ」といった初期指示を事前に設定しておけば、ユーザーがセッションに参加した瞬間に結果が用意されています。SendMessage も新機能であり、従来の resume を代替します。一時停止されたエージェントに新しいメッセージを送信して作業を再開させます。
上級者向けワークフロー
これまでの五つのセクションが部品の説明であったなら、今回のセクションはそれらを組み合わせて実際に使う方法です。八つの核心となるワークフローが互いに連携し、Claude Code の真の速度を生み出します。
計画モードを最優先してください。大規模な変更を行う前に必ず通過すべき関門です。Shift+Tab で計画モードに入ると、Claude はコードを一行も修正せず、計画書のみを作成します。ユーザーはこの計画を検証し承認した後にのみ、実際の修正が実行されます。「データベーススキーマを変更する」という指示に対し、Claude が即座にコードの修正を開始すれば、大きな事故につながります。
計画モードでは、影響範囲を事前に確認し、危険な箇所を指摘して回避するプロセスが必要です。
思考と努力量の調整。Alt+T で深層推論をオン・オフできます。単純なファイル操作ではオフにし、アーキテクチャの決定や微妙なバグの追跡ではオンにします。一度だけ最強モードで実行したい場合は、入力欄に「ultrathink」と入力してください。そのターンだけ最高レベルの思考で動作します。/effort コマンドを使用すると、low、med、high、max の 4 段階で、セッション全体の基本努力レベルを変更できます。
Git ワークツリー。開発者が複数のブランチを同時に操作する際に、重複しない作業領域を提供する機能です。claude コマンドに -w フラグを付与すると、独立したワークツリーでセッションが開始されます。/batch で 5 から 30 のタスクを並列実行する際、各タスクが自身のワークツリー内で独自の変更のみを扱うため、競合が発生しません。ライブラリ全体にわたる一括修正や、複数の PR を同時に進行させる作業において、その威力を発揮します。
claude -w feature-login # ワークツリー生成後に開始 /batch 5 "各ワーカーに割り当てられたモジュールのリファクタリング"
音声モード。/voice と入力すると音声入力モードに入ります。スペースキーを押しながら話すと、自動的にテキストに変換されます。韓国語を含む 20 言語に対応しています。長い指示を入力するのが面倒な場合や、散歩しながら構想した設計をそのまま出力したい場合に便利です。
コンテキスト管理。/context と入力すると、現在の会話がコンテキストウィンドウの何パーセントを占めているか表示されます。60〜70% に達したら /compact で圧縮するタイミングです。95% に達すると自動的に圧縮されますが、それより前に明示的に圧縮することで、どの情報を残すか指示でき、精度が高まります。Opus 4.6 は、Max 契約において 1M トークンのコンテキストをカウントするモデルをサポートしています。
数十万行のコードベースを一度にアップロードして分析できる分量です。
/context # 現在の使用量を確認 /compact "重要な決定事項と現在の作業ファイルのみを残してください"
セッションの活用。claude -c を実行すると、最後の会話を続けて開始します。退社時にセッションを終了しても、翌朝に -c を一度実行するだけで、昨日の作業がそのまま継続されます。claude -r "セッション名" は、名前を付けたセッションを呼び出します。複数のプロジェクトを行き来して作業する際、セッションに名前を付けておくと混乱が軽減されます。/btw は、現在のコンテキストを変更せずに短い質問をするためのコマンドです。
自動化と SDK。claude -p "質問" は自動化の入り口です。対話型 UI を表示せず、結果のみを返します。--output-format json を追加すると、結果が JSON 形式で返されるため、他のプログラムでパースしやすくなります。UNIX パイプとも相性が良好です。
tail -200 app.log | claude -p「Slack に異常兆候を通知」git diff main --name-only | claude -p「変更ファイルのセキュリティレビュー」
予約と遠隔制御です。/loop 30m は 30 分ごとに指示を繰り返し実行します。セッションが開いている間のみ動作します。/schedule は Routines を作成し、Anthropic クラウド上で実行します。ノートパソコンが電源オフの状態でも動作する、真の自動化です。/rc は claude.ai のウェブとセッションを接続し、モバイルからも制御可能にします。--remote フラグは、ウェブセッション内で作業が実行されるようにします。
この 6 つのセクションが、v2.1.86 基準の Claude Code の全体像です。日常的に使用する機能は、Ctrl+C、Ctrl+L、/clear、Shift+Tab、claude -c の 5 つに簡素化され、自動化パイプラインを構築する際には、claude -p、--output-format、MCP 接続機能、Routines が中心となります。
その間の数十種類の命令やフラグは、特定の瞬間に必要となった際に、この章に戻って検索すれば見つかります。
バージョンは急速に変化します。2026 年 3 月に --bare と --channels が、4 月に Routines が追加されたように、毎月新たな機能が追加されます。claude update を定期的に実行して最新バージョンを維持し、/doctor で環境状態を確認する習慣さえあれば、取り残されることはありません。
本書で取り上げていない新機能は、Claude Code 公式のチェンジログ(code.claude.com/docs/en/changelog)で直接ご確認ください。




