moonbit_claude_proxy

    Claude Code Proxy - translate Claude API requests to OpenAI-compatible API calls

    claude
    openai
    proxy
    api
    Download zip
    Version
    0.1.0
    License
    MIT
    Last updated
    6 months ago
    Downloads
    66

    #MoonBit Claude Code Proxy

    一个用 MoonBit 实现的代理服务器,将 Claude API 请求转换为 OpenAI API 调用,使 Claude Code 能够与任何 OpenAI 兼容的 API 提供商协同工作。

    #项目结构

    moonbit_claude_proxy/ ├── moon.mod.json # 模块配置 (依赖 moonbitlang/async 0.19.0) ├── moon.pkg # 根包导入配置 ├── constants.mbt # API 常量定义 (角色、内容类型、SSE 事件等) ├── config.mbt # 环境变量配置管理 ├── model_manager.mbt # Claude → OpenAI 模型映射 ├── models.mbt # 数据模型 (Claude/OpenAI API 类型及 JSON 解析) ├── request_converter.mbt # Claude → OpenAI 请求格式转换 ├── response_converter.mbt # OpenAI → Claude 响应转换 + SSE 流式处理 ├── openai_client.mbt # 异步 HTTP 客户端 (OpenAI API 调用) ├── server.mbt # HTTP 服务器 (路由、端点、请求处理) └── cmd/main/ ├── moon.pkg # 可执行包配置 (native 目标) └── main.mbt # 入口点

    #功能特性

    • Claude API 兼容: 支持 /v1/messages、/v1/messages/count_tokens、/health、/test-connection 端点
    • 多提供商支持: OpenAI、Azure OpenAI、Ollama 以及任何 OpenAI 兼容 API (通过 OPENAI_BASE_URL 配置)
    • 模型映射: haiku → SMALL_MODEL, sonnet → MIDDLE_MODEL, opus → BIG_MODEL
    • 函数调用: 完整的 tool_use / tool_result 在 Claude 和 OpenAI 格式之间转换
    • 流式响应: SSE 实时流式响应转换,包含完整的事件序列
    • 图像支持: Base64 图像从 Claude 格式转换为 OpenAI 格式
    • API 密钥验证: 通过 ANTHROPIC_API_KEY 可选的客户端密钥校验
    • 自定义 HTTP 头: 通过 CUSTOM_HEADER_* 环境变量注入自定义请求头

    #环境配置

    #必需变量

    环境变量说明
    OPENAI_API_KEYOpenAI API 密钥

    #模型配置

    环境变量说明默认值
    BIG_MODELopus 请求使用的模型gpt-4o
    MIDDLE_MODELsonnet 请求使用的模型同 BIG_MODEL
    SMALL_MODELhaiku 请求使用的模型gpt-4o-mini

    #API 配置

    环境变量说明默认值
    OPENAI_BASE_URLAPI 基础 URLhttps://api.openai.com/v1
    ANTHROPIC_API_KEY客户端验证密钥 (可选)未设置
    HOST服务器主机0.0.0.0
    PORT服务器端口8082

    #性能配置

    环境变量说明默认值
    MAX_TOKENS_LIMIT最大 tokens 限制4096
    MIN_TOKENS_LIMIT最小 tokens 限制100
    REQUEST_TIMEOUT请求超时 (秒)90

    #快速开始

    #1. 安装 MoonBit

    curl -fsSL https://cli.moonbitlang.com/install.sh | bash

    #2. 配置环境

    export OPENAI_API_KEY="sk-your-api-key" export BIG_MODEL="gpt-4o" export SMALL_MODEL="gpt-4o-mini"

    #3. 启动服务器

    cd moonbit_claude_proxy moon run cmd/main

    #4. 与 Claude Code 集成

    ANTHROPIC_BASE_URL=http://localhost:8082 claude

    #模型映射规则

    Claude 模型映射到环境变量
    包含 "haiku"SMALL_MODEL默认: gpt-4o-mini
    包含 "sonnet"MIDDLE_MODEL默认: gpt-4o
    包含 "opus"BIG_MODEL默认: gpt-4o

    如果模型名称包含 gpt-、o1-、ep-、doubao- 或 deepseek- 前缀,则直接透传,不做映射。

    #提供商配置示例

    #OpenAI

    export OPENAI_API_KEY="sk-your-openai-key" export OPENAI_BASE_URL="https://api.openai.com/v1" export BIG_MODEL="gpt-4o" export SMALL_MODEL="gpt-4o-mini"

    #Azure OpenAI

    export OPENAI_API_KEY="your-azure-key" export OPENAI_BASE_URL="https://your-resource.openai.azure.com/openai/deployments/your-deployment" export BIG_MODEL="gpt-4" export SMALL_MODEL="gpt-35-turbo"

    #Ollama (本地模型)

    export OPENAI_API_KEY="dummy-key" export OPENAI_BASE_URL="http://localhost:11434/v1" export BIG_MODEL="llama3.1:70b" export SMALL_MODEL="llama3.1:8b"

    #请求/响应流程

    Claude Code 客户端 ↓ [HTTP 请求] ↓ API 端点验证 (可选密钥校验) ↓ 请求转换器 (Claude → OpenAI 格式) ↓ 模型映射 (根据模型名称选择目标) ↓ OpenAI HTTP 客户端 (异步) ↓ OpenAI API 服务器 ↓ 响应转换器 (OpenAI → Claude 格式) ↓ [HTTP 响应 / SSE 流] ↓ Claude Code 客户端

    #技术栈

    • 语言: MoonBit
    • 异步运行时: moonbitlang/async 0.19.0
    • HTTP 服务器/客户端: moonbitlang/async/http
    • JSON 处理: moonbitlang/core/json
    • 目标平台: native

    #测试

    #单元测试(纯逻辑,无需网络)

    moon test --target native convert_test.mbt

    覆盖:模型映射、Claude↔OpenAI 请求/响应转换、SSE 事件、JSON 解析、多模态图片、工具定义转换等。

    #集成测试(真实 API 调用,需配置 .env)

    moon test --target native integration_test.mbt

    覆盖:简单对话、System Prompt、多工具并行调用、模型映射验证、配置加载。

    集成测试会自动加载 .env 文件,发送请求到配置的 API 提供商,并打印完整的请求和响应 JSON。

    #运行全部测试

    moon test --target native

    #编译与打包

    #开发模式

    # 类型检查 moon check --target native # 格式化代码 moon fmt # 直接运行 moon run cmd/main # 查看帮助 moon run cmd/main -- --help

    #编译可执行文件

    # Debug 构建(快速,包含调试信息) moon build --target native # Release 构建(优化,体积更小) moon build --target native --release

    产物路径:

    模式路径
    Debug_build/native/debug/build/cmd/main/main.exe
    Release_build/native/release/build/cmd/main/main.exe

    运行:

    ./_build/native/debug/build/cmd/main/main.exe

    #部署

    二进制文件可独立运行,部署只需:

    1. 拷贝 main.exe 到目标机器
    2. 在同平台创建 .env 配置文件
    3. 运行 ./main.exe

    注意: MoonBit 目前不支持交叉编译,Windows/Linux/macOS 需在各自平台分别编译。

    #许可证

    MIT License

    ClaudeContentBlock

    pub(all) enum ClaudeContentBlock {
    TextBlock(String)
    ImageBlock(String, String)
    ToolUseBlock(String, String, Map[String, Json])
    ToolResultBlock(String, Json)
    } derive(
    Debug
    )

    ClaudeContentBlock::from_json

    fn ClaudeContentBlock::from_json(json : Json) -> ClaudeContentBlock?

    ClaudeMessage

    pub(all) struct ClaudeMessage {
    role : String
    content : Json
    } derive(
    Debug
    )

    ClaudeMessagesRequest

    pub(all) struct ClaudeMessagesRequest {
    model : String
    max_tokens : Int
    messages : Array[ClaudeMessage]
    system : Json?
    stop_sequences : Array[String]
    stream : Bool
    temperature : Double
    top_p : Double?
    tools : Array[ClaudeTool]
    tool_choice : Map[String, Json]?
    } derive(
    Debug
    )

    ClaudeMessagesRequest::from_json

    ClaudeTokenCountRequest

    pub(all) struct ClaudeTokenCountRequest {
    model : String
    messages : Array[ClaudeMessage]
    system : Json?
    tools : Array[ClaudeTool]
    tool_choice : Map[String, Json]?
    } derive(
    Debug
    )

    ClaudeTokenCountRequest::from_json

    ClaudeTool

    pub(all) struct ClaudeTool {
    name : String
    description : String?
    input_schema : Map[String, Json]
    } derive(
    Debug
    )

    Config

    pub(all) struct Config {
    openai_api_key : String
    anthropic_api_key : String?
    openai_base_url : String
    big_model : String
    middle_model : String
    small_model : String
    host : String
    port : Int
    max_tokens_limit : Int
    min_tokens_limit : Int
    request_timeout : Int
    } derive(
    Debug
    )

    Config::get_custom_headers

    fn Config::get_custom_headers(_config : Config) -> Map[String, String]

    Get custom headers from environment (CUSTOM_HEADER_* variables).

    Config::load

    fn Config::load() -> Config

    Load config from environment variables.

    Config::validate_client_api_key

    fn Config::validate_client_api_key(config : Config, client_key : String) -> Bool

    Validate the client API key.

    OpenAIClient

    pub(all) struct OpenAIClient {
    base_url : String
    api_key : String
    custom_headers : Map[String, String]
    }

    OpenAIClient::chat_completion

    async fn OpenAIClient::chat_completion(self : OpenAIClient, request_body : Map[String, Json]) -> Map[String, Json]

    Send a non-streaming chat completion request.

    OpenAIClient::chat_completion_stream

    async fn OpenAIClient::chat_completion_stream(self : OpenAIClient, request_body : Map[String, Json]) -> Array[String]

    Send a streaming chat completion request.

    OpenAIClient::new

    fn OpenAIClient::new(config : Config) -> OpenAIClient

    CONTENT_IMAGE

    let CONTENT_IMAGE : String

    CONTENT_TEXT

    let CONTENT_TEXT : String

    CONTENT_TOOL_RESULT

    let CONTENT_TOOL_RESULT : String

    CONTENT_TOOL_USE

    let CONTENT_TOOL_USE : String

    DELTA_INPUT_JSON

    let DELTA_INPUT_JSON : String

    DELTA_TEXT

    let DELTA_TEXT : String

    EVENT_CONTENT_BLOCK_DELTA

    let EVENT_CONTENT_BLOCK_DELTA : String

    EVENT_CONTENT_BLOCK_START

    let EVENT_CONTENT_BLOCK_START : String

    EVENT_CONTENT_BLOCK_STOP

    let EVENT_CONTENT_BLOCK_STOP : String

    EVENT_MESSAGE_DELTA

    let EVENT_MESSAGE_DELTA : String

    EVENT_MESSAGE_START

    let EVENT_MESSAGE_START : String

    EVENT_MESSAGE_STOP

    let EVENT_MESSAGE_STOP : String

    EVENT_PING

    let EVENT_PING : String

    ROLE_ASSISTANT

    let ROLE_ASSISTANT : String

    ROLE_SYSTEM

    let ROLE_SYSTEM : String

    ROLE_TOOL

    let ROLE_TOOL : String

    ROLE_USER

    let ROLE_USER : String

    STOP_END_TURN

    let STOP_END_TURN : String

    STOP_ERROR

    let STOP_ERROR : String

    STOP_MAX_TOKENS

    let STOP_MAX_TOKENS : String

    STOP_TOOL_USE

    let STOP_TOOL_USE : String

    TOOL_FUNCTION

    let TOOL_FUNCTION : String

    convert_claude_to_openai

    fn convert_claude_to_openai(request : ClaudeMessagesRequest, config : Config) -> Map[String, Json]

    convert_openai_to_claude_response

    fn convert_openai_to_claude_response(openai_response : Map[String, Json], original_model : String) -> Map[String, Json]

    load_env

    async fn load_env(path? : String) -> Unit

    从 .env 文件加载环境变量(默认路径为当前目录下的 .env)。 已存在的环境变量不会被覆盖。

    map_claude_model_to_openai

    fn map_claude_model_to_openai(claude_model : String, config : Config) -> String

    Maps Claude model names to OpenAI models.

    sse_content_block_start

    fn sse_content_block_start(index : Int) -> String

    sse_content_block_stop

    fn sse_content_block_stop(index : Int) -> String

    sse_error

    fn sse_error(message : String) -> String

    sse_message_delta

    fn sse_message_delta(stop_reason : String, input_tokens : Int, output_tokens : Int) -> String

    sse_message_start

    fn sse_message_start(message_id : String, model : String) -> String

    sse_message_stop

    fn sse_message_stop() -> String

    sse_ping

    fn sse_ping() -> String

    sse_text_delta

    fn sse_text_delta(index : Int, text : String) -> String

    start_server

    async fn start_server(config : Config) -> Unit