核心编程工具
Gemini CLI
Google 官方终端 Agent,通过环境变量指向网关。
1安装
需要 Node.js 20 或更高版本。
终端
npm install -g @google/gemini-cli
gemini --version2配置接入
示例中的 YOUR_API_KEY 是占位符,直接复制无法使用。登录后可选择自己的密钥,自动填入本页全部示例。
登录后填入密钥Gemini CLI 通过两个环境变量指向网关。推荐写进它自己的 .env 文件,启动时自动读取。把 YOUR_API_KEY 换成你的密钥,或在页面顶部选择密钥自动填入。
手动方式:把以下内容写入 ~/.gemini/.env
GEMINI_API_KEY=YOUR_API_KEY
GOOGLE_GEMINI_BASE_URL=https://api.keyvia.cc或复制这段到终端执行
mkdir -p ~/.gemini && cat <<'EOF' > ~/.gemini/.env
GEMINI_API_KEY=YOUR_API_KEY
GOOGLE_GEMINI_BASE_URL=https://api.keyvia.cc
EOFGOOGLE_GEMINI_BASE_URL 填根地址,不带 /v1 或 /v1beta,CLI 会自己补路径。Key 绑定的分组需支持 Gemini 协议。
3验证
进入项目目录运行 gemini。首次启动选择认证方式时选「Use Gemini API Key」。能读取项目并回复即接入成功。
- 报 401 / 403 / 429 见 错误码。