NiceCode API 切换工具

自动配置 Claude、CodeX、Gemini 和 OpenCode CLI 工具，将其 API 端点切换到 NiceCode 服务。

快速开始

$3

一键安装并运行（推荐）：

``bash
curl -fsSL https://nicecode.ai/setup.sh | bash
`

或者下载后执行：

`bash
curl -fsSL https://nicecode.ai/setup.sh -o setup.sh
chmod +x setup.sh
./setup.sh
`

带参数执行（直接配置 Claude）：

`bash
curl -fsSL https://nicecode.ai/setup.sh | bash -s -- -cc -k your-api-key
`

$3

一键安装并运行（推荐）：

`powershell
iwr -useb https://nicecode.ai/setup.ps1 | iex
`

或者下载后执行：

`powershell
iwr -useb https://nicecode.ai/setup.ps1 -OutFile setup.ps1
.\setup.ps1
`

带参数执行（直接配置 Claude）：

`powershell
& ([ScriptBlock]::Create((iwr -useb https://nicecode.ai/setup.ps1).Content)) -cc -k your-api-key
`

功能特性

- 支持 Claude、CodeX、Gemini、OpenCode 四大 AI CLI 工具
- 交互式菜单或命令行参数两种使用方式
- 自动创建配置文件和目录结构
- 彩色终端输出，清晰的状态提示
- 支持一次性配置所有产品
- 安全的 API Key 输入（PowerShell 版本使用 SecureString）

使用方法

$3

直接运行脚本，按照菜单提示选择：

Linux/macOS:
`bash
./setup.sh
`

Windows:
`powershell
.\setup.ps1
`

会显示如下菜单：

`
======================================
NiceCode API 切换工具
======================================
1) Claude
2) CodeX
3) Gemini
4) OpenCode
5) 全部配置
0) 退出
======================================
请选择要配置的产品 [1-5]:
`

$3

支持通过命令行参数直接配置，适合自动化脚本。

#### 参数说明

| 参数 | 简写 | 说明 | 示例 |
|------|------|------|------|
| --claude | -cc | 配置 Claude | -cc |
| --codex | -cx | 配置 CodeX | -cx |
| --gemini | -gm | 配置 Gemini | -gm |
| --opencode | -oc | 配置 OpenCode | -oc |
| --choice | -c | 指定产品名称 | -c claude |
| --key | -k | 指定 API Key | -k your-api-key |
| --help | -h | 显示帮助信息 | -h |

#### 使用示例

配置 Claude：

`bash


Linux/macOS

./setup.sh -cc -k your-api-key
./setup.sh --claude --key your-api-key
./setup.sh -c claude -k your-api-key

Windows

.\setup.ps1 -cc -k your-api-key
.\setup.ps1 --claude --key your-api-key
.\setup.ps1 -c claude -k your-api-key
`

配置 CodeX：

`bash


Linux/macOS

./setup.sh -cx -k your-api-key

Windows

.\setup.ps1 -cx -k your-api-key
`

配置 Gemini：

`bash


Linux/macOS

./setup.sh -gm -k your-api-key

Windows

.\setup.ps1 -gm -k your-api-key
`

配置所有产品（使用相同的 API Key）：

`bash


Linux/macOS

./setup.sh -c all -k your-api-key

Windows

.\setup.ps1 -c all -k your-api-key
`

不指定 API Key（稍后输入）：

`bash


Linux/macOS

./setup.sh -cc

Windows

.\setup.ps1 -cc
`

支持的产品

$3

- 配置目录:
- Linux/macOS: ~/.claude
- Windows: %USERPROFILE%\.claude
- 配置文件: settings.json
- 环境变量:
- ANTHROPIC_BASE_URL: https://nicecode.ai
- ANTHROPIC_AUTH_TOKEN: your-api-key

$3

- 配置目录:
- Linux/macOS: ~/.codex
- Windows: %USERPROFILE%\.codex
- 配置文件:
- config.toml: 主配置文件
- auth.json: 认证文件
- 模型配置: gpt-5.1-codex

$3

- 配置目录:
- Linux/macOS: ~/.gemini
- Windows: %USERPROFILE%\.gemini
- 配置文件:
- .env: 环境变量配置
- settings.json: 设置文件
- 环境变量:
- GOOGLE_GEMINI_BASE_URL: https://nicecode.ai
- GEMINI_API_KEY: your-api-key

$3

- 配置目录:
- Linux/macOS: ~/.config/opencode
- Windows: %USERPROFILE%\opencode
- 配置文件:
- opencode.jsonc: 从 https://nicecode.ai/opencode.jsonc 下载（存在也覆盖）
- 认证文件:
- Linux/macOS: ~/.local/share/opencode/auth.json
- Windows: %USERPROFILE%\.local\share\opencode\auth.json
- 文档地址: https://nicecode.ai/docs/oc

配置说明

$3

脚本会创建 ~/.claude/settings.json:

`json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.nicecode.ai",
"ANTHROPIC_AUTH_TOKEN": "your-api-key"
}
}
`

并将 ~/.claude.json 中的 hasCompletedOnboarding 设置为 true。

$3

脚本会创建 ~/.codex/config.toml:

`toml
model_provider = "nicecode"
model = "gpt-5.1-codex"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
model_verbosity = "high"

