claudex CLAUDE.md

Claudex - Claude Code 项目指南

项目概述

Claudex 是一个 Rust 实现的多实例 Claude Code 管理器，内置智能翻译代理。它通过本地 proxy 将 Claude Code 的 Anthropic API 请求翻译并转发到多种 AI 提供商。

技术栈

• 语言: Rust (Edition 2021)
• 异步运行时: Tokio
• Web 框架: Axum 0.8
• HTTP 客户端: reqwest (rustls-tls)
• TUI: ratatui + crossterm
• 配置: TOML (toml crate)
• 日志: tracing + tracing-subscriber
• 错误处理: anyhow + thiserror

项目结构

src/
├── main.rs              # 入口 + CLI dispatch
├── cli.rs               # clap 子命令定义
├── config.rs            # 配置解析（API key 直接存 config，不自动读 keyring）
├── profile.rs           # Profile 管理
├── launch.rs            # 启动 claude 进程（含 Claude OAuth 特殊处理）
├── oauth/               # OAuth 订阅认证
│   ├── mod.rs           # AuthType, OAuthProvider, OAuthToken 类型
│   ├── token.rs         # 外部 CLI token 读取（Codex/Claude/Gemini）
│   ├── server.rs        # 本地回调服务器 + Device Code 轮询
│   └── providers.rs     # 各平台登录/刷新/状态逻辑
├── daemon.rs            # PID 文件 + 进程管理
├── metrics.rs           # 请求指标
├── proxy/               # 翻译代理
│   ├── mod.rs           # Axum server
│   ├── handler.rs       # 请求处理
│   ├── translation.rs   # Anthropic ↔ OpenAI 翻译
│   ├── streaming.rs     # SSE 流式翻译
│   ├── fallback.rs      # 断路器
│   ├── health.rs        # 健康检查
│   └── models.rs        # /v1/models 端点
├── router/              # 智能路由
│   ├── mod.rs
│   └── classifier.rs    # 意图分类
├── context/             # 上下文引擎
│   ├── mod.rs
│   ├── compression.rs   # 对话压缩
│   ├── sharing.rs       # 跨 profile 共享
│   └── rag.rs           # 本地 RAG
└── tui/                 # TUI 仪表盘
    ├── mod.rs
    ├── dashboard.rs
    ├── widgets.rs
    └── input.rs

构建与运行

# 开发构建
cargo build

# Release 构建
cargo build --release

# 检查
cargo check

# Clippy 检查
cargo clippy

# 运行
cargo run -- profile list
cargo run -- run grok
cargo run -- proxy start

核心概念

Provider Types

• DirectAnthropic: 原生 Anthropic API，直接转发（Anthropic、MiniMax）
• OpenAICompatible: OpenAI 兼容 API，需要协议翻译（OpenRouter、Grok、OpenAI、DeepSeek、Kimi、GLM、Ollama）