CLI Proxy

CLP (CLI Proxy) - 本地AI代理工具

项目简介

CLP 是一个本地CLI代理工具，用于管理和代理AI服务（如Claude和Codex）的API请求。该工具提供统一的命令行界面来启动、停止和管理多个AI服务代理，支持多配置管理和Web UI监控。

亮点
- 动态切换配置: 支持命令行/UI界面动态切换不同的服务配置，【无需重启claude/codex命令行终端，上下文保留】
- 敏感数据过滤: 可将敏感数据配置到请求过滤器中，防止泄露
- 多服务支持: 支持各种中转站配置，无需繁琐调整json配置后重启客户端
- token使用统计: 解析请求中的token使用情况
- 模型路由管理: 支持自定义模型路由，灵活控制请求目标站点的模型名称
- 负载均衡: 支持“号池管理” 按选择/权重的智能负载均衡，失败后切换下一权重站点

界面预览

主要功能

🚀 核心功能
- 多服务代理: 支持Claude（端口3210）和Codex（端口3211）代理服务
- 配置管理: 支持多配置切换和管理
- Web UI界面: 提供Web界面（端口3300）监控代理状态和使用统计
- 请求过滤: 内置请求过滤机制
- 流式响应: 支持流式API响应处理
- 使用统计: 自动记录和分析API使用情况

📊 监控功能
- 实时服务状态监控
- API使用量统计
- 请求/响应日志记录
- 配置状态跟踪

技术栈

- Python 3.7+
- FastAPI: 异步Web框架，用于代理服务
- Flask: Web UI界面
- httpx: 异步HTTP客户端
- uvicorn: ASGI服务器
- psutil: 进程管理

项目结构

快速开始

安装

命令使用方法

基本命令

配置管理（可在UI界面快速添加和切换配置）

Docker 部署

使用 Docker Compose（推荐）

1. 构建并启动服务

2. 查看服务状态

3. 查看日志

4. 停止服务

使用 Docker 命令

1. 构建镜像

2. 运行容器

3. 查看容器状态

4. 查看日志

5. 停止容器

Docker容器内服务管理

容器内配置管理

数据持久化

- 配置文件存储在Docker volume clp_data 中
- 包含Claude和Codex的配置、运行日志等数据
- 容器重启后配置会自动保留

端口说明

- 3210: Claude代理服务端口
- 3211: Codex代理服务端口
- 3300: Web UI管理界面端口

健康检查

容器内置健康检查，会定期检查Web UI服务是否正常运行：

故障排除

查看详细日志

进入容器调试

重新构建镜像

清理数据

开发环境

如果需要在开发环境使用Docker，可以挂载源代码：

更新版本

claude code 使用方法
1. 修改 ~/.claude/settings.json Claude配置文件，连接本地CLI代理服务

2. 重启Claude命令行即可（确保本地代理已启动 clp start）

codex 使用方法
1. 修改 ~/.codex/config.toml Codex配置文件，连接本地CLI代理服务

2. 修改 ~/.codex/auth.json (没有就创建一个)

3. 重启codex即可（确保本地代理已启动 clp start）

vscode 中的 claude code 使用方法
1. 创建 ~/.claude/config.json Claude配置文件（没有就创建一个）

2. 打开vscode->扩展->找到claude code扩展->右下角小齿轮->settings->Edit in settings.json 在 settings.json 中的 claude-code.environmentVariables 数组中填入以下配置，连接本地CLI代理服务

3. 重新打开 claude code 对话框即可

开发指南

1. 安装依赖

2. 配置文件

工具会在用户主目录下创建 ~/.clp/ 目录存储配置：

- ~/.clp/claude.json - Claude服务配置
-…