Skip to content

codehubcloud/claude_nvidia_proxy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 

Repository files navigation

Claude-NVIDIA-Proxy 用户使用指南

简介

Claude-NVIDIA-Proxy 是一个本地代理服务器,可以将 Anthropic API 格式的请求转换为 OpenAI 格式,并转发到 NVIDIA 等兼容 OpenAI API 的服务。这对于需要使用非官方 API 源的场景非常有用, 支持介入vscoe 插件使用。

功能特性

  • 支持 Anthropic API 格式的所有主要功能
  • 支持流式和非流式响应
  • 支持多模态(图片)输入
  • 支持 Tools/Function Calling
  • 系统托盘运行,后台无干扰
  • 简洁的 GUI 配置界面

系统要求

  • 操作系统: Windows 10/11(64位)
  • 内存: 至少 512MB 可用内存
  • 磁盘: 至少 100MB 可用空间

安装

1. 下载安装包

从官方下载地址获取 ClaudeNvidiaProxy-Setup-x.x.x.exe 安装包(x.x.x 为版本号)。

2. 运行安装程序

双击安装包,按照提示完成安装。默认安装路径为:

C:\Program Files\ClaudeNvidiaProxy

安装完成后,桌面和开始菜单会创建快捷方式。

配置

首次运行

首次启动程序时,会自动弹出配置窗口,需要设置以下信息:

配置项说明

  1. ClaudeNvidiaProxy软件配置项说明如下:
字段 说明 示例
Upstream Base URL 上游 API 服务地址 https://integrate.api.nvidia.com/v1/chat/completions
API Key 上游服务的 API 密钥 nvapi-xxxxxxxxxxxxxx
  1. claude code的配置:
C:\Users\用户名\.claude\settings.json

填写示例

Upstream Base URL: https://integrate.api.nvidia.com/v1/chat/completions
API Key: nvapi-xxxxxxxxxxxxxx

C:\Users\用户名\.claude\settings.json 文件配置项说明如下:

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "你在Nvidia平台获取的API Key",
        "ANTHROPIC_BASE_URL": "http://localhost:3001",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "z-ai/glm4.7",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "z-ai/glm4.7",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "z-ai/glm4.7",
        "ANTHROPIC_MODEL": "z-ai/glm4.7"
    },
    "alwaysThinkingEnabled": true
}

启动软件

点击 Save & Start 保存配置并启动代理服务。

修改配置

如果需要修改配置:

  1. 点击托盘图标或打开程序窗口
  2. 点击 Edit Config 按钮
  3. 修改配置后点击 Save & Start

使用方法

启动服务

启动程序后,点击 Start Proxy 按钮。

  • 服务成功启动后,程序会最小化到系统托盘
  • 托盘图标会显示当前运行状态

托盘功能

右键菜单

  • Show - 显示程序窗口
  • Running/Stopped - 显示当前服务状态
  • Exit - 退出程序

退出程序

点击托盘图标右键菜单中的 Exit,即可完全退出程序(会自动停止服务)。

卸载

通过控制面板卸载

方式1:

  1. 打开安装目录
  2. 双击 uninstall.exe

方式2:

  1. 打开 Windows 设置 → 应用
  2. 找到 ClaudeNvidiaProxy
  3. 点击卸载

卸载说明

  • 如果程序正在运行,会提示是否自动关闭
  • 卸载会删除所有程序文件和配置(包括 config.json)
  • 桌面和开始菜单快捷方式也会被删除

常见问题

Q: 服务启动失败

A: 请检查配置是否正确:

  • Upstream URL 是否填写正确
  • API Key 是否有效
  • 网络连接是否正常

Q: 支持 HTTPS 吗?

A: 代理仅监听本地 HTTP (127.0.0.1:3001)。如需从其他设备访问,请在服务器端配置端口转发或反向代理。

Q: 可以同时运行多个实例吗?

A: 不可以。程序内置单实例检测,无法同时运行多个实例。

技术支持

如有问题或建议,请通过以下方式联系:

  • 提交 Issue 到项目仓库
  • 联系项目维护者

版本历史

查看 CHANGELOG.md 了解版本更新历史。

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors