Obsidian 笔试环境里 Gemini CLI 登录卡住？TaoToken 这样改 API Base

在 Obsidian 笔试环境里敲下 gemini login终端停在「等待授权」浏览器回调页转半天也回不到命令行——第四部分接入 AI 辅助时卡在这一步的人不少。解法不复杂把 Gemini CLI 的鉴权方式从账号登录换成 API Key用 TaoToken 做统一接入通道Key 到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建Base URL 填 https://taotoken.net/api末尾不要带 /v1。下面按笔试机的真实情况把配置文件、验证命令和几个高频报错一次写清楚。前面三步通常是装好 Obsidian、建一个本地仓库、装上 Terminal 或 Shell commands 一类的插件。这些都不难真正让人停住的是第四步——AI 辅助要能跑起来。笔试机和你自己的笔记本不一样账号、浏览器、网络白名单都不在你手里所以思路要换不要去修授权链路而是把授权这一步整个替换掉。1. gemini login 卡住时先看清卡在哪一环1.1 三种典型的卡法对应三种不同的死法第一种是回调打不开。OAuth 流程会在本地起一个监听端口浏览器授权完要回调到localhost。笔试机上如果这个端口被别的进程占了或者浏览器根本不在同一台机器上很多人是终端在虚拟机、浏览器在宿主机回调就永远等不到。第二种是账号体系卡住。笔试机的浏览器可能登着别人的账号、学校的企业账号或者一个早就退出的会话。你想切回自己的账号又要过手机验证、辅助邮箱验证人在考场上根本折腾不起。第三种是最无奈的终端显示 waiting for authentication浏览器那边其实什么都没发生。原因是授权回调依赖的那个外部域名不在笔试机的访问白名单里请求发不出去看起来就像「网络抖了一下」实际上它会一直抖下去。1.2 为什么「换一次网络再试」救不了这一步这几种卡法看着不一样根子是同一个默认登录方式把三个你控制不了的变量绑在了一起——账号、本地回调端口、外部域名可达性。笔试环境的网络策略是提前配好的你没法临时加白名单账号也不是说切就切至于端口冲突考场上你更不敢随便杀进程。所以重试的价值很低它只是把同一条路重新走一遍。真正有效的做法是把鉴权方式从「账号授权」换成「API Key」。链路一下子从三段变成一段本地进程拿着 Key向一个固定的 HTTPS 地址发请求没有浏览器、没有回调、没有账号切换。这就是后面所有配置的出发点。2. 换鉴权方式前先把两个地址分清楚2.1 到官网创建一把 Key复制下来备用打开 TaoToken注册登录后进控制台创建一把 API Key。创建完立刻复制页面刷新后通常就不再完整显示了。为了后面配置好写全文统一把它记作YOUR_API_KEY你自己填的时候换成真实值。顺手在同一个站点看一眼模型广场把要用的模型 ID 记下来。不同时间上架的模型不一样以页面当时列出的为准别凭记忆写带日期后缀的 ID那种十有八九是不存在的。2.2 官网地址和 Base URL 是两个东西别混着填这是最容易出错的地方单独列个表用途该填什么注册账号、创建 Key、看模型广场、查用量https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end填进 Gemini CLI 的 Base URLhttps://taotoken.net/api两条铁律Base URL 末尾不要加/v1也不要带任何查询参数。把官网那个带 UTM 的链接复制进配置文件是另一类高频错误——它不会报「地址不对」只会给你一个 401。提示配置类字段里出现的地址永远是https://taotoken.net/api只有你在浏览器里点开的地址才需要带 UTM 参数。这两个场景的地址长得像但用途完全不同。3. 改 ~/.gemini 下的配置让 Obsidian 仓库里的 AI 辅助跟着生效3.1 用 .env 写死 Key 和 Base URL比 export 稳Gemini CLI 会读取~/.gemini目录下的配置。笔试机最稳的写法是把 Key 和 Base URL 写进~/.gemini/.env这样不管是终端里手敲gemini还是 Obsidian 插件帮你调起来都能读到mkdir -p ~/.gemini cat ~/.gemini/.env EOF GEMINI_API_KEYYOUR_API_KEY GOOGLE_GEMINI_BASE_URLhttps://taotoken.net/api EOF chmod 600 ~/.gemini/.env写完新开一个终端会话别在当前会话里硬试——环境变量是在进程启动时读进去的。不同版本的 Gemini CLI 变量名可能略有出入用gemini --help或你本地那份文档确认一次。核心就两条一把 Key一个 Base URL值分别是YOUR_API_KEY和https://taotoken.net/api。3.2 鉴权模式要从账号切到 API Key光有 Key 还不够。如果你的版本在~/.gemini/settings.json里管理鉴权方式要把类型从账号授权切换成 API Key 模式否则它还是走原来的登录流程{ security: { auth: { selectedType: gemini-api-key } } }字段名以你本地装的版本为准改之前先备份原文件。判断有没有切成功看下次启动gemini时还会不会提示你去浏览器授权——不提示了就说明走的是 Key 这条路。3.3 Obsidian 侧怎么把这条命令发出去Obsidian 本身是笔记软件不会自己调命令行第四部分的「AI 辅助」通常靠两种方式接一种是 Terminal 插件。在仓库根目录开一个终端会话然后正常敲gemini。注意插件开的会话未必继承你登录 shell 的全部环境变量所以前面的.env写法比export更省心。一种是 Shell commands 插件。把命令写进插件配置但要注意 Obsidian 是图形界面启动的进程PATH里可能没有全局 npm 目录命令会报找不到。稳妥做法是写绝对路径或者在命令前显式带上变量cd ~/vaults/obsidian-bi set -a . ~/.gemini/.env set a gemini -p 只读当前仓库里的 00-笔试须知.md列出 5 条今天要检查的项不要修改任何文件注意Gemini CLI 在这里的角色是读文件、解释内容、生成文本。让它去连生产库、执行诊断脚本、跑导入导出这类动作都不在合理范围内。真要做数据库相关的题让它生成 SQL你自己在本地 SQL*Plus 里执行再把报错贴回对话。3.4 先确认环境变量真的进去了动手验证之前花十秒确认两件事source ~/.gemini/.env echo $GEMINI_API_KEY echo $GOOGLE_GEMINI_BASE_URL第二行输出必须是https://taotoken.net/api。如果看到结尾多了/v1或者看到的是带?utm_source的那串官网地址先改回来再往下走——这两种情况后面一定会报 401而且报错信息不会告诉你原因。4. 跑一次提问确认 Obsidian 仓库里的 AI 辅助已经走通4.1 最小成本的一次提问先用一句废话问题把链路打通别一上来就拿复杂任务试gemini -p 只回答两个字收到能看到正常返回说明 Key、Base URL、模型这三样都对上了。这一步如果失败问题一定在配置层跟 Obsidian 插件没关系先解决命令行再回到仓库里。4.2 回到真实的笔试仓库跑一次命令行通了以后进到你的仓库目录再跑一次顺便验证插件会话的环境变量也没问题cd ~/vaults/obsidian-bi gemini -p 读一下 README.md 和 00-笔试须知.md用条目列出我今天最该先做的三件事如果第一次是在终端里跑的第二次是在 Obsidian 的 Terminal 插件里跑的两次都要成功才算真正稳。很多人卡在第二次终端里好好的插件里报鉴权失败原因就是插件会话读不到~/.zshrc里的export改用~/.gemini/.env就好了。5. 401 和其它报错先查 Base URL 有没有多写 /v15.1 401 不一定怪 Key按顺序排查看到 401别急着重新创建 Key。按这个顺序查八成能在前两步解决排查项怎么查期望结果Base URL 是否被写成https://taotoken.net/api/v1echo $GOOGLE_GEMINI_BASE_URL结尾是/api没有/v1Key 是否真的写进去了echo $GEMINI_API_KEY是真实 Key不是YOUR_API_KEYKey 是否被复制污染看~/.gemini/.env内容没有首尾空格、没有换行断开有没有把官网链接填进配置看配置文件配置里只有https://taotoken.net/api第一条是最常见的很多工具的文档里 Base URL 是带/v1的手一抖就顺手加上了。多这一段路径会落到不存在的地址上返回的就是 401 或 404看起来特别像 Key 有问题。5.2 其余几类报错的处理方向模型不存在的报错确认模型 ID 是否真的在售。以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 上的模型广场当时列表为准别用记忆里的名字也不要自己拼日期后缀。不确定就先把--model参数去掉用默认模型验证链路。命令找不到Obsidian 里通过 Shell commands 调用时报「command not found」基本都是PATH问题。用which gemini拿到绝对路径写进插件命令里。改了配置还是老行为环境变量是启动时读的当前会话不会自动刷新。换一个终端会话或者干脆重启一次 Obsidian。授权提示仍然出现说明鉴权模式没切过去回到settings.json检查那个selectedType字段顺便确认改的是用户目录下那份配置而不是项目目录里的。6. 笔试当天收尾把这次调用对上账6.1 确认这次请求确实被记上了命令行能返回、插件也能返回说明链路通了但「通了」和「记上了账」是两回事。用同一把 Key 在 TaoToken 模型对话 里发一条测试消息然后回 控制台 API Keys 看这条调用有没有出现。出现了说明 Base URL 和 Key 是配套的笔试当天不会突然翻车。如果笔试那几天需要连着跑很多次长文本总结可以先去 Coding Plan 看一眼套餐够不够用别等到写到一半才发现额度见底。6.2 顺手把 Claude Code 那条线也备好有些笔试题目会要求你在仓库里直接改代码这时候命令行问答就不够了得用能读多文件、能改代码的工具。如果你本来就装了 Claude Code它的环境变量怎么填可以在 Claude Code 接入文档 里对照Base URL 同样是https://taotoken.net/api末尾不加/v1。需要新 Key 的时候回 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 控制台再建一把就行。把 Key、Base URL、鉴权模式这三样记在备忘录里下次换机器五分钟能重新配好比在考场上跟授权页面较劲划算得多。