caomeiyouren/claude-code-proxy

Claude Code Proxy

Claude Code Proxy是一款代理服务器，旨在让Claude Code能够与OpenAI兼容的API提供者协同工作。它可将Claude API请求转换为OpenAI API调用，使您能通过Claude Code CLI使用多种大语言模型（LLM）提供者的服务。

核心功能

• 完整Claude API兼容性：支持 /v1/messages 端点的全部功能
• 多提供者支持：兼容OpenAI、Azure OpenAI、本地模型（Ollama）及任何OpenAI兼容API
• 智能模型映射：通过环境变量配置BIG、MIDDLE、SMALL模型
• 函数调用：完整支持工具调用并进行适当转换
• 流式响应：实时SSE流式响应支持
• 图片支持：Base64编码图片输入
• 自定义头部：自动注入自定义HTTP头部到API请求
• 错误处理：全面的错误处理与日志记录

使用场景

• 开发者希望在Claude Code CLI中使用Open***系列模型
• 需要将Claude Code请求转发至Azure OpenAI服务
• 本地部署Ollama模型后，通过Claude Code CLI调用本地模型
• 需要统一管理多LLM提供者的API调用

配置说明

环境变量配置

应用会自动从项目根目录的 .env 文件加载环境变量，也可直接在Shell中设置。关键变量如下：

• 必填：OPENAI_API_KEY（目标提供者的API密钥）
• 安全验证：ANTHROPIC_API_KEY（客户端验证用的***密钥，可选）
• 模型映射：BIG_MODEL（Claude ***请求映射模型，默认gpt-4o）、MIDDLE_MODEL（Claude ***映射模型，默认gpt-4o）、SMALL_MODEL（Claude ***映射模型，默认gpt-4o-mini）
• API配置：OPENAI_BASE_URL（API基础URL，默认https://api.openai.com/v1%EF%BC%89
• 服务器设置：HOST（服务器地址，默认0.0.0.0）、PORT（端口，默认8082）

Docker部署示例

Docker Run命令

bash
docker run -d \
  -p 8082:8082 \
  --env OPENAI_API_KEY="sk-your-openai-key" \
  --env OPENAI_BASE_URL="https://api.openai.com/v1" \
  --env BIG_MODEL="gpt-4o" \
  docker.xuanyuan.run/caomeiyouren/claude-code-proxy

Docker Compose配置

yaml
version: '3'
services:
  claude-code-proxy:
    image: docker.xuanyuan.run/caomeiyouren/claude-code-proxy
    ports:
      - "8082:8082"
    environment:
      - OPENAI_API_KEY=sk-your-openai-key
      - OPENAI_BASE_URL=https://api.openai.com/v1
      - BIG_MODEL=gpt-4o
      - SMALL_MODEL=gpt-4o-mini
    restart: always

使用示例

与Claude Code CLI集成

bash
# 启动代理后，设置环境变量并使用Claude Code
ANTHROPIC_BASE_URL=http://localhost:8082 ANTHROPIC_API_KEY="any-value" claude

基础请求示例

python
import httpx
response = httpx.post(
    "http://localhost:8082/v1/messages",
    json={
        "model": "claude-3-5-sonnet-20241022",
        "max_tokens": 100,
        "messages": [{"role": "user", "content": "Hello!"}]
    }
)
print(response.json())

模型映射规则

自定义头部配置

通过CUSTOM_HEADER_前缀设置自定义HTTP头部，例如：

bash
CUSTOM_HEADER_ACCEPT="application/jsonstream"
CUSTOM_HEADER_USER_AGENT="my-app/1.0.0"

代理会自动将这些变量转换为对应的HTTP头部（如CUSTOM_HEADER_X_API_KEY转换为X-API-KEY）。