Claude Codeとは — Anthropicのエージェント型AIコーディングCLIの完全ガイド(2026年4月最新版)

Claude Codeとは

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

利用はPro($17–20/月) / Max / Team / Enterpriseプラン、またはAnthropic ConsoleのAPI key(従量課金)。Freeプランでは利用できません。インストールは公式推奨のcurl Native Installで3分で完了し、Opus 4.7を選べば1Mトークンの巨大文脈で大規模リポジトリも一気通貫で処理できます。

Claude Codeの5つのコア特徴

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

Claude Codeでできること8選

始め方 — curl Native Installで3分

公式が 最優先で提示する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

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

# 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

Linuxにはapt / dnf / apkの公式署名付きリポジトリが提供されています。

Native Install以外は自動更新が効きません(brew upgrade 等を手動実行する必要あり)。チーム導入時も自動更新が回るNative Installを推奨します。Homebrewには2系統あり、claude-code caskがstableチャネル、claude-code@latest caskが最新チャネルです。

最初の1セッション

cd ~/your-project
claude

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

対話セッションで自然言語で指示します。

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

Claudeが関連ファイルを読み、変更提案し、承認後に編集します。権限モードがAskであれば、各操作で承認を求めてくるので安心です。

セッションの復帰は claude -c(continue)または claude -r(resume)、対話中なら /resume コマンドで前回のコンテキストを引き継げます。

中核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 コスト・使用量: /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サーバから提供されるpromptは /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 / claude-opus-4-7 / inherit
• permissionMode — 権限モード
• mcpServers — サブエージェント専用のMCPサーバ
• hooks — フック
• skills — 利用するSkills
• effort / isolation / background / color / maxTurns / initialPrompt

代表的な用途: code-reviewer、test-writer、security-audit、doc-linter。関心分離した運用が可能です。

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を作ってレビュー依頼まで」のような定型作業をスキル化すれば、毎回指示を書き直さずに済みます。

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 でgit commit前にlintを自動実行、PermissionRequest で破壊的コマンドを外部監査ログに送る、など。

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

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

# 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サーバ例: Notion、Asana、Sentry、GitHub、Airtable、Playwright、PostgreSQL(@bytebase/dbhub)、Stripe、PayPal、HubSpot。Enterpriseでは managed-mcp.json でallowlist / denylistが可能です。

メモリ(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が自動生成する長期メモリ)は ~/.claude/projects/<project>/memory/MEMORY.md に保存され、最初の200行or 25KBまで自動読み込みされます。10の実戦パターンはCLAUDE.md 10パターンを参照。

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

Claude Codeが利用可能なモデルは次のとおりです。

選び方の指針:

• Opus 4.7: 大規模リファクタ、複雑な仕様理解、長時間のエージェントループ
• Sonnet 4.6: 日常作業の主力。Opusの1/5〜1/3のコストで十分な品質
• Haiku 4.5: コスト最優先、高頻度の軽量タスク(lint提案、簡単な修正)

セッション内で /model で切り替え、コストは /cost で確認できます。

料金プランと選び方

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

FreeプランではClaude Codeは使えません。ConsoleのAPI key(プリペイドクレジット)経由でも利用可能で、こちらは厳密に従量課金です。

Claude Code vs Cursor vs GitHub Copilot

詳細はClaude Code vs Cursor vs Codex 2026年比較を参照。

判断指針: コードを書く工程そのものをAIに任せたいならClaude Code、IDE内で対話的に進めたいならCursor、タイプ中の補完中心ならGitHub Copilot。

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 が別途提供されています。

設定全体の体系はClaude Code設定完全ガイドにまとめています。

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

Claude Codeは更新頻度が高く、週に複数回のリリースが出ることもあります(公式に "週次" と明記はないが、stable / latestの2チャネル運用が事実上のcadence)。

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

Native Installのチャネルは autoUpdatesChannel で切り替え可能。"latest" は即時、"stable" は約1週間遅れ(major regressionをスキップ)です。

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

1. 認証エラー(401)

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

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

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

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

単ファイル100KBを超えると読み込みが遅い。関連部分だけにgrepで絞り、必要最小限のcontextを渡す。/compact でセッション履歴を要約、/clear で完全リセットも有効。

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

権限モードがAskの場合、逐一承認が必要。信頼できる作業は --dangerously-skip-permissions でスキップ可能だが、慎重に(破壊的操作が走る可能性)。Enterpriseは disableBypassPermissionsMode で封じることを推奨。

5. CLAUDE.mdが効かない

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

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

向く人

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

向かない人

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

まとめ — 学習の進め方

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

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

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