Claude Code VS Code 拡張機能のセットアップ: バックエンド、モデル、サンドボックス

Claude Code VS Code 拡張機能のセットアップ: バックエンド、モデル、サンドボックス

Claude Code は、VS Code のサイドバーに完全なコーディングエージェントとして登場します。補完ツールではなく、プロジェクトを読み取り、ファイルを編集し、コマンドを実行するマルチステップの課題解決ツールです。VS Code 拡張機能は CLI とエンジンを共有しているため、スラッシュコマンド、CLAUDE.md の認識、MCP ツール呼び出しはすべて、ターミナルで使用するのと同じ方法で機能します。セットアップを理解する価値があるのはバックエンド層です。すべての推論呼び出しはユーザーが制御するエンドポイントを通過し、そのエンドポイントを Novita AI にルーティングすると、Claude モデルに加えて、より幅広いオープンソースのコーディング代替モデルにアクセスできるようになります。しかも、高容量のエージェントタスクを実用的にする価格で提供されます。

Claude Code が VS Code でできること

Claude Code VS Code 拡張機能はサイドバーパネルであり、インラインのオートコンプリートエンジンではありません。パネルを開いてタスクを説明すると、Claude Code はファイルの読み取り、変更の書き込み、シェルコマンドの実行、適用前の差分に対する承認待ちなど、マルチステップの作業を実行します。この違いが重要なのは、開発者が「claude code vs code」を検索するとき、入力に応じて補完される単一行の提案という Copilot のような体験を期待することが多いからです。しかし、これはそうではありません。補完には、他のツールがその役割を担います。VS Code の Claude Code はタスク向けです。このモジュールのテストを書く、認証ハンドラをリファクタリングする、このクエリが遅い理由を説明する、今日の変更でプルリクエストを作成する、などです。

拡張機能の具体的な機能:

  • 複数ファイルのインライン差分編集。 Claude Code は複数のファイルにわたる変更を提案し、エディタを離れることなく受け入れまたは拒否できる差分を表示します。
  • スラッシュコマンド。 /compact/clear/init/memory、およびユーザーが定義したカスタムスラッシュコマンドはすべて CLI と同じように機能します。
  • コンテキストの固定。 # プレフィックスは、特定のファイル、シンボル、またはフォルダをリクエストに添付します。#src/auth/handler.ts fix the race condition と入力すると、Claude Code に正しいコンテキストが即座に渡されます。
  • CLAUDE.md の認識。 プロジェクトのコーディング規約、アーキテクチャのメモ、推奨ライブラリなど、CLAUDE.md 内のすべてがセッション開始時に読み込まれます。一度書けば、エージェントは毎セッションでそれを尊重します。
  • MCP ツール呼び出し。 Claude Code 設定に登録された MCP サーバーは、拡張機能パネル内で利用できます。

この拡張機能が行わないこと: 既存のエディタのキーバインドを置き換えたり、シンタックスハイライトを変更したり、キー入力ごとの補完を追加したりすることはありません。通常の VS Code ワークフローに重ねて使用するエージェントインターフェースです。

VS Code に Claude Code を追加する方法

拡張機能パネルを開きます (Windows/Linux では Ctrl+Shift+X、macOS では Cmd+Shift+X)。Claude Code を検索し、発行元 Anthropic を探します。** インストール** をクリックします。

コマンドラインを使用する場合:

code --install-extension Anthropic.claude-code

インストール後、Claude アイコンが VS Code の左側にあるアクティビティバーに表示されます。クリックするとエージェントパネルが開きます。

初回起動時の認証。 拡張機能は最初の起動時にサインインを求めます。2 つの方法があります:

  • Anthropic アカウント: ブラウザの OAuth フローです。Anthropic Console の API キーまたは有効な Claude サブスクリプションがあれば機能します。
  • Novita AI API キー: そのターミナルから VS Code を起動する前に、シェル環境で ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN を設定します。拡張機能は起動時にこれらを読み取り、Anthropic のログインを完全にバイパスします。詳細は次のセクションで説明します。

VS Code は拡張機能をバックグラウンドで自動的に更新します。バージョンを手動で追跡する必要はありません。

LLM API バックエンドの仕組み

3 層アーキテクチャを理解すると、すべての設定判断が明確になります:

  1. UI 層: VS Code 拡張機能 (または CLI、デスクトップアプリ — これらは互換性のあるサーフェスです)。
  2. エージェントロジック層: Claude Code エンジン — ツール定義、セッション管理、ファイル読み取り、コマンド実行。
  3. LLM API 層: すべての言語モデル呼び出しを処理する推論エンドポイント。

