Claude2Api

将 Claude 的 Web 服务转换为 API 服务，支持图像识别、文件上传、流式传输、思维过程输出等。

该 API 支持 OpenAI 格式的访问。

|中文

注意：只有 Pro 用户才能使用所有模型，免费用户仅能使用 claude-sonnet-4-20250514。

✨ 功能

• 🖼️ 图像识别 - 将图片发送给 Claude 进行分析
• 📝 自动会话管理 - 会话在使用后可自动删除
• 🌊 流式响应 - 获取来自 Claude 的实时流式输出
• 📁 文件上传支持 - 上传长上下文
• 🧠 思考过程 - 访问 Claude 的逐步推理过程，支持 <think> 标签
• 🔄 聊天历史管理 - 控制对话上下文长度，超出时会上传文件
• 🌐 代理支持 - 通过您首选的代理路由请求
• 🔐 API 密钥认证 - 保护您的 API 端点
• 🔁 自动重试 - 请求失败时自动重试的功能
• 🌐 直接代理 - 可以使用 sk-ant-sid01* 作为密钥来使用

📋 前置条件

• Go 1.23+（用于从源代码构建）
• Docker（用于容器化部署）

🚀 部署选项

Docker

docker run -d \
  -p 8080:8080 \
  -e SESSIONS=sk-ant-sid01-xxxx,sk-ant-sid01-yyyy \
  -e APIKEY=123 \
  -e CHAT_DELETE=true \
  -e MAX_CHAT_HISTORY_LENGTH=10000 \
  -e NO_ROLE_PREFIX=false \
  -e PROMPT_DISABLE_ARTIFACTS=false \
  -e ENABLE_MIRROR_API=false \
  -e MIRROR_API_PREFIX=/mirror \
  --name claude2api \
  ghcr.io/yushangxiao/claude2api:latest

Docker Compose

创建一个 docker-compose.yml 文件：

version: '3'
services:
  claude2api:
    image: ghcr.io/yushangxiao/claude2api:latest
    container_name: claude2api
    ports:
      - "8080:8080"
    environment:
      - SESSIONS=sk-ant-sid01-xxxx,sk-ant-sid01-yyyy
      - ADDRESS=0.0.0.0:8080
      - APIKEY=123
      - PROXY=http://proxy:2080  # 可选
      - CHAT_DELETE=true
      - MAX_CHAT_HISTORY_LENGTH=10000
      - NO_ROLE_PREFIX=false
      - PROMPT_DISABLE_ARTIFACTS=true
      - ENABLE_MIRROR_API=false
      - MIRROR_API_PREFIX=/mirror
    restart: unless-stopped

然后运行：

docker-compose up -d

Hugging Face Spaces

您可以使用 Docker 将此项目部署到 Hugging Face Spaces：

1. 分叉 Hugging Face Space：https://huggingface.co/spaces/rclon/claude2api
2. 在“设置”选项卡中配置您的环境变量
3. 该 Space 将自动部署 Docker 镜像

注意：在 Hugging Face 中，/v1 可能会被阻止，您可以改用 /hf/v1。

直接部署

# 克隆仓库
git clone https://github.com/yushangxiao/claude2api.git
cd claude2api
cp .env.example .env  
vim .env  
# 构建二进制文件
go build -o claude2api .

./claude2api

⚙️ 配置

YAML 配置

您可以在应用程序根目录下使用 config.yaml 文件来配置 Claude2API。如果该文件存在，则会优先于环境变量使用。

示例 config.yaml：

# 会话配置
sessions:
  - sessionKey: "sk-ant-sid01-xxxx"
    orgID: ""
  - sessionKey: "sk-ant-sid01-yyyy"
    orgID: ""

# 服务器地址
address: "0.0.0.0:8080"

# API 认证密钥
apiKey: "123"

# 其他配置选项...
chatDelete: true
maxChatHistoryLength: 10000
noRolePrefix: false
promptDisableArtifacts: false
enableMirrorApi: false
mirrorApiPrefix: ""

仓库中提供了一个名为 config.yaml.example 的示例配置文件。

环境变量

如果 config.yaml 不存在，则应用程序将使用环境变量进行配置：

环境变量	描述	默认值
SESSIONS	用逗号分隔的 Claude API 会话密钥列表	必填
ADDRESS	服务器地址和端口	0.0.0.0:8080
APIKEY	用于认证的 API 密钥	必填
PROXY	HTTP 代理 URL	可选
CHAT_DELETE	是否在使用后删除聊天会话	true
MAX_CHAT_HISTORY_LENGTH	超出时将文本保存到文件	10000
NO_ROLE_PREFIX	不在每条消息前添加角色	false
PROMPT_DISABLE_ARTIFACTS	尝试禁用提示中的 Artifacts	false
ENABLE_MIRROR_API	启用直接使用 sk-ant-* 作为密钥	false
MIRROR_API_PREFIX	添加前缀以保护镜像，当 ENABLE_MIRROR_API 为 true 时必需	``

