This commit is contained in:
zyc123 2026-05-14 14:17:04 +08:00
parent a9ba2281cd
commit 9d93215e36
3 changed files with 184 additions and 272 deletions

View File

@ -2,134 +2,121 @@
**Google AI 编程助手安装指南** **Google AI 编程助手安装指南**
资源| 地址 | 资源 | 地址 |
---|--- | --- | --- |
官方文档| [geminicli.com/docs](<https://geminicli.com/docs/>) | 官方文档 | [geminicli.com/docs](https://geminicli.com/docs/) |
| oneinai 控制台 | <https://api.oneinai.com/console/token> |
📋 前置要求 > 📋 **前置要求**
> 请先完成 [Node.js 环境安装](/node/windows),确保 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
验证安装:`gemini --version`
推荐使用 [CC-Switch 快速配置工具](</tools/cc-switch>) 进行图形化配置,简单快捷无需手动创建配置文件。
### 配置步骤 ### 配置步骤
**1\. 启动 CC-Switch 并切换到 Gemini 标签** **1. 启动 CC-Switch 并切换到 Gemini 标签**
1. 打开 CC-Switch 应用程序 1. 打开 CC-Switch 应用程序
2. 点击顶部的「Gemini」标签页 2. 点击顶部的「Gemini」标签页
3. 点击右上角橙色「+」按钮添加新配置 3. 点击右上角橙色「+」按钮添加新配置
![CC-Switch Gemini 标签页](https://docs.ikuncode.cc/images/tu12.png) ![CC-Switch Gemini 标签页](https://minio.oneinai.com/oneinai/images/docs/gemini-cli/gemini-cli01.png)
**2\. 填写 Gemini CLI 提供商配置** **2. 填写 Gemini CLI 提供商配置**
1. **提供商名称** 自定义名称如「ikuncode」 | 配置项 | 说明 |
2. **Base URL** :输入 `https://api.oneinai.com` | --- | --- |
3. **API Key** :粘贴您从 IkunCode 平台获取的 Gemini 专用令牌 | **提供商名称** | 自定义名称如「oneinai」 |
4. **Model** :选择 `gemini-3-pro-preview` 或其他可用模型 | **Base URL** | `https://api.oneinai.com` |
5. **安全设置** :根据需求调整(可选) | **API Key** | 在 [oneinai 控制台](https://api.oneinai.com/console/token) 创建的 Gemini 专用令牌 |
6. 点击「保存」按钮 | **Model** | `gemini-3-pro-preview` 或其他可用模型 |
| **安全设置** | 根据需求调整(可选) |
![CC-Switch 添加 Gemini CLI 配置](https://docs.ikuncode.cc/images/tu13.png)![CC-Switch Gemini CLI 配置详情](https://docs.ikuncode.cc/images/tu14.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)
* CC-Switch 会自动创建 `~/.gemini/.env``settings.json` 文件 > 💡 **提示**
* 可以添加多个提供商配置,随时切换 > - CC-Switch 会自动创建 `~/.gemini/.env``settings.json` 文件
* 切换配置后,关闭并重启 Gemini CLI 即可生效 > - 可以添加多个提供商配置,随时切换
> - 切换配置后,关闭并重启 Gemini CLI 即可生效
**3\. 启用配置并使用** **3. 启用配置并使用**
1. 在配置列表中找到刚创建的「ikuncode」配置 1. 在配置列表中找到刚创建的「oneinai」配置
2. 点击配置右侧的「当前使用」按钮 2. 点击配置右侧的「当前使用」按钮
3. 配置会被标记为「当前使用」状态(绿色标签) 3. 配置会被标记为「当前使用」状态(绿色标签)
4. 重启 Gemini CLI新配置即可生效 4. 重启 Gemini CLI新配置即可生效
**4\. 系统托盘快速切换** **4. 系统托盘快速切换**
CC-Switch 支持通过系统托盘快速切换 Gemini CLI 配置: CC-Switch 支持通过系统托盘快速切换 Gemini CLI 配置:
* 右键点击系统托盘中的 CC-Switch 图标 - 右键点击系统托盘中的 CC-Switch 图标
* 在菜单中选择 Gemini 分类 - 在菜单中选择 Gemini 分类
* 直接选择要切换到的配置 - 直接选择要切换到的配置
* 配置立即生效,无需打开主界面 - 配置立即生效,无需打开主界面
⚠️ 注意事项 > ⚠️ **注意事项**
> - 务必在 oneinai 平台创建 Gemini CLI 专用令牌
* 确保从 平台创建 Gemini CLI 专用令牌 > - Gemini 令牌与 Claude Code / CodeX 令牌不通用
* Gemini 令牌与 Claude Code/CodeX 令牌不通用 > - 切换配置后需要重启 Gemini CLI 才能生效
* 切换配置后需要重启 Gemini CLI 才能生效 > - 可在 CC-Switch 中测试 API 端点速度
* 可在 CC-Switch 中测试 API 端点速度
## ⌨️ 手动命令行配置 ## ⌨️ 手动命令行配置
如果不使用 CC-Switch可以按照以下步骤手动安装和配置 Gemini CLI。 如果不使用 CC-Switch可以按照以下步骤手动安装和配置 Gemini CLI。
### 🖥️ Windows 安装流程教程 ### 🖥️ Windows 平台
#### 1⃣ 全局安装 Gemini CLI #### 1⃣ 全局安装 Gemini CLI
powershell ```powershell
npm install -g @google/gemini-cli npm install -g @google/gemini-cli
```
1
#### 2⃣ 配置 Gemini CLI #### 2⃣ 配置 Gemini CLI
⚠️ 重要提示 > ⚠️ **重要提示**
> 请替换下方的 `GEMINI_API_KEY` 为你从 [oneinai 控制台](https://api.oneinai.com/console/token) 获取的 Gemini CLI 专用 API 密钥。
请替换下方的 `GEMINI_API_KEY` 为你从 <https://ikuncode.cc> 获取的 Gemini CLI 专用 API 密钥! **2.1 创建 gemini 配置目录**
**3.1 创建 gemini 文件夹** 在用户目录下创建:`%USERPROFILE%\.gemini\`
在用户目录下:`%USERPROFILE%\\.gemini\\` **2.2 创建 `.env` 文件**
**3.2 创建 .env 文件**
`gemini` 文件夹新建 `.env` 文件:
env
`.gemini` 目录中新建 `.env` 文件,写入:
```env
GOOGLE_GEMINI_BASE_URL=https://api.oneinai.com GOOGLE_GEMINI_BASE_URL=https://api.oneinai.com
GEMINI_API_KEY=你的专属密钥请到https://ikuncode.cc获取 GEMINI_API_KEY=你的专属密钥(在 oneinai 控制台创建)
GEMINI_MODEL=gemini-3-pro-preview GEMINI_MODEL=gemini-3-pro-preview
```
1 **2.3 创建 `settings.json` 文件**
2
3
**3.3 创建 settings.json 文件**
`gemini` 文件夹新建 `settings.json` 文件:
json
`.gemini` 目录中新建 `settings.json` 文件,写入:
```json
{ {
"ide": { "ide": {
"enabled": true "enabled": true
@ -140,77 +127,49 @@ json
} }
} }
} }
```
1
2
3
4
5
6
7
8
9
10
#### 3⃣ 启动 Gemini CLI #### 3⃣ 启动 Gemini CLI
powershell ```powershell
gemini gemini
```
1 > 🎉 **开始使用 Gemini CLI**
> - 输入上下文描述快速生成代码
> - Agent Mode 自动编程模式
> - Google Search 实时联网搜索
🎉 开始使用 Gemini CLI ### 🍏 macOS 平台
• 输入上下文描述 "M kikasuna" • Agent Mode 自动编程模式 • Google Search 实时联网搜索
### 🍏 macOS 安装流程教程
#### 1⃣ 全局安装 Gemini CLI #### 1⃣ 全局安装 Gemini CLI
bash ```bash
npm install -g @google/gemini-cli npm install -g @google/gemini-cli
```
1
#### 2⃣ 配置 Gemini CLI #### 2⃣ 配置 Gemini CLI
**3.1 创建配置目录** **2.1 创建配置目录**
bash
```bash
mkdir -p ~/.gemini mkdir -p ~/.gemini
cd ~/.gemini cd ~/.gemini
```
1 **2.2 创建 `.env` 文件**
2
**3.2 创建 .env 文件**
bash
```bash
cat > .env << 'EOF' cat > .env << 'EOF'
GOOGLE_GEMINI_BASE_URL=https://api.oneinai.com GOOGLE_GEMINI_BASE_URL=https://api.oneinai.com
GEMINI_API_KEY=你的专属密钥请到https://ikuncode.cc获取 GEMINI_API_KEY=你的专属密钥(在 oneinai 控制台创建)
GEMINI_MODEL=gemini-3-pro-preview GEMINI_MODEL=gemini-3-pro-preview
EOF EOF
```
1 **2.3 创建 `settings.json` 文件**
2
3
4
5
**3.3 创建 settings.json 文件**
bash
```bash
cat > settings.json << 'EOF' cat > settings.json << 'EOF'
{ {
"ide": { "ide": {
@ -223,75 +182,44 @@ bash
} }
} }
EOF EOF
```
1
2
3
4
5
6
7
8
9
10
11
12
#### 3⃣ 启动 Gemini CLI #### 3⃣ 启动 Gemini CLI
bash ```bash
gemini gemini
```
1 ### 🐧 Linux 平台
### 🐧 Linux 安装流程教程
#### 1⃣ 全局安装 Gemini CLI #### 1⃣ 全局安装 Gemini CLI
bash ```bash
sudo npm install -g @google/gemini-cli sudo npm install -g @google/gemini-cli
```
1
#### 2⃣ 配置 Gemini CLI #### 2⃣ 配置 Gemini CLI
**3.1 创建配置目录** **2.1 创建配置目录**
bash
```bash
mkdir -p ~/.gemini mkdir -p ~/.gemini
cd ~/.gemini cd ~/.gemini
```
1 **2.2 创建 `.env` 文件**
2
**3.2 创建 .env 文件**
bash
```bash
cat > .env << 'EOF' cat > .env << 'EOF'
GOOGLE_GEMINI_BASE_URL=https://api.oneinai.com GOOGLE_GEMINI_BASE_URL=https://api.oneinai.com
GEMINI_API_KEY=你的专属密钥请到https://ikuncode.cc获取 GEMINI_API_KEY=你的专属密钥(在 oneinai 控制台创建)
GEMINI_MODEL=gemini-3-pro-preview GEMINI_MODEL=gemini-3-pro-preview
EOF EOF
```
1 **2.3 创建 `settings.json` 文件**
2
3
4
5
**3.3 创建 settings.json 文件**
bash
```bash
cat > settings.json << 'EOF' cat > settings.json << 'EOF'
{ {
"ide": { "ide": {
@ -304,44 +232,28 @@ bash
} }
} }
EOF EOF
```
1
2
3
4
5
6
7
8
9
10
11
12
#### 3⃣ 启动 Gemini CLI #### 3⃣ 启动 Gemini CLI
bash ```bash
gemini gemini
```
1 > 🎉 **部署完成!**
> 现在你可以使用 Gemini CLI 进行 AI 辅助编程了。
🎉 部署完成! ## ❓ 常见问题
现在您可以使用 Gemini CLI 进行 AI 辅助编程了。
## 常见问题
### API Key 在哪里获取? ### API Key 在哪里获取?
登录 [IkunCode 平台](<https://api.oneinai.com>),创建 Gemini CLI 专用令牌 登录 [oneinai 控制台](https://api.oneinai.com/console/token),创建 Gemini CLI 专用令牌即可。
### 配置文件位置 ### 配置文件位置
* Windows: `%USERPROFILE%\\.gemini\\` - Windows`%USERPROFILE%\.gemini\`
* macOS/Linux: `~/.gemini/` - macOS / Linux`~/.gemini/`
### 更多问题 ### 更多问题
请查看 [FAQ](</support/faq>) 或联系[售后支持](</support/after-sales>)。 请查看 [FAQ](/support/faq) 或联系[售后支持](/support/after-sales)。

View File

@ -6,7 +6,7 @@
## Claude Code 镜像站 ## Claude Code 镜像站
[![EasyChat](https://docs.ikuncode.cc/images/Anthropic.png)EasyChatClaude Code 免费账号网页版镜像站,无需注册即可体验 Claude 对话→](<https://easychat.top/>) [![EasyChat](https://minio.oneinai.com/oneinai/images/docs/links/links01.png)EasyChatClaude Code 免费账号网页版镜像站,无需注册即可体验 Claude 对话→](<https://easychat.top/>)
### 简介 ### 简介
@ -20,13 +20,13 @@ EasyChat 是面向 Claude 网页 Chat 使用场景推出的镜像服务,主要
打开 [EasyChat](<https://easychat.top/>) 后,页面会展示多个可用的免费共享账号卡片,点击任意一个状态为「可用」的账号即可开始对话。 打开 [EasyChat](<https://easychat.top/>) 后,页面会展示多个可用的免费共享账号卡片,点击任意一个状态为「可用」的账号即可开始对话。
![账号选择界面](https://docs.ikuncode.cc/images/jxz.png) ![账号选择界面](https://minio.oneinai.com/oneinai/images/docs/links/links02.png)
**2\. 开始聊天** **2\. 开始聊天**
进入后即为标准的 Claude 聊天界面,支持中文对话、多轮上下文、代码生成等全部功能。 进入后即为标准的 Claude 聊天界面,支持中文对话、多轮上下文、代码生成等全部功能。
![聊天界面](https://docs.ikuncode.cc/images/ltjm.png) ![聊天界面](https://minio.oneinai.com/oneinai/images/docs/links/links03.png)
注意 注意

View File

@ -13,7 +13,7 @@ Claude Code、CodeX 和 Gemini CLI 都需要 Node.js 18+ 运行环境。 如果
3. 运行安装包,采用默认配置完成安装 3. 运行安装包,采用默认配置完成安装
4. 安装程序会自动配置系统 PATH 环境变量 4. 安装程序会自动配置系统 PATH 环境变量
![NodeJS下载页面](https://docs.ikuncode.cc/images/tu4.png) ![NodeJS下载页面](https://minio.oneinai.com/oneinai/images/docs/windows/windows01.png)
## 方法二:包管理器安装 ## 方法二:包管理器安装