文章512
标签269
分类66

gemini-cli使用

有一段时间没有写博客了,这两年AI的发展日新月异,真是可怕。最近终于把学校的一摊子事忙完了,接下来还有个创新大赛、八月份又要去广州参加国培,不可谓不忙;

本文介绍了如何使用 Google 最新出的 gemini-cli:


gemini-cli使用

一、简介

目前大家可能用的都是 Cursor 或者 VSCode 里的插件(如 Cline)、阿里的通义灵码,以及腾讯的 CodeBuddy 这类界面化的 AI 编码交互方式。

gemini-cli 是一个让你可以在命令行使用和上面功能类似的命令行工具!

功能特点:

  • AI 编程伙伴: 你可以直接在终端里问它编程问题、让它帮你写代码、解释错误信息或者优化现有代码。
  • 多功能助手: 不仅仅是代码,你还可以向它提问各种问题,甚至可以发图片(比如错误截图)给它看,让它帮你分析。
  • 简化工作: 对于开发者和技术人员来说,这意味着不用离开熟悉的终端界面,就能快速获得 AI 的帮助,从而提高工作效率。
  • 开源免费: 它是开源的,并且在预览期间为个人开发者提供了非常慷慨的免费使用额度。

二、安装

直接使用 npm 全局安装即可:

npm install -g @google/gemini-cli

三、使用

直接在命令行输入:

gemini

即可打开:

➜  blog git:(save) ✗ gemini

 ███            █████████  ██████████ ██████   ██████ █████ ██████   █████ █████
░░░███         ███░░░░░███░░███░░░░░█░░██████ ██████ ░░███ ░░██████ ░░███ ░░███
  ░░░███      ███     ░░░  ░███  █ ░  ░███░█████░███  ░███  ░███░███ ░███  ░███
    ░░░███   ░███          ░██████    ░███░░███ ░███  ░███  ░███░░███░███  ░███
     ███░    ░███    █████ ░███░░█    ░███ ░░░  ░███  ░███  ░███ ░░██████  ░███
   ███░      ░░███  ░░███  ░███ ░   █ ░███      ░███  ░███  ░███  ░░█████  ░███
 ███░         ░░█████████  ██████████ █████     █████ █████ █████  ░░█████ █████
░░░            ░░░░░░░░░  ░░░░░░░░░░ ░░░░░     ░░░░░ ░░░░░ ░░░░░    ░░░░░ ░░░░░


Tips for getting started:
1. Ask questions, edit files, or run commands.
2. Be specific for the best results.
3. Create GEMINI.md files to customize your interactions with Gemini.
4. /help for more information.



╭─────────────────────────────────────────────────────────────────────────────────────────────╮
│ >   Type your message or @path/to/file                                                      │
╰─────────────────────────────────────────────────────────────────────────────────────────────╯

~/workspace/blog (save*)       no sandbox (see /docs)        gemini-2.5-pro (100% context left)

首次运行时,它会引导完成几个设置步骤:

  • 选择主题风格: 为界面选择一个喜欢的颜色主题。
  • 授权登录: 它会提示您通过 Google 账户进行登录授权。这通常会生成一个链接,需要在浏览器中打开并授权。

授权后,就可以享受免费的调用额度(预览版期间每天有 1000 次请求)。


四、配置API登陆

如果你没有配置 API,每次运行 gemini-cli 都要重新登陆一次,可以配置 API 修改登录方式;

1、访问 Google AI Studio

在浏览器中打开网址:

2、创建或获取密钥

  • 如果尚未登录,请使用您的 Google 账户登录。
  • 点击 “Create API key” (创建 API 密钥) 按钮。
  • 系统会生成一个新的 API 密钥。这是一个很长的字符串。

3、复制并妥善保管

  • 立即点击密钥旁边的复制,复制 key;

4、引入环境变量

配置:

export GEMINI_API_KEY="YOUR_API_KEY"

将你复制的内容替换 YOUR_API_KEY

有关 Google Gemini API 的使用也可以看这篇文章:

5、生效

运行 source ~/.zshrc 或重启终端;

随后在登录选项中选择 API Key 的方式即可!


五、其他说明

启动 gemini 后,引用本地文件 可以使用 @ 来选择文件;

更多内容可以通过 /help 获取:

