跳转到主要内容

​
前言

Gemini CLI 是一个运行在终端里的本地编程代理工具，面向代码库进行理解、改动与执行，并提供交互式 TUI 与脚本化（headless）使用方式。 本节将介绍 如何将 Poixe 提供的 AI 大模型接入 Gemini CLI（不改变任何使用习惯，只替换鉴权与请求目标地址）。 gemini cli poster

Gemini CLI 官方文档

安装、命令、配置与使用方式参考

Gemini CLI GitHub 仓库

源码、版本发布与贡献指南

​
准备工作

确保你拥有： 并确认本机环境满足 Gemini CLI 的运行要求（Node.js 版本以官方文档为准）。

​
安装 Gemini CLI

使用 NPM 全局安装（官方仓库与文档均提供此方式）： 
npm install -g @google/gemini-cli
验证安装： 
gemini -v
gemini --help

​
配置环境变量

# 让 Gemini CLI 走 Poixe 网关
export GOOGLE_GEMINI_BASE_URL="https://api.poixe.com"
# 使用 Poixe API Key（建议用你自己的环境变量管理方式）
export GEMINI_API_KEY="$POIXE_API_KEY"

# 可选：写入 shell profile 持久化（zsh 示例）
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.poixe.com"' >> ~/.zshrc
echo 'export GEMINI_API_KEY="$POIXE_API_KEY"' >> ~/.zshrc
# 保存后重新加载配置
source ~/.zshrc

​
初始化配置

1

启动 Gemini CLI

gemini
2

首次认证

在交互界面中输入：
/auth
问题：How would you like to authenticate for this project?选择：Use Gemini API Key
3

测试连接

# 交互模式下直接输入
"hi"

# 或者在终端直接运行
gemini "hi"

​
开始使用

进入你的项目目录后启动： 
cd /path/to/your/project
gemini
你可以直接给一个任务（交互式继续追问/执行）： 
gemini "scan this repo, explain what it does, then propose a minimal plan to add a health check endpoint"

​
注意事项

​
1. 权限与执行风险

Gemini CLI 具备读写与执行能力。请只在你信任的仓库里使用，并谨慎批准涉及删除/批量改动/执行脚本的操作。

​
2. Poixe 网关下的“行为差异”

Poixe 是转发层，会在稳定性、风控、计费与工具能力上做一些工程取舍。若你遇到某些能力不可用/表现不同，请优先查阅 Poixe 的 兼容性与差异说明 相关章节。

​
常见问题

建议优先使用 API Key 环境变量方式：
  • 确认已设置 GEMINI_API_KEY="$POIXE_API_KEY"
  • 确认已设置 GOOGLE_GEMINI_BASE_URL="https://api.poixe.com"
  • 重启终端让环境变量生效
另外，若你之前走过官方登录态流程，可能会与当前网关目标不一致，建议切到 API Key 方式。
通常是权限/执行策略导致：
  • 先确认当前运行目录是否允许写入
  • 涉及危险命令（删除/安装/执行脚本）时，建议手动审阅并分步批准
  • 必要时把任务拆小：先让它输出计划与 diff，再由你决定是否执行
（具体权限/模式说明以官方文档为准。）
  • 优先检查环境变量是否正确（Base URL / API Key）
  • 复现时尽量提供请求时间与关键报错信息
  • 如需协助定位，请把 Poixe 的 Request ID 一并提供给团队