From 9d93215e36468695a535af30801d2c0d20a01e3c Mon Sep 17 00:00:00 2001 From: zyc123 <2594064239@qq.com> Date: Thu, 14 May 2026 14:17:04 +0800 Subject: [PATCH] 333 --- deploy/gemini-cli.md | 448 +++++++++++++++++-------------------------- intro/links.md | 6 +- node/windows.md | 2 +- 3 files changed, 184 insertions(+), 272 deletions(-) diff --git a/deploy/gemini-cli.md b/deploy/gemini-cli.md index a762e90..5df436e 100644 --- a/deploy/gemini-cli.md +++ b/deploy/gemini-cli.md @@ -1,347 +1,259 @@ -# Gemini CLI 安装步骤 +# Gemini CLI 安装步骤 **Google AI 编程助手安装指南** -资源| 地址 ----|--- -官方文档| [geminicli.com/docs]() - -📋 前置要求 +| 资源 | 地址 | +| --- | --- | +| 官方文档 | [geminicli.com/docs](https://geminicli.com/docs/) | +| oneinai 控制台 | | -请先完成 [Node.js 环境安装]()，确保 Node.js 18+ 已正确安装。 +> 📋 **前置要求** +> 请先完成 [Node.js 环境安装](/node/windows)，确保 Node.js 18+ 已正确安装。 -🚀 Gemini CLI 快速开始 +## 🚀 快速开始 -Google AI 编程助手，Gemini 2.5 Pro 驱动 +Google AI 编程助手，由 Gemini 2.5 Pro 驱动。 -**1️⃣** 安装 CLI **2️⃣** 配置密钥 **3️⃣** 开始编码 +**1️⃣ 安装 CLI　2️⃣ 配置密钥　3️⃣ 开始编码** -## 🚀 使用 CC-Switch 快速配置（推荐） +## 🚀 使用 CC-Switch 快速配置（推荐） -⚠️ 前置条件 +> ⚠️ **前置条件** +> 使用 CC-Switch 配置 Gemini CLI 之前，请确保已通过 npm 全局安装 Gemini CLI： +> +> ```bash +> npm install -g @google/gemini-cli +> ``` +> +> 验证安装：`gemini --version` -使用 CC-Switch 配置 Gemini CLI 之前，请确保已通过 npm 全局安装 Gemini CLI 工具： +推荐使用 [CC-Switch 快速配置工具](/tools/cc-switch) 进行图形化配置，简单快捷，无需手动创建配置文件。 -bash - - - npm install -g @google/gemini-cli +### 配置步骤 -1 +**1. 启动 CC-Switch 并切换到 Gemini 标签** -验证安装：`gemini --version` +1. 打开 CC-Switch 应用程序 +2. 点击顶部的「Gemini」标签页 +3. 点击右上角橙色「+」按钮添加新配置 -推荐使用 [CC-Switch 快速配置工具]() 进行图形化配置，简单快捷无需手动创建配置文件。 +![CC-Switch Gemini 标签页](https://minio.oneinai.com/oneinai/images/docs/gemini-cli/gemini-cli01.png) -### 配置步骤 +**2. 填写 Gemini CLI 提供商配置** -**1\. 启动 CC-Switch 并切换到 Gemini 标签** +| 配置项 | 说明 | +| --- | --- | +| **提供商名称** | 自定义名称，如「oneinai」 | +| **Base URL** | `https://api.oneinai.com` | +| **API Key** | 在 [oneinai 控制台](https://api.oneinai.com/console/token) 创建的 Gemini 专用令牌 | +| **Model** | `gemini-3-pro-preview` 或其他可用模型 | +| **安全设置** | 根据需求调整（可选） | - 1. 打开 CC-Switch 应用程序 - 2. 点击顶部的「Gemini」标签页 - 3. 点击右上角橙色「+」按钮添加新配置 +填写完成后点击「保存」按钮。 -![CC-Switch Gemini 标签页](https://docs.ikuncode.cc/images/tu12.png) +![CC-Switch 添加 Gemini CLI 配置](https://minio.oneinai.com/oneinai/images/docs/gemini-cli/gemini-cli02.png) +![CC-Switch Gemini CLI 配置详情](https://minio.oneinai.com/oneinai/images/docs/gemini-cli/gemini-cli03.png) -**2\. 填写 Gemini CLI 提供商配置** +> 💡 **提示** +> - CC-Switch 会自动创建 `~/.gemini/.env` 和 `settings.json` 文件 +> - 可以添加多个提供商配置，随时切换 +> - 切换配置后，关闭并重启 Gemini CLI 即可生效 - 1. **提供商名称** ：自定义名称（如「ikuncode」） - 2. **Base URL** ：输入 `https://api.oneinai.com` - 3. **API Key** ：粘贴您从 IkunCode 平台获取的 Gemini 专用令牌 - 4. **Model** ：选择 `gemini-3-pro-preview` 或其他可用模型 - 5. **安全设置** ：根据需求调整（可选） - 6. 点击「保存」按钮 +**3. 启用配置并使用** -![CC-Switch 添加 Gemini CLI 配置](https://docs.ikuncode.cc/images/tu13.png)![CC-Switch Gemini CLI 配置详情](https://docs.ikuncode.cc/images/tu14.png) +1. 在配置列表中找到刚创建的「oneinai」配置 +2. 点击配置右侧的「当前使用」按钮 +3. 配置会被标记为「当前使用」状态（绿色标签） +4. 重启 Gemini CLI，新配置即可生效 -💡 提示 - - * CC-Switch 会自动创建 `~/.gemini/.env` 和 `settings.json` 文件 - * 可以添加多个提供商配置，随时切换 - * 切换配置后，关闭并重启 Gemini CLI 即可生效 - -**3\. 启用配置并使用** - - 1. 在配置列表中找到刚创建的「ikuncode」配置 - 2. 点击配置右侧的「当前使用」按钮 - 3. 配置会被标记为「当前使用」状态（绿色标签） - 4. 重启 Gemini CLI，新配置即可生效 - -**4\. 系统托盘快速切换** +**4. 系统托盘快速切换** CC-Switch 支持通过系统托盘快速切换 Gemini CLI 配置： - * 右键点击系统托盘中的 CC-Switch 图标 - * 在菜单中选择 Gemini 分类 - * 直接选择要切换到的配置 - * 配置立即生效，无需打开主界面 +- 右键点击系统托盘中的 CC-Switch 图标 +- 在菜单中选择 Gemini 分类 +- 直接选择要切换到的配置 +- 配置立即生效，无需打开主界面 -⚠️ 注意事项 +> ⚠️ **注意事项** +> - 务必在 oneinai 平台创建 Gemini CLI 专用令牌 +> - Gemini 令牌与 Claude Code / CodeX 令牌不通用 +> - 切换配置后需要重启 Gemini CLI 才能生效 +> - 可在 CC-Switch 中测试 API 端点速度 - * 确保从 平台创建 Gemini CLI 专用令牌 - * Gemini 令牌与 Claude Code/CodeX 令牌不通用 - * 切换配置后需要重启 Gemini CLI 才能生效 - * 可在 CC-Switch 中测试 API 端点速度 +## ⌨️ 手动命令行配置 -## ⌨️ 手动命令行配置 +如果你不使用 CC-Switch，可以按照以下步骤手动安装和配置 Gemini CLI。 -如果您不使用 CC-Switch，可以按照以下步骤手动安装和配置 Gemini CLI。 +### 🖥️ Windows 平台 -### 🖥️ Windows 安装流程教程 +#### 1️⃣ 全局安装 Gemini CLI -#### 1️⃣ 全局安装 Gemini CLI +```powershell +npm install -g @google/gemini-cli +``` -powershell - - - npm install -g @google/gemini-cli +#### 2️⃣ 配置 Gemini CLI -1 +> ⚠️ **重要提示** +> 请替换下方的 `GEMINI_API_KEY` 为你从 [oneinai 控制台](https://api.oneinai.com/console/token) 获取的 Gemini CLI 专用 API 密钥。 -#### 2️⃣ 配置 Gemini CLI +**2.1 创建 gemini 配置目录** -⚠️ 重要提示 +在用户目录下创建：`%USERPROFILE%\.gemini\` -请替换下方的 `GEMINI_API_KEY` 为你从 获取的 Gemini CLI 专用 API 密钥！ +**2.2 创建 `.env` 文件** -**3.1 创建 gemini 文件夹** +在 `.gemini` 目录中新建 `.env` 文件，写入： -在用户目录下：`%USERPROFILE%\\.gemini\\` +```env +GOOGLE_GEMINI_BASE_URL=https://api.oneinai.com +GEMINI_API_KEY=你的专属密钥（在 oneinai 控制台创建） +GEMINI_MODEL=gemini-3-pro-preview +``` -**3.2 创建 .env 文件** +**2.3 创建 `settings.json` 文件** -在 `gemini` 文件夹新建 `.env` 文件： +在 `.gemini` 目录中新建 `settings.json` 文件，写入： -env - - - GOOGLE_GEMINI_BASE_URL=https://api.oneinai.com - GEMINI_API_KEY=你的专属密钥请到https://ikuncode.cc获取 - GEMINI_MODEL=gemini-3-pro-preview - -1 -2 -3 - -**3.3 创建 settings.json 文件** - -在 `gemini` 文件夹新建 `settings.json` 文件： - -json - - - { - "ide": { - "enabled": true - }, - "security": { - "auth": { - "selectedType": "gemini-api-key" - } - } +```json +{ + "ide": { + "enabled": true + }, + "security": { + "auth": { + "selectedType": "gemini-api-key" } + } +} +``` -1 -2 -3 -4 -5 -6 -7 -8 -9 -10 +#### 3️⃣ 启动 Gemini CLI -#### 3️⃣ 启动 Gemini CLI +```powershell +gemini +``` -powershell - - - gemini +> 🎉 **开始使用 Gemini CLI** +> - 输入上下文描述快速生成代码 +> - Agent Mode 自动编程模式 +> - Google Search 实时联网搜索 -1 +### 🍏 macOS 平台 -🎉 开始使用 Gemini CLI +#### 1️⃣ 全局安装 Gemini CLI -• 输入上下文描述 "M kikasuna" • Agent Mode 自动编程模式 • Google Search 实时联网搜索 +```bash +npm install -g @google/gemini-cli +``` -### 🍏 macOS 安装流程教程 +#### 2️⃣ 配置 Gemini CLI -#### 1️⃣ 全局安装 Gemini CLI +**2.1 创建配置目录**： -bash - - - npm install -g @google/gemini-cli +```bash +mkdir -p ~/.gemini +cd ~/.gemini +``` -1 +**2.2 创建 `.env` 文件**： -#### 2️⃣ 配置 Gemini CLI +```bash +cat > .env << 'EOF' +GOOGLE_GEMINI_BASE_URL=https://api.oneinai.com +GEMINI_API_KEY=你的专属密钥（在 oneinai 控制台创建） +GEMINI_MODEL=gemini-3-pro-preview +EOF +``` -**3.1 创建配置目录** ： +**2.3 创建 `settings.json` 文件**： -bash - - - mkdir -p ~/.gemini - cd ~/.gemini - -1 -2 - -**3.2 创建 .env 文件** ： - -bash - - - cat > .env << 'EOF' - GOOGLE_GEMINI_BASE_URL=https://api.oneinai.com - GEMINI_API_KEY=你的专属密钥请到https://ikuncode.cc获取 - GEMINI_MODEL=gemini-3-pro-preview - EOF - -1 -2 -3 -4 -5 - -**3.3 创建 settings.json 文件** ： - -bash - - - cat > settings.json << 'EOF' - { - "ide": { - "enabled": true - }, - "security": { - "auth": { - "selectedType": "gemini-api-key" - } - } +```bash +cat > settings.json << 'EOF' +{ + "ide": { + "enabled": true + }, + "security": { + "auth": { + "selectedType": "gemini-api-key" } - EOF + } +} +EOF +``` -1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12 +#### 3️⃣ 启动 Gemini CLI -#### 3️⃣ 启动 Gemini CLI +```bash +gemini +``` -bash - - - gemini +### 🐧 Linux 平台 -1 +#### 1️⃣ 全局安装 Gemini CLI -### 🐧 Linux 安装流程教程 +```bash +sudo npm install -g @google/gemini-cli +``` -#### 1️⃣ 全局安装 Gemini CLI +#### 2️⃣ 配置 Gemini CLI -bash - - - sudo npm install -g @google/gemini-cli +**2.1 创建配置目录**： -1 +```bash +mkdir -p ~/.gemini +cd ~/.gemini +``` -#### 2️⃣ 配置 Gemini CLI +**2.2 创建 `.env` 文件**： -**3.1 创建配置目录** ： +```bash +cat > .env << 'EOF' +GOOGLE_GEMINI_BASE_URL=https://api.oneinai.com +GEMINI_API_KEY=你的专属密钥（在 oneinai 控制台创建） +GEMINI_MODEL=gemini-3-pro-preview +EOF +``` -bash - - - mkdir -p ~/.gemini - cd ~/.gemini +**2.3 创建 `settings.json` 文件**： -1 -2 - -**3.2 创建 .env 文件** ： - -bash - - - cat > .env << 'EOF' - GOOGLE_GEMINI_BASE_URL=https://api.oneinai.com - GEMINI_API_KEY=你的专属密钥请到https://ikuncode.cc获取 - GEMINI_MODEL=gemini-3-pro-preview - EOF - -1 -2 -3 -4 -5 - -**3.3 创建 settings.json 文件** ： - -bash - - - cat > settings.json << 'EOF' - { - "ide": { - "enabled": true - }, - "security": { - "auth": { - "selectedType": "gemini-api-key" - } - } +```bash +cat > settings.json << 'EOF' +{ + "ide": { + "enabled": true + }, + "security": { + "auth": { + "selectedType": "gemini-api-key" } - EOF + } +} +EOF +``` -1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12 +#### 3️⃣ 启动 Gemini CLI -#### 3️⃣ 启动 Gemini CLI +```bash +gemini +``` -bash - - - gemini +> 🎉 **部署完成！** +> 现在你可以使用 Gemini CLI 进行 AI 辅助编程了。 -1 +## ❓ 常见问题 -🎉 部署完成！ +### API Key 在哪里获取？ -现在您可以使用 Gemini CLI 进行 AI 辅助编程了。 +登录 [oneinai 控制台](https://api.oneinai.com/console/token)，创建 Gemini CLI 专用令牌即可。 -## 常见问题 +### 配置文件位置 -### API Key 在哪里获取？ +- Windows：`%USERPROFILE%\.gemini\` +- macOS / Linux：`~/.gemini/` -登录 [IkunCode 平台]()，创建 Gemini CLI 专用令牌。 +### 更多问题 -### 配置文件位置 - - * Windows: `%USERPROFILE%\\.gemini\\` - * macOS/Linux: `~/.gemini/` - -### 更多问题 - -请查看 [FAQ]() 或联系[售后支持]()。 +请查看 [FAQ](/support/faq) 或联系[售后支持](/support/after-sales)。 diff --git a/intro/links.md b/intro/links.md index c3f2286..ac33b24 100644 --- a/intro/links.md +++ b/intro/links.md @@ -6,7 +6,7 @@ ## Claude Code 镜像站 -[![EasyChat](https://docs.ikuncode.cc/images/Anthropic.png)EasyChatClaude Code 免费账号网页版镜像站，无需注册即可体验 Claude 对话→]() +[![EasyChat](https://minio.oneinai.com/oneinai/images/docs/links/links01.png)EasyChatClaude Code 免费账号网页版镜像站，无需注册即可体验 Claude 对话→]() ### 简介 @@ -20,13 +20,13 @@ EasyChat 是面向 Claude 网页 Chat 使用场景推出的镜像服务，主要 打开 [EasyChat]() 后，页面会展示多个可用的免费共享账号卡片，点击任意一个状态为「可用」的账号即可开始对话。 -![账号选择界面](https://docs.ikuncode.cc/images/jxz.png) +![账号选择界面](https://minio.oneinai.com/oneinai/images/docs/links/links02.png) **2\. 开始聊天** 进入后即为标准的 Claude 聊天界面，支持中文对话、多轮上下文、代码生成等全部功能。 -![聊天界面](https://docs.ikuncode.cc/images/ltjm.png) +![聊天界面](https://minio.oneinai.com/oneinai/images/docs/links/links03.png) 注意 diff --git a/node/windows.md b/node/windows.md index 8471de9..3195044 100644 --- a/node/windows.md +++ b/node/windows.md @@ -13,7 +13,7 @@ Claude Code、CodeX 和 Gemini CLI 都需要 Node.js 18+ 运行环境。 如果 3. 运行安装包，采用默认配置完成安装 4. 安装程序会自动配置系统 PATH 环境变量 -![NodeJS下载页面](https://docs.ikuncode.cc/images/tu4.png) +![NodeJS下载页面](https://minio.oneinai.com/oneinai/images/docs/windows/windows01.png) ## 方法二：包管理器安装