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) ## 方法二:包管理器安装