首页教程Gemini CLI

Gemini CLI 配置教程
Google 官方命令行 AI 编程助手

⏱️ 预计 8 分钟🖥️ Windows / macOS / Linux📅 更新于 2026-03-08
💡 Gemini CLI 是 Google 官方推出的命令行 AI 编程助手,使用 Gemini 模型,通过 YourAgent 中转接入

📋 前置要求

1安装 Node.js

# Homebrew(推荐)
brew install node

# 或 nvm
nvm install --lts
nvm use --lts

nodejs.org 下载 LTS 版本,双击安装。

💡 推荐:安装 Windows Terminal,支持多标签、更好的中文和 emoji 渲染。
# nvm(推荐)
nvm install --lts
nvm use --lts

# 或包管理器
sudo apt install nodejs npm

验证安装:

node --version

2安装 Gemini CLI

npm install -g @anthropic-ai/gemini-cli

验证安装:

gemini --version

3配置 YourAgent API

# 编辑 ~/.zshrc(或 ~/.bashrc)
export GEMINI_API_BASE_URL=https://your-agent.cc/api/v1
export GEMINI_API_KEY=sk-xxx

# 保存后生效
source ~/.zshrc
# PowerShell(管理员)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_BASE_URL", "https://your-agent.cc/api/v1", "User")
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "sk-xxx", "User")

设置后重新打开终端生效。

⚠️ 重要:sk-xxx 替换为你从 YourAgent 管理员处获取的实际 API Key。

4启动 Gemini CLI

# 进入项目目录
cd ~/your-project

# 启动 Gemini CLI
gemini

首次启动会初始化,稍等片刻即可使用。

📊 Gemini CLI vs Claude Code vs Codex CLI

对比项 Gemini CLI Claude Code Codex CLI
开发商 Google Anthropic OpenAI
核心模型 Gemini 3 Pro Claude Opus 4.6 Codex 5.3
Node.js 要求 LTS 18+(原生无需) 22+
YourAgent 价格 按量计费 $4.5/$100 $4/$100

❓ 常见问题

Q: Gemini CLI 和 Claude Code 怎么选?

如果你习惯 Google 生态或者想尝试 Gemini 模型,用 Gemini CLI。如果追求最强 Coding 能力,推荐 Claude Code + Opus 4.6。两者可以共存。

Q: 官方定价参考?

参考 Google Gemini API 定价页面