Claude Code(クロードコード)とは — CLI起点のエージェント型開発ツール

Claude Codeとは

Claude Code(クロードコード)は、Anthropicが提供するエージェント型の開発ツールです。コードベース全体を読み、複数ファイルを横断編集し、コマンドを実行し、テストの結果を見て自分で直す。この「書く→実行→失敗→直す→再実行」のループを、承認を挟みながら自律的に回します。

補完中心のGitHub Copilotや、対話中心のChatGPTとの違いはここにあります。Claude Codeはチャットで答えを返すだけでなく、実際にファイルを書き換え、コマンドを実行し、その結果を見ながら作業を進めます。ターミナルのCLIが起点ですが、同じエンジンがVS Code / JetBrains拡張、デスクトップアプリ、ブラウザー(claude.ai/code)、iOS / Androidアプリでも動き、CLAUDE.mdや設定、MCPサーバーの接続をそのまま共有します。

利用にはPro / Max / Team / EnterpriseいずれかのClaudeサブスクリプション、またはAnthropic ConsoleのAPI keyが必要です。無料のClaude.aiプランにClaude Codeは含まれません。Amazon Bedrock、Google Cloudのエージェントプラットフォーム、Microsoft Foundry経由でも利用できます。

向いているのは、複数ファイルにまたがるリファクタやバグ修正、反復作業の型化、大規模コードベースの横断調査を日常的にこなす開発者です。最上位のFable 5を選べば最大1Mトークンのコンテキストで大規模リポジトリも一気通貫で扱えます。

提供形態 — 同じエンジンが複数の面で動く

Claude Codeは1つの実行エンジンが複数の面(サーフェス)に配信される設計です。どの面から始めても、CLAUDE.mdや権限設定、接続済みのMCPサーバーは共有されます。

セッションは1つの面に固定されません。Web版やスマホで起動したタスクをclaude --teleportで手元のターミナルに引き込む、ターミナルの作業を/desktopでデスクトップアプリに渡して差分を視覚確認する、外部のTelegramやDiscordのメッセージをチャネルとしてセッションに取り込む、といった移動ができます。CLIとIDEの使い分けに迷う場合はClaude.aiとClaude Codeの違いが参考になります。VS Code拡張の設定はClaude Code VS Codeガイド、Web・モバイルの操作はClaude Code Web・モバイルガイドで個別に扱っています。

インストール — Native Installと代替経路

システム要件はmacOS 13.0以降、Windows 10 1809以降(またはWindows Server 2019以降)、Ubuntu 20.04以降、Debian 10以降、Alpine Linux 3.19以降で、RAMは4GB以上が必要です。検索ツールのripgrepはバイナリに同梱されています。

公式が最優先で示すインストール方法は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)では次の形を使います。PowerShellと間違えると&&やirmのエラーが出るので、プロンプトの表示(PS C:\かC:\か)で見分けます。

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

代替として、以下のパッケージマネージャー経由も提供されています。いずれも自動更新はされないため、brew upgradeやwinget upgradeを手動で実行する必要があります。

# macOS(Homebrew。claude-codeはstableチャネル、claude-code@latestは最新チャネル)
brew install --cask claude-code
 
# Windows(WinGet)
winget install Anthropic.ClaudeCode
 
# npm(Node.js 22以降が必須。sudo npm install -g は非推奨)
npm install -g @anthropic-ai/claude-code

Debian / Fedora / RHEL / Alpine向けには、apt / dnf / apkの署名付き公式リポジトリが用意され、stableとlatestの2チャネルを選べます。npm版は内部的にNative Installと同じネイティブバイナリを@anthropic-ai/claude-code-darwin-arm64のようなプラットフォーム別パッケージ経由で取得する仕組みで、claudeバイナリ自体はNodeを呼び出しません。

インストール後は次で動作確認します。

claude --version
claude doctor

claude doctorはセッションを開始せず、インストール状態・設定ファイルの検証エラー・推奨される修正を表示する読み取り専用の診断です。組織で配布するときは、最新版に揃いやすいNative Installが扱いやすい選択肢になります。手順の全体はClaude Codeインストールガイドで詳しく扱っています。

最初のセッション — ログインから最初の編集まで

cd ~/your-project
claude

初回はブラウザーが開き、Anthropicアカウントでサインインします。ANTHROPIC_API_KEY環境変数を設定していれば、ログインではなくキーの承認プロンプトが出ます。認証情報はローカルに保存され、次回以降は自動で使われます。

