← Voltar aos guias

Gemini CLI 接入 59API：统一中转的低成本快速上手指南

先明确：你要切换的是调用入口

通过统一中转使用 Gemini CLI，不需要重写开发流程：仍在终端提问、理解项目和辅助修改代码，只把认证密钥与服务地址切换到 59API。它提供低价、按量付费的模型访问，适合不想维护多套供应商账户的开发者。

59API 提供原生官方品质模型，不做模型降级，价格处于低价梯队。不过，实际开销仍取决于所选模型、输入输出量和上下文长度，应以控制台价格及账单为准。

第一步：安装并确认运行环境

以下命令适用于 macOS 或 Linux 的 Bash 终端。准备 Node.js 20 或更高版本；如果当前 Gemini CLI 发行版要求更高版本，以安装提示为准。

检查环境：node --version

安装 CLI：npm install -g @google/gemini-cli

确认安装成功：gemini --version

另外准备一枚 59API 密钥，并在控制台确认账户可用额度、Gemini 接口说明及模型 ID。展示名称不一定等于请求中的模型 ID，不要自行猜测或拼写。

第二步：配置密钥和中转地址

在同一个终端会话中依次执行下面的命令。第一条会隐藏密钥输入，避免把密钥直接写进命令历史：

read -r -s -p "请输入 59API 密钥：" GEMINI_API_KEY

export GEMINI_API_KEY

export GOOGLE_GEMINI_BASE_URL="https://api.59api.com"

export GEMINI_MODEL_ID="替换为控制台提供的实际模型ID"

GEMINI_API_KEY 用于认证，GOOGLE_GEMINI_BASE_URL 用于指定 Gemini API 的服务入口。这套配置走的是 Gemini 原生协议，不要因为中转也兼容 OpenAI SDK，就给地址随意追加 /v1。如果控制台针对 Gemini CLI 给出了专用地址，应优先采用该说明。

这些变量只影响当前终端及其子进程。新开终端后需要重新设置；长期使用时可通过本机密钥管理工具加载，避免把密钥提交到项目仓库。

第三步：先做一次最小调用

可以先选择 Gemini 2.5 Flash 验证连通性；需要更复杂的分析时，再试 Gemini 3.1 Pro。两者都应使用控制台对应的实际模型 ID。

运行一次无需读取项目的测试：gemini -m "$GEMINI_MODEL_ID" -p "请用一句中文确认你能正常响应。"

若出现认证选择，选择 API Key 方式，而不是个人 Google 账户登录。已有登录状态导致认证方式不符时，在 CLI 中通过 /auth 重新选择。修改环境变量后，应退出并重新启动 CLI。

收到正常回复后，再进入项目目录运行：gemini -m "$GEMINI_MODEL_ID"

第一条项目任务可以是“概括目录结构，指出测试入口，暂时不要修改文件”。这既能检查项目理解能力，也能避免一上来就触发大规模文件修改。

遇到错误，按这个顺序排查

• 401 或认证失败：检查是否使用了 59API 密钥、输入是否完整，以及当前进程是否继承了环境变量。
• 404 或模型不存在：核对模型 ID、Gemini 原生接口地址和路径；不要混用 OpenAI 兼容接口。
• 429 或限流：降低并发、稍后重试，并查看账户配额与控制台提示，避免无间隔循环重试。
• 仍然访问原服务：检查认证选择与启动终端；可更新 CLI，并核对当前版本对 GOOGLE_GEMINI_BASE_URL 的支持。

控制成本，也控制代码暴露范围

先用短问题检查账单，再逐步增加上下文。明确文件范围、拆分任务，通常比反复提交整个仓库更经济。接入中转意味着请求经过额外服务方，生产密钥、客户数据和敏感代码应先脱敏；执行写文件或终端命令前，也要检查授权范围。

59API 还支持 Claude Code、Codex 和 OpenAI SDK，方便统一管理多工具的模型访问，但不同工具仍需配置各自协议。若你正在寻找低成本入口，可以注册 59API，先用小额度完成上述验证；有推荐需求时，也可了解其推荐返佣规则。

Preços · Docs