Claude Codeとは — Anthropicのエージェント型AIコーディングCLI完全ガイド

Claude Codeとは

Claude Codeは、Anthropicが提供するターミナル発のエージェント型AIコーディングCLIです。コードベース全体を読み、複数ファイルを編集し、テスト実行・gitコミットまで自律的に完了できます。補完中心のCursorやGitHub Copilotとの決定的な違いは、ここにあります。

ターミナルのCLIを起点に、VS Code / JetBrains拡張、デスクトップアプリ、ブラウザー(claude.ai/code)、iOSアプリまで同じエンジンで動きます。利用にはPro / Max / Team / EnterpriseのいずれかのClaudeサブスクリプション、またはAnthropic ConsoleのAPI keyが必要で、無料プランでは使えません。インストールは公式推奨のNative Install(curl / irm)なら数分で完了し、Opusを選べば最大1Mトークンの巨大なコンテキストで大規模リポジトリも一気通貫で扱えます。

向いているのは、複数ファイルにまたがるリファクタやバグ修正、反復作業の型化、大規模コードベースの横断調査を日常的にこなす開発者です。

Claude Codeの5つのコア特徴

1. エージェント型の自律動作 — タスクを投げれば、複数ファイルの読み書き、テスト実行、リポジトリ操作まで連続でこなします
2. コードベース全体の文脈把握 — Opus 4.8 / Sonnet 4.6の1Mトークンを活かし、大規模コードベースを俯瞰してから作業します
3. マルチサーフェス — ターミナルCLIを中心に、VS Code / JetBrains拡張、デスクトップ、Webでも同じCLAUDE.mdや設定を共有できます
4. 拡張性がエコシステム級 — Skills、Sub Agents、Hooks、MCP、Slash Commandsを組み合わせて自分用のワークフローを組めます
5. エージェントループ — 「書く → 実行 → 失敗 → 直す → 再実行」を自律的に回します

Claude Codeでできること8選

このうち「自分のチームでどのモデルを、いくらで、どう使うか」を先に詰めたい場合は、Claude Code料金プラン選び方ガイドが判断材料になります。

始め方 — Native Installで数分

公式が最優先で示すRecommendedはNative Install(curl / irmベース)です。Node.js環境に依存せず、自動バックグラウンド更新が効くのが利点です。

# 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

代替として、以下のパッケージマネージャー経由も提供されています。

# macOS(Homebrew)
brew install --cask claude-code
 
# Windows(WinGet)
winget install Anthropic.ClaudeCode
 
# npm(Node.js 18以降が必須、sudo npm install -g は非推奨)
npm install -g @anthropic-ai/claude-code

Debian / Fedora / RHEL / Alpine向けには、apt / dnf / apkの公式署名付きリポジトリが用意されています。npm版は内部的にNative Installと同じバイナリを入れる仕組みで、claude バイナリ自体はNodeを呼び出しません。

Native Install以外は自動更新が効かないため、brew upgrade 等を手動で実行する必要があります。Homebrewには2系統あり、claude-code caskがstableチャネル(約1週間遅れ、major regressionをスキップ)、claude-code@latest caskが最新チャネルです。組織で配布するときは、最新版に揃いやすいNative Installが扱いやすい選択肢になります。

最初の1セッション

cd ~/your-project
claude

初回はブラウザーが開き、Anthropicアカウントでサインインします。認証情報はローカルに保存され、次回以降は自動で使われます。利用できるのはPro / Max / Team / Enterpriseのサブスクリプション、またはConsoleのAPI key(プリペイドクレジット)で、無料のClaude.aiプランにClaude Codeは含まれません。Amazon Bedrock、Google Vertex AI、Microsoft Foundry経由でも利用できます。

対話セッションでは自然言語で指示します。最初は次の順で試すと、Claude Codeの動き方がつかめます。

このプロジェクトは何をするものですか

まずコードベースを読ませて全体像を把握させます。続けて小さな変更を頼みます。

app/login のフォームに email バリデーションを追加してください

