# claude-deepseek-proxy

**Repository Path**: xiejinwei/claude-deepseek-proxy

## Basic Information

- **Project Name**: claude-deepseek-proxy
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-22
- **Last Updated**: 2026-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DeepSeek Proxy for Claude Desktop

这是一个用 Go 语言实现的代理服务,用于让 Claude 桌面客户端能够使用 DeepSeek V4 系列大模型。

## 问题背景

Claude 桌面端内置了模型格式校验机制,界面层只识别以下前缀的模型名:
- `claude-` 开头 (如 `claude-sonnet-4-5`)
- `anthropic/claude-` 开头 (如 `anthropic/claude-sonnet-4-5`)

如果直接填写 `deepseek-v4-pro`、`deepseek-v4-flash` 等第三方原生模型名,客户端会直接判定为"非官方模型",触发红色格式警告,无法通过客户端的基础校验。

## 解决方案

本代理服务通过模型名映射的方式解决这个问题:

| 请求阶段 | 模型名 | 说明 |
|---------|--------|------|
| 客户端发出请求 | `anthropic/claude-3-5-sonnet-deepseek-pro` | 骗过 Claude 网关校验 |
| 代理转发至 DeepSeek | `deepseek-v4-pro` | 替换为 DeepSeek 原生模型名 |

## 功能特性

- ✅ Web UI 配置界面
- ✅ 自动模型名映射
- ✅ 支持流式响应
- ✅ 配置持久化
- ✅ 跨平台支持

## 快速开始

### 1. 安装依赖

```bash
go mod tidy
```

### 2. 运行程序

```bash
go run main.go
```

或者编译后运行:

```bash
# macOS/Linux
go build -o ds_proxy
./ds_proxy

# Windows
go build -o ds_proxy.exe
ds_proxy.exe
```

### 3. 配置

启动后访问 http://localhost:8080,在 Web 界面中:
1. 输入您的 DeepSeek API Key
2. 设置代理端口(默认 8080)
3. 点击保存

### 4. Claude 客户端配置

在 Claude 桌面客户端中配置:
- **API 基础 URL**: `http://localhost:8080`
- **模型名称**: 使用下表中的 Claude 格式模型名

## 模型映射表

| Claude 格式模型名 | DeepSeek 实际模型 |
|------------------|------------------|
| `anthropic/claude-3-5-sonnet-deepseek-pro` | `deepseek-v4-pro` |
| `anthropic/claude-3-5-sonnet-deepseek-flash` | `deepseek-v4-flash` |
| `claude-3-5-sonnet-deepseek-pro` | `deepseek-v4-pro` |
| `claude-3-5-sonnet-deepseek-flash` | `deepseek-v4-flash` |

## 命令行选项

```bash
# 显示帮助
./ds_proxy --help

# 显示版本
./ds_proxy --version
```

## 项目结构

```
ds_proxy/
├── main.go           # 主程序入口
├── config/
│   └── config.go     # 配置管理
├── proxy/
│   └── handler.go    # 代理转发逻辑
├── ui/
│   └── handler.go    # Web UI 界面
├── go.mod            # Go 模块定义
└── README.md         # 使用说明
```

## 工作原理

1. **接收请求**: 代理服务监听本地端口,接收 Claude 客户端请求
2. **模型名替换**: 将请求体中的 Claude 格式模型名替换为 DeepSeek 原生模型名
3. **转发请求**: 将修改后的请求转发到 DeepSeek API
4. **返回响应**: 将 DeepSeek 的响应返回给 Claude 客户端

## 注意事项

1. 确保 DeepSeek API Key 有效且有足够的配额
2. 代理服务需要保持运行状态
3. 如果使用自定义端口,请确保端口未被占用
4. 首次使用需要在 Web 界面配置 API Key

## 故障排查

### 问题: 无法连接到代理服务

**解决方案**:
- 检查代理服务是否正常运行
- 确认端口配置正确
- 检查防火墙设置

### 问题: API 请求失败

**解决方案**:
- 验证 DeepSeek API Key 是否正确
- 检查网络连接
- 查看代理服务日志

### 问题: 模型名不被识别

**解决方案**:
- 确保使用正确的 Claude 格式模型名
- 参考模型映射表

## 开发

### 构建

```bash
# 构建当前平台版本
go build

# 构建 macOS 版本
GOOS=darwin GOARCH=amd64 go build -o ds_proxy-darwin-amd64
GOOS=darwin GOARCH=arm64 go build -o ds_proxy-darwin-arm64

# 构建 Linux 版本
GOOS=linux GOARCH=amd64 go build -o ds_proxy-linux-amd64

# 构建 Windows 版本
GOOS=windows GOARCH=amd64 go build -o ds_proxy-windows-amd64.exe
```

### 依赖

- Go 1.21+
- 标准库 (无外部依赖)

## 许可证

MIT License

## 贡献

欢迎提交 Issue 和 Pull Request!