# codexproxy

**Repository Path**: w-b980952617/codexproxy

## Basic Information

- **Project Name**: codexproxy
- **Description**: LLM 协议转换代理桌面应用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-14
- **Last Updated**: 2026-06-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CodexProxy — Tauri + Vue + Go 代理

LLM 协议转换代理桌面应用。将 OpenAI / Anthropic 协议的请求转换为 DeepSeek、Kimi 等后端模型可识别的格式，让 Codex CLI 等工具无缝接入国产 LLM。

## 开发前置要求

| 工具 | 最低版本 | 说明 |
|------|---------|------|
| Go | 1.25+ | [下载](https://go.dev/dl/) |
| Node.js | 18+ | [下载](https://nodejs.org/) |
| Rust | 1.77+ | [下载](https://rustup.rs/) |

## 配置

编辑 `config.yml`，核心配置项：`config.example.yml`为参考配置。

```yaml
# 服务器监听地址
server:
  addr: "127.0.0.1:38440"

# 上游服务商
providers:
  deepseek:
    base_url: "https://api.deepseek.com/anthropic"
    api_key: "sk-your-deepseek-key"    # 👈 替换
    offers:
      - model: deepseek-v4-pro
```

完整配置说明见 [config.example.yml](config.example.yml)。

## 架构

```
┌─────────────────────────────┐
│  Tauri 桌面壳 (Rust)        │
│  ┌──────────┐ ┌───────────┐ │
│  │ 系统托盘  │ │ 进程管理   │ │
│  └──────────┘ └───────────┘ │
│  ┌──────────────────────────┐│
│  │  Vue 前端 (状态仪表盘)    ││
│  └──────────────────────────┘│
├─────────────────────────────┤
│  Go 代理 (后台进程)           │
│  监听 127.0.0.1:38440       │
│  ┌─────────────────────────┐│
│  │ Anthropic ↔ DeepSeek    ││
│  │ OpenAI   ↔ Kimi         ││
│  │ 协议转换 + 插件扩展       ││
│  └─────────────────────────┘│
└─────────────────────────────┘
```

- **Tauri** 管理窗口和托盘，负责 Go 进程的生命周期
- **Vue** 提供状态仪表盘，与 Rust 后端通过 IPC 通讯
- **Go 代理** 在后台运行 HTTP 服务，处理 LLM 协议转换



## 开发

```bash
# 安装前端依赖
yarn install

# Tauri 开发模式
yarn tauri dev
```
# 启动 Go 代理
-- 1. 选择 config.yml 配置文件
-- 2. 点击启动 Go 代理



## 打包

```bash
yarn tauri build
```

产物在 `src-tauri/target/release/bundle/` 目录。


## 故障排除

**Go 未安装**：启动时会自动检测，提示前往 https://go.dev/dl/ 下载。

**端口被占用**：修改 `config.yml` 中 `server.addr` 的端口号，或关闭占用 38440 端口的程序。

**配置文件未找到**：确保 `config.yml` 存在于应用同级目录，可从 `config.example.yml` 复制。

**Go 编译失败**：检查 Go 版本 ≥ 1.25，并确保网络可访问 Go 模块代理。