Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
Clove 是一个让你能够通过标准 Claude API 访问 Claude.ai 的反向代理工具。简单来说，它让各种 AI 应用都能连接上 Claude！
最大亮点：Clove 是首个支持通过 OAuth 认证访问 Claude 官方 API 的反向代理（就是 Claude Code 用的那个）！这意味着你能享受到完整的 Claude API 功能，包括原生系统消息和预填充等高级特性。
docker run -d --name clove --restart unless-stopped \
-p 5201:5201 -v ./data:/data \
-e HOST=0.0.0.0 -e PORT=5201 -e DATA_FOLDER=/data \
-e LOG_LEVEL=INFO -e LOG_TO_FILE=true -e LOG_FILE_PATH=/data/logs/app.log \
ghcr.io/huan-zhaojun/clove:latestmkdir -p clove && cd clove
curl -sO https://raw.githubusercontent.com/Huan-zhaojun/clove/main/docker-compose.yml
docker compose up -d- 打开浏览器访问：http://localhost:5201
- 使用控制台显示的临时管理密钥登录
- 添加你的 Claude 账户，开始使用！
💡 首次启动会在控制台显示随机生成的临时管理密钥，登录后记得设置自己的密钥。
- OAuth 模式：优先使用，可以访问 Claude API 的全部功能
- 网页反代模式：当 OAuth 不可用时自动切换，通过模拟 Claude.ai 网页版实现
与其他反代工具（如 Clewd）相比，Clove 的兼容性非常出色：
- ✅ 完全支持 SillyTavern
- ✅ 支持绝大部分使用 Claude API 的应用
- ✅ 甚至支持 Claude Code 本身！
- 完全访问 Claude API 的全部功能
- 支持原生系统消息
- 支持预填充功能
- 性能更好，更稳定
Clove 处理了 Claude.ai 网页版与 API 的各种差异：
- 图片上传支持
- 扩展思考（思维链）支持
即使是通过网页反代，Clove 也能让你使用原本不支持的功能：
- 工具调用（Function Calling）
- 停止序列（Stop Sequences）
- Token 计数（估算值）
- 非流式传输
Clove 尽可能让 Claude.ai 网页反代更接近 API，以期在所有应用程序中获得无缝体验。
- 现代化的 Web 管理界面
- 无需编辑配置文件
- 所有设置都能在管理页面上完成
- 自动管理用户配额和状态
- 自动 OAuth 认证：通过 Cookie 自动完成，无需手动登录 Claude Code
- 智能切换：自动在 OAuth 和 Claude.ai 网页反代之间切换
- 配额管理：超出配额时自动标记并在重置时恢复
Clove 依赖 curl_cffi 来请求 claude.ai，但这个依赖无法在 Termux 上运行。
解决方案：
- 使用不含 curl_cffi 的版本：pip install clove-proxy
- ✅ 通过 OAuth 访问 Claude API（需要在管理页面手动完成认证）
- ❌ 无法使用网页反代功能
- ❌ 无法自动完成 OAuth 认证
- 使用反向代理/镜像（如 fuclaude）
- ✅ 可以使用全部功能
- ❌ 需要额外的服务器（既然有搭建镜像的服务器，为什么要在 Termux 上部署呢 www）
如果你使用网页反代模式，避免接入会大量并行执行工具调用的应用。
- Clove 需要保持与 Claude.ai 的连接等待工具调用结果
- 过多并行调用会耗尽连接导致失败
- OAuth 模式不受此限制
当 Clove 使用网页反代时，Claude.ai 会在提示中添加额外的系统提示词和文件上传结构。当使用对结构要求高的提示词（如 RP 预设）时：
- 你可以预估请求将通过何种方式进行。在默认配置下：
- 使用 Free 账户时，所有请求通过 Claude.ai 网页反代
- 使用 Pro 账户时，Sonnet 模型通过 Claude API，Opus 模型通过 Claude.ai 网页反代
- 使用 Max 账户时，所有请求通过 Claude API 进行
- 若存在多账户，Clove 始终优先使用可访问该模型 API 的账户
- 请选择与请求方式兼容的提示词
虽然大部分配置都能在管理界面完成，但你也可以通过环境变量进行设置：
# 端口配置
PORT=5201
# 管理密钥（不设置则自动生成）
ADMIN_API_KEYS==your-secret-key
# Claude.ai Cookie
COOKIES=sessionKey=your-session-key更多配置请见 .env.example 文件。
配置完成后，你可以像使用标准 Claude API 一样使用 Clove：
import anthropic
client = anthropic.Anthropic(
base_url="http://localhost:5201",
api_key="your-api-key" # 在管理界面创建
)
response = client.messages.create(
model="claude-opus-4-20250514",
messages=[{"role": "user", "content": "Hello, Claude!"}],
max_tokens=1024,
)欢迎贡献代码！如果你有好的想法或发现了问题：
- Fork 这个项目
- 创建你的功能分支 (git checkout -b feature/AmazingFeature)
- 提交你的修改 (git commit -m 'Add some AmazingFeature')
- 推送到分支 (git push origin feature/AmazingFeature)
- 开一个 Pull Request
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
- Anthropic Claude - 可爱的小克 强大的 AI 助手
- Clewd - 初代 Claude.ai 反向代理
- ClewdR - 高性能 Claude.ai 反向代理
- FastAPI - 现代、快速的 Web 框架
- Tailwind CSS - CSS 框架
- Shadcn UI - 现代化的 UI 组件库
- Vite - 现代化的前端构建工具
- React - JavaScript 库
本项目仅供学习和研究使用。使用本项目时，请遵守相关服务的使用条款。作者不对任何滥用或违反服务条款的行为负责。
如有问题或建议，欢迎通过以下方式联系：
- 提交 Issue
- 发送 Pull Request
- 发送邮件至：orange@freesia.ink
丁香，桃金娘科蒲桃属植物，是一种常见的香料，也可用作中药。丁香（Clove）与丁香花（Syringa）是两种不同的植物哦~在本项目中，Clove 更接近 Claude 和 love 的合成词呢！