GeminiCLI.net

Gemini CLI 速查表

最常用 Gemini CLI 命令和标志的快速参考指南。

基本用法

gemini "您的提示词"

最基本的命令。向 Gemini 模型发送提示词并打印响应。

示例:gemini "世界上最大的5个城市是什么?"

npx @google/generative-ai '...'

无需永久安装即可运行 Gemini CLI。非常适合快速测试或不频繁使用。

示例:npx @google/generative-ai "为一个科技博客推荐一个好名字。"

文件和输入处理

gemini -f [FILE_PATH] '...'

将文件内容作为提示词上下文的一部分。文件内容会添加到您的提示词前面。

示例:gemini -f readme.md "总结这个 README 文件。"

cat [FILE_PATH] | gemini '...'

将文件内容(或任何标准输出)直接通过管道传递给 Gemini CLI 作为上下文。

示例:cat package.json | gemini '解释这些依赖项的用途。'

gemini --files="file1.py,file2.py" "比较这些文件"

发送多个文件给 Gemini 进行分析。

示例:gemini --files="v1.js,v2.js" "版本之间有什么变化?"

输出控制

gemini --json "从这段文本中提取数据"

请求以 JSON 格式输出,便于在脚本中解析。

示例:gemini --json "从以下内容中提取姓名、电子邮件和电话:张三,zhangsan@example.com,555-1234"

gemini --markdown "生成文档"

请求以 Markdown 格式输出。

示例:gemini --markdown "为 REST API 编写文档"

gemini --code-only "生成一个函数"

只输出代码块,不包含解释性文本。

示例:gemini --code-only "编写一个计算斐波那契数列的 Python 函数"

模型控制

gemini --model=gemini-1.5-pro "复杂问题"

指定使用哪个 Gemini 模型。

示例:gemini --model=gemini-1.5-flash "总结这段文字"

gemini --temperature=0.7 "创意故事"

控制响应中的随机性(0.0-1.0)。较低的值更具确定性。

示例:gemini --temperature=0.9 "写一个科幻短篇故事"

gemini --max-tokens=500 "长回答"

限制响应的长度。

示例:gemini --max-tokens=100 "总结这篇文章"

高级用法

gemini --system="你是一个有帮助的助手" "您的提示词"

设置系统提示以指导模型的行为。

示例:gemini --system="你是一个 Python 专家" "帮我解决这段代码"

gemini --save=mychat "开始一个对话"

保存对话以便稍后继续。

示例:gemini --save=project-planning "让我们规划一个新的网络应用"

gemini --load=mychat "继续我们的讨论"

继续之前保存的对话。

示例:gemini --load=project-planning "我们讨论的关键功能是什么?"

系统和网络工具

gemini '以表格形式列出当前目录中的文件'

执行 `ls` 命令并理解其输出。您可以要求特定格式或分析。

示例:gemini '递归显示 src 文件夹的内容,并识别任何 .css 文件'

gemini '在 `components` 目录中查找所有 `useState` 实例'

在文件中执行 `grep` 搜索内容。对代码分析和发现很有用。

示例:gemini '在所有 `.ts` 文件中搜索文本 `TODO:`。'

gemini '在 `src/blog` 文件夹中查找所有 markdown 文件'

使用 glob 模式按路径查找文件。代理通常会读取或分析这些文件。

示例:gemini '读取博客中的所有 `.md` 文件并给我每个文件的摘要。'

gemini '搜索网络上关于 AI 的最新新闻'

使用 Google 搜索执行网络搜索,回答关于时事或最新信息的问题。

示例:gemini '上次 Google I/O 活动的主要公告是什么?'

gemini '记住我更喜欢使用 pnpm 进行包管理。'

允许代理记住特定事实或偏好以供将来交互。

示例:gemini '从现在开始,当你建议安装包时,使用 pnpm。' '好的,我会记住使用 pnpm。'

gemini '运行命令 `npm run test` 并告诉我是否成功。'

执行任意 shell 命令并分析其输出。这是一个非常强大但可能危险的工具。

示例:gemini '使用 npm 安装 `is-odd` 包,然后编写一个 node 脚本来使用它。'

专业技巧

export GOOGLE_API_KEY="YOUR_KEY"

将您的 API 密钥设置为环境变量,这样您就不必在每个命令中提供它。

示例:将此添加到您的 .bashrc 或 .zshrc 文件中以保持持久性。

gemini -f code.js "重构这段代码。只输出原始的更新代码。"

使用提示来控制输出格式。要求'原始代码'有助于将输出直接管道传输到新文件中。

示例:gemini -f old.py "..." > new.py