LLM应用系列文章目录

第一章 Gemini CLI 与 Repomix 应用工具

文章目录

前言

本文主要整理 Gemini CLI 与 Repomix 两个应用工具的基本概念、安装方法、常用命令、配置方式以及输出格式说明，便于在 AI 编程、代码仓库整理和大模型上下文构建场景中使用。

提示：以下是本篇文章正文内容，下面案例可供参考

一、Gemini CLI

1.Gemini CLI

  • Gemini CLI是Google官方推出的一款命令行界面（Command-Line Interface）工具，类似于Claude Code。它允许用户直接在终端中与Gemini人工智能模型进行交互，支持提问、辅助编程、编辑文件等多种功能。20250701
  • GitHub地址：https://github.com/google-gemini/gemini-cli
  • Gemini CLI优势
    • 免费额度高：对于非重度用户，其免费额度基本能满足日常开发和学习需求。
    • 超长上下文能力：支持长篇对话，最长达10M个token，确保交互的连贯性。
    • 跨平台兼容：完美支持Windows、macOS和Linux系统，灵活性强。
    • 强大的社区与调试支持：虽然官方文档有限，但工具自带的调试模式（如-d选项）能有效帮助我们定位和解决问题。

2.安装Gemini CLI

  • 前提条件
    • Node.js环境：确保你的电脑已安装Node.js（推荐v20.x或更高版本）。
    • 网络环境：需要能够访问Google服务，通常需要配置代理或VPN。
  • 安装步骤
    • 打开终端（Windows使用CMD或PowerShell，macOS/Linux使用终端）。
    • 全局安装Gemini CLI命令：npm install -g @google/gemini-cli
      • 执行完成后，会在npm的执行命令文件夹中增加一个可执行的命令gemini。
      • 如果在其他工具如trae需要使用gemini，需要使用完整路径执行。
      • 如：/usr/local/lib/nodejs/node-v22.17.0-linux-x64/bin/gemini
    • 验证安装是否成功：gemini --version
    • 如果终端返回版本号，则说明安装成功。

3.Gemini CLI基本使用

  • 命令行启动交互模式：gemini

  • 启动后，选中使用Google账号登录

    • 在Windows中会直接调用本地浏览器，登录即可
    • 在Linux中会提示一个地址，可以使用远端的Windows浏览器登录即可。

  • 启动后，也可以使用GEMINI_API_KEY登录。但需要在Google账号申请Google AI Studio的账号。

  • 登录后，将进入一个交互式界面，可以直接输入问题或命令。
    在这里插入图片描述

  • 常用选项：

    • -d或–debug：启用调试模式，输出详细的连接和错误信息，用于排查问题。
    • -h：查看更多命令。

  • 退出：在交互模式下，按Esc键或输入exit退出。

  • 第一次登录可能会因为账号授权不了或者账号没有申请使用API而导致失败

4.解决登录授权问题

  • 需要为当前终端会话设置https_proxy环境变量，将Gemini CLI的网络请求指向本地代理端口。
  • 设置代理
    • Windows (CMD)设置代理：
set https_proxy=http://127.0.0.1:7890
  • Windows (PowerShell)设置代理：
$env:https_proxy="http://127.0.0.1:7890"
  • macOS/Linux (Bash/Zsh)设置代理：
export https_proxy=http://127.0.0.1:7890

5.解决google云服务账号API申请问题

  • 登录google云服务：https://console.cloud.google.com/
  • 选择或者创建一个项目。复制项目ID。如：probable-sprite-4************
  • 在google云服务中，搜索Gemini for Google Cloud服务并启用。
  • 将项目ID设置到环境变量中，命名为 GOOGLE_CLOUD_PROJECT。
    • Windows (CMD)设置环境变量：
set GOOGLE_CLOUD_PROJECT=你的项目ID
  • Windows (PowerShell)设置环境变量（建议使用Powershell，不用CMD）：
$env:GOOGLE_CLOUD_PROJECT="项目ID"
  • macOS/Linux (Bash/Zsh)设置环境变量：
export GOOGLE_CLOUD_PROJECT=项目ID

二、Repomix

1.Repomix

  • Repomix是将一整个github项目打包成一个AI模型可阅读的文件的工具。
  • 当需要将github代码库提供给大型语言模型 (LLM) 或其他AI工具（如 Claude、ChatGPT、DeepSeek、Perplexity、Gemini、Gemma、Llama、Grok等）时，Repomix可将整个github库打包成一个AI模型可阅读的文件。

2.Linux安装Repomix

  • 需要先安装nodejs和npm，nodejs版本需要在16或以上。
  • 使用npm安装repomix：npm install -g repomix

3.Repomix配置（可不需要）

  • 初始化新的配置文件（repomix.config.json）：
repomix --init
  • 会在项目根目录中创建一个用于自定义配置的文件，配置选项的解释
选项 描述 默认
output.filePath 输出文件的名称 “repomix-output.txt”
output.style 输出的样式（plain，xml，markdown） “plain”
output.parsableStyle 是否根据所选样式架构转义输出。会增加标记数量。 false
output.headerText 包含在文件头中的自定义文本 null
output.instructionFilePath 包含详细自定义说明的文件路径 null
output.fileSummary 是否在输出开头包含摘要部分 true
output.directoryStructure 是否在输出中包含目录结构 true
output.removeComments 是否从支持的文件类型中删除评论 false
output.removeEmptyLines 是否从输出中删除空行 false
output.showLineNumbers 是否为输出的每一行添加行号 false
output.copyToClipboard 除了保存文件之外，是否还将输出复制到系统剪贴板 false
output.topFilesLength 摘要中显示的顶级文件数。如设为0，不会显示摘要 5
output.includeEmptyDirectories 是否在存储库结构中包含空目录 false
include 要包含的文件的模式（使用glob 模式） []
ignore.useGitignore 是否使用项目.gitignore文件中的模式 true
ignore.useDefaultPatterns 是否使用默认忽略模式 true
ignore.customPatterns 要忽略的其他模式（使用glob 模式） []
security.enableSecurityCheck 是否对文件进行安全检查 true
tokenCount.encoding AI模型上下文限制的标记计数编码（如o200k_base） “o200k_base”
  • 示例配置

