# claude

**Repository Path**: wrdoct/claude

## Basic Information

- **Project Name**: claude
- **Description**: claude
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-30
- **Last Updated**: 2026-04-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

我来帮您理清CLIProxyAPI和CC Switch的关系，并给出完整的Linux配置方案。

## CLIProxyAPI vs CC Switch：它们是什么关系？

### 核心关系图

```
NVIDIA API (OpenAI格式)
    ↓
CLIProxyAPI (协议转换器)
    ↓ 转换为Claude兼容格式
本地代理服务 (localhost:8317)
    ↓
CC Switch (配置管理器)
    ↓ 写入配置文件
Claude Code (最终使用者)
```

### 详细解释

**CLIProxyAPI** - **协议转换器**

- 

  作用：将不同格式的API转换为标准格式

- 

  具体功能：将NVIDIA的OpenAI兼容API转换为Claude Code能识别的格式

- 

  运行方式：作为本地代理服务器（默认端口8317）

- 

  关键：**必须一直运行**，否则Claude Code无法连接到NVIDIA

**CC Switch** - **配置管理器**

- 

  作用：统一管理多个AI工具的API配置

- 

  具体功能：可视化配置Claude Code、Codex等工具的API供应商

- 

  运行方式：桌面应用程序（可常驻系统托盘）

- 

  关键：**不是必须的**，但能极大简化配置过程

### 简单比喻

- 

  **CLIProxyAPI** 就像"翻译官"：把NVIDIA的话翻译成Claude能听懂的语言

- 

  **CC Switch** 就像"管家"：帮您管理所有AI工具的配置，一键切换

## Linux下完整配置步骤

【注】

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

npm install -g @anthropic-ai/claude-code

### 第一步：安装CLIProxyAPI（协议转换器）

**方法A：一键脚本安装（推荐）**

```
# 下载并安装
curl -fsSL https://raw.githubusercontent.com/brokechubb/cliproxyapi-installer/refs/heads/master/cliproxyapi-installer | bash

# 创建配置目录
mkdir -p ~/.cli-proxy-api
cp /usr/share/doc/cli-proxy-api-bin/config.example.yaml ~/.cli-proxy-api/config.yaml
```

**方法B：手动安装（如果您已有tar.gz文件）**

```
# 解压
tar -xzf CLIProxyAPI_6.9.43_linux_amd64.tar.gz -C CLIProxyAPI_6.9.43_linux_amd64
cd CLIProxyAPI_6.9.43_linux_amd64

# 创建配置目录
mkdir -p ~/.cli-proxy-api
cp config.example.yaml ~/.cli-proxy-api/config.yaml
```

【注】https://github.com/router-for-me/CLIProxyAPI/releases

### 第二步：配置CLIProxyAPI

编辑配置文件：

```
nano ~/.cli-proxy-api/config.yaml
```

修改关键配置：

```
port: 8317
remote-management:
  allow-remote: true
  secret-key: "your-strong-password"  # 设置管理密码
auth-dir: "~/.cli-proxy-api"
api-keys: []
```

### 第三步：启动CLIProxyAPI服务

**创建systemd服务（推荐）**

```
# 创建服务文件
sudo nano /etc/systemd/system/cliproxyapi.service
```

添加内容：

```
[Unit]
Description=CLIProxyAPI Service
After=network.target

[Service]
Type=simple
User=llw
WorkingDirectory=/home/llw/claude
ExecStart=/home/llw/claude/CLIProxyAPI/CLIProxyAPI_6.9.43_linux_amd64/cli-proxy-api --config /home/llw/.cli-proxy-api/config.yaml
Restart=on-failure

[Install]
WantedBy=multi-user.target
```

启动服务：

```
sudo systemctl daemon-reload
sudo systemctl start cliproxyapi
sudo systemctl enable cliproxyapi
```

### 第四步：安装CC Switch（配置管理器）

**根据您的Linux发行版选择：**

**Ubuntu/Debian：**

```
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_*.deb
sudo dpkg -i cc-switch_*.deb
```

**Arch Linux：**

```
paru -S cc-switch-bin
# 或
yay -S cc-switch-bin
```

**通用AppImage：**

