Claude Code Rust 是 Claude Code 的高性能 Rust 重构版本，提供原版 TypeScript 版本的所有核心功能，并在性能、内存安全和部署体积上实现显著优化。

• ⚡ 卓越性能：基于 Rust 的高性能实现，启动速度和执行效率大幅提升
• 🛡️ 内存安全：Rust 的所有权系统保证零运行时内存错误
• 📦 轻量部署：单文件可执行程序，无需 Node.js 运行时环境
• 🔧 完整功能：支持 CLI、REPL、GUI、插件系统等核心功能
• 🌐 多语言支持：内置国际化系统，支持中英文界面
• 🔌 插件架构：模块化设计，支持动态加载第三方插件
• 🎯 DCC 工具集成：支持 Blender、UE5 等数字内容创建工具

• 交互式 REPL：支持多行输入和命令历史
• 命令系统：内置 help、version、config、login 等命令
• 查询执行：支持单次查询和批处理模式
• Git 集成：内置 Git 命令支持（commit、push、PR 创建）

• 原生桌面应用：基于 egui 的跨平台 GUI
• 聊天界面：实时对话和历史记录
• 设置管理：图形化配置界面
• 主题支持：深色/浅色主题切换

• 内置技能：help、version、config-check 等基础技能
• 技能加载：支持动态加载和卸载技能模块
• 权限控制：细粒度的技能执行权限管理

• 文件操作：读取、编辑、写入文件
• 代码搜索：支持正则表达式和模式匹配
• 系统命令：安全的命令执行环境
• Git 工具：版本控制操作支持

• 动态加载：运行时加载和卸载插件
• 安全沙箱：插件隔离执行环境
• DCC 工具：Blender、UE5 等数字内容创建工具集成
• 生命周期管理：完整的插件生命周期支持

• 多语言界面：支持中文和英文显示
• 本地化文件：基于 JSON 的翻译文件系统
• 动态切换：运行时语言切换支持

• 分层配置：全局、用户、项目级配置
• 环境变量：支持环境变量覆盖
• 配置验证：自动配置验证和错误提示

基于实际代码库的模块组织：

src/
├── bootstrap/          # 启动引导和快速路径优化
├── cli/               # 命令行接口和参数解析
├── commands/          # 命令系统（auth、config、git、interactive 等）
├── config/            # 配置管理系统和系统提示
├── gui/               # 图形用户界面（egui 实现）
├── i18n/              # 国际化支持系统
├── tools/             # 工具系统（文件操作、搜索、Git 等）
├── skills/            # 技能加载和执行系统
├── plugins/           # 插件系统和安全沙箱
├── services/          # 服务层（代理、语音、API 等）
├── features/          # 特性模块（语音、协调器、工作流等）
├── mcp/               # 模型上下文协议客户端
├── security/          # 安全机制和权限控制
├── utils/             # 工具函数和辅助模块
├── memory/            # 记忆存储和会话管理
├── web/               # Web 服务器和插件市场
├── wasm/              # WebAssembly 支持模块
├── crates/dcc-tools/  # DCC 工具集成（Blender、UE5）
├── lib.rs             # 库入口点
└── main.rs            # 主程序入口点

• Rust 语言：现代系统编程语言，提供零成本抽象和内存安全保证
• Tokio：异步运行时，支持高性能并发 I/O 操作
• Clap：功能强大的命令行参数解析库
• Serde：高效的序列化和反序列化框架
• Reqwest：异步 HTTP 客户端，支持 API 调用
• Egui：即时模式 GUI 库，用于构建原生桌面界面
• Ratatui：终端用户界面库，支持 TUI 应用
• Axum：Web 框架，用于构建插件市场和 API 服务
• SQLx：异步 SQL 数据库工具包
• Tracing：结构化日志记录和诊断框架

• Rust 工具链：1.70+ 版本
• Cargo：Rust 包管理器
• Windows：需要 Visual Studio 构建工具（MSVC）或 MinGW
• macOS/Linux：标准开发环境

