1. 为什么要把 Gemini CLI 塞进无头模式Gemini CLI 是 Google 官方推出的终端 AI 编程助手能在命令行里直接对话、读文件、跑 shell、改代码。它默认是交互式的你敲gemini回车进入一个 TUI 界面用斜杠命令、快捷键、主题切换来操作。但真正让它在工程里“值钱”的是无头模式Headless Mode——不弹界面直接吃 prompt、吐结构化结果能被脚本、CI、批处理调用。这篇聚焦三件事无头模式怎么跑通、主题与快捷键怎么配得顺手、以及怎么用 TaoToken 的统一 Key 把模型调用接进来。适合已经在用 Gemini CLI、想把它从“聊天玩具”升级成“自动化接口”的开发者。我会给出可直接复制的settings.json与config.toml骨架、无头模式验证命令、快捷键触发检查动作帮你把终端工作流一次落地。先说清楚一个前提Gemini CLI 本身是客户端它需要一个能响应模型请求的 API 端点。TaoToken 在这里扮演的是统一接入层——一个 Key 走通多家模型省去你到处申请、到处配环境变量的麻烦。下面所有配置都围绕这个思路展开。2. TaoToken 前置Key 与端点怎么准备在动手改配置前先把“钥匙”拿到。TaoToken 的官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台生成 API Key。API 基地址固定为 https://taotoken.net/api 注意这个地址不带任何查询参数配置时别画蛇添足。拿到 Key 后你有两种方式把它交给 Gemini CLI一是写进环境变量二是写进配置文件。我建议两者都做——环境变量用于临时覆盖配置文件用于长期稳定。环境变量名建议用TAOTOKEN_API_KEY避免和官方 Gemini 的变量名冲突。注意Key 属于敏感信息不要提交到 Git。建议放在~/.gemini/.env或系统的密钥管理里配置文件里用引用而非明文。如果你还没生成 Key可以直接去控制台页面https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 在 API Keys 页签下创建。创建时给它起个能认出来的名字比如gemini-cli-headless方便后续按用途吊销。3. 可复制配置settings.json 与 config.toml 骨架Gemini CLI 的配置分两层用户级在~/.gemini/settings.json项目级在project/.gemini/settings.json项目级覆盖用户级。无头模式相关的关键项包括输出格式、模型选择、工具审批策略。下面这份骨架可以直接抄改掉 Key 引用即可。{ general: { previewFeatures: true, enableAutoUpdate: false, vimMode: false }, output: { format: json }, model: { maxSessionTurns: -1, compressionThreshold: 0.5 }, tools: { autoAccept: false, useRipgrep: true, shell: { enableInteractiveShell: false } }, security: { disableYoloMode: false, enablePermanentToolApproval: false }, ui: { theme: Dracula, hideBanner: true, hideTips: true, showLineNumbers: true }, context: { fileFiltering: { respectGitIgnore: true, respectGeminiIgnore: true } } }几个点解释一下。output.format设成json是无头模式做自动化的基础脚本才能用jq解析。tools.shell.enableInteractiveShell关掉避免无头场景下卡在交互式 shell。ui.theme设成Dracula只是示例主题在无头模式下不影响输出但交互调试时有用。接下来是config.toml它主要管自定义命令和模型端点。放在~/.gemini/config.toml[api] base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY timeout_seconds 120 [model] default gemini-3-flash-preview fallback gemini-2.5-flash [headless] default_output_format json stream false include_stats trueapi.base_url指向 TaoToken 的 API 地址api_key_env告诉 CLI 从哪个环境变量读 Key。model.default我填的是 flash 系列无头批处理场景下速度和成本更友好需要强推理时再切 pro。headless.include_stats打开后JSON 输出里会带 token 用量方便你做成本监控。环境变量这样设export TAOTOKEN_API_KEYsk-你的Key export GEMINI_CLI1GEMINI_CLI1是 CLI 自己注入给子进程的标记手动设一下能让你的脚本判断“当前是否在 CLI 环境里”。4. 无头模式验证命令、输出与快捷键检查配置写完先验证无头模式能不能跑通。最基础的调用gemini -p 用一句话解释什么是幂等性 --output-format json如果配置正确你会拿到一段 JSON结构大致是response加stats。用jq提取正文gemini -p 用一句话解释什么是幂等性 --output-format json | jq -r .response流式输出适合长任务监控gemini -p 分析当前目录的代码结构 --output-format stream-json | jq -r .type这条命令会逐行吐出事件类型你能实时看到init、message、tool_use、result的流转。批处理场景我常用文件重定向cat src/auth.py | gemini -p 审查这段鉴权代码的安全问题 --output-format json review.json jq -r .response review.json主题与快捷键的验证稍微不同——它们主要影响交互体验无头模式下不生效。但你可以在交互模式里快速检查启动gemini输入/theme看主题列表是否包含你配的Dracula按CtrlY切换 YOLO 模式看状态栏是否变化按ShiftTab循环审批模式确认default、auto_edit、plan三态能切。这些动作确认后再回到无头脚本里行为才可预期。提示无头模式下工具审批默认走配置里的autoAccept。如果你在脚本里让模型执行 shell务必确认tools.autoAccept的取值符合你的安全预期别在无人值守环境里放开写操作。5. 本篇常见错排查报错一401 Unauthorized或invalid api key。九成是环境变量没生效。检查echo $TAOTOKEN_API_KEY是否有值以及config.toml里的api_key_env拼写是否一致。注意别把 Key 写进settings.json的明文字段CLI 读的是环境变量。报错二output-format json返回空或报解析错。先确认settings.json里output.format和命令行--output-format没冲突命令行优先级更高。如果 JSON 里error字段有内容看error.typeApiError通常是端点或网络问题AuthError回到上一条查 Key。报错三无头模式卡住不返回。多半是tools.shell.enableInteractiveShell没关或者某个工具调用在等审批。把tools.autoAccept按需设成true仅限可信脚本或显式加--yolo标志。生产环境慎用--yolo。报错四主题配了不生效。自定义主题文件必须放在主目录内CLI 出于安全只加载主目录下的主题文件。如果你把my-theme.json放在项目里会看到警告且不加载。把它挪到~/.gemini/themes/下再引用。报错五快捷键没反应。先确认终端没有拦截该组合键。比如CtrlS常被终端用作流控需要在终端设置里关掉。CtrlY切换 YOLO 只在交互模式有效无头模式不响应。6. 把 Key、模型对话与 Coding Plan 串起来配置跑通后日常使用会分成几条线。临时验证模型效果、对比不同模型的回答用模型对话页面最直接https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 不用改本地配置就能试。需要管理或轮换 Key去 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入细节和参数说明看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你打算把 Gemini CLI 长期挂在编码或 Agent 工作流里比如每天跑代码审查、生成提交信息、批量分析日志那 Coding Plan 更划算入口在https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。它按长期编码场景做了额度优化比单次调用更适合高频脚本。最后给一个我实测下来比较稳的批处理模板把无头模式、JSON 输出、TaoToken 端点串在一起#!/usr/bin/env bash set -euo pipefail export TAOTOKEN_API_KEY${TAOTOKEN_API_KEY:?请先设置 TAOTOKEN_API_KEY} for file in src/*.py; do result$(cat $file | gemini -p 找出潜在 bug 并给出修复建议 --output-format json) echo $result | jq -r .response reports/$(basename $file).md tokens$(echo $result | jq -r .stats.models // {} | to_entries | map(.value.tokens.total) | add // 0) echo $(date): $file 用了 $tokens tokens reports/usage.log done这段脚本的关键在于set -euo pipefail保证出错即停jq提取正文和 token 统计usage.log让你随时知道花了多少。跑之前记得mkdir -p reports。把主题和快捷键配好只是让交互舒服真正让 Gemini CLI 变成生产力工具的是这种能无人值守跑起来的无头脚本。
