【AI小打小闹】cliproxyapi踩坑实录

原创 于 2026-05-10 16:42:03 发布 · 352 阅读 · 4 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
GEO检测
标签
#cliproxyapi #nvidia api #ccswitch

AI 时代程序员必备技能

Codex、Claude Code、Cursor、Hermes Agent、OpenClaw等工程化实战专栏 ，讲透 AI 如何接管脏活累活

一键订阅

测试时用的是nvidia 免费api，国内访问延迟较高
https://build.nvidia.com/

由于这个延迟高，为了解决这个因延迟导致每次测试api联通性超时的问题，进行了如下工作：
1、cliproxyapi服务端项目

cliproxyapi 地址 ：https://github.com/router-for-me/CLIProxyAPI
cp ./config.example.yaml ./config.yaml

 

// 修改以下几个配置
allow-remote: true

secret-key: "1111"

api-keys:
  - "xxxxxxxxxx"
  - "your-api-key-2"
  - "your-api-key-3"

- Go 版本 ：必须使用 Go 1.26 或更高版本
- 配置文件 ：首次运行前必须创建 config.yaml

go version
如果版本低于1.26，升级一下：brew update go
go version
go mod download
go run ./cmd/server
### 修改 1：增强 APICall 错误日志和错误提示

**文件：** `internal/api/handlers/management/api_tools.go`  
**行数：** 第 194-227 行  
**修改类型：** 功能增强

#### 修改前

```go
resp, errDo := httpClient.Do(req)
if errDo != nil {
    log.WithError(errDo).Debug("management APICall request failed")
    c.JSON(http.StatusBadGateway, gin.H{"error": "request failed"})
    return
}
```

#### 修改后

```go
resp, errDo := httpClient.Do(req)
if errDo != nil {
    // 记录详细日志
    log.WithFields(log.Fields{
        "error":  errDo.Error(),
        "url":    urlStr,
        "method": method,
        "auth":   authIndex,
    }).Error("management APICall request failed")

    // 分类错误信息
    var userMessage string
    errMsg := errDo.Error()
    switch {
    case strings.Contains(errMsg, "timeout"):
        userMessage = "请求超时：连接上游服务器超时（600秒），请检查网络或稍后重试"
    case strings.Contains(errMsg, "connection refused"):
        userMessage = "连接被拒绝：上游服务器拒绝连接，请检查 URL 和网络"
    case strings.Contains(errMsg, "no such host"):
        userMessage = "DNS 解析失败：无法解析域名，请检查 URL"
    case strings.Contains(errMsg, "network is unreachable"):
        userMessage = "网络不可达：请检查网络连接和代理设置"
    case strings.Contains(errMsg, "proxy"):
        userMessage = "代理错误：代理服务器连接失败"
    default:
        userMessage = fmt.Sprintf("请求失败：%s", errMsg)
    }

    c.JSON(http.StatusBadGateway, gin.H{
        "error":  userMessage,
        "detail": errMsg,
    })
    return
}
```

#### 改动说明

| 改动项 | 说明 |
|--------|------|
| **日志级别提升** | 从 `Debug` 提升到 `Error`，确保错误信息默认输出到控制台 |
| **结构化日志** | 添加 `error`、`url`、`method`、`auth` 字段，方便排查问题 |
| **错误分类** | 根据错误类型返回不同的中文友好提示 |
| **前端错误信息** | 返回 `error`（用户友好提示）和 `detail`（详细技术信息）两个字段 |

#### 错误分类对照表

| 错误类型 | 前端显示 |
|---------|---------|
| 超时 | "请求超时：连接上游服务器超时（600秒），请检查网络或稍后重试" |
| 连接被拒 | "连接被拒绝：上游服务器拒绝连接，请检查 URL 和网络" |
| DNS 失败 | "DNS 解析失败：无法解析域名，请检查 URL" |
| 网络不可达 | "网络不可达：请检查网络连接和代理设置" |
| 代理错误 | "代理错误：代理服务器连接失败" |
| 其他错误 | "请求失败：[具体错误信息]" |

---

### 修改 2：增加 APICall 超时时间

**文件：** `internal/api/handlers/management/api_tools.go`  
**行数：** 第 23 行  
**修改类型：** 配置调整

#### 修改前

```go
const defaultAPICallTimeout = 60 * time.Second
```

#### 修改后

```go
const defaultAPICallTimeout = 600 * time.Second
```

#### 改动说明

| 改动项 | 说明 |
|--------|------|
| **超时时间** | 从 60 秒增加到 600 秒（10 分钟） |
| **影响范围** | 所有通过管理面板 `APICall` 接口发起的请求 |
| **适用场景** | NVIDIA 等响应较慢的国际 API 测试连接 |

---

2、cliproxyapi前端项目
cliproxyapi 前端地址： https://github.com/router-for-me/Cli-Proxy-API-Management-Center

## 1. 依赖包修复

### 问题描述
项目启动时 Vite 报错，提示以下依赖包未安装但代码中有引用：
- `react-router`
- `@codemirror/search`
- `@codemirror/view`
- `@codemirror/state`

### 变更内容

```bash
pnpm add @codemirror/search @codemirror/view @codemirror/state react-router
```

### 涉及文件
- `package.json` - 添加了以下依赖：
  - `@codemirror/search` ^6.7.0
  - `@codemirror/state` ^6.6.0
  - `@codemirror/view` ^6.41.1
  - `react-router` ^7.14.2

### 变更原因
这些依赖包是项目中以下文件所必需的：
- `react-router`: `src/hooks/useUnsavedChangesGuard.ts`
- `@codemirror/search`: `src/components/config/ConfigSourceEditor.tsx`
- `@codemirror/view`: `src/components/config/ConfigSourceEditor.tsx`
- `@codemirror/state`: `src/components/config/DiffModal.tsx`

---

## 2. 测试模型请求超时时间调整

### 变更描述
将 AI 提供商测试功能的请求超时时间从 30 秒延长至 10 分钟（600 秒）。

### 涉及文件

#### 2.1 AiProvidersOpenAIEditPage.tsx

**文件路径**: `src/pages/AiProvidersOpenAIEditPage.tsx`

**变更内容**:
```typescript
// 修改前
const OPENAI_TEST_TIMEOUT_MS = 30_000;

// 修改后
const OPENAI_TEST_TIMEOUT_MS = 600_000;
```

**影响范围**:
- OpenAI 提供商的单个密钥测试
- OpenAI 提供商的"一键测试全部密钥"功能

**超时提示语**: 超时提示会自动计算显示为"测试请求超时（600秒）"，无需额外修改语言文件。

---

#### 2.2 AiProvidersClaudeEditPage.tsx

**文件路径**: `src/pages/AiProvidersClaudeEditPage.tsx`

**变更内容**:
```typescript
// 修改前
const CLAUDE_TEST_TIMEOUT_MS = 30_000;

// 修改后
const CLAUDE_TEST_TIMEOUT_MS = 600_000;
```

**影响范围**:
- Claude 提供商的连通性测试

**超时提示语**: 超时提示会自动计算显示为"测试请求超时（600秒）"，无需额外修改语言文件。

---

## 变更统计

| 类型 | 数量 | 说明 |
|------|------|------|
| 依赖添加 | 4 个 | 修复缺失的运行时依赖 |
| 常量修改 | 2 处 | 测试超时时间调整 |

---

npm install pnpm -g
pnpm i
pnpm dev

为了让两个项目可以联调，需要增加一下配置

// vite.config.ts
export default defineConfig({
  // ......
  server: {
    proxy: {
      '/v0/management': {
        target: 'http://localhost:8317',
        changeOrigin: true,
      },
    },
  }
});


由于执行pnpm dev之后

所以访问的前端地址为：http://localhost:5173/#/

3、测试联通后，如何给claudecode中使用
3.1如果不借助ccswitch，直接给claudecode使用的话
需要在~/.claude/settings.json按如下配置

配置env
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "这里填写你后台复制的API密钥",
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:8317",
    "ANTHROPIC_MODEL": "z-ai/glm4.7",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "z-ai/glm4.7"
  }
}

3.2 如果搭配ccswitch，给claudecode使用的话

必须注意 关掉路由

 这个必须关掉，即不能是这种打开绿色的状态
模型选自定义的就行

注意这里一定要选择Anthropic Messages（原生）
为什么呢？
因为原理如下

当cliproxyapi 直接 和 claudecode交互
正向请求流：

Claude Code 原始请求 (Anthropic 格式) ➡️ cliproxyapi 本地代理 (拦截 & 改写 Key/Body/模型名) ➡️ 转换成目标 API 格式请求 (如 OpenAI 格式) ➡️ 目标大模型服务器

反向响应流：

目标大模型服务器 ➡️ 返回目标格式响应 (如 OpenAI 格式) ➡️ cliproxyapi 本地代理 (解析 & 逆向翻译) ➡️ 转换成 Anthropic 格式响应 ➡️ Claude Code 正常渲染输出

加入ccswitch后的流程应该是如下样子

正向请求流：

