Claude Code Proxy

ClaudeCodeProxy

跨平台桌面应用 - 管理 Claude Code 的本地代理服务

English | 简体中文

简介

ClaudeCodeProxy 是专为 Claude Code 设计的本地代理管理工具，帮助您轻松管理多个 API 中转服务，实现智能路由、自动故障切换和负载均衡。通过简洁优雅的黑金主题界面，一键配置、测试和切换不同的 API 服务。

核心优势

- 专为 Claude Code 优化 - 自动检测并配置，无需手动修改配置文件
- 智能路由 - 多配置分组管理，自动负载均衡和故障切换
- 安全可靠 - API 密钥加密存储在系统密钥链中
- 美观易用 - 黑金主题 UI，操作简单直观
- 跨平台 - 支持 Windows、macOS 和 Linux

功能特性

界面预览

仪表盘 - 代理状态与配置管理
配置管理 - API 配置与测试

环境设置向导 - 自动检测安装
高级配置 - MCP/权限/Skills

快速开始

系统要求

下载安装

访问 Releases 下载对应平台安装包：

macOS 安装说明

首次使用

1. 启动应用，完成环境设置向导
2. 进入「配置管理」添加 API 配置
3. 在「仪表盘」启动代理服务
4. 打开 Claude Code，所有请求将自动通过代理转发

从源码构建

前置要求

- Rust 1.70+ (安装指南)
- Node.js 18+ (安装指南)
- 系统依赖：
  - macOS: xcode-select --install
  - Linux: sudo apt install libwebkit2gtk-4.0-dev build-essential libssl-dev libgtk-3-dev
  - Windows: Visual Studio Build Tools

构建步骤

构建产物位置：src-tauri/target/release/bundle/

发布新版本

1. 更新版本号

需要在以下三个文件中同步更新版本号：

2. 更新 CHANGELOG.md

3. 创建 Tag 触发自动构建

GitHub Actions 将自动：
- 构建 macOS (Apple Silicon + Intel)、Windows、Linux 版本
- 创建 GitHub Release
- 上传所有安装包

项目结构

常见问题

macOS 提示"无法打开应用"

运行 xattr -d com.apple.quarantine /Applications/ClaudeCodeProxy.app 或右键选择"打开"。

启动代理后 Claude Code 无法连接

检查：代理服务是否运行 → API 配置是否有效 → 防火墙是否阻止端口 25341

API 密钥安全吗？

密钥使用系统密钥链加密存储（Windows: DPAPI / macOS: Keychain / Linux: libsecret），永不明文保存。

技术栈

许可证

MIT License

贡献

欢迎贡献代码、报告问题或提出建议！

1. Fork 仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add AmazingFeature')
4. 推送分支 (git push origin feature/AmazingFeature)
5. 创建 Pull Request

联系方式

- 问题反馈: GitHub Issues
- 讨论交流: GitHub Discussions
- 邮箱: jacksonsunjj@gmail.com

版本: 1.1.0 | 状态: 生产就绪

Made with ❤️ by sunjackson

⭐ 如果这个项目对您有帮助，请给我们一个 Star！欢迎咨询