2026/07/27

Claude Codeの使い方：ターミナルコーディングエージェント

Anthropic公式Claude Codeの機能：100万トークン、80.8% SWE-bench、Plan Mode、インストール、Cursorとの比較、単独利用と組込時の選択

Claude Codeを正しく使うなら、まずそれが何かを理解する必要があります。Anthropicが提供するエージェント型のコーディングツールで、ターミナルで動作し、プロジェクト全体を読み込んで、自然言語の指示から開発作業を実行します^[1]。一般提供開始以来、GitHubで101,000スター、15,500フォークを集めており、2026年のAIコーディングツールの中で最も採用が広がっています^[2]。

先代のツールとの構造的な違いをはっきり言う価値があります。これがあなたのワークフローに合うかどうかを左右するからです。Copilot型の自動補完は、あなたが既に書いた内容に基づいて次の行を提案します。Claude Codeは、プロジェクト全体を読み込み、手法を計画し、一度に複数のファイルを編集し、テストを実行し、失敗に対応し、反復し、コミットします。どのファイルが重要かを伝える必要がありません。

このガイドではClaudeコードの機能、動作環境、インストール方法、とくに得意な5つの作業、Cursorやコパイロットとの比較、そして独自の製品に同じ動作を組み込みたいときの選択肢をカバーします。

TL;DR

100万トークンのコンテキストウィンドウ：1回のセッションで概ね25,000～30,000行のコードを処理（分割なし）^[1]。
SWE-bench Verified 80.8%：公開ツール中で最高スコア（執筆時点）^[1]。
Plan Mode：変更前にファイル単位の計画を表示して承認を待つため、本番リポジトリでも安心^[1]。
ほぼどこでも動作：ターミナルCLI、VS Code、Cursor、Windsurf、JetBrains、デスクトップアプリ、Web、GitHub Issues上の@claude^[1]。
Pro/Max有料プランまたはClaude Console API アクセスが必須^[1]。
MCP対応：データベース、内部API、チケットシステム、監視プラットフォームと連携し、リポジトリを超えた判断が可能^[1]。

Claude Codeとは

ターミナルセッションで動くClaudeコード

Claude Codeはコード補完エンジンではなく、コーディングエージェントです。プロジェクトに指し示すと、シニア開発者のように構造をナビゲートします：エントリーポイントから始まり、依存関係グラフをたどり、コンポーネント間の相互作用を実装モデルとして構築し、局所的に正しくグローバルに破壊的ではなく、アーキテクチャ的に一貫した変更を行います。

この違いが最も重要な場面は、実際にエンジニアリング時間を消費する作業です。ステージング環境では出ない本番環境のバグをデバッグする。ORM変更、3つのエンドポイント更新、マイグレーションが必要なフィーチャーを実装する。これらは複数ファイルにまたがる問題で、複数ファイル問題こそが、フルコンテキストエージェントと自動補完の差がはっきり出る場面です。

重要な機能

100万トークンのコンテキストウィンドウ

Claude Codeは1回のコンテキストウィンドウで最大100万トークンを読み込めます。これは1回のセッション中に、分割や外部検索なしで概ね25,000～30,000行のコードを処理できる規模です^[1]。20万行のリポジトリで40ファイルに及ぶリファクタが必要なとき、ファイルリストを手動で指定する必要がありません。自動で見つけます。

SWE-bench Verified 80.8%

SWE-bench Verifiedは、オープンソースリポジトリから実在するGitHubの問題を評価対象にし、提案された修正がそのリポジトリ自身のテストスイートに合格するか否かで採点するベンチマークです。Claude Codeは80.8%を達成しており、これは確認されたツール中で最高スコアです^[1]。このベンチマークはコードベース理解の真の能力を測定するため、独立したスニペットでのパターンマッチングより、実際の有用性をより正確に追跡します。

Plan Mode

Claude Codeが何かを実行する前に、構造化された計画を提示します。どのファイルを変更するのか、どんな変更をするのか、順序はどうか。あなたがそれをレビューし、質問を出し、調整し、そして初めて承認を与えます^[1]。

