メインコンテンツまでスキップ

セットアップガイド

概要​

このガイドでは、Claude Codeを使用するための開発環境を段階的に構築します。

INFO

ローカル環境と、Dev Container環境でClaude Codeをセットアップします。ローカル環境だけで利用する場合にはDev Container環境の設定は不要ですが、Claude Codeによる破壊的な変更が発生してもローカル環境を安全に保全できるDev Container環境についてもひととおり理解しておくことを強く推奨します。

1. Claude Codeのセットアップ​

Claude Codeをインストールする​

NPMインストール ※Node.js 18以降がインストールされている場合:

npm install -g @anthropic-ai/claude-code

Claude Codeにログインする​

ここではAmazon Bedrockによる認証方法を記載します。この方法でClaudeモデルへのアクセスを設定してください。

Amazon Bedrockによる認証​

Amazon Bedrockの提供するClaudeモデルにアクセスするようにセットアップするためには、以下の前提条件が必要になります。

Amazon BedrockでClaude Codeを設定するための前提事項​
  • Bedrockアクセスが有効になっているAWSアカウント
  • Bedrockで希望するClaudeモデル（例：Claude Sonnet 4）へのアクセス
  • AWS CLIがインストールされ設定されている（オプション - 認証情報を取得する他の仕組みがない場合のみ必要）
  • 適切なIAM権限
AWSアカウントのセットアップ​

まず、AWSアカウントで必要なClaudeモデルへのアクセスがあることを確認してください。

  1. Amazon Bedrockコンソールに移動
  2. 左側のナビゲーションでModel accessに移動
  3. 希望するClaudeモデル（例：Claude Sonnet 4）へのアクセスをリクエスト
  4. 承認を待つ（ほとんどのリージョンで通常は即座）
INFO

日本国内での利用を想定するため、モデルアクセスはap-northeast-1リージョンで有効である必要がある点に注意してください。

端末側のAWS認証情報の設定​

Claude CodeはデフォルトのAWS SDK認証情報チェーンを使用します。以下のいずれかの方法で認証情報を設定してください。

注記

他にも、SSOプロファイルの利用やBedrock APIキーの利用といった手段もあります。詳細については公式ドキュメントをご参照ください。

  • オプションA: AWS CLI設定

    aws configure

  • オプションB: 環境変数（アクセスキー）

    export AWS_ACCESS_KEY_ID=your-access-key-id
    export AWS_SECRET_ACCESS_KEY=your-secret-access-key
    export AWS_SESSION_TOKEN=your-session-token

Claude Codeを設定する​

Bedrockを有効にするため、以下の環境変数を設定してください。

# Bedrock統合を有効にする
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=ap-northeast-1

さらに、デフォルトでモデルがUSリージョンのモデルが設定されているため、東京リージョンを含むAPACのクロスリージョン推論モデルを利用する場合、推論プロファイルIDかアプリケーション推論プロファイルを指定してください。

# 推論プロファイルIDを使用
export ANTHROPIC_MODEL='jp.anthropic.claude-sonnet-4-5-20250929-v1:0'
export ANTHROPIC_SMALL_FAST_MODEL='apac.anthropic.claude-3-haiku-20240307-v1:0'

# アプリケーション推論プロファイルARNを使用
export ANTHROPIC_MODEL='arn:aws:bedrock:ap-northeast-1:your-account-id:application-inference-profile/your-model-id'

# オプション: 必要に応じてプロンプトキャッシュを無効にする
export DISABLE_PROMPT_CACHING=1

動作確認​

これでClaude CodeへのアクセスをBedrock経由に設定することができました。claudeコマンドを実行し、Bedrock経由でClaudeモデルにアクセスすることができることを確認してください。

/status
INFO

東京リージョンではClaude 4 Opusが提供されていないことにより、エラーになる可能性があります。モデルの指定コマンドを実行して、適切なアプリケーション推論プロファイル（Claude 4 Sonnet）を選択し直すことで実行可能になります。