Claude Code 原始请求 (Anthropic 格式) ➡️ ccswitch (拦截路由 & 切换目标模型/配置) ➡️ cliproxyapi 本地代理 (接收 & 改写 Key/Body) ➡️ 转换成目标 API 格式请求 (如 OpenAI 格式) ➡️ 目标大模型服务器

反向响应流：

目标大模型服务器 ➡️ 返回目标格式响应 (如 OpenAI 格式) ➡️ cliproxyapi 本地代理 (解析 & 逆向翻译) ➡️ 转换成 Anthropic 格式响应 ➡️ ccswitch (透传响应) ➡️ Claude Code 正常渲染输出
 

简单理解各层职责：

  • ccswitch：决定“找谁说话”（负责在 Claude、GPT-4、DeepSeek 等不同配置间无缝切换）

  • cliproxyapi：决定“怎么说对方能听懂”（负责协议翻译和密钥替换，把 Claude 的话翻译给其他模型听）

AI 时代程序员必备技能

Codex、Claude Code、Cursor、Hermes Agent、OpenClaw等工程化实战专栏 ，讲透 AI 如何接管脏活累活

一键订阅
CLIProxyAPI：命令行代理工具，提升API测试与自动化效率
weixin_42521558的博客
05-06 345
在软件开发和DevOps实践中，API（应用程序编程接口）测试与集成是核心环节，其效率直接影响开发流程。传统方式依赖图形化工具或手动脚本，难以满足自动化与脚本化需求。命令行工具因其可脚本化、易于集成到CI/CD流水线的特性，成为提升效率的关键。通过将HTTP请求代理到命令行，开发者能以结构化参数发起复杂请求，实现请求构造、认证集成与响应处理的自动化。这一技术价值在于显著降低API交互门槛，支持Bearer Token、API Key等多种认证机制，并能无缝融入Shell脚本、Makefile及监控系统。应用
CLIProxyAPI：统一AI编程工具代理网关的架构与部署指南
weixin_42626599的博客
05-04 333
在AI编程工具日益普及的背景下，开发者常面临多模型API接口不统一、认证管理复杂的挑战。API网关作为解决这一问题的核心中间件，通过协议转换和智能路由，将不同供应商的接口标准化。其技术价值在于实现了客户端与后端服务的解耦，提升了开发效率和系统可维护性。在实际应用场景中，这类网关特别适用于需要同时调用多个AI模型服务的开发环境。本文以CLIProxyAPI为例，详细解析了其作为统一代理网关的架构设计，重点介绍了多账号负载均衡和智能回退等高级功能，并提供了基于Docker的完整部署方案。通过配置模型映射和故障转
Claude Code 配置NVIDIAAPI完整教程 - 免费使用国产大模型
weixin_37799575的博客
04-20 3806
摘要：零成本接入Claude Code的NVIDIA API解决方案 本文介绍了如何免费使用Claude Code通过NVIDIA API调用国产顶级大模型的方法。主要内容包括： 申请NVIDIA API Key的关键步骤，特别强调手机验证需加+86区号 部署CLIProxyAPI进行协议转换的详细配置流程 Claude Code连接代理的两种方式（推荐使用CC Switch工具） 可选的国产模型推荐：GLM-4.7（数学推理）、MiniMax M2.5（代码修复）、Kimi K2.5（长文本处理） 整套方
CLIProxyAPI故障排查手册：常见问题与解决方案汇总
gitblog_00040的博客
01-06 2165
CLIProxyAPI是一个强大的代理服务器，为CLI提供OpenAI/Gemini/Claude/Codex兼容的API接口。本手册汇总了在使用过程中可能遇到的各种常见问题及其解决方案，帮助您快速定位并解决问题。🚀 ## 🔍 常见连接问题与解决方案 ### 端口占用错误 当启动CLIProxyAPI时，如果遇到端口被占用的情况，您会看到类似以下的错误信息： ``` Error: li
英伟达NIM平台和CLIProxyAPI
Henry_Wu001的专栏
04-06 425
本文介绍了配置NVIDIA AI平台的详细步骤：1）注册获取API Key；2）下载cliproxyapi并配置config.yaml文件；3）通过网页管理界面设置代理和AI提供商信息；4）下载claudecodecli并配置相关环境变量。注意事项包括：手机号注册需多次尝试、配置文件需正确拷贝、API Key不需加引号等。最后提供了测试方法，帮助用户完成整个配置流程。
CLIProxyAPI + OpenCode
QJtDK1R5a的博客
04-05 71
Go 代码 🤔，有环境直接源码编译，再。
Claude订阅用户福音：claw-cli-proxy实现OpenAI兼容API调用
最新发布
weixin_28745975的博客
05-09 344
在人工智能API集成领域，协议兼容性是实现技术栈统一的关键。OpenAI API格式因其简洁性和广泛支持，已成为许多开发者的首选接口标准。claw-cli-proxy通过巧妙的架构设计，将Claude官方命令行工具的能力转化为标准HTTP服务，实现了协议层的无缝对接。这一技术方案的核心价值在于，它允许开发者在不修改现有代码架构的情况下，将Claude的强大模型能力集成到自动化工作流中。从技术实现角度看，该工具采用Go语言编写，具备零依赖、轻量级的特点，运行时内存占用仅10MB左右。在实际应用场景中，开发者可
【blob】blob视频的一种下载办法 m3u8
allanGold
10-19 9420
通过chrome浏览器，找到视频的标签，获取播放地址 因为是blob的视频，打开chrome的network，搜索框里输入m3u8，找到index.m3u8?…….的url copylink出来真实下载地址 使用ffmpeg -i 真实下载地址 novoicein.mp4 前提：需要在电脑上安装ffmpeg 如果是mac的话，可以通过homebrew来安装ffmpeg ...
iOS 手机非越狱 如何绑hosts
allanGold
09-25 7850
基于DNSMASQ 搭建个人的 DNS服务器（手机做hosts、host） 背景： 前端做项目时，方便起见，文件都存于服务器。 用电脑访问的时候可以 做hosts（也就是将域名转换为指定的ip去访问） 但是 iOS 和 Android 为 越狱破解的情况下，是没办法修改hosts文件的吗没有pc 方便，就在想，有没有办法可以使手机 通过pc端的host，这样就能达到效果。 其实原理也就是将 一台电脑作为dns服务器， 使你需要做host的手机经过这台 电脑来解析域名，制定到对应的ip地址。 需要借助的工具
iOS 新版真机系统sdk(iPhone)下载地址
allanGold
09-20 6139
https://github.com/filsv/iPhoneOSDeviceSupport Xcode iPhoneOS DeviceSupport (6.0 - 13.1 (17A5821e)) Update: To get iOS 13.1 (****) works try to rename a folder from this "13.1 (17A5821e)" to "13.1 (...
【工具】【IDE】Qt Creator社区版
allanGold
11-02 4456
qt creator
在线ps网站
allanGold
08-13 4391
https://juejin.im/post/5d1178c3e51d45108223fc92 介绍的 https://www.photopea.com 国内版是 https://ps.gaoding.com/#/ 国外秒杀PS抠图工具的神器网站、免费还抠的贼干净 https://www.remove.bg 小图免费、大图收费 ...
【Android Studio】Android Studio修改代码编辑区（工作区）背景色
allanGold
11-08 3681
Android Studio代码编辑区修改背景色
Mac VSCode Mermaid（markdown画图）
allanGold
12-27 3623
markdown mermaid 画图
代码对比工具 mac
allanGold
03-19 3503
代码比对神器 Kaleidoscope Kaleidoscope 是一个非常强大的比对工具，可以十分方便地比对文本、图片、文件夹等内容。搭配上 SourceTree，能够大大提升 Git 的效率。 Kaleidoscope 可以用来： 比对任意文字、图片、文件夹 Code Review 利器，可以比对 Git 中不同 commit、不同分支上的代码 快速解决 Git 合并冲突 … Source...
【工具】【数据库】Mac版DBeaver打开sqlite纪实
allanGold
02-09 2886
1、点击窗口，选中数据库导航，显示出左侧的数据库导航窗口 2、 点击这个带加号的插座按钮 3、选中sqlite 4、注意这里要把连接类型修改为测试
【抓包】【Mac Charles】局域网无法抓包 手机热点来解决
allanGold
05-08 2809
做移动开发，少不了要手机抓包，做一些验证什么的。尤其是做隐私整改时，要保证用户点击同意之前，任何网络请求都不能发生，单凭人工检查代码，免不了遗漏情况。这时候，抓包工具就派上了大用场。 我们都知道，抓包工具工作的场景是手机与电脑处于同一局域网下，但是呢，有些时候公司的局域网可能不是抓包工具要求的局域网，这时候就尴尬了，局域网下不能抓包了，是不是有点抓狂？ 别急，淡定，咱们有招。招是什么？听我慢慢说来 准备： 两部手机（其中一部要有可上网的sim卡），一台电脑（我这里用mac） 步骤： 重要的第一步
如何判断是使用的阿里云还是腾讯云
allanGold
10-11 2147
http://www.cnnic.net.cn 可以通过ping 网址 获取 ip
用于在线面试写代码的工具网站
allanGold
11-06 2137
http://collabedit.com
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值