repomix.config.json代码

{
  "output": {
    "filePath": "repomix-output.xml",
    "style": "xml",
    "parsableStyle": true,
    "headerText": "Custom header information for the packed file.",
    "fileSummary": true,
    "directoryStructure": true,
    "removeComments": false,
    "removeEmptyLines": false,
    "showLineNumbers": false,
    "copyToClipboard": true,
    "topFilesLength": 5,
    "includeEmptyDirectories": false
  },
  "include": [
    "**/*"
  ],
  "ignore": {
    "useGitignore": true,
    "useDefaultPatterns": true,
    // Patterns can also be specified in .repomixignore
    "customPatterns": [
      "additional-folder",
      "**/*.log"
    ]
  },
  "security": {
    "enableSecurityCheck": true
  },
  "tokenCount": {
    "encoding": "o200k_base"
  }
}

4.Repomix使用

  • 打包本地github目录（github项目需要先git clone下载并解压的目录）：
repomix path/to/directory
  • 打包指定文件或目录（使用glob模式）：
repomix --include "src/**/*.ts,**/*.md"
  • 要排除特定文件或目录：
repomix --ignore "**/*.log,tmp/"
  • 打包远程github项目（url为项目地址，不需要有.git）：
repomix --remote https://github.com/78/xiaozhi-esp32

5.输出文件格式

  • 纯文本格式（默认）

代码

This file is a merged representation of the entire codebase, combining all repository files into a single document.

================================================================
File Summary
================================================================
(Metadata and usage AI instructions)

================================================================
Directory Structure
================================================================
src/
  cli/
    cliOutput.ts
    index.ts
  config/
    configLoader.ts

(...remaining directories)

================================================================
Files
================================================================

================
File: src/index.js
================
// File contents here

================
File: src/utils.js
================
// File contents here

(...remaining files)

================================================================
Instruction
================================================================
(Custom instructions from `output.instructionFilePath`)
  • XML格式
    • 当提示涉及上下文、说明和示例等多个组件时，XML标签会起到决定性作用。可以帮助Claude更准确地解析提示，从而获得更高质量的输出。
    • 要生成 XML 格式的输出，使用–style xml选项：
repomix --style xml
  • XML 格式以分层方式构造内容：

代码

This file is a merged representation of the entire codebase, combining all repository files into a single document.

<file_summary>
  (Metadata and usage AI instructions)
</file_summary>

<directory_structure>
src/
cli/
cliOutput.ts
index.ts

(...remaining directories)
</directory_structure>

<files>
<file path="src/index.js">
  // File contents here
</file>

(...remaining files)
</files>

<instruction>
(Custom instructions from `output.instructionFilePath`)
</instruction>
  • Markdown格式
    • 要生成 Markdown 格式的输出，请使用以下–style markdown选项：repomix --style markdown
    • Markdown 格式以分层方式构建内容：

代码

This file is a merged representation of the entire codebase, combining all repository files into a single document.

# File Summary

(Metadata and usage AI instructions)

# Repository Structure

｀｀｀
src/
  cli/
    cliOutput.ts
    index.ts
｀｀｀

(...remaining directories)

# Repository Files

## File: src/index.js

｀｀｀
// File contents here
｀｀｀

(...remaining files)

# Instruction

(Custom instructions from `output.instructionFilePath`)

总结

本文整理了 Gemini CLI 与 Repomix 的基础使用方法。Gemini CLI 适合在终端中直接调用 Gemini 模型进行问答、编程辅助和文件编辑；Repomix 适合将代码仓库整理成大模型可阅读的单文件上下文，方便与 Claude、ChatGPT、DeepSeek、Gemini 等模型配合使用。实际使用时，需要注意代理、Google 账号授权、API/项目环境变量配置，以及根据模型需求选择 plain、xml 或 markdown 等输出格式。

# 人工智能 # 开发语言 # python
Logo
智能体开发者社区

中国智能体开发者社区，聚焦智能体与大模型开发，提供前沿资讯、实用工具链、开源项目及行业案例。通过技术沙龙、开发者大赛等活动，促进经验交流与协作，助力开发者快速构建创新智能应用。

更多推荐

cover

【小白也能轻松用】个人办公AI搭建，OpenClaw零基础零代码快速部署（含最新安装包）

avatar 智能体开发者社区

别再手动编译了，用 Docker 在 Instinct GPU 上三分钟跑通 vLLM

本文详解如何利用 Docker 在 AMD Instinct GPU 上三分钟快速部署 vLLM。借助 ROCm 7.x 官方预构建镜像，开发者可彻底告别手动编译地狱，轻松实现 Llama 3.1 等模型的高效推理。文章涵盖 BF16/FP8 精度配置及性能实测，助您大幅降低环境配置成本，加速大模型服务上线。

avatar 智能体开发者社区

显存不够别硬撑，FP8 量化让 70B 大模型在单卡 Instinct 上流畅运行

本文详解如何在单卡 Instinct MI300X 上利用 FP8 量化技术流畅运行 Llama 3.1 70B 大模型。通过 ROCm 7.x 与 vLLM 部署，FP8 将显存占用减半并释放带宽潜力，使吞吐量提升近 3 倍，有效解决显存瓶颈，助力大模型低成本高效落地。

avatar 智能体开发者社区