📝 API 使用

认证

在请求头中包含您的 API 密钥：

Authorization: Bearer YOUR_API_KEY

聊天完成

curl -X POST http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "claude-3-7-sonnet-20250219",
    "messages": [
      {
        "role": "user",
        "content": "你好，Claude！"
      }
    ],
    "stream": true
  }'

图像分析

curl -X POST http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "claude-3-7-sonnet-20250219",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "这张图片里有什么？"
          },
          {
            "type": "image_url",
            "image_url": {
              "url": "data:image/jpeg;base64,..."
            }
          }
        ]
      }
    ]
  }'

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

1. 分叉仓库
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '添加一些很棒的功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开 Pull Request

📄 许可证

本项目采用 MIT 许可证授权 - 详情请参阅 LICENSE 文件。

🙏 致谢

• Anthropic 创造了 Claude
• Go 社区提供了出色的生态系统

---

🎁 支持

如果您觉得这个项目很有帮助，请考虑在 Afdian 上支持我 😘

星标历史

由 yushangxiao 用心制作

Claude2API 快速上手指南

Claude2API 是一个将 Claude 网页服务转换为 API 服务的开源工具，支持图片识别、文件上传、流式传输及思维链输出。其接口完全兼容 OpenAI 格式，方便接入现有应用。

注意：仅 Pro 用户可使用所有模型，免费用户仅限使用 claude-sonnet-4-20250514。

环境准备

在部署前，请确保您的系统满足以下任一条件：

• 方案 A（推荐）: 已安装 Docker 或 Docker Compose。
• 方案 B（源码编译）: 已安装 Go 1.23+ 版本。

安装步骤

方式一：使用 Docker（推荐）

这是最快捷的部署方式。运行以下命令即可启动服务，请将 SESSIONS 替换为您真实的 Claude Session Key（格式为 sk-ant-sid01-...），将 APIKEY 设置为您自定义的访问密钥。

docker run -d \
  -p 8080:8080 \
  -e SESSIONS=sk-ant-sid01-xxxx,sk-ant-sid01-yyyy \
  -e APIKEY=123 \
  -e CHAT_DELETE=true \
  -e MAX_CHAT_HISTORY_LENGTH=10000 \
  --name claude2api \
  ghcr.io/yushangxiao/claude2api:latest

国内加速提示：如果拉取 ghcr.io 镜像较慢，可配置 Docker 镜像加速器，或使用代理环境变量 -e PROXY=http://your-proxy:port。

方式二：使用 Docker Compose

创建 docker-compose.yml 文件：

version: '3'
services:
  claude2api:
    image: ghcr.io/yushangxiao/claude2api:latest
    container_name: claude2api
    ports:
      - "8080:8080"
    environment:
      - SESSIONS=sk-ant-sid01-xxxx,sk-ant-sid01-yyyy
      - ADDRESS=0.0.0.0:8080
      - APIKEY=123
      - CHAT_DELETE=true
      - MAX_CHAT_HISTORY_LENGTH=10000
    restart: unless-stopped

执行启动命令：

docker-compose up -d

方式三：源码直接部署

适合需要自定义构建或调试的开发者。

# 克隆仓库
git clone https://github.com/yushangxiao/claude2api.git
cd claude2api

# 复制并编辑配置文件
cp .env.example .env  
vim .env  # 在此文件中填入 SESSIONS 和 APIKEY

# 编译二进制文件
go build -o claude2api .

# 运行
./claude2api

基本使用

服务启动后，默认监听 8080 端口。您可以使用兼容 OpenAI 格式的客户端或直接通过 curl 调用。

1. 基础对话

请求头需携带您在环境变量中设置的 APIKEY。

curl -X POST http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 123" \
  -d '{
    "model": "claude-3-7-sonnet-20250219",
    "messages": [
      {
        "role": "user",
        "content": "你好，请介绍一下你自己。"
      }
    ],
    "stream": true
  }'

2. 图片识别

支持发送 Base64 编码的图片进行分析：

curl -X POST http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 123" \
  -d '{
    "model": "claude-3-7-sonnet-20250219",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "这张图片里有什么？"
          },
          {
            "type": "image_url",
            "image_url": {
              "url": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
            }
          }
        ]
      }
    ]
  }'

关键配置说明

• SESSIONS: 多个 Session Key 请用逗号分隔，工具会自动轮询使用。
• CHAT_DELETE: 设为 true 可在每次请求后自动清理对话上下文，节省额度。
• PROXY: 若服务器无法直接访问 Claude，可在此处配置 HTTP 代理地址。
• Hugging Face 部署: 若部署在 HF Spaces，接口路径可能需要调整为 /hf/v1。