Sudo Code：Rust 终端编码 Agent

项目简介

Sudo Code（命令为 scode）是一个用 Rust 编写的终端编码 Agent，面向习惯在终端里工作的开发者。它可以修改文件、运行工具、保留可读的会话记录，并与你自行选择的模型服务商配合使用。既可以在终端里交互式使用，也可以放进 shell 脚本，或通过 ACP 协议从编辑器、Sudowork 等客户端调用。

整个项目以 MIT 协议开源。在整体架构中，Sudo Code 提供 Agent 引擎，Sudowork 提供界面，Nexus 提供存储、通信与托管运行时服务。

主要功能

• 终端原生：交互式会话、一次性任务、JSON 输出等多种运行方式。
• 可组合：输出内联在终端中，便于与 shell 管道和脚本配合。
• 会话可恢复：保存的会话包含压缩的原始响应记录，便于排查流式与协议问题；记录附有大小限制并可关闭。
• 自选模型与凭据：模型服务商、认证方式由用户决定，并有独立文档说明。
• 工具与扩展：支持 skills、plugins 与 MCP 集成；工具调用需经过权限与沙箱边界。
• ACP 协议：可从编辑器或 Web 客户端连接，支持 stdio 与端口监听两种方式。
• Agent 协作：agent_list 列出可用 Agent，send 发送消息，agent_spawn 在当前进程中委派子任务。
• 低内存占用：针对统一内存机器（如 Apple silicon、NVIDIA DGX Spark）优化运行时内存，为本地推理留出空间。
• 可检查：展示命令、路径、diff、失败信息和费用，状态同时通过文字与颜色表达。
• 跨平台：提供 macOS、Linux、Windows 支持。

安装与使用

macOS 或 Linux 上可用安装脚本：

curl -fsSL https://raw.githubusercontent.com/sudoprivacy/sudocode/main/install.sh | sh

安装器会自动选择主机架构并校验二进制的 SHA-256。可用 sh install.sh --no-sudo 做单用户安装，用 SCODE_INSTALL_DIR 指定目录，用 SCODE_VERSION=vX.Y.Z 固定版本。

国内镜像安装：

curl -fsSL https://sudowork-release-1309794936.cos.ap-beijing.myqcloud.com/sudocode/release/latest/install.sh | \
  SCODE_MIRROR=https://sudowork-release-1309794936.cos.ap-beijing.myqcloud.com/sudocode/release/latest sh

Windows 二进制与各平台安装包见 Releases 页面。

常用命令：

# 交互式终端会话
scode

# 一次性任务
scode "explain this codebase"
scode --output-format json prompt "list failing tests"

# 恢复已保存会话
scode --resume <session-id>

# 为编辑器或 Web 客户端提供 ACP
scode acp
scode acp serve --port 8080

# 检查配置与运行时依赖
scode doctor

从源码构建：

git clone https://github.com/sudoprivacy/sudocode.git
cd sudocode/rust
cargo build --release
# 二进制位于 target/release/scode

使用前需按 认证文档 配置模型与凭据。

注意事项

• 工具调用受权限与沙箱边界约束，详见 权限与沙箱文档。
• 遥测为显式选择加入（opt-in）。
• 保存的会话会附带原始响应记录，若不需要可通过选项关闭。
• 交互操作区分「干预当前工作」「排队下一轮」「清空队列」与「取消」，使用前建议阅读输入控制相关文档。
• 官方项目文档以英文为准，问题与讨论可使用任意语言。

---

本作品整理自 GitHub 开源项目 sudoprivacy/sudocode，原作者 @sudoprivacy，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。