この機能が、本番リポジトリ上での利用を実用的にします。人間を監視ループに入れておくことで、ループの外にいるのが高くつく瞬間に対応できます。

エージェントチーム

複数のClaudeコードインスタンスが問題の異なる部分に同時に取り組み、タスク割り当てと結果統合を担当するリードエージェントに調整されます^[1]。バックエンド変更、フロントエンド更新、ドキュメント更新という独立した作業に分解できるフィーチャーなら、トークン時間ではなくカレンダー時間を短縮できます。

Claude Codeが動く場所

VS Code拡張機能でインタラクティブなdiffレビューを表示するClaudeコード

広く採用される理由はシンプルです：開発者が既にいる場所に会わせるから^[1]。

ターミナルCLI：コア体験。プロジェクトに移動してclaudeと入力し、やりたいことを説明する。
VS Code拡張機能：ビジュアルなdiffレビューとインタラクティブな変更選択。同じ拡張機能がCursorとWindsurfでも動く。
JetBrains Plugin：IntelliJ IDEA、PyCharm、WebStorm他に対応。
デスクトップアプリ：平行セッション間でのビジュアルdiffレビュー、セッションスケジューリング、長時間実行ジョブのクラウド実行。
Web：claude.ai/code。ローカルインストール不要。Claude iOSアプリも対応。
GitHub：Issue上で@claudeタグを付ければプルリクエストが返ってくる。チームのやり方を変えさせない。

平行セッション間のdiffをレビューするClaudeコードデスクトップアプリケーション

Claude Codeの使い方：インストールと初回実行

macOSとLinux：

curl -fsSL https://claude.ai/install.sh | bash

またはHomebrew経由：

brew install --cask claude-code

Windows：

irm https://claude.ai/install.ps1 | iex

またはWinGet経由：

winget install Anthropic.ClaudeCode

プロジェクトに移動してclaudeを実行する。プロジェクト構造をインデックスし、何をしたいか聞いてきます。

インストール方法より重要な一歩があります。リポジトリのルートにCLAUDE.mdを作成して、慣例を書き込む：どのテストフレームワークを使うか、どのファイルを自動編集させないか、命名規則^[1]。毎セッション冒頭で読み込まれます。チームはここに制度知識を体系化できます。それはオンボーディング中にシニア開発者が口頭で伝えることをエンコードする、最高レバレッジの設定です。

特に得意な5つの作業

大規模リファクタリング。 リファクタが数十ファイルに及び、シグネチャ、インポート、テストの一貫性が必要なら、調整がボトルネックです。Claude Codeは依存マップを構築し、あらゆる呼び出し地点を見つけ、協調的な変更を行い、結果を示す前にスイートを走らせます。Rakutenのチームが記録したのは、大規模多言語ライブラリ内の活性化ベクトル抽出メソッドで7時間自律稼働し、参照実装に対して99.9%の数値精度を達成したケースです^[1]。

クロスファイルデバッグ。 ユーザ動作として現れたバグが、異なる時期に異なる人が書いた3つのモジュール間の相互作用に根ざす場合、フルコンテキストナビゲーションで実行パスを辿り、障害モード仮説を立て、診断を書き、最も明らかなもの1箇所だけでなく、その破壊的な仮定が存在するすべての場所を修正させます。

テスト未実装コードの自動生成。 実装を読み込み、コードと存在するドキュメントから意図を推論し、通常パス、エッジケース、エラー条件をカバーするテストを生成します。その過程でバグを見つけることも多い。

Git ワークフロー自動化。 コミットを平文で説明（除外物を指定可能）すると、ステージング、コミットメッセージ、プッシュ、構造化説明付きプルリクエストを全部処理します。GitHub MCP統合があれば、Issueを読み込み、修正を実装し、テストを走らせ、フルコンテキストでPRを開けます。

