設定本機開發環境

瞭解如何為Google Cloud設定本機開發環境。本文說明使用 Google Cloud 服務建構、測試及執行應用程式所需的核心工具：

  • gcloud CLI：管理雲端資源、設定專案，以及設定本機應用程式預設憑證 (ADC)。
  • Cloud 用戶端程式庫：使用偏好程式設計語言的慣用程式庫，透過程式存取 Google Cloud API。

本文也說明如何安裝google-cloud-developer外掛程式，在多個代理中取得 Google Cloud 工作和程式設計方面的協助。

如要概略瞭解 Google Cloud中的其他工具和介面，請參閱「與 Google Cloud互動的方式」。

事前準備

請要求機構管理員完成下列前置作業：

  • 佈建使用者身分：指派 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 Skills。
  • Developer Knowledge 遠端 MCP 伺服器：可搜尋 Google 官方開發人員說明文件，並擷取 Google 產品 (例如 Google Cloud、Firebase、Android、地圖等) 的資訊。

請根據您的代理程式，按照下列操作說明安裝 google-cloud-developer 外掛程式。

Antigravity

從 Antigravity Marketplace 安裝外掛程式：

  1. 在 Antigravity 中，前往「Customizations」>「Marketplace」，然後搜尋「Google Cloud Developer」。
  2. 按一下「新增」按鈕。

或者，您也可以使用 Antigravity CLI 安裝外掛程式：

agy plugin install google-cloud-developer

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

替代工具和環境

如果工作流程需要特定的開發環境或基礎架構工具，請考量下列事項：

後續步驟