Skip to content

README_zh.md

Latest commit

 

History

History
106 lines (79 loc) · 2.84 KB

README_zh.md

File metadata and controls

106 lines (79 loc) · 2.84 KB

ClewdR

ClewdR

ClewdR 是面向 Claude（Claude.ai、Claude Code）的 Rust 代理。
它提供低资源占用的多端点转发，并附带一个 React 管理界面用于管理 Cookie 和配置。

核心特点

  • 对接 Claude Web、Claude Code。
  • 单个静态二进制可运行在 Linux、macOS、Windows、Android，另有 Docker 镜像。
  • 网页控制台可查看状态、编辑 Cookie，并支持热加载配置。
  • 同时支持 OpenAI 兼容接口和原生 Claude 协议，流式响应可用。
  • 典型占用：<10 MB 内存、<1 秒 启动、~15 MB 二进制。

支持的端点

服务 地址
Claude 原生 http://127.0.0.1:8484/v1/messages
Claude OpenAI 兼容 http://127.0.0.1:8484/v1/chat/completions
Claude Code http://127.0.0.1:8484/code/v1/messages

所有端点均支持流式返回。

快速开始

  1. 从 GitHub Releases 下载对应平台的最新版。
    Linux/macOS 示例： 
    curl -L -o clewdr.tar.gz https://github.com/Xerxes-2/clewdr/releases/latest/download/clewdr-linux-x64.tar.gz
tar -xzf clewdr.tar.gz && cd clewdr-linux-x64
chmod +x clewdr
  2. 运行二进制： 
    ./clewdr
  3. 打开 http://127.0.0.1:8484，使用控制台（或 Docker 容器日志）显示的管理员密码登录。

Web 管理界面

  • Dashboard：查看健康状态、限流命中、连接数。
  • Claude：粘贴浏览器导出的 Cookie，ClewdR 自动检测有效性。
  • Settings：修改管理员密码、上游代理、指纹配置，支持热重载。

如忘记密码，删除 clewdr.toml 再启动即可。Docker 建议挂载该文件所在目录以持久化。

配置上游

Claude

  1. 在浏览器开发者工具导出 Claude.ai Cookie。
  2. 粘贴至 Claude 页签并保存，ClewdR 会实时标记状态。
  3. 如需自定义网络出口，可设置上游代理或指纹选项。

客户端示例

SillyTavern：

{
  "api_url": "http://127.0.0.1:8484/v1/chat/completions",
  "api_key": "控制台显示的密码",
  "model": "claude-3-sonnet-20240229"
}

Continue（VS Code）：

{
  "models": [
    {
      "title": "Claude via ClewdR",
      "provider": "openai",
      "model": "claude-3-sonnet-20240229",
      "apiBase": "http://127.0.0.1:8484/v1/",
      "apiKey": "控制台显示的密码"
    }
  ]
}

Cursor：

{
  "openaiApiBase": "http://127.0.0.1:8484/v1/",
  "openaiApiKey": "控制台显示的密码"
}

资源

致谢

  • wreq 提供指纹识别能力。
  • Clewd 提供参考实现。
  • Clove 提供 Claude Code 相关逻辑。