/model

最終確認です。最終的に環境変数は以下のように設定されているはずです。

# Bedrock統合を有効にする
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=ap-northeast-1

# 推論プロファイルIDを使用
export ANTHROPIC_MODEL='jp.anthropic.claude-sonnet-4-5-20250929-v1:0'
export ANTHROPIC_SMALL_FAST_MODEL='apac.anthropic.claude-3-haiku-20240307-v1:0'

# アプリケーション推論プロファイルARNを使用
export ANTHROPIC_MODEL='arn:aws:bedrock:ap-northeast-1:your-account-id:application-inference-profile/your-model-id'

# オプション: 必要に応じてプロンプトキャッシュを無効にする
export DISABLE_PROMPT_CACHING=1
INFO

Bedrockを使用する場合、認証はAWS認証情報を通じて処理されるため、/loginと/logoutコマンドは無効になります。

2. 基本ソフトウェアのインストール​

ここまでのセットアップで、ターミナル上でClaude Codeを使う準備はできています。ここからはIDEに統合してClaude Codeを使うことで、いくつかさらに利便性を上げる設定を追加できます。本ガイドではこれ以降Claude CodeをIDEに統合して利用する方法を基本的な使い方として解説します。

Visual Studio Code​

Claude CodeをIDE統合して利用するために、まずはVS Codeをインストールします。

インストール方法:

  1. Visual Studio Code公式サイトにアクセスする
  2. お使いのOS（Windows、macOS、Linux）に対応したインストーラーをダウンロードする
  3. ダウンロードしたインストーラーを実行してインストールする

動作確認:

# インストール確認
code --version

Dockerのインストール​

Dev Containerに接続して安全に利用するために、ローカルのDocker環境を準備します。

Windows​

  • オプションA: Docker Desktop（有償ライセンスが必要なケース有）

    ライセンスに関する注意

    Docker Desktop for Windowsは、一定規模以上の企業での商用利用時に有償ライセンスが必要になる場合があります。詳細はDocker社の公式サブスクリプションページをご確認ください。企業での利用を検討する場合は、ライセンス規約の確認を推奨します。

    1. Docker Desktop for Windowsをダウンロードする
    2. インストーラーを実行する
    3. WSL2バックエンドを有効化する

  • オプションB: WSL2 + Docker CE（無償だが、セットアップがやや複雑）

    この方法は無償で商用利用可能です。

    1. Microsoft公式ドキュメントに従ってWSL2をインストールする
    2. Docker公式ドキュメントに従って、WSL2内のUbuntu上にDocker CEをインストールする

macOS​

  1. Docker Desktop for Macをダウンロードする
  2. インストーラーを実行する

3. VS Code拡張機能のインストール​

拡張機能のインストール​

VS Codeを起動し、以下の拡張機能をインストールしてください。

  1. Claude Code (anthropic.claude-code)
    • Windows: Ctrl+Shift+X → "Claude Code" で検索 → インストール
    • macOS: ⌘+Shift+X → "Claude Code" で検索 → インストール
  2. Docker (ms-azuretools.vscode-Docker)
    • Windows: Ctrl+Shift+X → "Docker" で検索 → インストール
    • macOS: ⌘+Shift+X → "Docker" で検索 → インストール
  3. Dev Containers (ms-vscode-remote.remote-containers)
    • Windows: Ctrl+Shift+X → "Dev Containers" で検索 → インストール
    • macOS: ⌘+Shift+X → "Dev Containers" で検索 → インストール

これらの拡張機能を有効化することで、Claude CodeのIDE統合や、DevContainer環境内で安全にClaude Codeを実行できるようになります。

4. 最初のプロジェクトのセットアップ​

GitHubやGitLabのリモートリポジトリを作成し、ローカルにクローンして最初のリポジトリを作成しましょう。

5. (オプション) Dev Containerの設定​

最後に、ローカルでClaude Codeを使うよりも安全なDev Container環境をセットアップしましょう。

INFO