1. 安装 Rust 工具链

   # 使用 rustup 安装
   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

2. 克隆仓库

   git clone https://github.com/lorryjovens-hub/claude-code-rust.git
   cd claude-code-rust

3. 编译项目

   # 开发模式编译
   cargo build
   
   # 发布模式编译（推荐）
   cargo build --release

4. 运行应用

   # Windows
   .\target\release\claude.exe
   
   # macOS/Linux
   ./target/release/claude

在 Windows 上编译可能需要 Visual Studio 构建工具或 MinGW 环境：

# 如果遇到 libz-sys 编译问题，可以尝试：
set RUSTFLAGS=-C target-feature=+crt-static
cargo build --release

可以从 GitHub Releases 页面下载对应平台的预编译二进制文件。

为了方便区分和使用两个版本，推荐使用 PowerShell 配置：

# 1. 运行配置脚本
.\scripts\setup-powershell.ps1

# 2. 重新加载配置
. $PROFILE

# 3. 验证配置
claude-rust --version
claude-npm --version

编辑 PowerShell 配置文件：

# 打开配置文件
notepad $PROFILE

# 添加以下内容
function claude-rust {
    & "C:\迅雷下载\claude-code-rev-main\claude-code-rust\bin\claude.exe" @args
}

function claude-npm {
    & "C:\Users\user\AppData\Roaming\npm\claude" @args
}

详细配置说明请参考 INSTALL.md。

# 查看版本信息（明确标识为 Rust 版本）
claude --version
# 输出: 0.1.1 (Claude Code Rust - High-performance implementation)

# 查看帮助信息
claude --help

# 进入交互式 REPL 模式
claude
# 或
claude interactive

# 执行单次查询
claude query "请帮我分析这段代码"
# 或使用简写
claude q "你的问题"

# 查看当前配置
claude config

# 登录到 Claude API
claude login

# 退出登录
claude logout

# 检查系统配置
claude config-check

# 提交更改并创建 PR
claude git commit-push-pr "提交描述"

# 查看 Git 状态
claude git status

# 启动 GUI 桌面应用
claude gui

# 启动终端用户界面 (TUI)
claude tui

# 列出所有可用技能
claude skills list

# 执行帮助技能
claude help

# 显示版本信息
claude version

# 检查更新
claude upgrade check

# 执行自动升级（推荐）
claude upgrade execute

# 手动升级
# 1. 拉取最新代码
git pull origin master
# 2. 重新编译
cargo build --release

• claude upgrade check - 检查是否有新版本可用
• claude upgrade execute - 自动拉取最新代码并重新编译
• 手动升级 - 当自动升级失败时，可以使用git和cargo命令手动升级

1. 检查更新：运行 claude upgrade check 查看是否有新版本
2. 执行升级：运行 claude upgrade execute 自动完成升级
3. 重启应用：升级完成后需要重启Claude Code Rust以使用新版本

• 自动升级失败：通常是因为网络问题或权限问题，可以尝试手动升级
• 编译错误：如果编译失败，可能需要更新Rust工具链或解决依赖问题
• 版本检查失败：如果无法连接GitHub API，可以直接访问GitHub仓库查看最新版本

Claude Code Rust 采用模块化架构设计，主要模块包括：

• bootstrap/：启动引导、快速路径优化和宏配置系统
• cli/：命令行接口、参数解析和 REPL 实现
• commands/：命令系统，包括认证、配置、Git、交互式等命令
• config/：配置管理、系统提示和环境设置
• gui/：基于 egui 的图形用户界面
• tools/：工具系统，提供文件操作、搜索、命令执行等能力
• skills/：技能加载、注册和执行系统
• plugins/：插件框架和安全沙箱机制

1. 在 src/commands/ 目录下创建新的命令模块
2. 实现 CmdExecutor trait
3. 在命令注册系统中注册新命令