セッションを開始したら、まずコードベースを理解させる質問から始めると動き方がつかめます。

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

続けて小さな変更を頼みます。

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

Claudeが対象ファイルを特定し、変更案を提示し、権限モードに応じて承認を求めてから編集します。最後にgit操作も自然言語で頼めます。

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

日常的に使う操作を早見表にまとめます。

セッションの復帰はターミナルからのclaude -c / claude -rのほか、対話中なら/resumeコマンドでも前回のコンテキストを引き継げます。

覚えておきたい基本操作

スラッシュコマンド以外にも、入力中に覚えておくと体感が変わる操作があります。

@は「この設計、@app/login/page.tsxを見て直して」のように、読ませたいファイルを明示したいときに使います。!で打ったコマンドは結果がそのまま文脈に残るため、テスト結果やgitの状態を見せながら相談する流れが作れます。画像ペーストのキーは環境で変わり、一般的なターミナルはCtrl+V、iTerm2はCmd+V、WindowsとWSLはAlt+Vです。

ターミナルで詰まりやすい基本操作も押さえておきます。Tabでコマンドやサジェストを補完、↑ / ↓で入力履歴をたどる、Ctrl+Rで過去の入力を逆方向検索、Escで応答やツール実行を途中で止める(それまでの作業結果は保持されます)。セッションを開くとgit履歴をもとにした入力候補が薄く表示され、Tabか→で採用してEnterで送信できます。全ショートカットの早見表とkeybindings.jsonでのカスタマイズ方法はClaude Codeショートカット一覧にまとめています。

どのモデルを使うか — Fable 5を含む対応モデル

モデルはfable / opus / sonnet / haikuのエイリアスで指定するのが基本です。エイリアスが解決する先はプロバイダーで変わります。

セッション内で/model <alias|name>と打てば即座に切り替わり、/model単独ならピッカーが開きます。opus[1m] / sonnet[1m]のように[1m]を付けると1Mコンテキストを明示できます。計画フェーズはOpus、実装はSonnetに自動で切り替えるopusplanエイリアスも便利です。組織でFable 5が使える環境ではFable 5に、使えない環境では最新のOpusに解決されるbestエイリアスもあります。

defaultを選んだときの解決先はアカウント種別で変わります。Max / Team Premium / Enterprise従量課金 / APIではOpus 5、Pro / Team Standard / EnterpriseのシートではSonnet 5が既定です。Fable 5はどのプランでも既定にならず、/model fableでの明示的な選択が必要です。

Fable 5だけの制約もあります。全トラフィックで30日間のデータ保持が必須で、ゼロデータ保持(ZDR)契約の環境ではモデル一覧に出てこないか無効の状態で並びます。無償での提供は2026年7月19日(PT)に終了し、7月20日以降はProプランではusage credits経由、Maxプランでは週次上限の50%までが無償枠になります。思考(adaptive thinking)は常時オンで無効化できません。安全分類器が生物学関連と判定したリクエストはOpus 5で、サイバーセキュリティ関連と判定したリクエストはOpus 4.8で自動的に再実行されます。Fable 5はv2.1.170以降、Sonnet 5はv2.1.197以降、Opus 5はv2.1.219以降で選べます。VS Code拡張機能での切り替え手順はVS CodeでFable 5を使う方法にまとめています。

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

Sonnet 5・Fable 5・Opus 4.7以降は、Anthropic API経由なら常に1Mトークンのコンテキストウィンドウで動きます。それ以外の組み合わせはプランで条件が変わります。

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

Effort(推論の深さ)とFast mode

/effortコマンドで、モデルがどれだけ深く考えるかを調整できます。選べるレベルはモデルで異なります。

既定はhigh(Opus 4.7だけxhigh)です。/effortメニューにはultracodeもあり、こちらは単なる推論レベルではなくClaude Codeの設定で、xhighの推論に加えて実質的なタスクごとに動的ワークフローを組ませます。1回限りの深い思考が欲しいときは、プロンプトのどこかにultrathinkと書けば、セッションのeffort設定を変えずにその返答だけ深く考えさせられます。