この操作は任意です。

基本構成​

プロジェクトルートに.devcontainer/devcontainer.jsonを作成し、以下の最小構成でClaude CodeをDev Container環境に導入できます。

最小構成のdevcontainer.json例:

{
  "name": "Claude Code Project",
  "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
  "features": {
    "ghcr.io/devcontainers/features/node:1": {}
  },
  "postCreateCommand": "npm install -g @anthropic-ai/claude-code"
}

セキュリティ強化​

Claude Codeは強力なAIエージェントであるため、意図しない外部通信や破壊的な変更を防ぐためのセキュリティ対策が重要です。

Anthropic社は、公式リポジトリの.devcontainerディレクトリで以下のセキュリティ機能を加えた実装を公開しています。

  • iptablesによるファイアウォール設定: 許可リストベースで必要なサービス（GitHub、npm、Bedrock等）のみ外部通信を許可
INFO

企業環境や機密プロジェクトでClaude Codeを利用する場合は、上記の公式実装を参考にセキュリティ強化を検討しても良いでしょう。

カスタマイズのポイント​

プロジェクトの要件に応じて、以下のような調整が必要になる場合があります。

  • 言語やフレームワーク固有のツール: Node.js、Python、Java等のランタイムやパッケージマネージャー
  • 追加の開発ツール: linter、formatter、テストフレームワーク等
  • プロジェクト固有の依存関係: データベースクライアント、クラウドのCLI等

これらはfeaturesセクションやpostCreateCommand等で追加できます。詳細はDev Containers公式ドキュメントをご参照ください。

証明書エラーへの対処​

社内プロキシ環境などでDevContainerを利用する際、SELF_SIGNED_CERT_IN_CHAINエラーを引き起こす可能性があります。原因は、社内プロキシの中間証明書をコンテナ内で信頼していないことです。

解決方法:

  1. プロキシの中間証明書を.devcontainer/ca.crtとして保存します
  2. Dockerfileで証明書をコンテナにコピーして信頼させます
  3. 環境変数で各ツールが証明書を使用するよう設定します

実装例:

.devcontainer/Dockerfile:

FROM mcr.microsoft.com/devcontainers/base:ubuntu

# CA証明書をコピー
COPY ca.crt /usr/local/share/ca-certificates/ca.crt

# CA証明書を更新
RUN chmod 644 /usr/local/share/ca-certificates/ca.crt \
    && update-ca-certificates

# 例）git、curl、Node.jsがシステム証明書を使用するように環境変数を設定
ENV GIT_SSL_CAINFO=/etc/ssl/certs/ca-certificates.crt
ENV CURL_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt
ENV NODE_EXTRA_CA_CERTS=/etc/ssl/certs/ca-certificates.crt

.devcontainer/devcontainer.json:

{
  "name": "Claude Code Project",
  "build": {
    "dockerfile": "Dockerfile"
  },
  "features": {
    "ghcr.io/devcontainers/features/node:1": {}
  },
  "postCreateCommand": "npm install -g @anthropic-ai/claude-code"
}
INFO

証明書ファイル（ca.crt）は環境固有の設定ファイルです。社内プロキシ環境でのみ必要となるため、汎用的なリポジトリとして管理する場合は.gitignoreに追加し、READMEなどで証明書の配置方法を説明することを推奨します。組織内で共通の証明書を使用する場合は、チームで共有するためにコミットすることも検討してください。

DevContainer環境の起動​

  1. VS Codeでプロジェクトフォルダを開く
  2. Ctrl+Shift+P → "Dev Containers: Rebuild Container（開発コンテナー: コンテナーのリビルド）"
  3. 初回起動時はイメージのビルドに時間がかかります

動作確認​

DevContainer環境が起動したら、以下を確認してください。

Claude Codeの動作確認​

1. Claude Codeのセットアップ ＞ Claude Codeにログインするを実施してください。実施後、ターミナル上でclaudeを実行するとClaude Codeが起動します。

に最終更新