lorryjovens-hub/claude-code-rust：Claude Code 的 Rust 全量重构版本，通过原生编译实现 2.5 倍启动加速与 97% 体积缩减，提供零依赖、内存安全的轻量级 AI本页整理它解决什么问题、适用场景、安装方式和使用方法。
Claude Code 的 Rust 全量重构版本，通过原生编译实现 2.5 倍启动加速与 97% 体积缩减，提供零依赖、内存安全的轻量级 AI 编程助手 CLI 工具。
Claude Code Rust 是 Anthropic 官方 Claude Code 工具的 Rust 语言全量重构版本，定位为高性能、轻量级的本地 AI 编程助手。项目完全复刻原版功能，提供代码编辑、自动补全、问题解答、终端命令执行等核心能力，同时通过系统级语言优化带来质的性能提升。作为单文件分发的 CLI 工具，它支持直接运行、REPL 交互模式、MCP 服务器集成以及丰富的插件生态，旨在为开发者提供快速、可靠、安全的 AI 辅助编码体验，适用于从个人项目到企业级部署的各类场景。
原 TypeScript 版本的 Claude Code 存在启动延迟高（平均 158ms）、部署体积大（npm 安装后 164MB，含 156MB node_modules）、内存占用峰值超 300MB、依赖 Node.js 运行时以及垃圾回收导致的性能突刺等问题。Claude Code Rust 通过 Rust 原生编译彻底解决这些痛点：启动时间压缩至 63ms（2.5 倍提升），二进制文件仅 5MB（体积减少 97%），基础内存占用约 10MB（5 倍降低），零运行时依赖消除环境配置成本，所有权系统保证内存安全并完全避免 GC 停顿，为 AI IDE 工具链带来革命性的效率与稳定性提升。
Claude Code Rust 适用于多种开发场景：个人开发者可在终端中快速启动 REPL 进行交互式代码生成与调试；团队项目支持通过配置文件统一管理插件、权限规则与 hooks，实现组织级标准化；CI/CD 流水线可调用其命令行接口执行代码审查与自动化任务；资源受限环境（如容器、边缘设备）受益于 5MB 的极小体积与低内存占用；MCP 协议支持使其能作为服务器集成到第三方 IDE 或工具链中。无论是日常编码、代码迁移、文档生成还是安全合规审计，该工具都能提供高效、可靠的 AI 辅助能力。
项目提供三种安装途径以满足不同需求：最简方式是从 GitHub Releases 页面下载预编译的静态二进制文件（约 5MB），解压即可直接运行，支持 Windows、Linux 和 macOS；开发者可使用 Rust 工具链通过 cargo install claude_code_rs 命令从源码编译安装，自动处理依赖并适配本地平台；容器化部署可通过 Docker 镜像实现，使用 docker run --env-file .env -it claude-code-rust repl 命令并挂载配置文件。所有方式均需提前准备 .env 文件，配置 ANTHROPIC_API_KEY 或 DASHSCOPE_API_KEY 等必要环境变量以启用 API 访问功能。
工具采用典型的 CLI 交互模式：直接运行 claude-code 命令默认启动 REPL 交互终端，支持多轮对话与上下文记忆；使用 claude-code --version 可查看版本信息，claude-code --help 获取完整命令参考。核心功能包括代码文件读写、终端命令执行、Git 操作、搜索替换等，所有操作均可通过自然语言指令触发。高级用法涉及配置文件（~/.config/claude_code/config.toml）管理插件加载、hooks 规则、MCP 服务器连接及企业级权限策略。项目还提供独立 GUI 版本二进制 claude-code-gui，满足图形界面需求。详细命令与参数说明参考官方文档与示例配置。
项目架构采用分层设计：CLI 层基于 clap 实现参数解析与子命令路由；异步层通过 tokio 运行时支撑高并发网络与文件操作；HTTP 层使用 reqwest 与支持 rustls 的 TLS 连接 Anthropic 或 DashScope API；业务层处理会话管理、工具调用与流式响应；UI 层由 crossterm 和 ratatui 构建响应式终端界面。配置系统支持用户、项目、企业三级覆盖，集成权限校验与 PreToolUse hooks。插件系统支持动态加载与命令注册，MCP 协议提供标准化工具集成接口。代码库同时包含上游 TypeScript 版本的源码还原目录（claude-code-rev-main）与插件示例集，便于开发者参考与扩展。
主要区别在于实现语言与性能指标：Rust 版本通过原生编译实现启动速度 2.5 倍提升（63ms vs 158ms）、二进制体积仅 5MB（减少 97%）、内存占用降低 10 倍以上，且零依赖、无 GC 停顿。功能上保持 100% 兼容，支持相同的 CLI 命令、REPL 交互、插件系统和 MCP 协议。
提供三种方式：① 从 GitHub Releases 下载预编译二进制文件（5MB），解压后直接运行；② 使用 Rust 工具链执行 cargo install claude_code_rs 从源码编译；③ 通过 Docker 镜像部署，使用 docker run --env-file .env -it claude-code-rust repl。所有方式均需提前配置 .env 文件中的 API 密钥。
在项目根目录创建 .env 文件（可复制 .env.example 模板），设置 ANTHROPIC_API_KEY 或 DASHSCOPE_API_KEY 环境变量，可选配置 CLAUDE_MODEL 指定模型版本（如 claude-3-5-sonnet-20241022）、RUST_LOG 调整日志级别，以及 HTTP_PROXY/HTTPS_PROXY 设置代理。Docker 部署时可通过 --env-file 参数挂载该配置文件。
基准测试在标准开发环境下进行，使用 time 命令测量冷启动、热启动与命令执行时间，对比对象为官方 TypeScript 版本。测试涵盖 100 次启动、50 个并发实例、配置查询等典型场景，结果多次运行取平均值。详细测试方法与原始数据可在项目仓库的 README 性能基准部分查阅。
项目明确支持 Windows、Linux 和 macOS 三大桌面平台，预编译二进制已为各平台单独打包。基于 Rust 的跨平台特性，理论上也可编译至其他目标（如 BSD 变种），但官方仅提供上述三平台的 Release 构建。Docker 镜像则提供统一的 Linux 容器化运行环境。