AnyRouter Transparent Proxy

AnyRouter Transparent Proxy

一个基于 FastAPI 的轻量级透明 HTTP 代理服务，专为解决 AnyRouter 的 Anthropic API 在 Claude Code for VS Code 插件中报错 500 的问题而设计。

效果图

目录

- 核心特性
- 项目结构
- 快速开始
  - Docker 部署（推荐）
  - 本地运行
- 配置说明
- 核心功能
- 架构与技术
- 安全性
- 贡献

核心特性

- 完全透明 - 支持所有 HTTP 方法，无缝代理请求
- 流式响应 - 基于 httpx.AsyncClient 异步架构，完美支持流式传输
- 标准兼容 - 严格遵循 RFC 7230 规范，正确处理 HTTP 头部
- 灵活配置 - 支持环境变量配置目标 URL 和 System Prompt 替换
- 高性能 - 连接池复用，异步处理，高效应对并发请求
- 智能处理 - 自动计算 Content-Length，避免请求体修改导致的协议错误
- Web 管理面板 - 提供实时监控、统计分析和配置管理功能

项目结构

说明：
- backend/ - 后端 Python 服务，负责代理逻辑和 API 处理
- frontend/ - 前端 Vue 项目，提供 Web 管理面板
- static/ - 前端构建产物，由 Docker 构建时自动生成，不提交到 Git
- env/ - 运行时配置文件目录

快速开始

Docker 部署（推荐）

使用 Docker Compose：

或使用 Docker 命令：

服务将在 http://localhost:8088 启动，然后在 Claude Code 中配置此地址即可。

~~管理面板通过 http://localhost:8088/admin 访问。~~

现在管理面板可以直接访问主页 http://localhost:8088 自动跳转了

本地运行

环境要求： Python 3.7+

服务将在 http://localhost:8088 启动。

注意：本地开发时，如果需要使用 Web 管理面板，需要先构建前端：

构建产物会输出到 static/ 目录（该目录已在 .gitignore 中忽略）。

~~管理面板通过 http://localhost:8088/admin 访问。~~

现在管理面板可以直接访问主页 http://localhost:8088 自动跳转了

配置说明

环境变量

创建 env/.env 文件或设置环境变量：

自定义请求头（可选）

可以通过 env/.env.headers.json 文件配置自定义请求头，这些头部会被注入到所有代理请求中。

配置步骤：

1. 复制模板文件创建配置：

2. 编辑 env/.env.headers.json 文件，添加你需要的请求头：

3. 重启服务使配置生效

说明：
- 配置文件使用标准 JSON 格式
- 以  开头的字段会被忽略（可用于添加注释）
- 如果文件不存在，默认使用空配置 {}
- 自定义请求头会覆盖原请求中的同名头部
注：配置完成后需要重新启动服务

核心功能

System Prompt 替换

动态替换 Anthropic API 请求体中 system 数组第一个元素的 text 内容：

- 自定义 Claude Code CLI 行为
- 调整 Claude Agent SDK 响应
- 统一注入系统级提示词

配置 SYSTEM_PROMPT_REPLACEMENT 变量启用此功能。

智能请求头处理

- 自动过滤 - 移除 hop-by-hop 头部（Connection、Keep-Alive 等）
- Host 重写 - 自动改写为目标服务器域名
- Content-Length 自动计算 - 根据实际内容自动计算，避免长度不匹配
- 自定义注入 - 支持覆盖或添加任意请求头
- IP 追踪 - 自动维护 X-Forwarded-For 链

使用示例

将原本指向 anyrouter.top 或其他 API 的请求改为指向代理服务：

架构与技术

请求处理流程

关键技术

- 路由处理…