# Gemini CLI 使用指南

Google 开源终端 Agent，用于 Gemini 编程、项目上下文与命令行自动化。

Canonical URL: https://aiidelist.com/zh/blog/traeide-gemini-cli-zh

Language: zh

Published: 2026-10-03

Updated: 2026-10-03

> 本文基于 2026 年 9 月的资料整理。价格、模型和界面名称可能变化；这是一份操作指南，并非实时产品状态。

Google 开源终端 Agent，用于 Gemini 编程、项目上下文与命令行自动化。

编程 Agent · Google · macOS · Windows · Linux

 

## 适合的工作流

适合使用 Google 账户、Gemini API 密钥或 Vertex AI 的开发者。

## 限制与计费

额度取决于身份验证方式；Workspace 账户可能需要 Google Cloud 项目。

## 已核实的功能

Agent 工作流 · 命令行界面 · MCP · 技能 · 规则／指令 · 钩子 · 自带 API 密钥

这里只列出有依据的功能，并非完整功能清单。未列出的能力尚未在这条资料中核实。

## 价格与用量

**可免费使用，需查看限制**

账户额度或 Gemini / Vertex AI 按量计费。按量使用或外部 Agent 的费用可能与订阅分开计算。

## 模型与访问权限

支持 Google 登录、Gemini API 密钥或 Vertex AI 凭据。

已核实的模型系列： Gemini.

<span id="cli-setup"></span>

## 安装并启动 CLI

安装受支持的 Node.js 和 npm；普通项目建议使用稳定版。

```
npm install -g @google/gemini-cli
```

在终端打开项目目录，然后运行：

```
gemini
```

## 账户与身份验证

首次启动时选择 Google 登录、GEMINI\_API\_KEY 或 Vertex AI。

## 项目配置与工具

使用 GEMINI.md 提供项目上下文；扩展和 MCP 需在登录之外单独配置。

## 建议尝试的首个任务

让 Gemini 先梳理主要模块和测试命令，再修改文件。

## 脚本用法

此示例请求生成项目概览。工具权限仍然生效；提示词不等于沙箱隔离。

```
gemini -p "Summarize the project structure without modifying files."
```

## 相关 CLI 工具

[查看全部 AI CLI →](/zh/blog/traeide-coding-agents-zh)

[Qwen Code](/zh/blog/traeide-qwen-code-zh) — Qwen 开源终端 Agent，用于代码库开发与模型接入配置。

[Codex](/zh/blog/traeide-codex-zh) — OpenAI 编程 Agent，用于本地项目与云端任务。

[Grok Build](/zh/blog/traeide-grok-build-zh) — Grok 编程 Agent，提供终端界面、脚本模式与 ACP 集成。

## 项目评估步骤

1. 打开一个熟悉的小型项目，确认必要的语言工具能够正常工作。
2. 给 Agent 一项范围明确的修改任务，并设定可观察的验收标准。
3. 审查差异、运行项目检查，并与现有工作流的结果比较。
4. 任务结束后查看用量，据此估算同类工作一个月的费用，包括单独的模型或 Agent 账单。

## TRAE 站内延伸阅读

- [TRAE 产品详情与教程入口](/zh/ide/trae)
- [Trae IDE / TraeCode 下载指南](/zh/blog/traeide-download-zh)
- [TraeCode 使用指南](/zh/blog/traeide-traecode-zh)
- [TraeWork 使用指南](/zh/blog/traeide-traework-zh)
- [TRAE 价格：TraeCode 与 TraeWork](/zh/blog/traeide-pricing-zh)
- [TRAE 模型与访问权限](/zh/blog/traeide-models-zh)
- [TraeWork 与 TraeCode（Trae IDE）比较](/zh/blog/traeide-traework-vs-traecode-zh)
- [TRAE MCP 配置与故障排查](/zh/blog/traeide-mcp-zh)