[model_providers.nicecode]
name = "nicecode"
base_url = "https://api.nicecode.ai/v1"
wire_api = "responses"
requires_openai_auth = true
`

以及 ~/.codex/auth.json:

`json
{
"OPENAI_API_KEY": "your-api-key"
}
`

$3

脚本会创建 ~/.gemini/.env:

`env
GOOGLE_GEMINI_BASE_URL=https://api.nicecode.ai
GEMINI_API_KEY=your-api-key
GEMINI_MODEL=
`

以及 ~/.gemini/settings.json:

`json
{
"general": {
"previewFeatures": true
},
"ide": {
"hasSeenNudge": true
},
"model": {
"name": "gemini-3-flash-preview"
},
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}
`

$3

脚本会从 https://nicecode.ai/opencode.jsonc 下载配置文件到：
- Linux/macOS: ~/.config/opencode/opencode.jsonc
- Windows: %USERPROFILE%\opencode\opencode.jsonc

如果配置文件已存在，会被覆盖。

脚本会创建或更新认证文件：
- Linux/macOS: ~/.local/share/opencode/auth.json
- Windows: %USERPROFILE%\.local\share\opencode\auth.json

`json
{
"provider": {
"opencode": {
"apiKey": "your-api-key"
}
}
}
`

如果认证文件已存在，会更新其中的 apiKey 字段，保留其他配置。

系统要求

$3

- Bash 3.2 或更高版本
- 基本 Unix 工具：mkdir, cat, grep, sed
- 可选：jq（用于更好的 JSON 处理，如未安装会自动使用备用方案）

$3

- PowerShell 5.1 或更高版本
- Windows 7/8/10/11 或 Windows Server 2008 R2 及更高版本

安全提示

1. 审查脚本: 在执行任何网络脚本之前，建议先下载并审查其内容：
`bash
# Linux/macOS
curl -fsSL https://nicecode.ai/setup.sh -o setup.sh
cat setup.sh # 查看脚本内容

# Windows
iwr -useb https://nicecode.ai/setup.ps1 -OutFile setup.ps1
Get-Content setup.ps1 # 查看脚本内容
`

2. API Key 保护:
- 不要在命令行历史中暴露 API Key
- 建议使用交互式输入而非命令行参数传递 API Key
- Windows 版本使用 SecureString 保护输入

3. 配置文件权限:
- 配置文件包含敏感信息，确保适当的文件权限
- Linux/macOS 建议设置为 600 或 700

常见问题

$3

A: 这表示对应的 CLI 工具尚未安装。请先安装相应的工具：

- Claude: 访问 Claude CLI 官网 安装
- CodeX: 访问 CodeX 官网 安装
- Gemini: 访问 Gemini CLI 官网 安装

脚本会创建配置目录，但建议先安装官方 CLI 工具以确保完整功能。

$3

A: 配置完成后，运行相应的 CLI 工具：

`bash


验证 Claude

claude --version

验证 CodeX

codex --version

验证 Gemini

gemini --version
`

$3

A: 手动编辑配置文件，将 API URL 改回官方地址，或删除配置文件重新运行官方工具初始化。

$3

A:
- Linux: Ubuntu, Debian, CentOS, Fedora, Arch 等主流发行版
- macOS: macOS 10.10 及更高版本
- Windows: Windows 7/8/10/11 及 Windows Server 2008 R2 及更高版本

$3

A: 从互联网直接执行脚本存在安全风险。建议：
1. 先下载脚本查看内容
2. 确认来源可信
3. 使用 HTTPS 连接
4. 定期更新脚本

$3

A: 可以。分别运行脚本配置每个产品：

`bash
./setup.sh -cc -k claude-api-key
./setup.sh -cx -k codex-api-key
./setup.sh -gm -k gemini-api-key
``

技术支持

如有问题或建议，请访问：

- 官网: https://nicecode.ai
- 文档: https://nicecode.ai/docs
- 问题反馈: https://github.com/nicecode/nicecode-tools/issues

许可证

MIT License

更新日志

$3

- 首次发布
- 支持 Claude、CodeX、Gemini 三大 CLI 工具
- 提供 Linux/macOS 和 Windows 版本
- 交互式菜单和命令行参数两种使用方式
- 一键安装支持