デフォルトでは、LLM API 層は api.anthropic.com を指します。Claude Code は Anthropic Messages API 形式を使用してリクエストを送信します。重要な詳細: ANTHROPIC_BASE_URL はそれらのリクエストをすべて Anthropic 互換のエンドポイントにリダイレクトします。Novita AI は同じ Messages API 形式を https://api.novita.ai/anthropic で公開しているため、この切り替えはエージェントロジック層に対して透過的です。Claude Code は、応答が Anthropic のサーバーから来たのか Novita のサーバーから来たのかを認識せず、気にしません。

さらに 3 つの環境変数で構成が完了します:

  • ANTHROPIC_AUTH_TOKEN — 選択したプロバイダーの API キー。
  • ANTHROPIC_MODEL — 主要なタスクに使用するモデル ID。
  • ANTHROPIC_SMALL_FAST_MODEL — 要約やコンテキスト圧縮などの高速なバックグラウンドタスク用のモデル ID。

これらは VS Code を起動する前に設定してください。拡張機能はシェル環境からそれらを継承します。

Claude Code を Novita AI に接続する

ステップ 1: Novita AI API キーを取得する

novita.ai でサインアップし、Key Management ページに移動します。新しいキーを生成してすぐにコピーしてください。再度表示されることはありません。

ステップ 2: 環境変数を設定する

macOS または Linux では、VS Code を起動する前にターミナルで変数をエクスポートします:

export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<your-novita-api-key>"
export ANTHROPIC_MODEL="zai-org/glm-4.6"
export ANTHROPIC_SMALL_FAST_MODEL="zai-org/glm-4.6"

Windows (コマンドプロンプト) の場合:

set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<your-novita-api-key>
set ANTHROPIC_MODEL=zai-org/glm-4.6
set ANTHROPIC_SMALL_FAST_MODEL=zai-org/glm-4.6

その後、同じターミナルセッションから VS Code を起動します:

code .

ステップ 3: 接続を確認する

Claude Code パネルを開き、短いテストメッセージを送信します。拡張機能が応答を返したら、ルーティングは機能しています。これ以降の料金は Novita AI 経由で請求されます。Anthropic アカウントには請求されません。

構成を永続的にするには、エクスポートをシェルプロファイル (~/.zshrc~/.bashrc、または同等のもの) に追加するか、direnv で管理するプロジェクトレベルの .env ファイルを使用して、プロジェクトごとにモデルを切り替えます。

クローズドソースのコーディング性能に匹敵するオープンソースモデル

Novita AI 経由でルーティングすると、Claude モデルに限定されません。Novita の LLM カタログには、エージェンティックなコーディングタスクに重要なベンチマークでクローズドソースの代替モデルと直接競争するオープンソースのコーディングモデルが含まれています。

Zhiyu AI の GLM-4.6 は実用的な例です。200K トークンのコンテキストウィンドウを備え、実際のコーディング評価では Claude Sonnet 4 に対して 48.6% の勝率を達成しています。長いコンテキストが重要となるエージェンティックワークフロー (大規模なコードベースでのデバッグ、完全なテストスイートの読み取りなど) では、このコンテキストウィンドウは仕様書の数字ではなく、実用的な利点です。Novita のモデル ID は zai-org/glm-4.6 です。

Novita のプラットフォームでコーディングワークロード用に評価する価値のある他のモデルには、DeepSeek R1 と Qwen 3 Coder があります。どちらもコード生成と指示追従ベンチマークで競争力のあるパフォーマンスを実証しています。同じ ANTHROPIC_MODEL 環境変数でそれらを切り替えることができます。再インストールも新しい統合も必要ありません。

オープンソースのコスト面の利点: Claude Code を大規模に実行しているチーム (CI パイプラインでの多数のエージェント実行、共有 Novita API キーを使用した複数開発者のセットアップ、大量のトークンを消費する長時間のエージェンティックセッション) は、Novita の価格設定のオープンソースモデルによって、インフラストラクチャ予算に有意義な余裕が生まれることを実感しています。Claude Sonnet 4 の 90% の性能を 40% のコストで実現するモデルは、エージェントを継続的に実行する際の経済性を変えます。

実行環境としての Novita Agent Sandbox

VS Code の Claude Code はシェルコマンドをローカルで実行できます。プロジェクトのビルド、テストの実行、パッケージのインストール、マシン上でのファイル作成などが可能です。ほとんどの日常的なタスクではそれで問題ありません。しかし、一部のエージェントタスクは分離されたコンピューティング環境で処理する方が適しています。マシンをブロックする重いテストスイート、システムパッケージをインストールするビルドステップ、システム設定を変更するコマンド、再現性が必要な並列エージェント実行などです。