Fast modeは、Opus 5とOpus 4.8をより高速に動かす研究プレビュー機能です(/fastで切替)。同じモデル・同じ品質のまま最大2.5倍高速になりますが、トークン単価は入力$10 / 出力$50(MTok単位)と高くなります。SonnetやHaikuでは使えず、VS Code拡張でも使えません。個人アカウントはusage creditsを有効化していれば使え、Team / Enterpriseは組織のOwnerが有効化して初めて使えます。Opus 4.7のFast modeは2026年6月25日に非推奨化、7月24日に廃止されました。詳しい仕組みと切り分けはClaude Code Fast mode完全ガイドを参照してください。

プランと機能アクセスの早見表

料金プランをまたいで見えにくいアクセス条件を1つの表にまとめます。Fable 5だけは、Team / EnterpriseでもStandardとPremiumで条件が分かれます。

Fable 5はどのプランでもZDR(ゼロデータ保持)契約の環境では利用できません。座席の種類ではなく契約形態そのものの制約なので、Standard / Premiumを問わず該当します。

権限モードの選び方

Claudeがファイルを編集したりコマンドを実行したりするたび、承認を求めて一時停止します。権限モードは、その一時停止の頻度を決める設定です。Shift+Tabで循環させるか、--permission-modeフラグで起動時に指定します。

.git、.claude、.vscode、.npmrc、シェルの起動ファイルなど一部のパスは「保護パス」として、Bypass permissionsモード以外では常に承認を求められます。誤って自分の設定を壊さないためのガードです。

Plan modeは、破壊的な変更や設計判断を伴う作業で有効です。/planで入り、ファイル編集を保留したままClaudeに計画を提示させ、承認してから実行に移します。Auto modeが利用できる環境では、調査中のシェルコマンドは一時停止ではなく分類器の承認を通して実行されます。opusplanエイリアスと組み合わせると、計画はOpus、実装はSonnetという自動切り替えになります。詳細はClaude Code Plan mode完全ガイドを参照してください。

Auto modeの分類器は何を止め、何を通すか

Auto modeは「毎回の承認プロンプトをなくす」機能ですが、実態は無条件の自動承認ではありません。ツール呼び出しのたびに、専用の分類器モデルがその行動を審査し、要求を逸脱する操作・見覚えのない基盤への接続・敵対的な内容に誘導された疑いのある操作を止めます。承認そのものを省くのではなく、承認の主体を人からモデルに移す設計です。

既定でブロックされる代表的な操作には、curl | bashのようなコード実行、機密データの外部送信、本番デプロイやマイグレーション、force push、git reset --hardのような未コミット変更を破棄するコマンド、シークレットマネージャーへの書き込み、承認されていないPRのマージが含まれます。逆に、作業ディレクトリ内のローカルなファイル操作、ロックファイルに宣言済みの依存関係インストール、読み取り専用のHTTPリクエストは既定で許可されます。

分類器が3回連続、または合計20回操作をブロックすると、Auto modeは一時停止して通常の承認プロンプトに戻ります。境界を会話中で明言する(「pushしないで」等)と、その指示は分類器にとってもブロック信号として扱われ、後で撤回するまで有効です。ただし境界は会話のtranscriptから毎回読み直される仕組みなので、コンテキストが要約されて発言そのものが失われると効力を失います。確実に止めたい操作は、会話での指示ではなくpermissions.denyルールとして明示するのが安全です。

利用にはモデルとプロバイダーの条件があり、Anthropic APIとClaude Platform on AWSではOpus 4.6以降・Sonnet 4.6以降・Fable 5が対象です。組織はpermissions.disableAutoModeで無効化もできます。有効化の手順と組織向け設定はClaude Code Auto mode有効化ガイドにまとめています。差分を細かく確認せずに実装を進める「vibe coding」の実践でも、acceptEditsやAuto modeとの組み合わせ方が鍵になります。詳しくはvibe codingとは — Claude Codeでの安全な始め方で扱っています。

サンドボックスと安全設計

サンドボックス化されたBashツールは、コマンドを承認なしで動かせるようにしつつ、ファイルシステムとネットワークへのアクセスをOSレベルで制限する仕組みです。macOSは組み込みのSeatbelt、Linux / WSL2はbubblewrapとsocatを使います。ネイティブWindowsでは動かず、WSL2の内側で実行する必要があります。

既定では、書き込みは作業ディレクトリとセッションの一時ディレクトリに限られ、読み取りは拒否リストにある場所を除いて全体に及びます。この既定の読み取り範囲は~/.aws/credentialsや~/.ssh/も含んでしまうため、sandbox.credentials設定で明示的にブロックする必要があります。ネットワークは既定で全ドメイン拒否で、コマンドが新しいドメインへの接続を必要とするたびに承認を求めます。