Claudeが対象ファイルを特定し、変更案を提示し、承認後に編集します。最後に履歴の確認とコミットも自然言語で頼めます。

変更内容をわかりやすいメッセージでコミットしてください

権限モードがAskであれば各操作で承認を求めてくるので、いきなり破壊的な操作が走る心配はありません。

セッションの復帰は claude -c(continue)または claude -r(resume)、対話中なら /resume コマンドで前回のコンテキストを引き継げます。インストール後に動作確認したいときは claude --version と claude doctor が役立ちます。

コマンド以外の操作 — @・!・Shift+Tab・画像ペースト

スラッシュコマンド以外にも、入力中に覚えておくと体感が大きく変わる操作があります。最初の数分で手に馴染ませておくと、以降のやり取りが滑らかになります。

@ は「この設計、@app/login/page.tsx を見て直して」のように、読ませたいファイルを明示したいときに使います。! で打ったコマンドは結果がそのまま文脈に残るため、テスト結果やgitの状態を見せながら相談する流れが作れます。

画像ペーストのキーは環境で変わります。一般的なターミナルは Ctrl+V、iTerm2は Cmd+V、WindowsとWSLは Alt+V です。UIのスクリーンショットやエラー画面を貼って「この表示を直して」と頼めます。Shift+Tab で入る plan モードは、編集を保留したまま計画だけ先に出させる安全運用に向いています(詳細はPlan mode完全ガイド)。

最初に覚えるキー操作

ターミナルで詰まりやすい基本操作です。

セッションを開くと、git履歴をもとにした入力候補が薄く表示されます。Tab か → で採用し、Enter で送信できます。

どの面で使えるか — CLI以外のサーフェス

Claude Codeはターミナルだけの道具ではありません。同じエンジンが複数の面で動き、CLAUDE.md・設定・MCPサーバーがそのまま共有されます。

セッションは1つの面に固定されません。Webやスマホで起動したタスクを claude --teleport で手元のターミナルに引き込む、ターミナルの作業を /desktop でデスクトップアプリに渡して差分を視覚確認する、といった移動ができます。チーム連携としては、Slackで @Claude にバグ報告するとPRが返ってくる経路、GitHub ActionsやGitLab CI/CDでのレビュー自動化、Chromeでの実行中アプリのデバッグも用意されています。CLIとIDEのどちらを主に使うかで迷う場合は、Claude.aiとClaude Codeの違いも参考になります。

中核5機能の使い分け早見表

Claude Codeの拡張機構は5つあり、似て見えますが役割が違います。最初に押さえておくと迷いにくくなります。

迷ったときの目安は次のとおりです。

• 「この一連の手順を毎回やる」 → Slash CommandかSkill
• 「主担当Claudeと別人格でやらせたい」 → Sub Agent
• 「コマンド前にlint、後にformatを必ず実行」 → Hooks
• 「外部DB / APIを呼びたい」 → MCP

各機能の実戦パターンはClaude Codeワークフロー設計集、Claude Code Skills 5パターン、Hooks入門、MCP活用ガイドで扱っています。

Slash Commands — 40+ の組み込みコマンド

公式に提示されているスラッシュコマンドは40種以上あります。代表的なものを役割別に並べると次のとおりです。

• セッション管理: /resume(alias /continue)、/clear、/compact、/exit、/context、/btw(会話履歴を汚さず現在の作業について質問。ツールは使わず今の文脈だけで即答)
• コスト・使用量: /cost(alias /usage)
• 診断・設定: /doctor、/config(alias /settings)、/status、/theme
• モデル切り替え: /model、/effort、/fast
• 権限・セキュリティ: /permissions、/sandbox、/security-review
• プランニング: /plan、/review
• 拡張機能: /agents、/skills、/hooks、/mcp、/plugin、/reload-plugins
• バージョン管理連携: /branch(alias /fork)、/diff、/rewind(alias /checkpoint / /undo)
• 外部エクスポート: /export、/release-notes、/tasks、/schedule

さらにBundled Skillsとして /batch、/claude-api、/debug、/loop、/simplify が組み込まれています。MCPサーバーから提供されるプロンプトは /mcp__<server>__<prompt> の形で自動公開されます。

毎日・週次・緊急時に分けた実用的な使い分けはClaude Codeスラッシュコマンド実用集で詳しく扱っています。

Sub Agents — 関心分離で並行作業

サブエージェントは、特定タスクに特化した小さなClaudeを定義し、メインセッションから呼び出せる仕組みです。配置場所は次のとおりです。

• .claude/agents/*.md(プロジェクト共有)
• ~/.claude/agents/*.md(ユーザー個人)
• Managed Settings(Enterprise)
• プラグイン同梱
• --agents '<json>' でCLI起動時に渡す

YAML frontmatterで必須なのは name と description だけです。任意で次のフィールドが使えます。

• tools / disallowedTools — 使用可能ツールの制御
• model — sonnet / opus / haiku / inherit などの指定
• permissionMode — 権限モード
• mcpServers — サブエージェント専用のMCPサーバー
• hooks — フック
• skills — 利用するSkills
• effort / isolation / background / color / maxTurns / initialPrompt

代表的な用途は code-reviewer、test-writer、security-audit、doc-linter などです。複数のサブエージェントを同時に走らせるagent teamsや、画面ひとつで複数の本格セッションを監視するbackground agentsと組み合わせると、長時間運用の構造を作りやすくなります。作り方の詳細はClaude Code Sub-agents完全ガイドを参照してください。

Skills — 作業手順をMarkdownでテンプレ化

Skillsは、再利用可能な作業手順をMarkdown+少量のYAMLで定義する仕組みです。

• 配置: .claude/skills/<name>/SKILL.md(プロジェクト)/ ~/.claude/skills/<name>/SKILL.md(個人)/ EnterpriseのManaged
• frontmatterはすべて任意ですが description を推奨
• 主なfrontmatterキー: when_to_use、disable-model-invocation、user-invocable、allowed-tools、model、context: fork、agent、paths、arguments、hooks、shell
• サポートファイル(scripts/、reference.md等)を同梱可能
• 置換変数: $ARGUMENTS、${CLAUDE_SKILL_DIR}、${CLAUDE_SESSION_ID}

「PRを作ってレビュー依頼まで」のような定型作業をスキル化すれば、毎回指示を書き直さずに済みます。設計のコツはClaude Code Skills完全ガイドで扱っています。

Hooks — ライフサイクルで任意コマンドを発火

Hooksは、Claude Codeのライフサイクルイベントで任意のシェルコマンド / HTTP / MCPツールを呼び出す仕組みです。公式に定義されたイベントは多岐にわたります。

• セッションライフサイクル: SessionStart、SessionEnd、InstructionsLoaded、Stop、StopFailure
• ユーザー入力: UserPromptSubmit、UserPromptExpansion、Elicitation、ElicitationResult
• ツール実行: PreToolUse、PostToolUse、PostToolUseFailure、PostToolBatch
• 権限: PermissionRequest、PermissionDenied
• サブエージェント: SubagentStart、SubagentStop
• タスク: TaskCreated、TaskCompleted、TeammateIdle
• 設定・環境: ConfigChange、CwdChanged、FileChanged
• ワークツリー: WorktreeCreate、WorktreeRemove
• コンパクション: PreCompact、PostCompact
• 通知: Notification

typeは command(シェルコマンド)/ http(外部Webhook)/ mcp_tool(MCPツール)の3種です。PostToolUse でファイル編集後に自動フォーマットを走らせる、PermissionRequest で破壊的コマンドを外部監査ログへ送る、といった使い方ができます。レシピ集はClaude Code Hooks完全ガイドにまとめています。

MCP — 外部ツール接続の標準

MCP(Model Context Protocol)はAnthropicが提唱したオープン規格で、Claudeが外部ツール(DB、API、ファイルシステム、社内ツール)を呼び出すための標準プロトコルです。設定はCLIから追加できます。

# CLI で追加
claude mcp add --transport <http|sse|stdio> <name> <url-or-cmd>

または .mcp.json(projectスコープ、VCS共有)に記述します。スコープは local(~/.claude.json)/ project(.mcp.json)/ user の3レベルで、環境変数展開(${VAR:-default})もサポートします。

公式に紹介されているMCPサーバー例は、Google Drive、Jira、Slack、Sentry、GitHub、Playwright、PostgreSQL(@bytebase/dbhub)、Stripeなどです。Enterpriseでは managed-mcp.json でallowlist / denylistを管理できます。実装手順はMCP活用ガイドで扱っています。

メモリ(CLAUDE.md)— プロジェクト固有の文脈

Claude Codeはセッション開始時に階層的にメモリファイルを読み込みます。配置と読み込み順序は次のとおりです(上から優先)。

1. Managed(Enterprise) — /Library/Application Support/ClaudeCode/CLAUDE.md(macOS)等
2. Project — ./CLAUDE.md または ./.claude/CLAUDE.md(親ディレクトリまで遡って全ファイル読み込み)
3. User — ~/.claude/CLAUDE.md
4. Local — ./CLAUDE.local.md(個人メモ、VCS除外推奨)

@path/to/file 記法で他ファイルをimportできます(最大5 hop)。.claude/rules/*.md に paths: frontmatterでパススコープルールも置けます。AGENTS.md は直接読まれないので @AGENTS.md でimportするのが推奨です。

Auto memory(セッション中にClaudeが自動生成する長期メモリ)も用意され、ビルドコマンドやデバッグの知見を書かずに横断保存できます。10の実戦パターンはCLAUDE.md 10パターンを参照してください。

対応モデル — どれを使うべきか

Claude Codeで使えるモデルは、opus / sonnet / haiku のエイリアスで指定するのが基本です。Anthropic API経由では、各エイリアスが次のバージョンに解決されます(2026年6月時点)。

選び方の目安は次のとおりです。

• Opus 4.8: 大規模リファクタ、複雑な仕様理解、長時間のエージェントループ。既定のeffortは high
• Sonnet 4.6: 日常作業の主力。Opusより低コストで実用品質
• Haiku 4.5: コスト最優先、高頻度の軽量タスク(lint提案、簡単な修正)

セッション内で /model を使うと即座に切り替えられ、/model 単独でピッカーが開きます。opus[1m] / sonnet[1m] のように [1m] を付けると1Mコンテキストを明示できます。計画フェーズはOpus、実装はSonnetに自動で切り替える opusplan エイリアスも便利です。コストは /cost で確認できます。

default を選んだときの解決先はアカウント種別で変わります。Max / Team Premium / Enterprise(従量) / APIではOpus 4.8、Pro / Team Standard / EnterpriseのシートではSonnet 4.6が既定です。Opus 4.8はClaude Code v2.1.154以降で利用できるため、claude update で最新版に上げておくと選べます。モデルの使い分けをより詳しく知りたい場合はモデル選定ガイドが参考になります。

1Mコンテキストはどのプランで使えるか

1Mトークンのコンテキストは、プランによって利用条件が異なります。

200Kを超えても追加のトークン単価が乗らない点が特徴です。1Mを完全に無効化したいときは環境変数 CLAUDE_CODE_DISABLE_1M_CONTEXT=1 を設定します。

料金プランと選び方

Claude Codeの利用に必要なプラン構成は次のとおりです(2026年6月時点。料金体系は時々改定されます)。

無料プランにClaude Codeは含まれません。ConsoleのAPI key(プリペイドクレジット)経由でも利用でき、こちらは厳密に従量課金です。プラン横断の比較や「Pro / Maxどちらが得か」の損益分岐はClaude料金プラン総まとめとClaude Code料金プラン選び方ガイドで扱っています。

Claude Code vs Cursor vs GitHub Copilot

GitHub Copilotとの違いはClaude Code vs GitHub Copilot比較、VS Code拡張系のClineとの違いはClaude Code vs Cline比較、CursorやCodexを含む3者の比較はClaude Code vs Cursor vs Codex 2026年比較で詳しく扱っています。

判断の目安は次のように整理できます。コードを書く工程そのものをAIに任せたいならClaude Code、IDE内で対話的に進めたいならCursor、タイプ中の補完が中心ならGitHub Copilotが噛み合います。CursorからClaude Codeへ移りたい場合はCursorからの移行ガイドも用意しています。

CoworkとClaude Codeの使い分け

同じAnthropic製品でも、Claude Codeは開発者向けCLI、Coworkはビジネスユーザー向けのデスクトップエージェントです。

両方を使う職種(プロダクトマネージャー、テクニカルライター、DevRel)は併用が現実的です。

セキュリティと権限管理

Claude Codeはローカルファイルを読み書きし、コマンドを実行するため、セキュリティ設計は避けて通れません。権限モード(Ask / Allow / Plan / Sandbox)、サンドボックス、データ扱いの整理はClaude Codeセキュリティ・権限ガイドを参照してください。

Enterprise向けのManaged Settingsは3形式で配布できます。

• Anthropicサーバー配信(ビジネス契約)
• MDM(macOS plist、Windowsレジストリ HKLM\SOFTWARE\Policies\ClaudeCode)
• ファイル配布(managed-settings.json、managed-settings.d/*.json)

3種類とも同じJSONスキーマで、組織ポリシーを統一できます。MCP制御用には managed-mcp.json が別途用意されています。availableModels で利用可能なモデルを制限したり、minimumVersion で古いバージョンへの自動ダウングレードを防いだりもできます。設定全体の体系はClaude Code設定完全ガイドにまとめています。

計画してから実行する — Plan modeとworktree

破壊的な変更や設計判断を伴う作業では、いきなり編集させずに計画を先に出させると安全です。/plan で入るPlan modeは、ファイル編集を保留したままClaudeに計画を提示させ、承認してから実行に移します。opusplan エイリアスと組み合わせると、計画はOpus、実装はSonnetという自動切り替えになります。詳細はClaude Code Plan mode完全ガイドを参照してください。

複数のタスクや複数のエージェントを並行で走らせたいときは、gitのworktreeで作業ツリーを分離すると、ブランチごとに独立した作業領域を保てます。手順はClaude Code worktree完全ガイドで扱っています。

バージョン追跡 — 最新情報を逃さない

Claude Codeは更新頻度が高く、stable / latestの2チャネルで継続的にリリースが出ます。

• Claude Codeのリリースノート一覧

Native Installのチャネルは autoUpdatesChannel で切り替えられます。"latest" は即時、"stable" は約1週間遅れ(major regressionをスキップ)です。minimumVersion を併用すると、stableへ切り替えても新しい版から不要に下がらないように下限を固定できます。

よくあるつまずき5つと回避策

1. 認証エラー(401)

地域制限・プロキシ・社内ネットワークの影響が多いケースです。IT管理者にAnthropic APIへのホワイトリスト登録を依頼します。無料プランで claude を実行してもログインできないため、Pro以上のサブスクリプション、またはConsoleのAPI keyが必要です。

2. コストが想定以上に高い

Opusを多用すると1日で数十USDに達することがあります。/cost で現在のセッション使用量を確認し、日常作業はSonnet 4.6 + /effort medium に落とすのが基本です。重要なセッションだけOpusを呼ぶ運用が現実的です。

3. 大きなファイルで反応が遅い

単ファイルが大きいと読み込みに時間がかかります。関連部分だけにgrepで絞り、必要最小限のコンテキストを渡します。/compact でセッション履歴を要約、/clear で完全リセットも有効です。

4. 権限エラーで操作が止まる

権限モードがAskの場合、逐一の承認が必要になります。信頼できる作業は --dangerously-skip-permissions でスキップできますが、破壊的操作が走る可能性があるため慎重に扱います。Enterpriseは disableBypassPermissionsMode で封じる選択肢があります。

5. CLAUDE.mdが効かない

CLAUDE.mdの位置がプロジェクトルートか確認します。monorepoの場合、作業中のパッケージディレクトリに置く必要があります。/memory で読み込まれたメモリの一覧を確認できます。

切り分けに迷ったときは、エラー別の対処をまとめたClaude Codeトラブルシューティングガイドが役立ちます。

Claude Codeを使うべき人 / 向かない人

向く人

• 複数ファイル横断のタスクが多い — リファクタ、バグ修正、テスト追加
• 反復作業を型化したい — 同じようなPRを何度も作る、リリースノート整理
• CLI / スクリプト運用に慣れている — ターミナル中心で仕事する開発者
• 自律エージェントを活かしたい — 人を介さずタスクを完結させたい
• 大規模コードベースで文脈把握が要る — 1Mトークンのコンテキストを使い切る

向かない人

• タイプ中の補完が主目的 — GitHub Copilotが噛み合う
• IDE一体型を好む — Cursorが噛み合う
• 小規模な修正のみ — 無料のClaude.aiで足りる
• 無料プラン縛り — Claude Codeは無料プランで使えない

よくある質問

Claude Codeは無料で使えますか

無料のClaude.aiプランにClaude Codeは含まれません。利用にはPro / Max / Team / Enterpriseのいずれか、またはAnthropic ConsoleのAPI key(プリペイドクレジット)が必要です。

Claude Codeとは何ですか、ChatGPTとどう違いますか

Claude Codeは、コードベースを読んで複数ファイルを編集し、テスト実行やgitコミットまで自律的に進めるエージェント型のCLIです。チャットUIで回答を返すだけのツールと違い、実際にファイルを書き換え、コマンドを実行して結果を確認しながら作業を進めます。

どのモデルを選べばよいですか

複雑な設計や大規模リファクタにはOpus 4.8、日常のコーディングにはSonnet 4.6、高頻度で軽い作業にはHaiku 4.5が目安です。セッション中は /model で切り替えられ、計画にOpus・実装にSonnetを自動で割り当てる opusplan も選べます。

Claude CodeとCursorはどちらがよいですか

書く工程そのものを自律エージェントに任せたいならClaude Code、エディター内で対話しながら進めたいならCursorが噛み合います。詳しい比較はClaude Code vs Cursor vs Codex 2026年比較で扱っています。

Windowsでも動きますか

動きます。PowerShellまたはCMDからNative Installできるほか、WSL 2でも利用できます。Git for Windowsを入れるとBashツールが使え、WSL 2環境ではサンドボックスにも対応します。

VS CodeやJetBrainsから使えますか

使えます。VS Code拡張ではインライン差分や計画レビュー、JetBrainsプラグインでは差分ビューや選択範囲の共有がエディター内で完結します。CLIと同じCLAUDE.mdや設定が共有されます。

コストを抑えるにはどうすればよいですか

日常作業をSonnet中心にし、/effort を下げ、/cost で使用量を随時確認するのが基本です。Opusは重要なセッションに絞ると費用対効果が安定します。プラン選びはClaude Code料金プラン選び方ガイドが判断材料になります。

1Mトークンのコンテキストは誰でも使えますか

Max / Team / EnterpriseではOpusの1Mがサブスクに含まれます。Sonnetの1M、およびProでのOpusの1Mは追加のusage creditが必要です。API / 従量課金ではフルアクセスです。

CLAUDE.mdには何を書けばよいですか

コーディング規約、アーキテクチャの方針、使うライブラリ、レビュー観点などプロジェクトの前提を書きます。セッション開始時に毎回読まれるため、繰り返し説明している内容を移すと指示が短くなります。具体例はCLAUDE.md 10パターンで扱っています。

まとめ — 学習の進め方

Claude Codeを最短で身に付けるには、次の順序が現実的です。

1. インストール後に /resume / /cost / /doctor の3コマンドを覚える(初日)
2. CLAUDE.mdにプロジェクトの前提を書く(初週)
3. よく使うタスクをSkillsにする(2週目以降)
4. 危険な操作をHooksでgateする(1ヶ月目)
5. Sub AgentsとMCPで関心分離と外部ツール連携を組む(本格運用フェーズ)

まずはProプランで1リポジトリ、1週間使ってみるのが、最もコストの低い入口になります。