← Retour aux guides

Gemini CLI 中转站怎么接？59API 配置与环境变量

想用 Gemini CLI，卡在接入这一步

「模型接不进命令行」大概是很多开发者用 Gemini CLI 时的第一道坎。环境变量名写错一个字母、接口地址多带一段路径、密钥复制时少了引号，看起来都是小事，排错却能耗掉一整晚。更麻烦的是，Gemini CLI 使用的是 Google 原生协议，不是 OpenAI 兼容接口，网上抄来的通用配置几乎都要改。

59API 的定位很清楚：它是一个独立第三方 AI API 中转站，一个账号、一把 API 密钥、一个 API 主机 https://api.59api.com，就能接入 Claude、GPT、Gemini、DeepSeek 等模型。你不必为每个模型单独注册、单独记地址，也不用在多个后台之间来回切换。

对 Gemini CLI 来说，接入 59API 只需要两个环境变量：GOOGLE_GEMINI_BASE_URL 指向主机地址，GEMINI_API_KEY 填你的密钥。设置好之后，日常写代码、问问题、跑重构，都还是你熟悉的命令行工作流。

这篇文章就按这个思路走：先把准备工作做扎实，再把配置一条条写清楚，最后验证连接并看懂账单。全程不需要改项目代码，属于照着做就能完成的那种活。如果你还在犹豫值不值得折腾，先看结论：59API 采用预付余额、按请求的真实 token 用量计费，没有月费，余额永不过期，新注册账号还有 ¥1 免费额度，先跑通再充值，试错成本很低。

准备工作：密钥、余额和那只主机地址

第一步不是敲命令，而是把「钱包和钥匙」准备好。在 59API 官网注册后，你会拿到属于自己的 API 密钥，也就是后面配置里要填的 YOUR_59API_KEY 所对应的真实内容。密钥只属于你的账号，请像对待密码一样保管。

新账号注册即有 ¥1 免费额度，足够你把连接流程完整走一遍，包括启动客户端、发出第一个请求、看到用量记录。想继续用，充值选项也很直白：¥10、¥50、¥100、¥200、¥500、¥1000，支持微信支付和银行卡，需要发票也可用。

59API 的计费方式是预付余额，按请求的真实 token 用量扣费，没有月费，余额永不过期。这意味着你不需要为了「续费」卡着时间，也不用担心某个月没用就清零，钱放在那里随时可用。

密钥、主机和模型是解耦的：同一把密钥既能跑 Gemini CLI，也能在别处跑 GPT、DeepSeek 等模型。所以配置时不要把模型名写死在地址里，地址只负责主机，模型由你在客户端里选择。这也是 59API 用起来顺手的关键。

准备工作到此为止，接下来才是真正的接入动作。

两行环境变量，把 Gemini CLI 指到 59API

Gemini CLI 认的是 Google 原生协议，所以它读取的环境变量名也是 Google 那一套：GOOGLE_GEMINI_BASE_URL 和 GEMINI_API_KEY。设置方式很直接，在终端里写成下面两行：

• export GOOGLE_GEMINI_BASE_URL=https://api.59api.com
• export GEMINI_API_KEY=YOUR_59API_KEY

第一行是 59API 的 API 主机地址，注意它就是 https://api.59api.com，不要自作主张加上 /v1，也不要在末尾多打一个斜杠。第二行换成你自己的密钥，粘贴时留意别带空格和换行。

如果你希望每次打开终端都自动生效，把这两行写进 shell 的配置文件（例如 ~/.bashrc 或 ~/.zshrc），保存后重新打开终端即可。Windows 用户则可以按自己的终端习惯设置同名环境变量，变量名和值保持完全一致，59API 的配置在不同环境下是同一套逻辑。

这套配置之所以省心，是因为 59API 把接入面收敛成了一把密钥和一个主机地址。你不需要为 Gemini 单独申请 Google 侧的密钥，也不需要维护多套 endpoint；想换模型时，改的是客户端里的模型选择，而不是环境变量本身。

写完之后先别急着跑大任务，用最小的一次请求确认链路通畅，比出了问题再回头翻配置省时得多。

跑一次请求，顺便认清协议边界

打开终端，进入你的项目目录，启动 Gemini CLI，随便问一句短问题。如果能正常返回，说明 59API 的地址和密钥已经生效，接下来就可以把 Gemini 放进你的日常工作流里。

这里要特别提醒一条容易踩的边界：Gemini 模型走 Google 原生协议，只在 Gemini CLI 这类原生客户端里使用，它们不是 OpenAI 兼容模型，不能通过 /v1/chat/completions 调用。Cursor、Cherry Studio、Cline、OpenCode 以及各类 OpenAI SDK、cURL、Codex 走的是另一条路，那条路适合 GPT、DeepSeek 等非 Claude、非 Gemini 模型。

同样地，Claude 模型只能在正版 Claude Code 或 Claude Desktop（2.1.285 或更新版本）中使用。把这条边界记清楚，你就不会把「接口地址填错了」和「客户端根本不支持」混为一谈，排查方向会清楚很多。

验证阶段建议顺手做两件事：一是确认终端里没有残留旧的 GOOGLE_GEMINI_BASE_URL 值，避免旧配置抢占；二是尽量让密钥通过环境变量读取，而不是直接写进脚本或提交到代码仓库。前者避免踩坑，后者避免密钥随代码流出去。

到这一步，接入 59API 的技术动作已经完成，剩下的就是用起来。

账怎么算：费率透明，余额不会过期

跑通之后，真正让人安心的是账算得清。59API 的价格按每 100 万 token 列出，以人民币计价，输入、输出、缓存读取分别标注。以 Gemini 为例：Gemini 2.5 Flash 输入 ¥1.5、输出 ¥12、缓存读取 ¥0.15；Gemini 3.1 Pro 输入 ¥10、输出 ¥58、缓存读取 ¥1；Gemini 4 Argon 输入 ¥10、输出 ¥48、缓存读取 ¥0.5；Gemini 3.8 Flash 输入 ¥8、输出 ¥36、缓存读取 ¥0.8。

同一个账号还能顺手跑其他模型。以 GPT-6.1 Sol 为例，500 万输入加 100 万输出、不走缓存，在 59API 上的费用是 ¥13.32；同样的用量按官方标价 $20（约 ¥144）计算，59API 约为标价的 9%。这里要说明，官方标价只是参考价，59API 是独立第三方中转站，并非官方或授权渠道。

回到 Gemini 本身：按真实 token 用量扣费、余额永不过期、没有月费，这三点意味着你可以在需求高峰时多跑一点，在需求平淡时让余额安静躺着，不必做任何取舍。如果你还会用 GPT 或 Claude，也可以看看 59API 的可选周卡和月卡；卡片有独立密钥，只能调用对应系列模型，只从卡内额度扣费，不会回落到钱包余额，余额密钥也不会动用卡片，未用完的额度不结转。

现在轮到你了：注册后拿上 ¥1 免费额度，把上面两行环境变量贴进终端，跑一次 Gemini CLI 请求。几分钟之后，你就拥有了一条统一、可计量、随时可切换模型的接入路径。

Docs