设置本地开发环境

了解如何为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 技能。
  • Developer Knowledge 远程 MCP 服务器，可让您搜索 Google 的官方开发者文档，并检索 Google Cloud、Firebase、Android、Google 地图等 Google 产品的信息。

根据您的代理，按照以下说明安装 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）以包含以下代码行，启用对开发者知识 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

其他工具和环境

如果您的工作流需要特定的开发环境或基础架构工具，请考虑以下事项：

后续步骤