1. 在 src/skills/ 目录下创建技能模块
2. 实现 Skill trait
3. 在技能加载器中注册新技能

参考 PLUGIN_DEVELOPMENT.md 文档了解插件开发流程和 API。

# 运行所有测试
cargo test

# 运行特定测试
cargo test test_command_system

# 代码质量检查
cargo clippy -- -D warnings

# 代码格式化
cargo fmt

# 构建文档
cargo doc --open

1. Fork 仓库：创建个人 fork

2. 创建分支：使用描述性的分支名称

   git checkout -b feat/add-new-command

3. 实现功能：遵循项目代码规范

4. 添加测试：为新功能编写测试用例

5. 提交更改：使用规范的提交消息

   feat: 添加新的配置命令
   fix: 修复登录认证问题
   docs: 更新 README 文档
   refactor: 重构命令执行器
   

6. 推送分支：推送到您的 fork

   git push origin feat/add-new-command

7. 创建 PR：在 GitHub 上创建 Pull Request

• 命名约定：使用蛇形命名法（snake_case）用于变量和函数，大驼峰命名法（PascalCase）用于类型
• 错误处理：使用 anyhow::Result 或自定义错误类型
• 文档注释：公共 API 必须包含文档注释
• 测试覆盖：新功能应包含单元测试和集成测试

# 运行完整的测试套件
cargo test --all-features

# 检查测试覆盖率
cargo tarpaulin --ignore-tests --out html

# 运行性能基准测试
cargo bench

本项目采用 MIT 许可证 - 详见 LICENSE 文件。

作为 Rust 重构版本，Claude Code Rust 在多个维度上提供显著性能改进：

• 冷启动时间：毫秒级启动，无需 Node.js 运行时初始化
• 热启动优化：利用系统级缓存，实现极速启动

• 内存占用：原生二进制执行，内存开销显著降低
• 部署体积：单文件分发，无需庞大的 node_modules 目录
• CPU 利用率：高效的异步运行时，更好的多核利用

• 命令响应：原生机器码执行，无解释器开销
• I/O 操作：基于 Tokio 的高效异步 I/O
• 并发处理：无锁数据结构和高效的并发原语

• 内存安全：Rust 编译器保证零运行时内存错误
• 线程安全：编译时数据竞争检测
• 沙箱隔离：插件系统的安全执行环境

• 完善插件系统：提供更丰富的插件开发 API 和示例
• 增强 DCC 集成：深化 Blender 和 UE5 工具链集成
• 改进 GUI 体验：优化用户界面和交互流程
• 扩展技能库：添加更多实用技能和工具

• 云同步功能：配置和状态的跨设备同步
• 团队协作：多人协作和共享工作空间
• 高级分析：代码质量分析和性能洞察
• 市场生态：插件市场和技能商店

• 全平台支持：移动端和嵌入式设备支持
• AI 模型集成：本地 AI 模型和混合推理
• 企业功能：企业级部署和管理工具
• 生态系统：完整的开发者工具链生态

• PLUGIN_DEVELOPMENT.md - 插件开发指南
• ARCHITECTURE.md - 系统架构设计文档
• PERFORMANCE_COMPARISON.md - 性能对比分析
• CHANGELOG.md - 版本更新日志
• CONTRIBUTING.md - 贡献者指南

A: Rust 版本提供更好的性能、内存安全和部署效率，同时保持了核心功能兼容性。界面会明确标识为 "Claude Code Rust"。

A: 建议使用不同的命令别名，如 claude-rust 和 claude-npm，具体配置方法参见安装部分。

A: Windows 需要 Visual Studio 构建工具或 MinGW 环境，也可以直接下载预编译的二进制文件。

A: 插件系统设计为兼容原版插件架构，但可能需要适配器或重新编译。

• GitHub Issues：问题报告
• 文档反馈：飞书文档
• 社区交流：B站关注 lorry黄同学

Claude Code Rust - 为性能和安全而生的 AI 开发工具链