サンドボックスのモードは2つあります。Auto-allowモードはサンドボックス内で完結するコマンドを承認なしで実行し、Regular permissionsモードはサンドボックス化されていても通常の承認フローを通します。どちらのモードでも、明示的な拒否ルールとrm -rf /のようなルート・ホームディレクトリの削除は常にプロンプトが出ます。開発コンテナでの隔離実行との使い分けはdevcontainerとサンドボックス完全ガイドで扱っています。

拡張5機構の使い分け

Claude Codeの拡張機構は5つあり、似て見えますが役割が違います。

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

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

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

Skillsは、SKILL.mdにYAML frontmatterと手順を書くだけで、Claudeがツールキットに追加する仕組みです。カスタムコマンドはSkillsに統合され、.claude/commands/deploy.mdと.claude/skills/deploy/SKILL.mdはどちらも/deployを作り、同じように動きます。

frontmatterの主なキーは次のとおりです。

本文内では$ARGUMENTSや$0 $1で引数を、${CLAUDE_SKILL_DIR}でスキル自身のディレクトリを参照できます。!`command`の行はClaudeが読む前にシェルコマンドを実行し、出力をその場に差し込む「動的コンテキスト注入」にも使えます。

配置場所は、組織全体のEnterprise管理設定、個人用の~/.claude/skills/、プロジェクト用の.claude/skills/、プラグイン同梱の4段階です。同名スキルが複数あるとき優先されるのはEnterprise > 個人 > プロジェクトの順です。詳しい設計と実例はClaude Code Skills完全ガイド、パターン集はClaude Code Skills 5パターンで扱っています。

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

サブエージェントは、特定タスクに特化した小さなClaudeをメインセッションから呼び出す仕組みです。組み込みでExplore(読み取り専用の高速探索、メインの会話モデルを継承)、Plan(計画のための調査、書き込み不可)、general-purpose(調査と修正の両方が要る複雑タスク)が用意されています。

frontmatterで必須なのはnameとdescriptionだけです。任意で使えるキーは次のとおりです。

