# gemini-cli-clx

**Repository Path**: chen-lexiang/gemini-cli-clx

## Basic Information

- **Project Name**: gemini-cli-clx
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-27
- **Last Updated**: 2025-06-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Gemini CLI

[![Gemini CLI CI](https://github.com/google-gemini/gemini-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/google-gemini/gemini-cli/actions/workflows/ci.yml)

![Gemini CLI 截图](./docs/assets/gemini-screenshot.png)

本仓库包含 Gemini CLI，这是一个命令行 AI 工作流工具，可连接您的工具、理解您的代码并加速您的工作流程。

使用 Gemini CLI，您可以：

- 在 Gemini 的 100 万 token 上下文窗口内外查询和编辑大型代码库。
- 利用 Gemini 的多模态能力，从 PDF 或草图生成新应用。
- 自动化操作任务，例如查询拉取请求或处理复杂的 rebase 操作。
- 使用工具和 MCP 服务器连接新功能，包括 [使用 Imagen、Veo 或 Lyria 生成媒体](https://github.com/GoogleCloudPlatform/vertex-ai-creative-studio/tree/main/experiments/mcp-genmedia)。
- 通过内置的 [Google 搜索](https://ai.google.dev/gemini-api/docs/grounding) 工具为您的查询提供依据。

## 快速入门

1. **先决条件**：确保已安装 [Node.js 18 或更高版本](https://nodejs.org/en/download)。
2. **运行 CLI**：在终端中执行以下命令：

   ```bash
   npx https://github.com/google-gemini/gemini-cli
   ```

   或通过以下方式安装：

   ```bash
   npm install -g @google/gemini-cli
   gemini
   ```

3. **选择颜色主题**。
4. **身份验证**：根据提示使用您的个人 Google 账户登录。这将为您提供每分钟最多 60 次模型请求和每天最多 1,000 次模型请求的权限。

您现在可以开始使用 Gemini CLI 了！

### 高级使用或提高限制

如果需要使用特定模型或更高的请求容量，可以使用 API 密钥：

1. 从 [Google AI Studio](https://aistudio.google.com/apikey) 生成密钥。
2. 在终端中将其设置为环境变量。将 `YOUR_API_KEY` 替换为生成的密钥。

   ```bash
   export GEMINI_API_KEY="YOUR_API_KEY"
   ```

有关其他身份验证方法（包括 Google Workspace 账户），请参阅 [身份验证指南](./docs/cli/authentication.md)。

### 使用本地模型（兼容 OpenAI）

您还可以使用本地模型或兼容 OpenAI 的 API 与 Gemini CLI 交互：

1. 设置您的本地模型服务器，提供兼容 OpenAI 的端点。
2. 配置环境变量：
   ```bash
   export OPENAI_API_KEY="your_api_key"
   export OPENAI_API_BASE="http://your_local_server:port/v1"
   ```
3. 在身份验证提示中选择 "OpenAI Compatible API"。

详细设置说明请参阅 [OPENAI_COMPATIBLE_SETUP.md](./OPENAI_COMPATIBLE_SETUP.md)。

## 示例

运行 CLI 后，您可以从终端开始与 Gemini 交互。

您可以从新目录启动项目：

```sh
cd new-project/
gemini
> 为我编写一个 Gemini Discord 机器人，使用我将提供的 FAQ.md 文件回答问题
```

或处理现有项目：

```sh
git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> 给我总结昨天提交的所有更改
```

### 后续步骤

- 学习如何 [贡献或从源代码构建](./CONTRIBUTING.md)。
- 探索可用的 **[CLI 命令](./docs/cli/commands.md)**。
- 如果遇到问题，请查看 **[故障排除指南](./docs/troubleshooting.md)**。
- 更全面的文档，请参阅 [完整文档](./docs/index.md)。
- 查看一些 [常见任务](#常见任务) 获取更多灵感。

### 故障排除

如果遇到问题，请前往 [故障排除指南](docs/troubleshooting.md)。

## 常见任务

### 探索新代码库

进入现有或新克隆的仓库并运行 `gemini`。

```text
> 描述该系统的主要架构组件。
```

```text
> 有哪些安全机制？
```

### 处理现有代码

```text
> 为 GitHub issue #123 实现初稿。
```

```text
> 帮助我将此代码库迁移到最新版本的 Java。从计划开始。
```

### 自动化工作流程

使用 MCP 服务器将本地系统工具与企业协作套件集成。

```text
> 制作一个幻灯片，展示过去 7 天的 git 历史记录，按功能和团队成员分组。
```

```text
> 制作一个全屏网页应用，用于墙显展示我们互动最多的 GitHub issue。
```

### 与系统交互

```text
> 将此目录中的所有图像转换为 png，并使用 exif 数据中的日期重命名。
```

```text
> 按支出月份整理我的 PDF 发票。
```

## 服务条款和隐私声明

有关 Gemini CLI 使用条款和隐私声明的详细信息，请参阅 [服务条款和隐私声明](./docs/tos-privacy.md)。