ローカル開発環境を設定する

Google Cloudのローカル開発環境を構成する方法を学習します。このドキュメントでは、 Google Cloud サービスを使用してアプリケーションをビルド、テスト、実行するために必要なコアツールについて説明します。

  • gcloud CLI: クラウド リソースの管理、プロジェクトの構成、ローカル アプリケーションのデフォルト認証情報（ADC）の設定を行います。
  • Cloud クライアント ライブラリ: 任意のプログラミング言語の慣用的なライブラリを使用して、 Google Cloud API にプログラムでアクセスします。

また、このドキュメントでは、google-cloud-developer プラグインをインストールして、さまざまなエージェントで Google Cloud タスクとコーディングのサポートを受ける方法についても説明します。

Google Cloudの他のツールとインターフェースの概要については、 Google Cloudとのやり取り方法をご覧ください。

始める前に

組織の管理者に、次の前提条件を満たすよう依頼します。

  • ユーザー ID をプロビジョニングする: Cloud Identity アカウントまたは Google Workspace アカウントを割り当てます。
  • プロジェクト アクセスと IAM ロールを付与する: プロジェクトに必要な Identity and Access Management（IAM）ロールを割り当てます。
  • 課金を有効にする: プロジェクトで Cloud Billing が有効になっていることを確認します。

組織全体の設定については、Google Cloud 設定ガイド付きフローをご覧ください。

gcloud CLI と認証を設定する

リソースを管理し、ローカル環境を認証するように gcloud CLI（gcloud）を構成します。

  1. ローカル ワークステーションに gcloud CLI をインストールします。
  2. ターミナルで gcloud init を実行してログインし、デフォルトのプロジェクトを選択します。
  3. gcloud auth application-default login を実行して、アプリケーションのデフォルト認証情報（ADC）を構成します。ADC を使用すると、ローカル クライアント ライブラリがプロジェクトに対して自動的に認証されます。

Cloud クライアント ライブラリをインストールする

アプリケーション コードから Google Cloud サービスにプログラムでアクセスするには:

  1. プロジェクトで必要な Cloud API を有効にします。
  2. プログラミング言語（Java、Python、Go など）用の Cloud クライアント ライブラリをインストールします。コードは ADC を使用して自動的に認証されます。

google-cloud-developer プラグインをインストールする

Claude Code CLI、Antigravity CLI、Codex CLI などのエージェントを使用して開発作業を支援する場合は、google-cloud-developer プラグインをインストールして、 Google Cloud タスクとコーディングのサポートを受けることができます。このプラグインには次のものが含まれます。

  • アカウントの作成、お支払い情報の設定、プロジェクト管理、 Google Cloud サービスと API への認証に役立つスキル。
  • finding-google-skills スキル。適切な Google プロダクト スキルをオンデマンドで検索して実行し、Google スキルを事前に読み込む必要がなくなります。
  • Developer Knowledge リモート MCP サーバー。Google の公式デベロッパー ドキュメントを検索し、Google Cloud、Firebase、Android、マップなどの Google プロダクトの情報を取得する機能を提供します。

エージェントに基づいて、次の手順で google-cloud-developer プラグインをインストールします。

Antigravity CLI

  1. Google Agent Skills リポジトリでプラグインの場所を指定して、プラグインをインストールします。

    agy plugin install https://github.com/google/skills/plugins/cloud/google-cloud-developer

  2. gcloud CLI を使用して、 Google Cloud プロジェクトで Developer Knowledge API を有効にします。

    gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID

Claude Code CLI

  1. Google プラグイン マーケットプレイスを追加し、プラグインをインストールします。

    claude plugin marketplace add google/skills
claude plugin install google-cloud-developer@google-plugins

  2. gcloud CLI を使用して、 Google Cloud プロジェクトで Developer Knowledge API を有効にします。

    gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID

  3. API キーを作成して保護するの手順に沿って、Developer Knowledge API の API キーを作成します。作成したキーは安全な場所に保存してください。

  4. Claude Code CLI を起動する前に、API キーを環境にエクスポートします。

    export DEVELOPERKNOWLEDGE_API_KEY=YOUR_API_KEY

Codex CLI

  1. Google プラグイン マーケットプレイスを追加し、プラグインをインストールします。

    codex plugin marketplace add google/skills
codex plugin add google-cloud-developer@google-plugins

  2. gcloud CLI を使用して、 Google Cloud プロジェクトで Developer Knowledge API を有効にします。

    gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID

  3. API キーを作成して保護するの手順に沿って、Developer Knowledge API の API キーを作成します。作成したキーは安全な場所に保存してください。

  4. ~/.codex/config.toml（またはプロジェクトの .codex/config.toml）を更新して次の行を含めることで、Developer Knowledge MCP サーバーへの認証済みアクセスを有効にします。

    [mcp_servers.developer-knowledge]
  url = "https://developerknowledge.googleapis.com/mcp"
  env_http_headers = { "X-Goog-Api-Key" = "DEVELOPERKNOWLEDGE_API_KEY" }

  5. Codex を起動する前に、API キーを環境にエクスポートします。

    export DEVELOPERKNOWLEDGE_API_KEY=YOUR_API_KEY

代替ツールと環境

ワークフローに特定の開発環境またはインフラストラクチャ ツールが必要な場合は、次の点を考慮してください。

次のステップ