アーキテクチャ分析。 未知のコードベースに指し示して、アーキテクチャを説明させます。構成、各主要コンポーネント、サービス間のデータフロー、クリティカルパスの構造化ウォークスルーが得られます。オンボーディング、技術デューディリジェンス、未実装のドキュメント執筆に有用。

MCP連携

Claude Codeはモデルコンテキストプロトコルに対応しています。これはAnthropicが定めたモデルを外部ツールやデータに接続する開放標準です^[1]。リポジトリを超えた推論ができます：マイグレーション前にデータモデル理解のため本番DBにクエリ、実装前にAcceptance基準確認のためチケット読込、デバッグ前にエラーパターン把握のための監視プラットフォーム確認。

プラグインディレクトリには増え続けるコミュニティ統合があり、大抵のツールは対応済みです。

Claude Code対 Cursor対 Copilot

	Claude Code	Cursor	GitHub Copilot
インターフェース	ターミナルCLI + IDE拡張	カスタムVS Code フォーク	IDE拡張
コンテキストウィンドウ	100万トークン	約128K トークン	約128K トークン
SWE-bench スコア	80.8%	未報告	未報告
エージェント操作	完全：計画→実行→テスト→コミット	部分的（Composer Mode）	部分的（Copilot Workspace）
複数ファイル編集	ネイティブ・協調的	あり	制限的
料金	Claude Pro/Max、$20～$100/月	$20/月	$10～$39/月

比較行の出典は、ここで参照されている同じガイドです^[1]。

正直な見方は、これらが同じ時間を競っていない、ということです。Cursorはエディタ全体にAIが統合されたVS Codeフォーク：高速インライン補完、複数モデル対応、ビジュアルIDE。Copilotはマイクロソフトのエンタープライズサブスクリプション内に組み込まれているので最も広く展開され、日常的な補完は得意ですが、複雑な複数ファイルの作業ではフルエージェントとして機能しません。

両方を使う開発者が多い傾向：日々の編集はCursor、大規模リファクタ・アーキテクチャ変更・セキュリティ監査・複雑なクロスファイルバグ検出にはClaudeコードを使う。

独自の製品にこの動作を組み込みたい場合

Claude Codeはanthropicのエージェントで、ターミナルで作業するのなら正しいツールです。自分が配布するソフトウェアの中にこの動作を組み込むのなら、異なる選択肢が必要です。CI内のコードレビューボット、顧客向けマイグレーションエージェント、リポジトリを読み込んで質問に答える内部ツール。どれもデベロッパーのラップトップ上のCLIではありません。

その仕事にはモデルが直接必要です。Claude Code自体へのアクセスはClaudeのPro/Max有料プランか、Claude ConsoleのAPIアクセスで利用できます^[1]。独自エージェントを構築するなら、その第二層で作業します。

reAPIはClaude モデルをOpenAI互換の/v1/chat/completionsエンドポイント経由で提供するため、1つのクライアントと1つのキーでClaudeがGPTやGeminiと並んで利用できます：

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_REAPI_KEY",
    base_url="https://api.reapi.ai/v1",
)

resp = client.chat.completions.create(
    model="claude-opus-5",
    messages=[{"role": "user", "content": "Review this diff and report issues with severity."}],
    max_tokens=16000,
    stream=True,
)

ネイティブAnthropicの/v1/messagesインターフェースも利用でき、どちらかのフォーマットで書かれたSDKが変更なしで動きます。モデルページとレートはreapi.ai/models、現在のOpus世代のエンドポイント参照はreapi.ai/docs/claude-opus-5にあります。

自分のリポジトリにはClaudeコード。他人の環境で走らせるならAPI。

Anthropic. Claude Code — overview, capabilities, surfaces, and configuration. Retrieved July 2026 from platform.claude.com/docs/claude-code
Anthropic. Claude Code — official repository. Retrieved July 2026 from github.com/anthropics/claude-code
Anthropic. Claude Code documentation. Retrieved July 2026 from docs.claude.com/en/docs/claude-code/overview