https://github.com/CassiopeiaCode/b4u2cc

https://github.com/CassiopeiaCode/b4u2cc

Last synced: 4 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/CassiopeiaCode/b4u2cc
• Owner: CassiopeiaCode
• Created: 2025-12-07T14:01:51.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2025-12-11T09:04:12.000Z (6 months ago)
• Last Synced: 2025-12-12T07:21:42.220Z (6 months ago)
• Language: TypeScript
• Size: 85.9 KB
• Stars: 61
• Watchers: 0
• Forks: 104
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
# b4u2cc - Claude Code 代理服务器

b4u2cc 是一个基于 Deno 的代理服务器，用于将 Claude Code 的请求转换为兼容 OpenAI 格式的请求，使 Claude Code 能够与不支持原生工具调用的上游模型进行交互。

## 项目概述

本项目主要包含 `deno-proxy` 服务，它负责在 Claude Code 和 OpenAI（或其他无工具模式的 Chat API）之间建立桥梁，通过以下方式实现无缝对接：

- 将 Claude Code 的 SSE 流转换为上游兼容格式

- 插入必要的日志与格式转换

- 确保客户端无需感知上游差异

## 核心功能

### 🔄 协议转换

- **Claude → OpenAI**: 将 Anthropic Claude Messages API 请求转换为 OpenAI chat/completions 格式

- **OpenAI → Claude**: 将上游响应转换回 Claude Code 兼容的 SSE 流格式

- **工具调用支持**: 通过提示词注入实现工具调用，即使上游不支持原生 function calling

### 🛠️ 工具调用机制

- 动态生成触发信号，识别工具调用边界

- 将工具定义转换为系统提示词

- 解析上游文本中的工具调用描述

- 支持多工具调用和流式解析

### 🧠 思考模式

- 支持 Claude 的思考模式（thinking mode）

- 将思考内容转换为 `` 标签格式

- 在响应中正确处理思考块和文本块的顺序

### 📊 Token 计数

- 集成 Claude 官方 `/v1/messages/count_tokens` API

- 本地 tiktoken 实现作为备用方案

- 支持通过 `TOKEN_MULTIPLIER` 调整计费倍数

- 提供 `/v1/messages/count_tokens` 端点

### 📝 日志系统

- 结构化日志记录请求全过程

- 支持多级别日志（debug、info、warn、error）

- 可完全禁用日志以提高性能

- 请求 ID 跟踪，便于调试

## 快速开始

### 环境要求

- Deno 1.40+ 

- 可访问的上游 OpenAI 兼容 API

### 安装与运行

1. 克隆仓库

```bash

git clone 

cd b4u2cc

```

2. 配置环境变量

```bash

# 必需配置

export UPSTREAM_BASE_URL="http://your-upstream-api/v1/chat/completions"

export UPSTREAM_API_KEY="your-upstream-api-key"

# 可选配置

export PORT=3456

export HOST=0.0.0.0

export CLIENT_API_KEY="your-client-api-key"  # 客户端认证密钥

export TIMEOUT_MS=120000

export MAX_REQUESTS_PER_MINUTE=10

export TOKEN_MULTIPLIER=1.0

```

3. 启动服务

```bash

cd deno-proxy

deno run --allow-net --allow-env src/main.ts

```

4. 验证服务

```bash

curl http://localhost:3456/healthz

```

## 详细配置

### 环境变量说明

| 变量名 | 必需 | 默认值 | 说明 |

|--------|------|--------|------|

| `UPSTREAM_BASE_URL` | 是 | - | 上游 OpenAI 兼容 API 地址 |

| `UPSTREAM_API_KEY` | 否 | - | 上游 API 密钥 |

| `UPSTREAM_MODEL` | 否 | - | 强制覆盖请求中的模型名称 |

| `CLIENT_API_KEY` | 否 | - | 客户端认证密钥 |

| `PORT` | 否 | 3456 | 服务监听端口 |

| `HOST` | 否 | 0.0.0.0 | 服务监听地址 |

| `TIMEOUT_MS` | 否 | 120000 | 请求超时时间（毫秒） |

| `AGGREGATION_INTERVAL_MS` | 否 | 35 | SSE 聚合间隔（毫秒） |

| `MAX_REQUESTS_PER_MINUTE` | 否 | 10 | 每分钟最大请求数 |

| `TOKEN_MULTIPLIER` | 否 | 1.0 | Token 计数倍数 |

| `CLAUDE_API_KEY` | 否 | - | Claude API 密钥（用于精确 token 计数） |

| `LOG_LEVEL` | 否 | info | 日志级别（debug/info/warn/error） |