Basics:                                                                                     │
│ Add context: Use @ to specify files for context (e.g., @src/myFile.ts) to target specific   │
│ files or folders.                                                                           │
│ Shell mode: Execute shell commands via ! (e.g., !npm run start) or use natural language     │
│ (e.g. start server).                                                                        │
│                                                                                             │
│ Commands:                                                                                   │
│  /clear - clear the screen and conversation history                                         │
│  /help - for help on gemini-cli                                                             │
│  /memory - Commands for interacting with memory.                                            │
│    show - Show the current memory contents.                                                 │
│    add - Add content to the memory.                                                         │
│    refresh - Refresh the memory from the source.                                            │
│  /theme - change the theme                                                                  │
│  /docs - open full Gemini CLI documentation in your browser                                 │
│  /auth - change the auth method                                                             │
│  /editor - set external editor preference                                                   │
│  /privacy - display the privacy notice                                                      │
│  /stats - check session stats. Usage: /stats [model|tools]                                  │
│  /mcp - list configured MCP servers and tools                                               │
│  /extensions - list active extensions                                                       │
│  /tools - list available Gemini CLI tools                                                   │
│  /about - show version info                                                                 │
│  /bug - submit a bug report                                                                 │
│  /chat - Manage conversation history. Usage: /chat <list|save|resume> <tag>                 │
│  /quit - exit the cli                                                                       │
│  /compress - Compresses the context by replacing it with a summary.                         │
│  ! - shell command                                                                          │
│                                                                                             │
│ Keyboard Shortcuts:                                                                         │
│ Enter - Send message                                                                        │
│ Ctrl+J - New line                                                                           │
│ Up/Down - Cycle through your prompt history                                                 │
│ Alt+Left/Right - Jump through words in the input                                            │
│ Shift+Tab - Toggle auto-accepting edits                                                     │
│ Ctrl+Y - Toggle YOLO mode                                                                   │
│ Esc - Cancel operation                                                                      │
│ Ctrl+C - Quit application

官方也提供了大量的经典案例:


六、后记

实际上和这位博主一样,我最开始也不喜欢使用命令行:

由于先入为主的一些体验,我一直习惯于使用像 Cursor 或者 VSCode 里的插件(如 Cline)、阿里的通义灵码,以及腾讯的 CodeBuddy 这类界面化的 AI 编码交互方式。相比之下,对于 Claude cli、Gemini cli 这类基于终端、命令行的交互方式,我一直提不起兴趣。

直到最近,我体验了几次 Claude cli 的编码功能,这才让我对以往的成见有了一些改变。过去我之所以更习惯插件式的交互方式,是因为它们的操作更为直观。无论是选择代码段、文件,还是插入图片,都非常直接简单。因此,我一直认为这种交互方式就是最优雅的 AI 编码方式。

正因为这种先入为主的心态,我始终对 Cli 这类交互方式有些抵触。我一直不太能理解,在编辑器里写代码,却要用终端来进行 AI 编码,这到底是一种怎样的交互逻辑?总觉得这种方式很割裂,与 AI 的交互以及 AI 的编码过程变成了一种黑盒,很不直观。这也是我迟迟没有尝试这种编码方式的原因。

但是在安装并且体验了之后,发现确实要方便很多!

他最后的总结也是我的体验以及一些个人感想:

这让我意识到,很多时候限制我们接受新事物的,并不是事物本身的缺点。那些所谓的缺点,或许只是我们自己想象出来的。真正阻碍我们发展的,往往是自己内心深处那些根深蒂固的成见。我们习惯于依赖以往成功的经验,固守在自己的舒适区,对不熟悉的方式和交互逻辑产生抵触情绪。而正是这种抵触,让我们与更美好的事物始终形同陌路。

这次 Claude cli 的体验给了我一个提醒:应该始终保持开放的心态,勇于尝试那些看似不符合直觉的新方法或新工具。也许这样能够带来许多意想不到的效率提升和全新的体验,要善于打破自己的成见,才能真正拥抱进步。


附录

参考:



本文作者:Jasonkay
本文链接:https://jasonkayzk.github.io/2025/07/14/gemini-cli使用/
版权声明:本文采用 CC BY-NC-SA 3.0 CN 协议进行许可