Claude Code 完全ガイド

Claude Code は Anthropic 公式のコーディング用 AI エージェントです。ターミナルにいる Claude にプロジェクトを丸ごと預け、コードの説明・生成・修正・テスト実行・コミットまでを日本語の指示で任せられます。チャット欄にコードを貼って答えをもらう従来のやり方と違い、Claude が自分でファイルを読み、書き換え、コマンドを走らせて結果を確かめる――この「自分で手を動かす」点がいちばんの特徴です。

「ターミナル専用ツール」と紹介されることもありますが、現在は VS Code 拡張・JetBrains プラグイン・デスクトップアプリ・Web・iOS・Slack でも動きます。本ガイドは、最初の起動から権限の考え方、サブエージェントや MCP といった強力な機能、料金の読み方、そしてつまずきやすい点までを、初めての人が読んでそのまま使えるように整理します。

FIG.1　指示を受けたら、Claude 自身がファイルを読み・直し・コマンドを走らせて確かめる

01何ができるツールなのか

従来の AI チャットは「コードを貼る→答えをもらう→自分で貼り戻す」の往復が前提でした。Claude Code は、その往復をエージェント自身が肩代わりします。あなたが「lib/auth.ts を JWT 認証に書き直して、テストも足して」と頼むと、Claude は関連ファイルを探して読み、差分を作り、テストを実行し、失敗すれば原因を調べて直す――という一連の作業を自走します。

得意なのは、複数ファイル・複数ディレクトリにまたがる変更、既存コードの調査と説明、テストやビルドを回しながらのデバッグ、そして git 操作（差分の説明やコミット）。一方で、仕様があいまいなまま大きく任せると的外れな実装が増えるため、小さく区切って頼むのが成功の鍵になります（後述）。

02インストールとセットアップ

導入方法は2通りあります。現在は依存不要のネイティブインストーラが公式の推奨で、Node.js を入れなくても 1 分ほどで終わります。バージョンを固定したい・既存の Node 環境に揃えたい場合は npm 経由（Node.js 18 以上が必要）も使えます。

料金プランや必要アカウントの条件は更新が早いため、契約前に公式の最新情報を確認してください（本ガイド執筆時点の目安は後半の「料金の読み方」に整理します）。

03基本の使い方は3パターン

使い方は大きく3つ。最初は「対話しながら少しずつ」から始めると、AI の挙動を観察しながら安全に慣れていけます。

どのパターンでも、Claude は実行前に「これからこういう変更をします」と示し、あなたの確認を取ってから動くのが既定の挙動です（次節）。

04権限：勝手に走らせない仕組み

エージェントに作業を任せるうえで、一番大事なのが権限の制御です。Claude Code は既定で、ファイル編集やコマンド実行のたびに承認を求めます。作業の信頼度に応じて、確認の強さを段階的に切り替えられます。

慎重寄り（おすすめの初期設定）	速度寄り（信頼できる作業のみ）
Plan モード：実行せず計画だけを提示。レビューしてから着手できる	編集の自動承認：ファイル編集は自動、コマンド実行は都度確認
変更前に差分を確認 → 納得してから許可	全自動：確認なしで実行（壊れても困らない環境・信頼できるタスク限定）

モードは /permissions で対話的に切り替えられます。プロジェクトごとに「このコマンドは常に許可」といった許可リストを設定しておくと、確認の手間（後述の「権限プロンプト疲れ」）を減らせます。本番リポジトリや破壊的なコマンドを含む作業では、全自動を避けるのが安全です。

05強力な機能

慣れてきたら、Claude Code を「自分の開発環境」に合わせて拡張できます。代表的な4つを押さえましょう。

FIG.2　本体を中心に、役割の違う4つの拡張で能力と安全性を足していく

サブエージェント（Subagents）

専門の小さなエージェントに、独立した文脈とツール権限を与えて作業を分担させる仕組みです。たとえば「コードレビュー専門」「テスト実行専門」「セキュリティ確認専門」を切り出し、メインの Claude が計画と統合を担います。各サブエージェントは自分専用の文脈ウィンドウを持つため、本体の会話を汚さずに長い調査を回せるのが利点です。

MCP 連携

MCP（Model Context Protocol）は、ファイルシステムの外にある外部システムへ Claude をつなぐ標準規格です。課題管理（JIRA など）、データベース（Postgres へクエリ）、監視ツール（Sentry を確認）、ブラウザ自動化、デザインツールなどに接続でき、「あなたの実際のワークフロー」を Claude から操作できるようになります。

スキル（Skills）

あなた専用の「やり方」を .claude/skills/<名前>/SKILL.md として登録しておくと、Claude が現在のタスクに合うものだけを自動で読み込みます。「このプロジェクト特有のテストの書き方」「リファクタの方針」などを永続化でき、毎回説明し直す手間がなくなります。

