Claude CodeはAnthropicのターミナルベースのAIコーディングエージェントです。プレーンな英語でやりたいことを入力するだけで、コードベースを読み込み、コードを書き、コマンドを実行、エラーを修正、変更をコミットします — すべてターミナルから。IDEプラグイン不要。ブラウザタブ不要。ただあなたとAIがターミナルウィンドウ内で作業するだけです。
Cursor（IDE内で動作）やCodex（クラウドで動作）とは異なり、Claude Codeは実際の開発環境でローカルに動作します。ファイル、git履歴、ターミナル出力をすべて見えます。これにより、AIとコードの間でコンテキストスイッチが発生しないため、多くのワークフローで高速になります。
このガイドでは、インストール、最初のプロジェクト、主要コマンド、そしてClaude Codeを効果的に使うワークフローを解説します。
| ツール | 最適な用途 | 動作場所 | ワークフロー |
|---|---|---|---|
| Claude Code | インタラクティブなエージェント型コーディング | ローカルターミナル | あなたがガイド + リアルタイムでステップを実行 |
| Cursor | 日常のコーディング + インライン編集 | IDE内 | 可視化された差分 + オートコンプリート |
| Codex | 非同期の委任タスク | クラウドサンドボックス | タスク送信 → 後でPRを確認 |
Claude Code のインストール方法
Node.js 18+ と Claude アカウント（Pro または API）が必要です。
ステップ 1: npm でグローバルにインストール：
npm install -g @anthropic-ai/claude-code
ステップ 2: プロジェクトディレクトリに移動：
cd your-project
ステップ 3: Claude Code を実行：
claude
初めて実行すると、Anthropic アカウントで認証するよう求められます。Claude Pro（$20/月）を使っている場合、寛大なトークン上限が得られます。API を使っている場合、トークンごとに課金されます（現在の料金は料金制限ガイドで確認してください）。
料金の見積もり（驚かないために）
API 課金の場合、中規模のリポジトリで30–60分の典型的なセッションは、モデルとイテレーション数によって$2–$10程度です。/costを定期的に使い、長時間のセッションはVibe Coding Cost Calculatorで確認してください。
Claude Code との最初の 5 分間
Claude Code が起動したら、インタラクティブセッションに入ります。AI はプロジェクトディレクトリ全体にアクセスできます。シンプルに始めましょう:
探索を依頼: 「このプロジェクトは何ですか？高レベルな概要を教えて。」と入力。Claude は主要ファイル（package.json、README、メインエントリーポイント）を読み、内容を要約します。プロジェクト構造を理解しているかを確認するのに最適です。
何かを探す依頼: 「認証ロジックはどこですか？」Claude はコードベースを検索し、関連ファイルを示します。テキスト一致だけでなくコード構造を理解します。
変更を依頼: 「サインアップフォームに入力バリデーションを追加。メールは有効な形式、パスワードは最低 8 文字。」Claude はフォームコンポーネントを特定し、バリデーションを書き、適用前に差分を表示します。
重要なポイント: Claude Code は実際のファイルに操作します。変更は本物で、ディスク上のファイルが修正されます。エディタで変更を確認、テストを実行、通常通りコミットできます。
必須コマンド
Claude Codeには、動作を制御するいくつかのスラッシュコマンドがあります：
| コマンド | 動作内容 | 使用タイミング |
|---|---|---|
/init | プロジェクトルートにCLAUDE.mdファイルを作成します | リポジトリでの最初の本格的なタスクの前 |
/compact | コンテキスト制限近くで会話履歴を圧縮します | 長いセッション；品質が低下する前 |
/cost | 使用トークン数と推定コストを表示します | API課金、予算追跡 |
/clear | コンテキストを保持しつつ会話をリセットします | 無関係なタスク間の切り替え時 |
これで価値を感じていますか？ AIコーディングツールとワークフローの週刊ガイドを公開しています。インBOXに届ける →
CLAUDE.md ファイル — プロジェクトの AI コンテキスト
CLAUDE.md ファイルは Claude Code ワークフローで最も重要なものです。プロジェクトルートにあるマークダウンファイルで、セッション開始時に Claude が読み込みます。コードベース用のカスタム指示と考えてください。
良い CLAUDE.md には以下を含めます:
プロジェクト概要: プロジェクトの目的、技術スタック、アーキテクチャを 3-5 文で。
コード規約: フォーマット好み、命名規約、従うパターン。「フック付き関数コンポーネントを使用。名前付きエクスポートを優先。スタイリングは Tailwind を使用。」
主要ファイル: Claude が理解すべき重要なファイルを指定。「主なデータモデルは lib/models/ に。API ルートは app/api/ に。」
避けること: 「データベースマイグレーションファイルは変更しない。vendor/ は一切変更しない。api/ ファイルを変更したら常にテストを実行。」
CLAUDE.md なしでは、Claude Code はプロジェクトスタイルに合わない汎用コードを出力します。これがあると、数ヶ月チームにいた人が書いたような出力になります。これが コンテキストエンジニアリングの実践です。
実際のワークフロー: 機能構築
典型的な機能開発セッションで私が Claude Code をどう使うか:
1. 目標から開始: 「API にレートリミッターを追加。Redis を使用。/api/submit エンドポイントに適用、IP あたり分間 10 リクエスト制限。」
2. Claude に計画させる: 既存 API コードを読み、Redis が設定済みかを確認、アプローチを提案。コーディング前に計画をレビュー。
3. 作業を見守る: Claude はレートリミッターモジュールを作成、API ルートに統合、Redis 接続用の環境変数を追加、テストを書きます。
4. テスト: Claude がテストを実行。失敗したらエラーを読み、コードを調整して再試行。このイテレーショーループがエージェントの強み — 通常の複数回のマニュアル作業を自動化。
5. レビューとコミット: 差分を確認。調整したらコミット。依頼すれば Claude がコミットメッセージも書けます。
このような機能では、手動執筆比で Claude Code が通常 60-70% の時間を節約します。本当の節約はボイラープレート、統合コード、テスト執筆 — 面倒だが知的挑戦の少ない部分です。
トークン使用量の管理
Claude Code はすべてのインタラクションでトークンを使います。大規模コードベースの長セッションは API 課金で高額になりがち。料金を抑える習慣:
/compact を定期的に使用。 コンテキストがいっぱいになるまで待たない。各タスク完了後に圧縮。
具体的に指示。 「ログインフォームのバグを修正」は「アプリケーション全体を見てバグを探せ」より安価。具体的な依頼はコード読み込みを減らします。
無関係タスク間で /clear を使用。 フロントエンド作業からデータベースマイグレーションに切り替えるならコンテキストをクリア。古いコンテキストはトークンを無駄にし、モデルを混乱させます。
/cost を頻繁に確認。 各セッションのメンタル予算を設定してチェック。30 分の機能セッションは API 課金で $2-8 程度。
Claude Code と Cursor の詳細な料金比較は 30 日間の実コスト比較 を参照。
Claude Code vs Cursor vs Codex
クイック決定ガイド:
| オプション | 最適な場合... | トレードオフ |
|---|---|---|
| Claude Code | インタラクティブでリポジトリ全体の変更をローカルで実行したい場合 | 慎重なレビューが必要（実際のファイルを編集するため） |
| Cursor | IDE内にAIを組み込み、タイトな編集ループを求める場合 | ターミナルエージェントより手離れのしやすさが劣る |
| Codex | 非同期でPRベースの委任を求める場合 | インタラクティブ性が低く、文脈がずれる可能性あり |
Claude Code: フルプロジェクトの文脈とターミナルネイティブのワークフローを求める開発者に最適。インタラクティブでリアルタイム、実際のファイルで動作。複雑な機能、リファクタリング、デバッグに最適。
Cursor: IDE内にAIを求める開発者に最適。インラインディフでリアルタイムに変更を確認。日常のコーディングとAI提案に最適。詳細比較はこちら。
Codex: 非同期でバッチ処理のコーディングタスクを求めるチームに最適。タスクを提出し、後でPRを確認。完全に委任したい明確に定義されたタスクに最適。詳細比較はこちら。
多くの開発者が2つ以上を使っています。Claude Codeを複雑な機能に、Cursorを日常編集に、Codexをバッチタスクに。
どんなAIコーディングツールでもプロンプトを改善したい？ The Prompt Optimizer がリクエストを構造化し、より明確で具体的な出力を得る手助けをします。
もっとこんな内容が欲しい？ AIコーディングツールと開発者ワークフローについて毎週公開中。無料購読 →
よくある質問
Claude Code は Windows で動作しますか？
はい、WSL（Windows Subsystem for Linux）、PowerShell、または Command Prompt で。多くの開発ツールが Linux ネイティブのため、WSL が最高の体験を提供します。
Claude Code はインターネットにアクセスできますか？
Claude Code 自体はウェブ閲覧しませんが、curl、npm install、git clone などのコマンドを実行可能。GitHub、データベース、API などの外部サービスには MCP サーバーも使用できます。
Claude Code は大規模コードベースをどう扱いますか？
Claude の 200K トークンコンテキストウィンドウにより、数千のソースファイルを同時に読み込み処理可能。超大規模モノレポではすべてをロードせず関連ファイルを選択的に読み込みます。CLAUDE.md ファイルが各タスクで重要なコード部分を教えます。
私のコードは Anthropic のサーバーに送信されますか？
はい、処理のため Anthropic の API に送信されます。Anthropic はデフォルトで API 入力から学習しませんが、機密・独自コードの場合は最新利用規約を確認。最大プライバシーのためデータ保持を無効にした API を検討。
開示: 本記事の一部リンクはアフィリエイトリンクです。実際にテスト・常用したツールのみ推奨。詳細開示ポリシー を参照。