MCPcopy Index your code
hub / github.com/Xerxes-2/clewdr

github.com/Xerxes-2/clewdr @v0.12.25

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.12.25 ↗ · + Follow
491 symbols 836 edges 85 files 112 documented · 23%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

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 示例: bash 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. 运行二进制: bash ./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 相关逻辑。

Extension points exported contracts — how you extend this code

LLMProvider (Interface)
(no doc) [2 implementers]
src/providers/mod.rs
CheckClaudeErr (Interface)
(no doc) [1 implementers]
src/error.rs
AuthStatus (Interface)
(no doc)
frontend/src/types/auth.types.ts
AuthProps (Interface)
(no doc)
frontend/src/types/auth.types.ts
Tab (Interface)
(no doc)
frontend/src/types/ui.types.ts
StatusMessageProps (Interface)
(no doc)
frontend/src/types/ui.types.ts
ButtonProps (Interface)
(no doc)
frontend/src/types/ui.types.ts

Core symbols most depended-on inside this repo

return_cookie
called by 11
src/claude_code_state/mod.rs
check_claude
called by 10
src/error.rs
collect
called by 10
src/services/cookie_actor.rs
into_response
called by 9
src/api/error.rs
admin_auth
called by 8
src/config/clewdr_config.rs
formatIsoTimestamp
called by 7
frontend/src/utils/formatters.ts
build
called by 7
src/router.rs
exchange_code
called by 7
src/claude_code_state/exchange.rs

Shape

Method 190
Function 162
Class 70
Interface 36
Enum 33

Languages

Rust77%
TypeScript23%

Modules by API surface

src/types/claude.rs64 symbols
src/config/cookie.rs33 symbols
src/services/cookie_actor.rs27 symbols
src/claude_code_state/chat.rs24 symbols
src/middleware/claude/request.rs17 symbols
tests/image_conversion_test.rs16 symbols
frontend/src/components/claude/CookieVisualization.tsx16 symbols
src/providers/claude/mod.rs14 symbols
src/api/misc.rs13 symbols
src/router.rs12 symbols
src/config/clewdr_config.rs12 symbols
src/claude_web_state/mod.rs12 symbols

For agents

$ claude mcp add clewdr \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page