```
wget https://github.com/farion1231/cc-switch/releases/latest/download/CC-Switch-v*-Linux.AppImage
chmod +x CC-Switch-v*-Linux.AppImage
./CC-Switch-v*-Linux.AppImage
```

【注】https://github.com/farion1231/cc-switch/releases

### 第五步：配置CC Switch连接CLIProxyAPI

1. 

   **启动CC Switch**

   ```
   cc-switch  # 或从应用程序菜单启动
   ```

2. 

   **添加NVIDIA供应商配置**

   - 

     点击右上角"+"按钮

   - 

     选择"OpenAI Compatible"模板

   - 

     填写配置：

     ```
     供应商名称：NVIDIA
     Base URL：http://localhost:8317
     API Key：sk-任意值（CLIProxyAPI会忽略此值）
     模型：nvi/z-ai/glm4.7（或其他NVIDIA模型）
     ```

3. 

   **启用配置**

   - 

     在供应商列表中找到"NVIDIA"

   - 

     点击"Enable"按钮

   - 

     状态变为"Active"表示生效

### 第六步：配置CLIProxyAPI的NVIDIA提供商

1. 

   **访问管理界面**

   打开浏览器访问：`http://localhost:8317/management.html`

   使用您在config.yaml中设置的密码登录

2. 

   **添加NVIDIA API提供商**

   - 

     点击"AI提供商" → "添加提供商"

   - 

     选择"OpenAI兼容提供商"

   - 

     配置信息：

     ```
     提供商名称：NVIDIA
     Base URL：https://integrate.api.nvidia.com/v1
     API密钥：您的NVIDIA API Key（从build.nvidia.com获取）
     模型列表：
       minimaxai/minimax-m2.5
       z-ai/glm4.7
       moonshotai/kimi-k2.5
       z-ai/glm5
     ```

3. 

   **添加API密钥**

   - 

     点击"API密钥" → "添加API密钥"

   - 

     输入：`sk-任意值`（与CC Switch中填写的保持一致）

### 第七步：验证配置

1. 

   **测试CLIProxyAPI**

   ```
   curl http://localhost:8317/v1/models
   ```

   应该返回NVIDIA支持的模型列表

2. 

   **测试Claude Code**

   ```
   claude
   ```

   在Claude Code中应该能看到NVIDIA模型选项

### 第八步：使用流程

**正常使用流程：**

1. 

   CLIProxyAPI服务保持运行（systemd会自动管理）

2. 

   CC Switch保持运行（系统托盘）

3. 

   在CC Switch中选择"NVIDIA"供应商

4. 

   打开终端运行`claude`

**切换供应商：**

- 

  只需在CC Switch中点击其他供应商（如官方Claude、DeepSeek等）

- 

  无需重启CLIProxyAPI

## 常见问题解决

### 1. CC Switch无法连接CLIProxyAPI

```
# 检查CLIProxyAPI服务状态
sudo systemctl status cliproxyapi

# 检查端口是否监听
netstat -tlnp | grep 8317

# 检查防火墙
sudo ufw allow 8317
```

### 2. Claude Code报错

```
# 检查CC Switch配置是否正确写入
cat ~/.claude/settings.json

# 重启终端使配置生效
exit
# 重新打开终端
```

### 3. NVIDIA API调用失败

- 

  检查NVIDIA API Key是否有效

- 

  检查CLIProxyAPI管理界面中的NVIDIA提供商配置

- 

  查看CLIProxyAPI日志：`journalctl -u cliproxyapi -f`

## 总结

**核心要点：**

1. 

   **CLIProxyAPI必须运行** - 它是实际的协议转换服务

2. 

   **CC Switch只是配置工具** - 它让配置变更更简单

3. 

   **两者配合使用** - CLIProxyAPI做"翻译"，CC Switch做"管理"

**配置顺序建议：**

1. 

   先安装配置CLIProxyAPI并启动服务

2. 

   再安装CC Switch并配置连接

3. 

   最后在CLIProxyAPI管理界面添加NVIDIA提供商

这样配置完成后，您就可以通过CC Switch轻松切换不同的AI供应商，而CLIProxyAPI会在后台处理所有的协议转换工作。