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]。毎セッション冒頭で読み込まれます。チームはここに制度知識を体系化できます。それはオンボーディング中にシニア開発者が口頭で伝えることをエンコードする、最高レバレッジの設定です。

configured model not available

新しいサブスクリプションを契約する前に、現在の接続を確認します。/status を実行し、プロバイダー、ベース URL、認証情報の取得元を記録してください。エラー全文、HTTP ステータス、Claude Code のバージョン、リクエスト ID を保存し、共有前に認証情報と非公開のプロンプト内容を除去します。保存済みの Claude ログインが、現在のリクエストの認証元とは限りません。^[4]^[5]

まずモデルを確認します。 Anthropic の文書では、“There's an issue with the selected model” はモデル名を認識できないか、アクセス権がない場合のエラーです。“Configured model not available” は調査すべき症状であり、個別に確認済みの公式エラーコードではありません。対話セッションでは /model を開き、-p を使うコマンドでは --model を確認します。ANTHROPIC_MODEL と model 設定にも古い上書き指定が残っていないか確認してください。組織による制限には管理者の対応が必要で、別の表記に変えてもアクセス権は得られません。^[6]

キーとエンドポイントを対応させます。 Claude Code は ANTHROPIC_AUTH_TOKEN を Bearer トークンとして送り、ANTHROPIC_API_KEY を x-api-key として送ります。設定を置き換えたり削除したりする前に、/status が実際に示す取得元を確認してください。ゲートウェイの認証情報は保存済みの Claude ログインより優先される場合があります。/login で無効なゲートウェイキーを修復することはできません。^[4]^[5]

reAPI の現在のネイティブ Messages ルートでは、ベース URL は https://reapi.ai/api、完全なエンドポイントは https://reapi.ai/api/v1/messages です。その現在の reAPI アカウントのキーと、明示的にサポートされる ID、claude-haiku-5-5、claude-sonnet-5-5、claude-opus-5-5、claude-fable-5、claude-fable-5-1 のいずれかを使います。このガイドの別の箇所にある https://api.reapi.ai/v1 の例は、独立した旧ワークスペースのものです。そのキーやモデル選択が現在のネイティブルートにも適用できるとは考えないでください。ネイティブ Messages リファレンスを参照してください。エンドポイントとコードの確認で分かるのは、この設定上の区別までです。Claude Code のエンドツーエンドテストや、すべてのツール機能の検証が済んだことを示すものではありません。^[7]

現在のモデルの詳細は Claude Sonnet 5.5 ページをご覧ください。

認証、アクセス権、利用枠を区別します。 Anthropic の直接 API では、401 は認証、402 は請求、403 はリソースへのアクセス権の問題を示します。429 はレート制限の場合も支出上限の場合もあり、上限に達した状態は再試行を繰り返しても解消しません。入金する前に、実際に料金を負担しているアカウントを確認してください。ゲートウェイの応答は別途解釈が必要です。reAPI の現在のネイティブ実装は、上流の 401 または 403 をクライアント向けの 502 として返します。そのため、上流の失敗だけでは reAPI キーを交換すべきだとは判断できません。^[8]

エラーの発生元を確認します。 “Upstream rejected the request” は、Claude apps gateway から返される一部の未分類の 400 応答について文書化されています。この文言だけで、reAPI がエラーを返したと断定はできません。機密情報を除いたメッセージ、ステータス、リクエスト ID をゲートウェイ運用者に渡し、元の拒否理由を調べてもらってください。^[9]

地域エラーは別に扱います。 403 だけなら、アカウントの権限や企業のプロキシが関係している可能性もあります。地域で利用できないという明示的なメッセージがある場合は、Anthropic の対応地域ポリシーを確認します。利用条件を満たすか不明な場合は、該当アカウントまたはプロバイダーのサポートに問い合わせてください。ゲートウェイを変えても、これらの制限の例外が認められるわけではありません。^[10]^[11]

特に得意な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
Anthropic. Claude Code を LLM ゲートウェイに接続する. 確認日：2026-10-23。接続、認証ヘッダー、/status.
Anthropic. 認証. 確認日：2026-10-23。認証の優先順位.
Anthropic. Claude Code エラーリファレンス. 確認日：2026-10-23。選択したモデルのエラー、モデル設定.
reAPI. ネイティブ Messages リファレンス. 確認日：2026-10-23。現在の文書とネイティブルートのモデル許可リストを照合。 Claude Sonnet 5.5 のエンドポイントとヘッダー.
Anthropic. API エラー. 確認日：2026-10-23。 HTTP エラーとリクエスト ID. ゲートウェイ固有のステータス動作は、reAPI の現在のネイティブルート実装と別途照合しました。
Anthropic. Claude apps gateway の設定. 確認日：2026-10-23。上流のエラーメッセージ.
Anthropic. インストールとログインのトラブルシューティング. 確認日：2026-10-23。ログイン後の 403、インストール時の応答.
Anthropic. 対応地域ポリシー. 確認日：2026-10-23。対応地域と利用条件.