快速入门

快速入门

欢迎使用 Gemini CLI！本教程将指导您完成安装、配置和第一次使用的全过程。

步骤 1: 安装 Gemini CLI 💡 推荐方式

我们推荐使用 NPX 方式，无需安装即可使用最新版本。

npx @google/gemini-cli --help 其他安装方式 # 全局安装（推荐频繁使用者）

npm install -g @google/gemini-cli

# 项目本地安装

npm install @google/gemini-cli 步骤 2: 获取 API 密钥 🔑 重要提示

使用 Gemini CLI 需要 Google AI API 密钥。请确保您有有效的 Google 账户。

访问 Google AI Studio 使用您的 Google 账户登录 点击 "Create API Key" 按钮 选择或创建一个项目 复制生成的 API 密钥 步骤 3: 配置 API 密钥

有几种方式可以配置您的 API 密钥：

方式 1: 使用命令行配置（推荐） # 设置 API 密钥

npx @google/gemini-cli config set api-key YOUR_API_KEY_HERE

# 验证配置

npx @google/gemini-cli config get api-key 方式 2: 使用环境变量 # Linux/macOS

export GOOGLE_API_KEY="YOUR_API_KEY_HERE"

# Windows PowerShell

$env:GOOGLE_API_KEY="YOUR_API_KEY_HERE" 步骤 4: 第一次对话

现在让我们进行第一次 AI 对话：

# 简单的问候

npx @google/gemini-cli chat "你好！请介绍一下自己。"

# 询问技术问题

npx @google/gemini-cli chat "什么是 JavaScript？" 🎉 成功！

如果您看到了 AI 的回复，恭喜您已经成功设置了 Gemini CLI！

步骤 5: 尝试高级功能 文件分析

创建一个测试文件并让 AI 分析：

# 创建一个简单的 JavaScript 文件

echo "function hello(name) { return 'Hello, ' + name + '!'; }" > hello.js

# 让 AI 分析这个文件

npx @google/gemini-cli chat "请分析这个 JavaScript 函数" --file hello.js 保存输出 # 生成代码并保存到文件

npx @google/gemini-cli chat "写一个 Python 函数来计算斐波那契数列" --output fibonacci.py

# 查看生成的文件

cat fibonacci.py 调整生成参数 # 使用更保守的设置生成技术文档

npx @google/gemini-cli chat --temperature 0.2 "解释什么是 REST API"

# 使用更有创造性的设置写故事

npx @google/gemini-cli chat --temperature 0.9 "写一个关于 AI 的短故事" 常见任务示例 代码生成 # 生成 React 组件

npx @google/gemini-cli chat "创建一个显示用户列表的 React 组件"

# 生成 Python 脚本

npx @google/gemini-cli chat "写一个读取 CSV 文件的 Python 脚本" 文档编写 # 生成 README

npx @google/gemini-cli chat "为我的 Node.js 项目生成 README 文件"

# 生成 API 文档

npx @google/gemini-cli chat "为这个函数生成文档" --file api.js 学习和解释 # 解释概念

npx @google/gemini-cli chat "用简单的语言解释什么是机器学习"

# 代码解释

npx @google/gemini-cli chat "解释这段代码的作用" --file complex.py 翻译和转换 # 语言翻译

npx @google/gemini-cli chat "将这段文字翻译成英文" --file chinese.txt

# 格式转换

npx @google/gemini-cli chat "将这个 JSON 转换为 YAML 格式" --file data.json 常见问题解决 ❌ "command not found" 错误 解决方案：

• 确保使用 npx @google/gemini-cli 而不是 gemini • 检查 Node.js 和 npm 是否正确安装 • 尝试重新安装：npm install -g @google/gemini-cli ⚠️ "Invalid API key" 错误 解决方案：

• 确认 API 密钥正确复制（没有多余的空格） • 检查 API 密钥是否已启用 • 确保项目有足够的配额 • 尝试重新生成 API 密钥 🐌 响应速度慢 解决方案：

• 尝试使用 gemini-flash 模型：-m gemini-flash • 减少输出长度：--max-output-tokens 1000 • 检查网络连接 • 简化提示词 下一步

恭喜您完成了快速入门！现在您可以：

深入配置

学习如何自定义 Gemini CLI 的行为和设置

掌握聊天功能

学习高级聊天技巧和最佳实践

文件处理

了解如何处理各种文件格式

高级教程

探索更复杂的使用场景和技巧

获取帮助

如果您遇到问题或需要帮助：

• 查看 完整文档 • 访问 GitHub 仓库 • 查看 更多示例 • 加入 社区讨论