Claude Code の全体像
Claude Code でできること、使える場所、拡張の仕組みを一望し、各機能のページへ移るための見取り図です。
Claude Code は、コードベースを読み、ファイルを編集し、コマンドを実行し、開発ツールとつながるエージェント型のコーディングツールです。ターミナル・IDE・デスクトップアプリ・ブラウザで動き、どこで使っても中身のエンジンは同じです。このページは、全体像から個別のページへ入る入口として使ってください。
- 動きの基本は「文脈を集める → 行動する → 結果を確かめる」の繰り返しです。途中でいつでも割り込めます
- CLAUDE.md・スキル・フック・MCP・サブエージェント・プラグインで、知識・接続・自動化を足せます
- 使う場所は、ターミナル・VS Code・JetBrains・デスクトップ・Web・モバイルから選べます
- 設定・CLAUDE.md・MCP サーバーは、手元で動く各画面で共通です
はじめる#
最初の一歩は インストールとログイン にまとめています。画面ごとの入口は次のとおりです。
| 使う場所 | 始め方 | 詳しいページ |
|---|---|---|
| ターミナル(CLI) | インストーラを実行し、プロジェクトで claude を起動する |
インストールとログイン |
| VS Code | 拡張機能「Claude Code」を入れ、コマンドパレットから「Open in New Tab」を選ぶ | VS Code と JetBrains |
| デスクトップアプリ | アプリを入れてサインインし、「Code」タブを開く(有料プランが必要) | デスクトップアプリ |
| Web | ブラウザで claude.ai/code を開く | クラウド(Web)で使う |
| JetBrains | JetBrains Marketplace からプラグインを入れる(CLI は別に必要) | VS Code と JetBrains |
- 多くの画面は Claude のサブスクリプションか Anthropic Console のアカウントが必要です。ターミナル・VS Code・JetBrains はサードパーティのプロバイダーにも対応します(Bedrock・Vertex AI・Foundry)
- ネイティブインストールは裏で自動更新されます。Homebrew と WinGet は自動更新されません
できること#
| やりたいこと | 概要 | 見るページ |
|---|---|---|
| 先延ばしの作業を任せる | テスト作成、lint の修正、マージ競合の解消、依存関係の更新、リリースノート作成など | よくある作業の進め方 |
| 機能追加とバグ修正 | 平易な言葉で頼むと、計画・複数ファイルの編集・動作確認まで進める | よくある作業の進め方 |
| コミットとプルリクエスト | git を直接操作し、変更のステージ・メッセージ作成・ブランチ作成・PR 作成までできる | GitHub Actions、GitLab CI/CD |
| 外部ツールとの接続 | MCP で Google Drive、Jira、Slack、自作ツールなどにつなぐ | MCP サーバーをつなぐ |
| 指示・スキル・フックでの調整 | CLAUDE.md で規約を渡し、スキルで手順を共有し、フックで編集後の整形などを自動化する | CLAUDE.md とメモリ、スキル、フックの使い方 |
| エージェントの並列実行 | サブエージェントや複数セッションで分担し、Agent SDK で自作もできる | 並列作業の選び方、Agent SDK の基本 |
| パイプ・スクリプト・自動化 | ログを渡す、CI で動かす、他のツールと連結する | ヘッドレス実行(-p)、CLI のコマンドとフラグ |
| 定期実行 | ルーティン(クラウド)、デスクトップの定期タスク、/loop |
ルーティン、定期実行と /loop |
| 場所を選ばない作業 | リモートコントロール、Web とモバイル、/desktop、Slack からの依頼 |
リモートコントロールとモバイル |
CLI の使い方の例です。
# 直近のログを調べさせる
tail -200 app.log | claude -p "Slack me if you see any anomalies"
# 変更されたファイルをレビューさせる
git diff main --name-only | claude -p "review these changed files for security issues"
補足
claude --teleport で Web やモバイルの長いタスクをターミナルへ取り込めますが、claude.ai のサブスクリプションが必要です。/desktop でターミナルのセッションをデスクトップアプリへ引き継ぐ操作も、claude.ai のサブスクリプションが必要で、macOS と x64 Windows で使えます。
動き方の見取り図#
Claude に仕事を渡すと、「文脈を集める」「行動する」「結果を確かめる」の3つの段階をまたいで進みます。段階の境目ははっきりせず、ツールは全体で使われます。
- 質問なら文脈集めだけで終わり、バグ修正なら3段階を何度も回ります
- 動かしているのは、推論するモデルと、行動するツールです。Claude Code はツールを提供し、モデルが見る文脈を管理する外側の層(harness)です
- モデルは
/modelで切り替えるか、claude --model <name>で起動します。詳しくは モデル・effort・fast mode を見てください
組み込みツールの分類#
| 分類 | できること |
|---|---|
| ファイル操作 | 読む、編集する、新規作成する、名前変更や整理をする |
| 検索 | パターンでファイルを探す、正規表現で内容を検索する、コードベースを探索する |
| 実行 | シェルコマンド、サーバー起動、テスト、git |
| Web | Web 検索、ドキュメント取得、エラーメッセージの調査 |
| コードインテリジェンス | 編集後の型エラーや警告、定義へのジャンプ、参照検索(コードインテリジェンスのプラグインが必要) |
全ツールは ツール一覧 にあります。
Claude が触れるもの#
claude を実行したディレクトリで、次のものが使えます。
- プロジェクトのファイル(ディレクトリ配下。ほかの場所は許可があれば)
- ターミナルで実行できるコマンドすべて
- git の状態(現在のブランチ、未コミットの変更、最近のコミット履歴)
- CLAUDE.md(
AGENTS.mdがあれば、単独でも CLAUDE.md と併用でも読める)。CLAUDE.md とメモリ を見てください - 自動メモリ。MEMORY.md の先頭 200 行か 25KB のうち、先に達したほうまでが毎セッションの開始時に読み込まれます
- 設定した拡張(MCP サーバー、スキル、サブエージェント、Chrome)
実行環境#
| 環境 | コードが動く場所 | 使いどころ |
|---|---|---|
| ローカル | 自分のマシン | 既定。ファイルやツールにそのままアクセスできる |
| クラウド | Anthropic が管理する VM、または組織が運用するセルフホスト環境 | 作業を任せる、手元にないリポジトリで作業する |
| リモートコントロール | 自分のマシン(操作はブラウザから) | Web の画面を使いつつ、実行とファイルは手元に置く |
セルフホスト環境は セルフホスト環境 を見てください。
セッションと文脈#
- 会話は
~/.claude/projects/の下に JSONL で保存され、巻き戻し・再開・分岐に使われます。詳しくは セッションの再開と管理 と .claude ディレクトリの中身 を見てください - セッションは互いに独立です。新しいセッションは空の文脈から始まり、持ち越したいことは CLAUDE.md か自動メモリに置きます
- ブランチを切り替えても会話の履歴は残ります。並列で動かすなら worktree で並行作業 を使います
claude --continueとclaude --resumeは同じセッション ID で再開し、--fork-sessionと/branchは履歴を新しい ID にコピーします- 文脈が埋まると、古いツール出力から消し、必要なら要約します。残したい内容は CLAUDE.md の「Compact Instructions」に書くか、
/compact focus on the API changesのように指定します。コンテキストとプロンプトキャッシュ を見てください - 編集の前にファイルのスナップショットが取られます。Esc を2回押すと巻き戻せます。リモートの操作(DB・API・デプロイ)は戻せません。チェックポイントと巻き戻し を見てください
権限モード#
Shift+Tab でモードを切り替えます。
| モード | 動き |
|---|---|
| Auto | 分類器が裏で確認し、危険な操作を止める。v2.1.283 以降は対話のターミナルと VS Code の開始モード。それ以前は Pro・Max・Team のみ |
| Manual | ファイル編集とシェルコマンドの前に確認する |
| Accept edits | ファイル編集と mkdir・mv などの基本操作は確認なし。ほかのコマンドは確認する |
| Plan | 調べて計画を示すだけで、ソースは編集しない |
助けを得る・割り込む#
/initは CLAUDE.md の雛形を作り、/doctorはインストールと設定の診断をします- Esc で即座に止められます。実行中に入力して Enter を押すと、メッセージはキューに入り、ツール呼び出しの完了後に読まれます。対話モードの操作 を見てください
- 「ファイルや手順を指定せず、背景と方向を渡して任せる」使い方が向いています。コツは 上手に使うコツ にあります
拡張の仕組み#
内蔵ツールで足りない部分を、次の拡張で補います。
| 拡張 | 役割 | 詳しいページ |
|---|---|---|
| CLAUDE.md | 毎セッション読み込まれる永続の文脈 | CLAUDE.md とメモリ |
| 出力スタイル | 役割・口調・応答の形を決める | 出力スタイル |
| スキル | 再利用できる知識と、/名前 で呼べる手順 |
スキル |
| サブエージェント | 独立した文脈で動き、要約を返す | サブエージェント |
| ワークフロー(dynamic workflows) | Claude が書いた台本で多数のサブエージェントを動かす | ワークフロー |
| セッション間メッセージ | 自分のセッション同士でメッセージを渡す | セッション間のメッセージ |
| コードインテリジェンス | 言語サーバーによるシンボル単位の移動と型エラー | プラグインを使う |
| MCP | 外部サービスやツールへの接続 | MCP サーバーをつなぐ |
| フック | ライフサイクルのイベントで、スクリプト・HTTP・MCP ツール・プロンプト・サブエージェントを動かす | フックの使い方、フックのリファレンス |
| アーティファクト | セッションの出力を非公開の対話ページとして出す | アーティファクト |
| プラグイン | スキル・フック・サブエージェント・MCP を1つにまとめて配る | プラグインを使う、プラグインを作って配る |
プラグインのスキルは /my-plugin:review のように名前空間が付き、複数のプラグインが共存できます。
設定を育てる順序#
最初からすべてを設定する必要はありません。きっかけごとに足します。
| きっかけ | 足すもの |
|---|---|
| 規約やコマンドを2回間違えた | CLAUDE.md に書く |
| 短くして・詳しくして・同じ形式で、と何度も頼む | 出力スタイルを設定する |
| 同じ依頼文を何度も打つ | ユーザーが呼べるスキルにする |
| 同じ手順書を3回目に貼る | スキルにする |
| ブラウザのタブからデータを何度もコピーする | MCP サーバーにする |
| シンボルの定義や使用箇所を探して大量にファイルを読む | コードインテリジェンスのプラグインを入れる |
| 副次的な作業の出力が会話を埋める | サブエージェントに回す |
| 毎回確実に何かを起こしたい | フックを書く |
| 2つ目のリポジトリで同じ設定が要る | プラグインにまとめる |
ヒント
同じ間違いや同じレビューコメントが繰り返されるなら、会話で直すのではなく CLAUDE.md を直します。手で調整し続けている手順は、スキルの改訂のサインです。
似た機能の使い分け#
| 比べるもの | 判断の目安 |
|---|---|
| CLAUDE.md とスキル | 常に知っておくべきことは CLAUDE.md。ときどき要る資料や /名前 で起動する手順はスキル。CLAUDE.md は 200 行以内を目安にし、増えたら移す |
| CLAUDE.md と出力スタイル | プロジェクトの事実と規則は CLAUDE.md。応答の長さ・形式・役割は出力スタイル。どちらも指示であり、強制ではない |
CLAUDE.md・.claude/rules/・スキル |
毎回要るものは CLAUDE.md。パスで絞れる指針は rules(paths の frontmatter で、該当ファイルを扱うときだけ読み込む)。必要なときだけ要るものはスキル |
| スキルとサブエージェント | 再利用する内容はスキル。文脈を分けたい作業はサブエージェント。サブエージェントは skills: でスキルを先読みでき、スキルは context: fork で隔離して動かせる |
| サブエージェントとワークフロー | 小さな専任の作業はサブエージェント。数体で足りない規模や、結果の突き合わせが要る作業はワークフロー |
| MCP とスキル | MCP は外部への接続。スキルはその使い方の知識。組み合わせて使う |
| フックとスキル | 毎回同じに動かしたい処理はフック。Claude の判断が要る手順や知識はスキル |
注意
「.env を編集しない」のような指示は、CLAUDE.md やスキルに書いてもお願いにとどまります。確実に守らせたい規則は、編集を止める PreToolUse フックにします。
設定の重なり方#
| 機能 | 同じものが複数の階層にあるとき |
|---|---|
| CLAUDE.md | 追加方式。すべての階層が同時に文脈へ入る。矛盾は Claude が判断して調整する |
| スキル | 名前で上書き。優先順位は managed > user > project。プラグインのスキルは名前空間で衝突しない |
| サブエージェント | 名前で上書き。managed > CLI フラグ > project > user > plugin |
| MCP サーバー | 名前で上書き。local > project > user |
| フック | 統合。どの出どころのフックも、該当するイベントですべて動く |
機能ごとの文脈コスト#
| 機能 | 読み込まれる時点 | 文脈への影響 |
|---|---|---|
| CLAUDE.md | セッション開始時に全文 | 毎回のリクエスト |
| 出力スタイル | 開始時と切り替え時。既定のスタイルは何も入らない | 毎回のリクエスト |
| スキル | 開始時は説明のみ、使うときに全文 | 低い(説明が毎回) |
| MCP サーバー | 開始時はツール名のみ。スキーマは必要になってから | 使うまで低い |
| コードインテリジェンス | 編集後の診断と、シンボル検索のとき | 低い。ファイル読み込みを減らせる |
| サブエージェント | 起動時に独立した文脈 | メインの会話とは別 |
| フック | イベント時。外部で動く | 出力を返さない限りゼロ |
- スキルの frontmatter に
disable-model-invocation: trueを付けると、説明が Claude の文脈に入りません。副作用のあるスキルに向いています - 自分で書いていないスキルは、設定の
skillOverridesで同じ扱いにできます /context allで、読み込まれた MCP ツールごとのトークン数が見えます/mcpで各サーバーの接続状態を確認できます
どこでも使う#
すべての画面が同じエンジンにつながっているので、リポジトリの CLAUDE.md・設定・MCP サーバーは共通です。
| やりたいこと | 向いている方法 |
|---|---|
| ローカルのセッションをスマホや別の端末で続ける | リモートコントロールとモバイル |
| Telegram・Discord・iMessage や自前の webhook の出来事をセッションへ流す | チャネル |
| ローカルで始めてモバイルで続ける | claude --cloud のあと、Claude モバイルアプリ(クラウド(Web)で使う) |
| 決まった間隔で動かす | ルーティン またはデスクトップの定期タスク |
| PR レビューや Issue の仕分けを自動化する | GitHub Actions または GitLab CI/CD |
| すべての PR に自動でコードレビューを付ける | コードレビューと ultrareview |
| Slack の不具合報告からプルリクエストを作る | Slack と Claude Tag |
| 動いている Web アプリをデバッグする | Chrome とコンピュータ操作 |
| 自作のエージェントを作る | Agent SDK の基本 |
画面ごとの比較#
| 画面 | 向いている用途 | 得られるもの |
|---|---|---|
| CLI | ターミナル作業、スクリプト、リモートサーバー | 全機能、Agent SDK、macOS のコンピュータ操作(Pro・Max)、サードパーティのプロバイダー |
| デスクトップ | 視覚的なレビュー、並列セッション | diff ビューア、アプリのプレビュー、コンピュータ操作と Dispatch(Pro・Max) |
| VS Code | エディタを離れずに作業する | インライン diff、統合ターミナル、ファイルの文脈 |
| JetBrains | IntelliJ・PyCharm・WebStorm などの中で作業する | diff ビューア、選択範囲の共有、ターミナルのセッション |
| Web | 手をかけなくてよい長い作業、オフラインでも続く作業 | クラウド(既定は Anthropic 管理)、切断後も継続 |
| モバイル | 外出先でタスクを始めて見守る | クラウドセッション、リモートコントロール、Dispatch(Pro・Max) |
- スクリプトと Agent SDK は CLI だけです。デスクトップと IDE 拡張は、CLI だけの機能を一部手放す代わりに、視覚的なレビューとエディタとの統合が得られます
- Amazon Bedrock と Microsoft Foundry は、CLI か IDE 拡張、または「Claude Desktop on 3P」を使います。企業向けデスクトップは Google Cloud の Agent Platform に対応し、ゲートウェイのプロバイダーにも対応します。ネットワークと LLM ゲートウェイ を見てください
外出先から動かす方法#
| 方法 | きっかけ | 動く場所 | 向いている用途 |
|---|---|---|---|
| Dispatch | モバイルアプリからタスクを送る | 自分のマシン(デスクトップ) | 離席中に任せる。設定が少ない |
| リモートコントロール | claude.ai/code やモバイルアプリから動いているセッションを操作する | 自分のマシン(CLI・デスクトップ・VS Code) | 別の端末から作業を操縦する |
| チャネル | チャットアプリや自前サーバーのイベント | 自分のマシン(CLI) | CI の失敗やチャットの発言に反応する |
| Slack | チャンネルで @Claude にメンションする |
Anthropic のクラウド | チャットから PR やレビューを得る |
| セルフホスト環境 | クラウドセッションで組織の環境を選ぶ | 組織のインフラ(Team・Enterprise) | ネットワーク内で動かしたいクラウドセッション |
| 定期実行 | スケジュールを決める | CLI・デスクトップ・クラウド | 毎日のレビューなどの繰り返し |
Claude Tag は、組織共通の ID として @Claude を動かす仕組みで、Team と Enterprise プランが対象です。
利用条件と法務#
Claude Code の利用は、プランによって次の規約に従います。
| 規約 | 対象 |
|---|---|
| Commercial Terms of Service | Team・Enterprise・Claude API の利用者 |
| Consumer Terms of Service | Free・Pro・Max の利用者 |
- Claude API を直接使う場合も、Amazon Bedrock や Google Cloud の Agent Platform 経由の場合も、双方で別途合意がなければ、既存の商用契約が Claude Code の利用に適用されます
- 製品への組み込み(ホスト型サンドボックスなど)は、Commercial Terms of Service への同意と次の条件が必要です。
- Claude Code のバイナリを改変しない。認証方法を削除・無効化・制限しない
- 利用者に代わって Claude の利用料を支払う、再販する、間に入ることをしない。利用者ごとに自分の API キー・サブスクリプション・サードパーティプロバイダーの認証情報で認証する
- 「Claude Code」の名前やロゴは、自社の製品名・ロゴに使えません。「Claude Code が入っている」と平文で正確に書くことは可能です。Anthropic が作った・推奨している・提携していると見せる使い方もできません
- BAA(Business Associate Agreement)を結び、対象の組織で Zero Data Retention を有効にしている場合は、Claude Code 経由の API トラフィックにも BAA が及びます
- 利用は Anthropic Usage Policy に従います。Pro と Max の利用上限は、Claude Code と Agent SDK の通常の個人利用を想定しています
- OAuth 認証は、Free・Pro・Max・Team・Enterprise の購入者向けで、通常の利用のためのものです
- 製品やサービスを作る開発者(Agent SDK を含む)は、Claude Console か対応するクラウドプロバイダーの API キーを使います。第三者の開発者が自分のアプリに Claude.ai のログインを組み込むことや、Free・Pro・Max の認証情報で利用者のリクエストを中継することは認められていません。Claude.ai の認証情報やセッショントークンを収集・保存・仲介することもできません
- 自分の API キーを開発環境やシークレット管理に設定して使うことは制限されません。利用料がキーの持ち主に請求される場合に限ります
- これらの制限は、予告なく執行される場合があります
- 脆弱性の報告は HackerOne で受け付けています。安全性の情報は Anthropic Trust Center と Transparency Hub にあります
認証の仕組みは インストールとログイン、データの扱いは セキュリティとデータの扱い を見てください。
次に読むページ#
- インストールとログイン:インストールからログインまで
- よくある作業の進め方 と 上手に使うコツ:作業の型とコツ
- CLAUDE.md とメモリ:永続的な指示と自動メモリ
- 設定ファイルの仕組み:設定のカスタマイズ
- トラブルシューティング:よくある問題の対処
- 用語集:用語の意味
公式ドキュメント(英語)
2026年10月5日時点の内容をもとに、日本語でまとめています。