生信喵 发表于 2025-12-14 22:22:14

音云API助力使用Gemini CLI，大幅降低开发成本

<blockquote>
<p>Claude Code V.S. CODEX V.S. GEMINI都可以用于生物信息学分析，对比大致如下<br />
<img src="https://tcapi.voiceclouds.cn:8444/uploads/2025/12/12/mj2qb5mm1z0dxoilx49.png" alt="" /></p>
</blockquote>
<h1>背景</h1>
<p>Gemini cli开源，且有免费次数，付费套餐每月20美金，且目前由于网络延迟，可能使用起来缓慢，效果不佳。所以音云API实现直连使用Gemini，且按量扣费。</p>
<h1>使用步骤</h1>
<h2>0. 系统要求</h2>
<ul>
<li>Linux(Ubuntu 18.04+, CentOS 7+, Debian 9+)或是Windows</li>
<li>Node.js 18+</li>
<li>网络连接</li>
</ul>
<h2>1. 安装 Node.js</h2>
<p>使用官方安装包</p>
<p>!<br />
Linux版本如下</p>
<ol>
<li>访问 https://nodejs.org</li>
<li>下载 LTS 版本的 Linux Binaries</li>
</ol>
<pre><code>wget https://nodejs.org/dist/v24.11.1/node-v24.11.1-linux-x64.tar.xz
</code></pre>
<ol start="3">
<li>解压并安装到系统目录</li>
</ol>
<pre><code>tar -xJvf node-v24.11.1-linux-x64.tar.xz
</code></pre>
<ol start="4">
<li>配置 PATH 环境变量</li>
</ol>
<pre><code>echo 'export PATH=&quot;/path/to/your/node-v24.11.1-linux-x64/bin:$PATH&quot;' &gt;&gt; ~/.bashrc &amp;&amp; source ~/.bashrc
</code></pre>
<p>Windows版本<br />
教程参考,使用npm管理：https://blog.voiceclouds.cn:8444/test/nvm%ef%bc%9enode%e9%ab%98%e7%89%88%e6%9c%ac%e9%99%8d%e7%ba%a7%e4%b8%ba%e4%bd%8e%e7%89%88%e6%9c%ac/<br />
最终实现版本推荐node18如下</p>
<pre><code>PS C:\Users\Administrator&gt; node -v
v18.18.2
PS C:\Users\Administrator&gt; npm -v
9.8.1
PS C:\Users\Administrator&gt; nvm ls
    22.15.0
* 18.18.2 (Currently using 64-bit executable)
</code></pre>
<h3>1.1 bug</h3>
<p>本来使用的node18版本，gemini报错</p>
<pre><code>gemini
file:///C:/Users/Administrator/software/nvm/nvm/v18.18.2/node_modules/@google/gemini-cli/node_modules/string-width/index.js:16
const zeroWidthClusterRegex = /^(?:\p{Default_Ignorable_Code_Point}|\p{Control}|\p{Mark}|\p{Surrogate})+$/v;
                              ^

SyntaxError: Invalid regular expression flags
    at ESMLoader.moduleStrategy (node:internal/modules/esm/translators:119:18)
    at ESMLoader.moduleProvider (node:internal/modules/esm/loader:468:14)

Node.js v18.18.2
</code></pre>
<p>解决方案，使用node24<br />
参考npm管理教程</p>
<pre><code>PS &gt; nvm install 24.9.0
Downloading node.js version 24.9.0 (64-bit)...
Extracting node and npm...
Complete
Installation complete.
If you want to use this version, type:
nvm use 24.9.0
PS &gt; nvm use 24.9.0
Now using node v24.9.0 (64-bit)
PS &gt; node -v
v24.9.0
PS &gt; nvm ls
  * 24.9.0 (Currently using 64-bit executable)
    22.15.0
    18.18.2