| `LOGGING_DISABLED` | 否 | false | 是否完全禁用日志 |

### Token 倍数格式

`TOKEN_MULTIPLIER` 支持多种格式：

- 数字：`1.2`

- 带后缀：`1.2x`、`x1.2`

- 百分比：`120%`

- 带引号：`"1.2"`

## API 端点

### `/v1/messages`

处理 Claude Messages API 请求，支持流式响应。

**请求示例**:

```bash

curl -X POST http://localhost:3456/v1/messages \

  -H "Content-Type: application/json" \

  -H "x-api-key: your-client-api-key" \

  -d '{

    "model": "claude-3.5-sonnet-20241022",

    "max_tokens": 1024,

    "messages": [

      {"role": "user", "content": "你好，请介绍一下你自己"}

    ],

    "stream": true

  }'

```

### `/v1/messages/count_tokens`

计算请求的 token 数量。

**请求示例**:

```bash

curl -X POST http://localhost:3456/v1/messages/count_tokens \

  -H "Content-Type: application/json" \

  -d '{

    "model": "claude-3.5-sonnet-20241022",

    "messages": [

      {"role": "user", "content": "Hello, world"}

    ]

  }'

```

### `/healthz`

健康检查端点。

## 使用示例

### 基础对话

```bash

./scripts/test-proxy.sh

```

### 思考模式

```bash

./scripts/test-thinking-mode.sh

```

### 通过代理启动 Claude Code

```bash

./scripts/run-claude-via-proxy.sh

```

## 架构设计

### 核心组件

1. **请求转换器** (`anthropic_to_openai.ts`)

   - 将 Claude 请求格式转换为 OpenAI 格式

   - 处理角色映射、内容块转换

   - 支持思考模式标签转换

2. **提示词注入器** (`prompt_inject.ts`)

   - 生成工具调用提示词

   - 创建触发信号

   - 构建工具定义 XML

3. **上游调用器** (`upstream.ts`)

   - 处理与上游 API 的通信

   - 支持流式响应

   - 超时和错误处理

4. **响应解析器** (`parser.ts`)

   - 解析上游文本中的工具调用

   - 支持流式解析

   - 处理思考内容

5. **响应转换器** (`openai_to_claude.ts`)

   - 将解析结果转换为 Claude SSE 格式

   - 处理内容块和工具调用块

   - 生成正确的 token 计数

### 工作流程

```

Claude Code 请求

       ↓

   请求验证

       ↓

   格式转换

       ↓

   提示词注入

       ↓

   上游调用

       ↓

   流式解析

       ↓

   响应转换

       ↓

   Claude SSE 响应

```

## 开发与测试

### 运行测试

```bash

cd deno-proxy

deno test --allow-env src

```

### 开发模式

```bash

cd deno-proxy

deno task dev

```

### 日志调试

```bash

# 启用详细日志

LOG_LEVEL=debug deno run --allow-net --allow-env src/main.ts

# 完全禁用日志

LOGGING_DISABLED=true deno run --allow-net --allow-env src/main.ts

```

## 部署指南

### Deno Deploy 一键部署 🚀

最简单的部署方式是使用 Deno Deploy 官方平台：

[![Deploy on Deno](https://deno.com/button)](https://console.deno.com/new?clone=https://github.com/your-username/b4u2cc)

**优势**:

- 无需管理服务器

- 自动扩缩容

- 全球 CDN 分发

- 免费额度充足

**快速部署步骤**:

1. 点击上方 "Deploy on Deno" 按钮

2. 授权 GitHub 访问

3. 配置环境变量（上游 API 地址和密钥）

4. 点击部署，几秒钟后即可访问

详细说明请参考：[Deno 部署指南](docs/deno-deployment-guide.md#deno-deploy-一键部署)

### 其他部署方式

该指南还包含以下部署场景：

- 本地开发环境

- 生产环境 (systemd)

- Docker 容器化

- 云平台部署 (Vercel, Railway, DigitalOcean)

- 性能优化与监控

### 快速部署示例

#### Docker 部署

```bash

# 构建镜像

docker build -t b4u2cc-proxy .

# 运行容器

docker run -d \

  --name b4u2cc-proxy \

  -p 3456:3456 \

  -e UPSTREAM_BASE_URL=http://your-upstream-api/v1/chat/completions \

  -e UPSTREAM_API_KEY=your-api-key \

  b4u2cc-proxy

```

#### 系统服务部署

```bash

# 创建服务文件

sudo tee /etc/systemd/system/b4u2cc.service > /dev/null <