Google 推出 Gemini API CLI 預覽版，讓 Claude Code 和 Codex 等代理直接調用 Gemini
Google AI Studio 團隊在 2026 年 10 月 19 日推出 Gemini API CLI（指令名稱 `gemini-api`）的實驗性預覽版，公告由團隊成員 Dmitry Lyalin 和 Philipp Schmid 聯署。這個工具的官方說明寫得很直接：給 Codex、Claude Code、Antigravity、OpenClaw、Hermes，或任何有命令列權限的 AI 代理，一個調用 Gemini API 的方法。
換句話說，Google 這次賣的不是自家的代理，而是讓對手的代理用自己的模型。GitHub 說明文件的第一句就是「你已經在用的那個代理，也可以用 Gemini 的模型和託管代理」。
一個指令換一個檔案，圖片不會塞進脈絡視窗
據官方 GitHub 說明文件，`gemini-api` 是一個無狀態的單一 Go 執行檔，不需額外套件，在 macOS、Linux 和 Windows 都能跑，以 Apache 2.0 授權開源。據 AICoder 10 月 22 日的報道，最新版本 v0.4.3 在 10 月 19 日發布。
用法是一句命令列指令，例如 `gemini-api image "A friendly robot mascot for a developer tool" --out ./assets/`：提示詞進去，圖片落在專案的資料夾裏。據 AICoder 報道，生成的媒體檔案直接寫入磁碟，標準輸出只印出檔案路徑，所以 base64 編碼的圖片不會塞進代理的脈絡視窗（即模型一次能讀到的文字上限）。
託管代理（managed agent）的長工作則另一種做法：在背景開一個 Gemini 託管代理，指令回傳一個 interaction ID，之後憑這個編號取回結果。
指令分四組
分組 | 指令 | 做甚麼 |
|---|---|---|
Create | generate, image, tts, music, video | 生成文字、圖片、語音、音樂和影片 |
Understand | analyze, transcribe | 分析檔案和 YouTube 影片、把音訊和影片轉成文字 |
Manage | agent, files, models | 管理託管代理、檔案和模型 |
Advanced | environments, credentials, webhooks, triggers | 管理沙盒環境、伺服器端憑證、webhook 和定時觸發 |
說明文件寫明，整套介面都可以由執行檔本身問出來：`--usage` 印出整棵指令樹，`--schema` 印出請求內容的 JSON Schema，`--dry-run` 則在不連網、不讀作業系統鑰匙圈的情況下驗證參數，並印出已隱去憑證的 HTTP 請求。輸出可以是 JSON 或較精簡的 TOON 格式，也可以用 `--jq` 直接篩選欄位。
據 AICoder 報道，結束代碼分開四種情況：0 是成功，1 是執行或 API 失敗，2 是用法或驗證錯誤，3 是認證失敗；經 Files API 上傳的檔案保留 48 小時。
預設用哪些模型
指令 | 預設模型 |
|---|---|
generate、analyze、transcribe | gemini-3.8-flash |
image | gemini-nano-banana-2.1 |
video | gemini-omni-1.1-flash |
music | lyria-3.5 |
tts | gemini-3.8-flash-tts |
據 AICoder 報道，這組預設來自官方的 GitHub 說明文件，而工具本身不會改變模型的輸出質素。
Google 自己寫明：實驗性質，不是受支援的產品
官方說明文件在開首就標明，這不是一件受 Google 支援的產品。據 AICoder 報道，Google 並未為這次發布公布任何效能或準確度的基準測試，而對於生產環境的後端，Google 仍然建議用 Gen AI SDK（Python、TypeScript、Go、Java），命令列工具的位置是命令列管道、CI 和 AI 代理。
AICoder 同時指出，這個工具與 Google 原有的 Gemini CLI 是兩件不同的產品，後者是一個互動式的編程代理，已有部分開發者覺得兩者的名字容易混淆。
安裝方面，說明文件提供 macOS 和 Linux 的一行 `curl` 安裝腳本、Windows 的 PowerShell 版本，以及 `go install` 一途；自行編譯 `main` 分支需要 Go 1.26.10 或以上。設定好 `GEMINI_API_KEY` 之後，Google 建議在代理的指示檔案（`AGENTS.md`、`CLAUDE.md` 或 `.cursorrules`）加一段文字，叫代理先讀 `--help` 或 `--usage` 挑指令，用 `--dry-run` 預覽，再把回傳的檔案路徑和 interaction ID 接落下一步。
來源
- Introducing the Gemini API CLI（Google AI Studio 官方公告）
- google-gemini/gemini-api-cli（官方 GitHub 說明文件）
- Google previews Gemini API CLI, a zero-dependency Go binary for coding agents（AICoder）
暫時未有留言
提交留言即表示你已閱讀我們的私隱政策。