</code></pre>
<p>**Gemini3 pro模型已经上线，既有用于代码，也有用于生成图片（会消耗大量token，因为一张图片1MB，等于几十万行代码）！注意看模型介绍 **</p>
<h2>2. 安装 Gemini CLI</h2>
<p>打开终端，执行以下命令：</p>
<pre><code>npm install -g @google/gemini-cli
</code></pre>
<p><strong>验证安装：</strong></p>
<pre><code>gemini --version
# 0.20.2
</code></pre>
<h2>3. 配置 音云API</h2>
<p>我们通过模型价格页面https://api.voiceclouds.cn/models?provider=Claude可以比较出<br />
最便宜则是gemini-3-pro-preview模型的default分组。</p>
<h3>3.1 建立令牌专用Gemini</h3>
<p><img src="https://tcapi.voiceclouds.cn:8444/uploads/2025/12/14/mj5hvqbltkycwpdw69.png" alt="" /><br />
分组默认default，不用修改，仅是测试成本最低，可以选择官方的分组，更快更稳定。<br />
模型限制✔，输入gemini-3-pro-preview 选中。如果还需要其他模型则也可以添加到一起。（也可以默认不限制）</p>
<h3>3.2 创建 .gemini 文件夹</h3>
<p>新建位置：<code>~/.gemini/</code><br />
windows则在用户根目录建立，一般c盘。最后位置参考C:/Users/Administrator/.gemini</p>
<h3>3.3 创建 .env 文件</h3>
<p>在 .gemini 文件夹中创建 .env 文件：</p>
<p>.env复制配置</p>
<pre><code>GOOGLE_GEMINI_BASE_URL=https://api.voiceclouds.cn/
GEMINI_API_KEY=粘贴为Gemini CLI专用分组令牌key
GEMINI_MODEL=gemini-3-pro-preview
</code></pre>
<p>模型则是你要使用，且令牌支持的模型，现在已支持gemini-3-pro-preview，参考模型介绍页<br />
https://api.voiceclouds.cn/models</p>
<h3>3.4 创建 settings.json 文件</h3>
<p>在 .gemini 文件夹中创建 settings.json 文件：</p>
<p>settings.json复制配置</p>
<pre><code>{
&quot;ide&quot;: {
    &quot;enabled&quot;: true
},
&quot;security&quot;: {
    &quot;auth&quot;: {
      &quot;selectedType&quot;: &quot;gemini-api-key&quot;
    }
}
}
</code></pre>
<p><strong>注意：</strong> 配置文件更加安全且便于管理，需要重启 Gemini CLI 才生效。</p>
<h2>4. 启动 Gemini CLI</h2>
<p>配置完成后，运行以下命令启动：</p>
<p>gemini</p>
<p><strong>开始使用 Gemini CLI！</strong></p>
<ul>
<li>超大上下文窗口：1M tokens</li>
<li>Agent Mode 自动规划任务</li>
<li>Google Search 实时联网<br />
<img src="https://tcapi.voiceclouds.cn:8444/uploads/2025/12/14/mj5hww8qavzbmhkl55c.png" alt="" /><br />
可以看到右下角的当前模型。</li>
</ul>
<h1>总结</h1>
<p>因为我们的api量大管饱，而gemini一般也会自动判断使用pro还是flash。如果你想让gemini判定或者选择pro，只要你选择的令牌分组支持该模型名，可以直接不限制模型选择（默认不限制不勾选）。<br />
对Gemini的.env配置文件修改，例如</p>
<pre><code>GEMINI_MODEL=gemini-3-pro-preview
</code></pre>
<p>或者启动后/model选择模型<br />
<img src="https://tcapi.voiceclouds.cn:8444/uploads/2025/12/14/mj53g2hv9fdlvjoevst.png" alt="" /><br />
可以看到默认auto，搭配我们env指定了flash，那么实际就只用flash模型。<br />
<img src="https://tcapi.voiceclouds.cn:8444/uploads/2025/12/14/mj5hyo4vi3zxv1xjinr.png" alt="" /><br />
测试初始化阅读项目目录，梳理生成专用agents，仅消费了0.06额度，也就是平台的0.12元人民币。这么便宜。<br />
不限制于官方网络延迟，便宜，按量收费。这样的api，还要啥自行车？</p>
页: [1]
查看完整版本: 音云API助力使用Gemini CLI，大幅降低开发成本