跳转到主要内容
Gemini CLI 可以通过环境变量或本地配置文件连接 APIAny.AI。适合在终端、编辑器和自动化开发流程中使用统一模型接口。

​
准备工作

  • 已安装 Gemini CLI。
  • 已在 APIAny.AI 控制台 创建 API Key。
  • 已准备一个要使用的模型 ID。

​
安装

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

​
配置环境变量

macOS / Linux： 
export GEMINI_API_KEY="sk-xxxxxxxxxxxx"
export GEMINI_BASE_URL="https://apiany.ai/v1"
gemini --model gemini-3.5-flash "帮我总结当前项目"
Windows PowerShell： 
$env:GEMINI_API_KEY = "sk-xxxxxxxxxxxx"
$env:GEMINI_BASE_URL = "https://apiany.ai/v1"
gemini --model gemini-3.5-flash "Summarize this project"

​
推荐模型

模型 ID适用场景
gpt-5.5适合复杂推理、编码和生产级工作流，优先推荐。
gpt-5.4适合高级对话、Agent 和通用生产任务。
gpt-5.4-mini速度、质量和成本均衡，适合日常高频使用。
gpt-4o-mini适合简单对话、翻译和轻量任务，速度快、成本低。
claude-sonnet-4-6适合 Claude 兼容配置的长文本、写作和编码任务。
gemini-3.5-flash适合 Gemini 兼容配置的快速多模态任务。

​
常见问题

​
返回 401 或认证失败

确认 API Key 已完整复制，前后没有多余空格，并且已经在 APIAny.AI 控制台中启用。

​
模型无法选择或调用失败

手动输入模型 ID，并确认该模型在 模型目录 中可用。不同工具可能不会自动拉取模型列表。

​
Base URL 应该怎么填

OpenAI 兼容配置通常使用 https://apiany.ai/v1；Claude 兼容配置通常使用 https://apiany.ai；需要完整接口地址的工具使用 https://apiany.ai/v1/chat/completions。