配置は.claude/agents/*.md(プロジェクト共有)、~/.claude/agents/*.md(個人)、Managed Settings、プラグイン同梱、--agents '<json>'でのCLI起動時指定です。代表的な用途はcode-reviewer、test-writer、security-auditなどです。複数のサブエージェントを同時に走らせるagent teamsや、画面ひとつで複数の本格セッションを監視するbackground agentsと組み合わせると、長時間運用の構造を作りやすくなります。作り方の詳細はClaude Code Sub-agents完全ガイド、実装例はサブエージェント作成ガイドを参照してください。

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

Hooksは、Claude Codeのライフサイクルイベントでコマンド・HTTP・MCPツール・プロンプト・サブエージェントを呼び出す仕組みです。イベントはセッション単位(SessionStart / SessionEnd)、ターンごと(UserPromptSubmit / Stop)、ツール呼び出しごと(PreToolUse / PostToolUse)に大別されます。権限判定(PermissionRequest)やサブエージェントの開始・終了(SubagentStart / SubagentStop)にも対応します。

ハンドラーの種類は5つです。

フックはJSON経由でコンテキストを受け取り、終了コード2でブロッキングエラーを返す、またはpermissionDecision: "deny"を含むJSONを返すことで操作を止められます。マッチャーにはBashのような完全一致のほか、mcp__memory__.*のような正規表現も使えます。PostToolUseでファイル編集後に自動フォーマットを走らせる、PermissionRequestで破壊的コマンドを外部監査ログへ送る、といった使い方ができます。レシピ集はClaude Code Hooks完全ガイドとHooksレシピカタログにまとめています。

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

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

# CLI で追加(HTTP transportが推奨)
claude mcp add --transport http notion https://mcp.notion.com/mcp

または.mcp.json(projectスコープ、VCS共有)に記述します。設定スコープはlocal(~/.claude.json、既定・個人限定)、project(.mcp.json、チーム共有・要承認)、user(全プロジェクト横断)の3段階で、同名サーバーが複数箇所にある場合はlocal > project > user > プラグイン > claude.aiコネクタの順で解決されます。環境変数展開(${VAR:-default})にも対応します。SSE transportは非推奨で、HTTPが使える場合はそちらを優先します。

公式に紹介されているMCPサーバー例は、Google Drive、Jira、Slack、Sentry、GitHub、Playwright、PostgreSQL(@bytebase/dbhub)、Stripeなどです。Enterpriseではmanaged-mcp.jsonでallowlist / denylistを管理できます。MCPツールの定義は既定で遅延読み込み(deferred)されるため、ツール名だけが文脈に入り、実際に使うときだけ完全な定義が読み込まれてコスト効率が保たれます。実装手順はMCP活用ガイド、自作サーバーの構築はMCPサーバー構築ガイドで扱っています。

CLAUDE.mdとメモリ — セッションをまたぐ知識

Claude Codeには2つの補完的な記憶の仕組みがあります。CLAUDE.mdはあなたが書く指示、Auto memoryはClaudeがあなたの訂正や好みから自動で書きためる学習です。どちらも毎セッション開始時に読み込まれますが、コンテキストとして扱われるだけで強制設定ではありません。特定のタイミングで必ず実行させたい処理はHooksに任せます。

配置場所は上位から、Enterprise管理下の/Library/Application Support/ClaudeCode/CLAUDE.md(macOS)等、./CLAUDE.mdまたは./.claude/CLAUDE.md(プロジェクト、チーム共有)、~/.claude/CLAUDE.md(ユーザー個人)、./CLAUDE.local.md(個人のプロジェクト固有メモ、VCS除外推奨)の順です。作業ディレクトリより上の階層にあるCLAUDE.mdはすべて起動時に読み込まれ、サブディレクトリのものはそのディレクトリのファイルを読むタイミングで追加読み込みされます。

@path/to/file記法で他ファイルをimportでき、最大4ホップまで再帰できます。大きなプロジェクトでは.claude/rules/ディレクトリにトピック別のファイルを分割し、paths:frontmatterで特定ファイルを触るときだけ読み込むスコープ限定もできます。AGENTS.mdは直接読まれないので@AGENTS.mdでimportするか、シンボリックリンクで揃えるのが推奨です。CLAUDE.mdは1ファイル200行未満を目安にし、超える場合はパススコープルールやSkillへの移行が案内されています。

Auto memory(セッション中にClaudeが自動生成する長期メモリ)は~/.claude/projects/<project>/memory/に保存され、MEMORY.mdが索引として機能します。読み込まれるのはMEMORY.mdの先頭200行または25KBのどちらか早い方までで、詳細は個別のトピックファイルに逃がす設計です。ビルドコマンドやデバッグの知見を書かずに横断保存できます。3層のメモリ設計を実例で解説したメモリ3層構造ガイド、実戦パターンはCLAUDE.md 10パターンを参照してください。

設定ファイルの階層

Claude Codeの設定は複数のスコープに分かれ、優先度は高い順にManaged(IT / 管理者が展開、上書き不可)、コマンドライン引数、Local(.claude/settings.local.json、gitignore対象)、Project(.claude/settings.json、リポジトリにコミット)、User(~/.claude/settings.json、全プロジェクト共通)です。設定ファイルの実体は次のとおりです。

~/.claude/settings.json          # ユーザー設定(全プロジェクト)
.claude/settings.json            # プロジェクト設定(git追跡)
.claude/settings.local.json      # ローカル設定(gitignore)
~/.claude.json                   # OAuth、MCP、キャッシュ
.mcp.json                        # プロジェクトMCP設定
CLAUDE.md                        # メモリ・命令

permissions / hooks / apiKeyHelperは即座に反映されますが、model / outputStyleはセッション開始時にだけ読み込まれます。組織はサーバー管理設定・MDM(macOSのmanaged preferences、WindowsのレジストリHKLM\SOFTWARE\Policies\ClaudeCode)・ファイル配布(managed-settings.json)の3経路でmanaged設定を配れます。設定キーの全リストと実例はClaude Code設定完全ガイドにまとめています。

料金プランと選び方

Claude Codeの利用に必要なプラン構成は次のとおりです(料金体系は改定されることがあるため、契約前に公式の料金ページで確認してください)。

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

コストを抑える具体策

Anthropicのエンタープライズ導入データでは、1開発者あたりの平均コストは1日約$13、月$150〜250で、90%のユーザーは1日あたり$30未満に収まっています。現在のコストは/usageコマンドで確認でき、Pro / Max / Team / Enterpriseではプラン上限に対する使用状況の内訳(Skill・サブエージェント・プラグイン・MCPサーバー別)も表示されます。

トークン使用量を抑える具体策は次のとおりです。

• 関係のないタスクに切り替えるときは/clearする。古いコンテキストは毎メッセージでコストを積み増します
• モデルを作業の重さに合わせる。日常のコーディングはSonnet、複雑な設計判断だけOpusに絞ります
• 使っていないMCPサーバーを/mcpで無効化する。ツール定義は既定で遅延読み込みされますが、gh awsのようなCLIツールの方がさらに文脈を消費しません
• 大量出力の処理はHooksやサブエージェントに任せる。10,000行のログをClaudeに直接読ませず、Hookでgrepしてから渡す、テスト実行はサブエージェントに切り出して要約だけ受け取る、といった設計がコンテキストを守ります
• CLAUDE.mdは200行未満に保つ。特定ワークフローの詳細はSkillへ移し、必要なときだけ読み込ませます

Agent teamsはteammateがplan modeで動くとき通常セッションの約7倍のトークンを消費します。チームは小さく保ち、spawnするプロンプトを絞り込むのが効きます。

CI・自動化 — GitHub ActionsとHeadlessモード

CI環境やスクリプトからは、対話なしで1回実行して終わる非対話モード(headless、claude -p)を使います。

# ログを解析して異常があればSlack通知
tail -200 app.log | claude -p "Slack me if you see any anomalies"
 
# 差分レビューをCIに組み込む
git diff main --name-only | claude -p "review these changed files for security issues"

GitHub連携は/install-github-appで対話的にセットアップでき、GitHub Appのインストールとワークフローファイル・APIキーシークレットの追加を案内してくれます。Issueやプルリクエストのコメントで@claudeとメンションすると、コード分析からPR作成まで自動化できます。ワークフローの最小構成は次のとおりです。

name: Claude Code
on:
  issue_comment:
    types: [created]
jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

claude_argsにCLI引数(--max-turns --model --mcp-config等)を渡せるほか、promptにスキル名を指定してSkillsをそのままCI上で起動することもできます。Amazon Bedrockを使う場合はGitHubのOIDCプロバイダー経由の認証設定、Google Cloudのエージェントプラットフォームを使う場合はWorkload Identity Federationの設定が必要です。コストはGitHub Actionsの実行時間とAPIトークンの両方にかかるため、--max-turnsの上限設定とワークフロー単位のタイムアウトが有効です。導入手順の全体はClaude Code GitHub Actions連携ガイドにまとめています。

Claude Code vs Cursor vs GitHub Copilot vs Cowork

同じAnthropic製品でも、Claude Codeは開発者向けCLI、Coworkはビジネスユーザー向けのデスクトップエージェントです。対象読者が違う4つを並べると、コードを書く工程を渡すのか、業務文書を渡すのかで役割がはっきり分かれます。

判断の目安は、コードを書く工程そのものをAIに任せたいならClaude Code、IDE内で対話的に進めたいならCursor、タイプ中の補完が中心ならGitHub Copilotが噛み合います。コードやgit操作を扱わない業務文書中心の作業ならCoworkが適任です。プロダクトマネージャーやテクニカルライターなど、開発とビジネス業務の両方をこなす職種では併用が現実的です。

3者の詳しい比較はClaude Code vs Cursor vs Codex 2026年比較で扱っています。GitHub Copilotとの違いはClaude Code vs GitHub Copilot比較で、VS Code拡張系のClineとの違いはClaude Code vs Cline比較で個別に掘り下げています。CursorからClaude Codeへ移りたい場合はCursorからの移行ガイドも用意しています。

セキュリティと権限管理

Claude Codeはローカルファイルを読み書きし、コマンドを実行するため、セキュリティ設計は避けて通れません。権限モード、サンドボックス、保護パスの3層で防御しますが、Enterprise向けにはさらにManaged Settingsが用意されています。配布経路はAnthropicサーバーからの配信(ビジネス契約)、MDM(macOS plist、Windowsレジストリ)、ファイル配布(managed-settings.json)の3形式で、いずれも同じJSONスキーマを使うため組織ポリシーを統一できます。availableModelsで利用可能なモデルを制限したり、minimumVersionで古いバージョンへの自動ダウングレードを防いだりもできます。権限モード・サンドボックス・監査ログの全体設計はClaude Codeセキュリティ・権限ガイドを参照してください。

よくあるつまずきと対処

認証エラー(401)

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

コストが想定以上に高い

Opusを多用すると1日で数十USDに達することがあります。/usageで現在のプラン上限に対する使用状況を確認し、日常作業はSonnet 5 + /effort mediumに落とすのが基本です。重要なセッションだけOpusを呼ぶ運用が現実的です。上限に当たったときに出るメッセージは実は複数種類あり、原因の見分け方とプラン別の対処はClaude Codeの利用上限ガイドにまとめています。

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

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

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

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

CLAUDE.mdが効かない

CLAUDE.mdの位置がプロジェクトルートか確認します。monorepoの場合、作業中のパッケージディレクトリに置く必要があります。/contextを実行し「Memory files」欄に読み込まれているか確認できます。

サンドボックスが特定のコマンドで失敗する

dockerやwatchmanに依存するツール(jest等)はサンドボックスと相性が悪いため、excludedCommandsに登録してサンドボックス外で実行させます。macOSのgh gcloud terraformがTLS検証で失敗する場合も同様です。

切り分けに迷ったときは、エラー別の対処をまとめたClaude Codeトラブルシューティングガイドが役立ちます。環境変数の一覧は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コミットまで自律的に進めるエージェント型のツールです。チャットUIで回答を返すだけのツールと違い、実際にファイルを書き換え、コマンドを実行して結果を確認しながら作業を進めます。

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

大規模リファクタや複雑な設計にはOpus 5、日常のコーディングにはSonnet 5、高頻度で軽い作業にはHaiku 4.5が目安です。長時間の自律タスクで能力の上限まで使いたいときだけ、最上位のFable 5を/model fableで明示的に選びます。計画にOpus・実装にSonnetを自動で割り当てるopusplanも選べます。

Auto modeは安全ですか

Auto modeは承認プロンプトを減らしますが、安全性を保証する仕組みではありません。分類器が既定の危険操作を止めますが、信頼できる方向性のタスクで使うものであり、機密性の高い操作の代わりにはなりません。

Windowsでも動きますか

動きます。PowerShellまたはCMDからNative Installできるほか、WSL 2でも利用できます。ただしサンドボックス機能はネイティブWindowsでは使えず、WSL2の内側での実行が必要です。

VS CodeやJetBrainsから使えますか

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

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

日常作業をSonnet中心にし、/effortを下げ、/usageで使用状況を随時確認するのが基本です。Opusは重要なセッションに絞り、使っていないMCPサーバーを無効化すると費用対効果が安定します。

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

Max / Team / EnterpriseではOpusの1Mがサブスクに含まれます。旧世代Sonnet 4.6の1M、およびProでのOpusの1Mは追加のusage creditが必要です。API / 従量課金ではフルアクセスです。Sonnet 5・Fable 5・Opus 4.7以降はこの条件分岐の対象外で、Anthropic APIでは常に1Mで動作します。

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

コーディング規約、アーキテクチャの方針、使うライブラリ、レビュー観点などプロジェクトの前提を書きます。セッション開始時に毎回読まれるため、繰り返し説明している内容を移すと指示が短くなります。1ファイル200行未満を目安にし、多くなったら.claude/rules/かSkillへ分割します。

GitHub ActionsとHeadlessモードはどう使い分けますか

GitHub Actionsは@claudeメンションやPRイベントをトリガーに、リポジトリの外(GitHubのランナー)でClaude Codeを動かす仕組みです。Headlessモード(claude -p)は自分のマシンやCIサーバーで対話なしに1回実行して終わる使い方で、ログ解析やバッチ処理のパイプに組み込みやすい形です。両方とも同じCLAUDE.mdと設定を尊重します。

まとめ — 学習の進め方

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

1. インストール後に/resume / /usage / claude doctorを覚える(初日)
2. CLAUDE.mdにプロジェクトの前提を書く(初週)
3. よく使うタスクをSkillsにする(2週目以降)
4. 危険な操作をHooksでgateし、権限モードを作業の重さに合わせる(1ヶ月目)
5. Sub AgentsとMCPで関心分離と外部ツール連携を組み、Auto modeで承認疲れを減らす(本格運用フェーズ)

まずはProプランで1リポジトリ、1週間使ってみるのが、最もコストの低い入口になります。バージョン追跡はClaude Codeアップデートまとめとv2.1.219リリースノートで追えます。モデルの使い分けをより詳しく知りたい場合はモデル選定ガイドが参考になります。