フック（Hooks）

フックは、ファイル編集の前後やコマンド実行前といったイベントで、あなたの用意したスクリプトを確実に実行する仕組みです。プロンプト（モデルの解釈に依存）と違い、フックは決定的なコードとしてルールを強制します。編集後に lint やフォーマッタを自動で走らせる、危険なコマンドをブロックする、といった「ガードレール」を仕込めます。

内蔵ブラウザ（Built-in Browser）

2026 年 7 月、Claude Code に内蔵ブラウザが加わり、AI が外部 Web サイトを開いて読み・クリックし・フォームに入力する操作をターミナルの内側から実行できるようになりました（THE DECODER 報道）。これまでは MCP 経由でブラウザ操作ツールを差し込む必要がありましたが、本体に組み込まれたことで、開発中のアプリの動作確認・公式ドキュメントの参照・ログイン後の管理画面の操作までを Claude 自身が回して結果を見に行けます。他の実行機能と同じく既定では実行前に確認を挟むため、意図しない外部サイト操作を防ぐ設計になっています。

06料金の読み方

料金体系は変動しやすいので、契約前に必ず公式ページで最新を確認してください。本ガイド執筆時点（2026年）の大枠だけ整理すると、個人向けは月額のサブスク、チーム・大規模利用には API 従量課金という構成です。

• Pro（月 USD 20 目安）：個人開発者の多くをカバー。Sonnet・Opus 両系統に対応し、集中した1セッション規模の作業に十分な使用枠。
• Max（月 USD 100 / 200 目安）：Pro のおよそ5倍・20倍の使用枠。重いタスクや長時間の利用向け。
• API（従量課金）：トークン単位で課金。チーム導入や自動化パイプラインに組み込むときに検討。

注意したいのは使用枠の管理です。サブスクの枠は通常の Claude 利用と共有で消費され、5時間単位の枠に加えて週（7日）単位の上限も設けられています。上限に達したら枠のリセットを待つか、API レートでの追加利用に切り替える形になります。「プロジェクト全体を一気に読ませると枠を急速に消費する」点は、初心者がまず体感するところです（次節で対策）。

07使いこなしのコツ

同じツールでも、頼み方ひとつで結果が大きく変わります。最初に身につけたい3つの習慣です。

CLAUDE.md でプロジェクトのルールを定着させる

プロジェクト直下に CLAUDE.md を置くと、Claude Code が起動時に読み込み、作業の前提として扱います。「テストフレームワークは vitest」「コミットメッセージは英語」「外部ライブラリの追加は事前確認」など、毎回言わなくても守ってほしい約束を書いておくと、出力の一貫性が上がります。

小さく頼んで積み上げる

「全部書き直して」より「まずファイル A、結果を見て次に B」と段階を分けます。AI が誤った方向に進んだとき、被害を小さく留められるうえ、各ステップで方向修正もしやすくなります。

うまくいく秘訣は、賢いモデルを選ぶことより 小さく区切って、確認しながら進める こと。

テスト駆動と相性がよい

「このテストが通るように実装して」と頼むと、満たすべき仕様が明確になり、AI の出力が安定します。先にテストを書く文化と Claude Code は噛み合いがよく、合否という客観的な基準で進められます。

08つまずきポイントと処方箋

• 使用枠を一気に消費する：大きなコードベースを丸ごと読ませると枠が急減します → /clear で文脈を整理し、調査はサブエージェントに分離する。
• 権限プロンプト疲れ：確認が多くてテンポが落ちる → 信頼できる作業では編集の自動承認に切り替え、よく使う安全なコマンドは許可リストへ。
• git の競合：Claude のコミットと自分の作業中の変更が衝突することがある → 専用ブランチで作業し、変更をこまめにレビューしてからマージする。
• 仕様あいまいでの暴走：抽象的な丸投げは的外れな実装を生みやすい → まず Plan モードで計画を確認し、合意してから実行する。

09他ツールとの併用と、最初の一歩

Claude Code は単独でも完結しますが、エディタでの細かな日常編集と、エージェントによる大きな変更を使い分ける人も多いです。VS Code や JetBrains では拡張から同じ Claude Code を IDE 内に呼び出せるため、ターミナルと IDE を行き来する必要もありません。プロジェクトのルールを CLAUDE.md に集約しておけば、どの入口から使っても一貫した品質を保てます。

まずは、壊れても困らない練習用リポジトリで claude を起動し、「このプロジェクトの構成を説明して」と尋ねるところから始めましょう。次に小さな修正を Plan モードで頼み、提案された差分を眺めてから承認する――この往復を数回繰り返すうちに、「どこまで任せ、どこを自分で確認するか」の感覚がつかめてきます。