Novita Agent Sandbox は、このユースケース専用に構築されたクラウド実行環境を提供します。サンドボックスはマイクロVMであり、ミリ秒単位で起動し、ホストシステムから分離された環境でコードを実行し、タスクが完了するとクリーンに終了します。残った状態はなく、ローカル環境への影響もなく、マシンの CPU が回復するのを待つ必要もありません。

Claude Code ユーザーにとっての実用的なワークフローは、言語モデル呼び出しの推論を Novita AI の LLM エンドポイントにルーティングし、ビルド、テスト実行、コード評価などの重い実行タスクについては、Novita Agent Sandbox API を介して Agent Sandbox インスタンスを起動することです。2 つのサービスは認証を共有しているため (同じ Novita API キー)、別途の認証情報管理は不要です。

自動コードレビューパイプラインや CI 統合型 Claude Code エージェントを構築しているチームは、この組み合わせが特に有用だと感じています。LLM コストは Novita のトークン単位の価格設定で予測可能なままであり、コンピューティングコストは Agent Sandbox の秒単位の請求で予測可能なままです。

日常の VS Code ワークフローのヒント

この拡張機能を珍しいものではなく実用的にするいくつかのパターン:

新しいプロジェクトは /init で開始する。 新しいリポジトリで /init を実行すると、CLAUDE.md のスターターファイルが生成されます。これは、Claude Code が編集を開始する前にプロジェクトの規約を伝える最も効率的な方法です。

# でコンテキストを固定する。 どのファイルを見るかを説明する代わりに、#filename と入力して直接添付します。リファクタリング作業では、#src/components/Button.tsx update the onClick handler to use the new event type の方が「Button コンポーネントを見て…」と説明するよりも速いです。

/compact を積極的に使う。 長いセッションでは、Claude Code はコンテキストを蓄積します。/compact は会話を要約し、トークンのオーバーヘッドを削減します。大きなタスクが完了した後、次のタスクを開始する前に実行してください。

差分をインラインで受け入れるか拒否する。 Claude Code がファイルを編集する前に、パネルに差分が表示されます。すべての変更を受け入れる必要はありません。部分的な差分を拒否して、修正されたアプローチを依頼してください。すべての応答を最終的な答えではなく出発点として扱うと、より良い結果が得られます。

プロジェクトの指示とセッションの指示を分ける。 CLAUDE.md は安定したプロジェクトコンテキスト (ビルドコマンド、アーキテクチャ、コードスタイル) 用です。現在のタスクの一時的な指示はセッションプロンプトに含めます。単一タスクのガイダンスで CLAUDE.md を乱雑にしないでください。

FAQ

Claude Code VS Code 拡張機能のドキュメントはどこにありますか?

公式の拡張機能ドキュメントは Anthropic によって claude.ai/code で管理されています。リリースノートと変更ログは、VS Code の拡張機能パネルの Claude Code の一覧で確認できます。

Claude Code VS Code 拡張機能は無料ですか?

拡張機能自体は無料でインストールできます。利用コストはバックエンドの構成によって異なります。Anthropic アカウントでは、トークンごとに支払うか、サブスクリプションクレジットを使用します。Novita AI にルーティングすると、Novita のトークン単位の料金を支払い、Anthropic の請求は発生しません。新しい Novita アカウントは、サインアップ時に無料トライアルクレジットを受け取ります。

VS Code 拡張機能と Claude Code CLI を同時に使用できますか?

はい、できますが、それらは別々のセッションとして実行されます。VS Code 拡張機能は、開いている CLI インスタンスとライブセッションを共有しません。2 つの間でセッションの継続性が必要な場合は、CLI で claude -c を使用して、そのディレクトリの最新セッションを再開してください。

VS Code における Claude Code と Cline の違いは何ですか?

Cline は、OpenAI 互換の任意のバックエンドを介してエージェント作業をルーティングする VS Code 拡張機能です。プロバイダーの柔軟性を最大限に提供しますが、より多くの構成が必要です。Claude Code は、緊密に統合されたツールセットを備えた Anthropic 独自のエージェントです。ANTHROPIC_BASE_URL のリダイレクトにより、Claude Code は実際には同様のバックエンド柔軟性を実現します。Novita AI を Claude Code 用にすでに設定している場合、Novita のモデルカタログにアクセスするために別途 Cline をインストールする必要はありません。

プロジェクトごとに異なるモデルを使用できますか?

はい。direnv とプロジェクトレベルの .env ファイルを使用して、ANTHROPIC_MODEL を特定のディレクトリにスコープします。direnv が有効なターミナルから VS Code でそのプロジェクトを開くと、拡張機能はプロジェクト固有のモデル設定を継承します。

Novita AI は、シンプルな API を使用して AI モデルをデプロイする簡単な方法を開発者に提供し、ビルドとスケーリングのための手頃で信頼性の高い GPU クラウドも提供する AI クラウドプラットフォームです。

おすすめ記事