GeminiCode：基于Gemini 2.5在终端运行的AI编程助手

综合介绍

GeminiCode 是一个在终端中运行的 AI 编程助手，由开发者在周末业余时间开发。它基于 Google 的 Gemini 2.5 Pro 模型，能读取和修改你电脑当前目录中的文件。这个工具的灵感来自 Anthropic 的 Claude Code，目标是为程序员提供一个直接在命令行中使用的助手。它是个实验项目，不是生产环境用的软件，可能有 bug，用户需谨慎使用。开发者建议只在测试环境或不重要的目录中使用，避免操作敏感文件。

功能列表

• 读取文件：自动读取当前目录及子目录中的所有文件内容。
• 修改文件：可以创建、编辑或删除文件，直接改变目录中的代码。
• 执行命令：能在终端中运行 bash 命令，执行简单操作。
• 代码生成：根据用户输入生成代码，比如写一个函数。
• 调试支持：帮助分析错误信息并给出修复建议。

使用帮助

GeminiCode 是一个命令行工具，需要在终端中安装和运行。以下是详细步骤和操作指南，确保你能快速上手。注意：它会直接访问你当前目录的文件，没有明确权限提示，使用前务必确认目录安全。

安装流程

1. 创建虚拟环境
   打开终端，输入以下命令创建一个隔离的 Python 环境，避免干扰其他项目：

python3 -m venv venv
source venv/bin/activate

运行第二条命令后，终端会显示 (venv)，表示环境激活成功。

2. 安装 GeminiCode
   在虚拟环境中输入：

pip install gemini-code

这会从 PyPI 下载并安装最新版本。安装过程通常几秒到一分钟，取决于网络速度。

3. 设置 API 密钥
   你需要一个 Google API 密钥来使用 Gemini 模型。获取方法：访问 https://ai.google.dev/，注册并生成密钥。然后在终端输入：

gemini setup YOUR_GOOGLE_API_KEY

替换 YOUR_GOOGLE_API_KEY 为你的实际密钥。设置成功后，工具就能连接模型。

4. 启动会话
   输入以下命令启动：

gemini

如果提示缺少模块 questionary，运行：

pip install questionary

或者指定模型启动：

gemini --model models/gemini-2.5-pro-exp-03-25

启动后，终端会进入交互模式。

基本操作

1. 查看目录文件
   在会话中输入：

What files are in this directory?

工具会列出当前目录的所有文件，比如 main.py、readme.txt。

2. 生成代码
   输入类似：

Create a simple Python function that calculates the Fibonacci sequence

工具会生成代码并显示，比如：

def fibonacci(n):
if n <= 1:
return n
return fibonacci(n-1) + fibonacci(n-2)

你可以复制到文件或让工具直接写入。

3. 修改文件
   输入：

Add a print statement to main.py

它会读取 main.py，添加 print("Hello")，然后保存。注意：没有确认步骤，直接修改文件。

4. 调试代码
   粘贴错误信息，比如：

Help me debug this error message: NameError: name 'x' is not defined

工具会分析并建议定义变量 x。

5. 执行命令
   输入：

Run ls command

它会执行 bash 命令并返回结果（仅限支持的简单命令）。

6. 退出会话
   输入：

/exit

会话结束，回到普通终端。

使用注意事项

• 请求限制：免费版每天 25 次请求，Tier 1 为 100 次。超出后会切换到 1.5 Pro 模型，但可能不稳定。
• 安全建议：只在测试目录使用，重要文件要备份。可以用 Docker 等容器运行，增加隔离性。
• 常见问题：如果卡住，重启会话即可。查看帮助用 /help。

通过这些步骤，你可以在终端中使用 GeminiCode。它适合实验性编程任务，但不稳定，不适合正式开发。

应用场景

1. 快速测试代码
   你想试写一个小功能，比如计算器。可以用 GeminiCode 在测试目录生成代码，运行前手动检查。
2. 学习调试
   新手程序员遇到错误信息看不懂，可以粘贴到 GeminiCode，获取简单解释和修改建议。
3. 临时文件操作
   需要批量修改文件内容，比如加注释。用 GeminiCode 输入指令，几秒完成。

QA

1. GeminiCode 安全吗？
   不完全安全。它直接操作文件，没保护机制。建议只用在不重要目录，重要数据要备份。
2. 需要联网吗？
   是的，运行时需要联网调用 Google API。
3. 支持哪些文件类型？
   能读取任何文本文件，比如 .py、.txt，但主要为代码设计。
4. 超过请求限制怎么办？
   超出后自动用 1.5 Pro 模型，功能可能受限。建议等次日或升级账户。