Claude Codeとは何か — Cursorとは「思想」が違う
Claude Codeは、AnthropicがClaudeモデルを使って開発したCLI（コマンドライン）型のAIコーディングエージェントだ。
claude というコマンドをターミナルで叩くだけで、プロジェクトのコードベースを読み、ファイルを編集し、テストを走らせ、Gitにコミットする。一連の開発作業を「会話」で進められる。
CursorやGitHub Copilotとの最大の違いは、エディタに依存しない設計思想にある。Cursorはエディタの中に住む「補完者」、Copilotは「サジェスト機」だ。
一方、Claude Codeはターミナルから動く「実行者」。エディタを開かずに、自然言語で「このバグ直して」「テスト書いて」「PR出して」と指示できる。
| 観点 | Claude Code | Cursor | GitHub Copilot |
|---|---|---|---|
| 形態 | CLI（ターミナル） | エディタ統合 | エディタ拡張 |
| 主な役割 | 自律実行エージェント | 高機能エディタ | コード補完 |
| ファイル編集 | 自動・複数ファイル横断 | エディタ経由 | 提案のみ |
| 並列実行 | サブエージェント機能 | × | × |
| プロジェクトルール | CLAUDE.md | .cursorrules | × |
| 拡張機能 | MCP / スキル / フック | 限定的 | 限定的 |
| コスト | API従量 or Claude Pro/Max | サブスク | サブスク |
特筆すべきは、Claude Codeが「コードを書く」だけのツールではないという点だ。GitのPR作成、Slackへの通知、Supabaseへのクエリ実行まで、開発周辺の業務を一気通貫で担える。
基本の3ステップ — インストールから初回起動まで
導入は3ステップで完了する。エディタの設定もプラグインも要らない。
ステップ1: グローバルインストール。
npm install -g @anthropic-ai/claude-code
ステップ2: 認証。Anthropicアカウント（Claude Pro / Max / API）でサインインする。
claude auth
ステップ3: プロジェクトディレクトリで claude を叩くだけ。
cd your-project
claude
対話インターフェースが立ち上がり、プロジェクトのコードを理解した状態で会話が始まる。Cursorのように専用エディタをインストールする必要も、設定ファイルを書く必要もない。
「最初の5分で動く」——これがClaude Codeの設計思想を象徴している。
CLAUDE.mdがすべてを決める — プロジェクトルールの設計
Claude Codeの使い込み度合いは、CLAUDE.mdの完成度でほぼ決まる。これは断言していい。
CLAUDE.mdは、プロジェクトのルートに置く「Claudeへの指示書」だ。技術スタック、コーディング規約、ディレクトリ構成、コマンド、データベース列名の注意点、デプロイ手順——プロジェクト固有のローカルルールを書いておくと、Claudeは毎回これを読み込んでから作業を始める。
良いCLAUDE.mdの条件は、3つに集約される。
第一に、コマンドを明示する。pnpm dev で起動、pnpm test でテスト、というように。これがないとClaudeはnpm / yarn / pnpmのどれを使うべきか毎回迷う。
第二に、命名規約を書く。「ファイルはPascalCase」「DB列はsnake_case」「インポートは @/ エイリアス」など。書かないとClaudeは標準的な慣習に従うが、プロジェクトと衝突することがある。
第三に、落とし穴を共有する。「DBの記事本文カラムはbody（contentではない）」「Server ActionsはCLIから呼べない」など、人間が踏んだバグはCLAUDE.mdに書き残す。これがあるかないかで、Claudeの精度は段違いに変わる。
| 必須項目 | 書く内容 | 効果 |
|---|---|---|
| プロジェクト概要 | 何を作っているか1〜2行 | 文脈共有 |
| 技術スタック | フレームワーク・DB・パッケージマネージャ | コマンド推測の精度向上 |
| ディレクトリ構成 | app/, lib/, scripts/ などの役割 | ファイル配置の判断 |
| コマンド | dev / build / test / lint | 実行ミス防止 |
| 命名規約 | ファイル・関数・DB列 | コード一貫性 |
| 落とし穴 | 過去ハマったバグ・制約 | 同じミスを繰り返さない |
CLAUDE.mdは「育てるドキュメント」だ。プロジェクトを進めながら、Claudeが間違えた箇所、ハマった箇所を追記していく。これがClaude Codeを使いこなす第一歩。
スキルとサブエージェント — 自律性を引き出す2つの仕組み
Claude Codeには、自律性を一段引き上げる2つの強力な機能がある。
スキルは、定型業務をパッケージ化する仕組みだ。~/.claude/skills/ にSKILL.mdを置くと、Claudeは「このトリガー語が来たらこの手順で動け」というルールを学習する。
たとえば「議事録を起こす」「PRレビューする」「請求書を作る」といった繰り返し業務をスキル化しておけば、毎回プロンプトを書かずに /skill-name で呼び出せる。
もうひとつが、サブエージェント。メインのClaudeが、別のClaudeインスタンスにタスクを委譲して並列実行させる機能。
「3つのファイルを同時に調査」「2つのテストを並行実行」といった処理を、人間が指示せずともClaude自身が判断して並列化する。
サブエージェントが本領を発揮するのは、大規模リファクタや横断調査だ。
「このコードベース全体でcamelCaseをsnake_caseに変える」のような作業を、複数エージェントで並列処理できる。シングルエージェントの数倍速で動く。
MCP連携 — Slack・Supabase・Vercelを"会話"で操作する
MCP（Model Context Protocol）は、Anthropicが2024年末にオープンソース化した「AIと外部サービスをつなぐ共通規格」。
Claude Codeはこれをネイティブに統合しており、対応サービスをインストールするだけで会話から外部操作ができる。
ユースケースを具体的に挙げる。
「先週のGitHub PRをまとめてSlackに投稿して」——Claude CodeはGitHub MCPでPRを取得し、Slack MCPでチャンネルに投稿する。
「Supabaseのusersテーブルから今月の新規登録ユーザーを抽出してCSVに」——Supabase MCPで直接クエリを実行し、結果をローカルファイルに書き出す。
「Vercelの最新デプロイのログを取得してエラー原因を分析して」——Vercel MCPでログを取得し、解析結果を提示する。
これらは従来、APIキーを管理し、各サービスのSDKを叩いてスクリプトを書く工程が必要だった。MCPはそれを「会話」で完結させる。Claude CodeはMCPを最も自然に使えるエージェントだ。
生産性が10倍になる10の実践Tips
ここからが本記事の主役。Claude Codeを使い込んだ開発者が共通して使う10のテクニックを紹介する。
| # | Tips | 効果 | 難易度 |
|---|---|---|---|
| 1 | CLAUDE.mdに「踏んだバグ」を追記する | 同じミスを繰り返さない | ★ |
| 2 | TodoWriteで複雑タスクを分解させる | 進捗の可視化 | ★ |
| 3 | プロンプト末尾に制約条件を添える | 仕様の明示 | ★ |
| 4 | 失敗時は「なぜ失敗した？」と聞く | 根本原因の特定 | ★★ |
| 5 | スキル化すべき業務を見極める | 繰り返し業務の自動化 | ★★ |
| 6 | サブエージェントを明示的に呼び出す | 並列処理の活用 | ★★ |
| 7 | フックでgit-commit前に自動レビュー | 品質ゲートの自動化 | ★★★ |
| 8 | MCP経由でDB・Slack・Vercelを操作 | 開発周辺業務の統合 | ★★★ |
| 9 | カスタムスラッシュコマンドを作る | 個人最適化 | ★★★ |
| 10 | プランモードで設計→実装を分離 | 大規模変更の安全化 | ★★ |
特に効果的なのがTips 1、7、10の3つ。
Tips 1（CLAUDE.mdへの追記）は、Claude Codeの精度を継続的に上げる唯一の方法。プロジェクトを進めながら「Claudeがハマった箇所」をメモしていくと、半年後には「自分専用のシニアエンジニア」が完成する。
Tips 7（フック）は、Claude Codeの実行前後に任意のシェルコマンドを差し込める機能。pre-tool-use フックでlintを走らせる、post-tool-use で型チェックを走らせる、といった運用ができる。
Tips 10（プランモード）は、コードを書く前に「設計案」を提示させて承認を取るモード。大規模リファクタや初期設計時、いきなりコードに飛びついて壊されるリスクを排除できる。
やってはいけない3つの落とし穴
最後に、Claude Codeを使う上での代表的なアンチパターンを3つ挙げる。
落とし穴1: CLAUDE.mdを書かずに使い続ける。
Claude Codeは強力だが、プロジェクト固有のクセは知らない。CLAUDE.mdが空の状態で使い続けると、毎回同じ説明を繰り返すことになり、生産性が出ない。最低でもコマンド・命名規約・DB構成は書いておく。
落とし穴2: 「読まずに承認」を続ける。
Claude Codeは、ファイル編集やBashコマンドの実行時にユーザー承認を求める。これを脳死で「承認」し続けると、意図しない破壊的変更（force push、データ削除など）が走るリスクがある。差分を必ず目視確認する。
落とし穴3: 巨大プロンプトで丸投げする。
「このアプリ全部リファクタして」のような巨大依頼は、Claudeが文脈を見失い、品質が下がる原因。タスクは適切な粒度に分解し、TodoWriteで管理させる。プランモードを併用すると安全。
| アンチパターン | 起きる問題 | 対策 |
|---|---|---|
| CLAUDE.md空 | 同じ説明を繰り返す・精度低下 | 最低限の規約を書く |
| 脳死承認 | 破壊的変更が走る | 差分を目視確認 |
| 巨大プロンプト | 品質低下・暴走 | 分解とプランモード併用 |
Claude Codeは誰の仕事を変えるか
Claude Codeが最も価値を発揮するのは、「ひとりで複数プロジェクトを回す」エンジニアだ。
スタートアップのCTO、フリーランスのエンジニア、SaaS事業の個人開発者——彼らはコードを書く時間より、「コード周辺の雑務」に時間を奪われている。GitHubでPRを管理し、Slackで進捗を共有し、デプロイログを確認し、ドキュメントを書く。Claude Codeは、この雑務をMCPとスキルで吸収する。
一方で、大企業の専門エンジニアにとっては、Claude Codeは「もうひとりの自分」になる。深夜のリファクタ、リリース前の最終チェック、ドキュメント整備——人手が足りない領域を埋める存在として機能する。
「コードを書くAI」の時代は終わった。これからは「開発全体を回すAI」の時代だ。Claude Codeをどこまで使い込めるかは、エンジニアの市場価値を分ける新しい軸になる。
あなたのCLAUDE.mdには、何が書かれているだろうか？
出典・参考
- Anthropic公式ドキュメント: Claude Code Overview（https://docs.anthropic.com/claude/docs/claude-code）
- Model Context Protocol公式:
- Claude Code GitHub:
