legard/claude-code-proxy

Claude Code Proxy

镜像概述

Claude Code Proxy是一款代理服务器，可让Claude Code CLI与OpenAI兼容的API提供商协同工作。它能将Claude API请求转换为OpenAI API调用，使您可以通过Claude Code界面使用多种大语言模型提供商（如OpenAI、Azure OpenAI、本地模型等）。

核心功能

• 完全兼容Claude API（支持/v1/messages端点）
• 多提供商支持（OpenAI、Azure OpenAI、Ollama及任何OpenAI兼容API）
• 通过环境变量实现智能模型映射
• 完整支持工具调用/函数调用功能
• 基于SSE的流式响应
• 支持Base64编码的图片输入
• 自定义HTTP头注入

使用场景

适用于希望通过Claude Code CLI界面访问不同OpenAI兼容大语言模型的开发者，可灵活切换模型提供商（包括本地部署的模型如Ollama），满足多样化的开发需求。

配置说明

快速启动

Docker Run方式

bash
docker run -d \
  --name claude-proxy \
  -p 8082:8082 \
  -e OPENAI_API_KEY="您的OpenAI密钥" \
  -e BIG_MODEL="gpt-4o" \
  -e SMALL_MODEL="gpt-4o-mini" \
  docker.xuanyuan.run/legard/claude-code-proxy:latest

Docker Compose方式

yaml
services:
  proxy:
    image: docker.xuanyuan.run/legard/claude-code-proxy:latest
    ports:
      - "8082:8082"
    env_file:
      - .env

环境变量配置

必填变量

• OPENAI_API_KEY：目标提供商的API密钥

可选配置

• BIG_MODEL：用于Claude ***请求的模型（默认：gpt-4o）
• SMALL_MODEL：用于Claude ***请求的模型（默认：gpt-4o-mini）
• OPENAI_BASE_URL：OpenAI兼容提供商的自定义API端点
  • 默认值：https://api.openai.com/v1
  • 示例：
    • Azure OpenAI：https://您的资源.openai.azure.com/openai/deployments/您的部署
    • Ollama：http://localhost:11434/v1
    • 其他兼容API：任何OpenAI兼容的端点

更多配置细节请参考https://github.com/fuergaosi233/claude-code-proxy#configuration

与Claude Code配合使用

bash
ANTHROPIC_BASE_URL=http://localhost:8082 claude

相关链接

• https://github.com/fuergaosi233/claude-code-proxy
• https://github.com/fuergaosi233/claude-code-proxy#readme
• https://github.com/fuergaosi233/claude-code-proxy/issues

支持平台

• linux/amd64
• linux/arm64