Claude / Anthropic Guide

Claude CodeをVS Codeで使う導入手順と安全設定

Claude CodeはVS Code拡張から、計画の確認、ファイルや行の参照、差分レビューをIDE内で行えます。必要条件、導入、ログイン、最初の安全なタスク、企業向け設定を順番に整理します。

結論：公式VS Code拡張を使い、ManualかPlanから始める

先に答えると、VS CodeではAnthropic公式のClaude Code拡張を導入し、最初はManualまたはPlanの権限モードで使うのが安全です。公式資料ではVS Code 1.98.0以上と、対象のClaude有料契約またはClaude Consoleアカウントが前提です。拡張のチャットパネルにはCLIが同梱されますが、統合ターミナルでclaudeコマンドを使う場合は別途スタンドアロンCLIが必要です。

導入直後から自動編集へ切り替えず、読み取り、計画、差分確認、テストの順に小さく試します。扱うリポジトリ、入力してよい情報、実行してよいコマンド、承認者を先に決めると、便利さを維持しながら事故範囲を限定できます。

必要条件とインストール

VS Code 1.98.0以上を確認し、拡張機能ビューでClaude Codeを検索してAnthropic提供の拡張をインストールします。初回はブラウザでサインインします。Pro、Max、Team、Enterpriseなど対象のClaude契約、またはClaude Consoleアカウントが利用できます。APIキーが必須というわけではありません。

拡張が表示されない場合はVS Codeを再起動するか、Command PaletteからDeveloper: Reload Windowを実行します。シェルにAPIキーを設定しているのに認識されない場合、VS Codeが環境変数を継承していない可能性があります。安易にキーを設定ファイルへ直書きせず、公式の認証方法と組織ルールを確認します。

パネルを開いて最初の依頼を送る

ファイルを開いた状態でエディタ上部のSparkアイコン、Activity Bar、Command Palette、Status BarからClaude Codeを開けます。選択したコードは文脈として認識され、Option+KまたはAlt+Kでファイルと行範囲の参照をプロンプトへ追加できます。最初の依頼は「この関数の役割を説明し、変更はしない」のような読み取りだけにします。

次に、既存テストがある小さな修正を依頼し、計画、変更対象、差分、テスト結果を確認します。プロジェクト全体の大規模改修や本番設定の変更を初回タスクにしません。会話履歴へ機密が残る可能性もあるため、貼り付ける情報だけでなく自動的に参照される作業フォルダも確認します。

権限モードの違い

Manualはファイル編集と多くのシェルコマンドの前に許可を求めます。Planは実行前に計画を表示し、Markdown文書へコメントを加えてレビューできます。Edit automaticallyは編集を自動承認するため、対象範囲と復旧手段を確認した限定環境でのみ検討します。モード名だけで安全性は決まらず、接続ツールや端末権限も合わせて管理します。

企業導入では、読み取り専用の検証リポジトリ、保護ブランチ、秘密情報の除外、ネットワーク制限、テスト、コードレビューを組み合わせます。拡張が提案する差分は、誰が作成したかに関係なく通常のコードレビュー対象です。承認ボタンを押した記録だけでなく、何を確認したかも残します。

安全に使い始める番号手順

1. VS Codeと拡張の提供元を確認する。2. 組織承認済みのアカウントでログインする。3. 機密を含まない検証用リポジトリを開く。4. ManualまたはPlanを選ぶ。5. 読み取りだけの質問を送る。6. 小さな変更を依頼し差分を確認する。7. テストを実行する。8. 変更を人間がレビューしてから反映する。

チェックリスト：秘密ファイルを除外した／自動承認を既定にしていない／外部送信と本番変更を禁止した／テストとロールバック手順がある／利用者と承認者を記録する／拡張更新時に設定を再確認する。

よくある質問

VS Code拡張だけで使えますか？ チャットパネルにはCLIが同梱されますが、統合ターミナルでclaudeコマンドを使うにはスタンドアロンCLIも必要です。無料アカウントで使えますか？ 公式前提では対象の有料Claude契約またはClaude Consoleアカウントが必要です。

差分は自動で反映されますか？ 権限モードによります。Manualでは確認が入り、Planでは計画をレビューできます。企業では自動編集の可否を個人判断にせず、業務リスク別のルールとして管理します。

企業設定で追加確認する項目

個人のVS Code設定だけに任せず、利用できるリポジトリ、拡張、MCPサーバー、ネットワーク接続、シェルコマンド、環境変数、ログ保存先を組織単位で整理します。秘密情報を含む.envや認証ファイルは、プロンプトへ貼らないだけでなく作業フォルダからの参照可否も確認します。開発端末に強い権限がある場合、Claude Codeの権限もその範囲で影響を持ち得ます。

保護ブランチ、必須レビュー、CI、シークレットスキャン、依存関係検査はClaude Code導入後も維持します。AIが生成した変更を特別扱いせず、人間の変更と同じ品質ゲートを通します。監査では会話全文だけに依存せず、コミット、差分、テスト、承認者、実行環境を結び付けて追跡できる状態にします。

よくあるトラブルの切り分け

拡張が開かない場合は、VS Codeのバージョン、拡張の提供元、再読み込み、ネットワーク制御を順番に確認します。ログインできない場合は、対象アカウント、ブラウザ認証、組織のSSO、プロキシ、環境変数の継承を確認します。認証情報をチャットやチケットへ貼り付けず、エラーメッセージも秘密部分を除いて共有します。

ファイルを認識しない場合は、開いているワークスペース、選択範囲、除外設定、作業ディレクトリを確認します。意図しない変更が出た場合は承認せず、依頼範囲を小さくし、Planで対象ファイルと手順を明示させます。自動編集の停止、変更破棄、テスト再実行ができることを事前に確かめます。

チーム展開の進め方

最初は一つのチーム、一つのリポジトリ、一種類のタスクに限定します。説明やテスト追加など採点しやすい仕事から始め、二週間程度の検証で品質、時間、費用、事故、利用者の迷いを記録します。成果が出ても、個人情報や本番操作を含む別業務へ自動的に拡大しません。

利用ガイドには、開始方法、推奨プロンプト、禁止情報、権限モード、差分確認、テスト、相談先、事故時の停止手順を含めます。拡張やClaude Codeの更新で画面や機能が変わるため、更新日と確認担当を置きます。定着の指標は利用回数ではなく、レビュー負荷と手戻りが安全に減ったかです。

公式情報と次の一歩

公式情報：Use Claude Code in VS Code、Claude Code setup。基本操作はClaude Codeの使い方、導入要件はインストール方法、権限設計は権限設定ガイドも確認してください。

Miraigentの無料診断では、開発環境、権限、データ、レビュー、ログ、停止条件を確認し、Claude Codeを安全に試す最小範囲を整理します。