333
This commit is contained in:
parent
a9ba2281cd
commit
9d93215e36
@ -2,135 +2,122 @@
|
|||||||
|
|
||||||
**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. 点击右上角橙色「+」按钮添加新配置
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
**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/.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` 文件,写入:
|
||||||
|
|
||||||
在 `gemini` 文件夹新建 `.env` 文件:
|
```env
|
||||||
|
GOOGLE_GEMINI_BASE_URL=https://api.oneinai.com
|
||||||
|
GEMINI_API_KEY=你的专属密钥(在 oneinai 控制台创建)
|
||||||
|
GEMINI_MODEL=gemini-3-pro-preview
|
||||||
|
```
|
||||||
|
|
||||||
env
|
**2.3 创建 `settings.json` 文件**
|
||||||
|
|
||||||
|
在 `.gemini` 目录中新建 `settings.json` 文件,写入:
|
||||||
|
|
||||||
GOOGLE_GEMINI_BASE_URL=https://api.oneinai.com
|
```json
|
||||||
GEMINI_API_KEY=你的专属密钥请到https://ikuncode.cc获取
|
{
|
||||||
GEMINI_MODEL=gemini-3-pro-preview
|
|
||||||
|
|
||||||
1
|
|
||||||
2
|
|
||||||
3
|
|
||||||
|
|
||||||
**3.3 创建 settings.json 文件**
|
|
||||||
|
|
||||||
在 `gemini` 文件夹新建 `settings.json` 文件:
|
|
||||||
|
|
||||||
json
|
|
||||||
|
|
||||||
|
|
||||||
{
|
|
||||||
"ide": {
|
"ide": {
|
||||||
"enabled": true
|
"enabled": true
|
||||||
},
|
},
|
||||||
@ -139,80 +126,52 @@ json
|
|||||||
"selectedType": "gemini-api-key"
|
"selectedType": "gemini-api-key"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
```
|
||||||
1
|
|
||||||
2
|
|
||||||
3
|
|
||||||
4
|
|
||||||
5
|
|
||||||
6
|
|
||||||
7
|
|
||||||
8
|
|
||||||
9
|
|
||||||
10
|
|
||||||
|
|
||||||
#### 3️⃣ 启动 Gemini CLI
|
#### 3️⃣ 启动 Gemini CLI
|
||||||
|
|
||||||
powershell
|
```powershell
|
||||||
|
gemini
|
||||||
|
```
|
||||||
|
|
||||||
|
> 🎉 **开始使用 Gemini CLI**
|
||||||
|
> - 输入上下文描述快速生成代码
|
||||||
|
> - Agent Mode 自动编程模式
|
||||||
|
> - Google Search 实时联网搜索
|
||||||
|
|
||||||
gemini
|
### 🍏 macOS 平台
|
||||||
|
|
||||||
1
|
|
||||||
|
|
||||||
🎉 开始使用 Gemini CLI
|
|
||||||
|
|
||||||
• 输入上下文描述 "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
|
||||||
|
cd ~/.gemini
|
||||||
|
```
|
||||||
|
|
||||||
|
**2.2 创建 `.env` 文件**:
|
||||||
|
|
||||||
mkdir -p ~/.gemini
|
```bash
|
||||||
cd ~/.gemini
|
cat > .env << 'EOF'
|
||||||
|
GOOGLE_GEMINI_BASE_URL=https://api.oneinai.com
|
||||||
|
GEMINI_API_KEY=你的专属密钥(在 oneinai 控制台创建)
|
||||||
|
GEMINI_MODEL=gemini-3-pro-preview
|
||||||
|
EOF
|
||||||
|
```
|
||||||
|
|
||||||
1
|
**2.3 创建 `settings.json` 文件**:
|
||||||
2
|
|
||||||
|
|
||||||
**3.2 创建 .env 文件** :
|
```bash
|
||||||
|
cat > settings.json << 'EOF'
|
||||||
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": {
|
"ide": {
|
||||||
"enabled": true
|
"enabled": true
|
||||||
},
|
},
|
||||||
@ -221,79 +180,48 @@ bash
|
|||||||
"selectedType": "gemini-api-key"
|
"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
|
```bash
|
||||||
|
gemini
|
||||||
|
```
|
||||||
|
|
||||||
|
### 🐧 Linux 平台
|
||||||
gemini
|
|
||||||
|
|
||||||
1
|
|
||||||
|
|
||||||
### 🐧 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
|
||||||
|
cd ~/.gemini
|
||||||
|
```
|
||||||
|
|
||||||
|
**2.2 创建 `.env` 文件**:
|
||||||
|
|
||||||
mkdir -p ~/.gemini
|
```bash
|
||||||
cd ~/.gemini
|
cat > .env << 'EOF'
|
||||||
|
GOOGLE_GEMINI_BASE_URL=https://api.oneinai.com
|
||||||
|
GEMINI_API_KEY=你的专属密钥(在 oneinai 控制台创建)
|
||||||
|
GEMINI_MODEL=gemini-3-pro-preview
|
||||||
|
EOF
|
||||||
|
```
|
||||||
|
|
||||||
1
|
**2.3 创建 `settings.json` 文件**:
|
||||||
2
|
|
||||||
|
|
||||||
**3.2 创建 .env 文件** :
|
```bash
|
||||||
|
cat > settings.json << 'EOF'
|
||||||
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": {
|
"ide": {
|
||||||
"enabled": true
|
"enabled": true
|
||||||
},
|
},
|
||||||
@ -302,46 +230,30 @@ bash
|
|||||||
"selectedType": "gemini-api-key"
|
"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
|
```bash
|
||||||
|
gemini
|
||||||
|
```
|
||||||
|
|
||||||
|
> 🎉 **部署完成!**
|
||||||
|
> 现在你可以使用 Gemini CLI 进行 AI 辅助编程了。
|
||||||
|
|
||||||
gemini
|
## ❓ 常见问题
|
||||||
|
|
||||||
1
|
|
||||||
|
|
||||||
🎉 部署完成!
|
|
||||||
|
|
||||||
现在您可以使用 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)。
|
||||||
|
|||||||
@ -6,7 +6,7 @@
|
|||||||
|
|
||||||
## Claude Code 镜像站
|
## Claude Code 镜像站
|
||||||
|
|
||||||
[EasyChatClaude Code 免费账号网页版镜像站,无需注册即可体验 Claude 对话→](<https://easychat.top/>)
|
[EasyChatClaude Code 免费账号网页版镜像站,无需注册即可体验 Claude 对话→](<https://easychat.top/>)
|
||||||
|
|
||||||
### 简介
|
### 简介
|
||||||
|
|
||||||
@ -20,13 +20,13 @@ EasyChat 是面向 Claude 网页 Chat 使用场景推出的镜像服务,主要
|
|||||||
|
|
||||||
打开 [EasyChat](<https://easychat.top/>) 后,页面会展示多个可用的免费共享账号卡片,点击任意一个状态为「可用」的账号即可开始对话。
|
打开 [EasyChat](<https://easychat.top/>) 后,页面会展示多个可用的免费共享账号卡片,点击任意一个状态为「可用」的账号即可开始对话。
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
**2\. 开始聊天**
|
**2\. 开始聊天**
|
||||||
|
|
||||||
进入后即为标准的 Claude 聊天界面,支持中文对话、多轮上下文、代码生成等全部功能。
|
进入后即为标准的 Claude 聊天界面,支持中文对话、多轮上下文、代码生成等全部功能。
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
注意
|
注意
|
||||||
|
|
||||||
|
|||||||
@ -13,7 +13,7 @@ Claude Code、CodeX 和 Gemini CLI 都需要 Node.js 18+ 运行环境。 如果
|
|||||||
3. 运行安装包,采用默认配置完成安装
|
3. 运行安装包,采用默认配置完成安装
|
||||||
4. 安装程序会自动配置系统 PATH 环境变量
|
4. 安装程序会自动配置系统 PATH 环境变量
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
## 方法二:包管理器安装
|
## 方法二:包管理器安装
|
||||||
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user