Free MIT AI coding agent — no API key needed. Built-in free model, or bring Claude, GPT, Gemini, DeepSeek, Ollama +50 more. Swarm mode, 40+ tools, browser & desktop automation, built in Rust.

AlphaCode – 开源 Rust AI 编码代理

简介 – AlphaCode 是一款终端优先、基于 Rust 的 AI 代理，能够理解自然语言指令、推理代码库、编辑文件、运行命令并验证结果。它还可以与实际 Firefox 实例及原生桌面应用交互，让您从同一界面自动化 Web UI 和 GUI 程序。

核心功能

功能	您可以要求它执行的操作
代码理解与编辑	检查代码仓库、规划修复方案、应用补丁、添加测试、运行测试套件并报告差异。
Shell 执行	在安全提示下运行任意命令、批处理任务或后台任务。
Web 自动化	通过 AlphaCode 浏览器代理 Firefox 扩展，它可以导航页面、填写表单、截图、下载文件并验证 UI 流程。
桌面自动化	使用操作系统辅助功能 API（Windows 上的 UI Automation、macOS 上的 Accessibility、Linux 上的 AT-SPI2）进行点击、输入、滚动、读取窗口等操作。
群组模式	将大型目标拆分为多个代理处理的独立子任务，然后汇总结果。
持久会话与记忆	保存对话和项目上下文，以便在关闭终端后恢复工作。
模型无关	开箱即用，包含免费的内置模型；您还可以连接 Claude、OpenAI、Gemini、Copilot、Cursor、Bedrock、Azure、OpenRouter 或任何兼容 OpenAI 的端点。
40 多个内置工具	文件操作（`read`、`write`、`patch`）、搜索（`agentgrep`）、执行（`bash`、`batch`）、Web（`webfetch`、`httpflow`）、桌面（`desktop`、`macos_computer_use`）、工作流（`plan`、`swarm`）、实用工具（`doctor`、`self_improve`）等。

典型工作流程

描述目标 – 例如：“修复 utils.rs 中失败的测试并添加回归测试。”
AlphaCode 分析代码仓库，制定计划，并决定调用哪些工具。
执行 – 它编辑文件，运行 cargo test，可能打开 Firefox 检查 UI，或点击桌面应用。
验证 – 再次运行相关测试，捕获截图或差异，并生成简明报告。

快速开始

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/dragonked2/alphacode/main/scripts/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/dragonked2/alphacode/main/scripts/install.ps1 | iex

alphacode doctor   # 检查环境是否正常
alphacode          # 启动交互式界面

您也可以不使用 UI 运行单个任务： alphacode run "fix the failing test"

要启用浏览器自动化，请从 README 中的链接安装 Firefox 扩展并运行 alphacode browser setup。

模型与提供商配置

alphacode login                     # 启动 OAuth / API 密钥流程
alphacode provider list             # 查看已配置的提供商
alphacode model use gpt-4o          # 为会话选择模型

内置免费通道无需任何密钥即可使用，让首次尝试畅通无阻。

安全措施

阻止破坏性的文件系统路径。
高风险操作会触发明确的权限提示。
Shell 命令在带有超时的沙箱中运行。
网络调用会扫描 SSRF 和凭据泄露。
会话持久化；崩溃后可恢复。
代理被指示进行小而孤立的更改，重新运行测试，并在任何合并前呈现结构化报告。

何时使用 AlphaCode

错误修复 / 回归追踪 – 让代理定位原因，应用最小补丁，并通过测试验证。
功能添加 – 描述新行为，AlphaCode 将搭建代码框架、添加测试并运行套件。
Web 应用 QA – 在真实 Firefox 窗口中自动化登录流程、表单验证或基于截图的检查。
桌面应用脚本编写 – 自动化重复的 GUI 任务（例如：打开计算器、执行计算、读取结果）。
安全审查 – 在可重现的工作流程中结合代码分析、HTTP 探测和基于浏览器的测试。
大型项目 – 使用 群组模式 将工作（代码审查、安全审计、文档编写）分配给多个代理。

文档与社区

完整文档位于仓库的 docs/ 文件夹中。
发布版本在 GitHub 上提供 Windows、macOS 和 Linux 的版本化二进制文件。
问题、功能请求和错误报告通过 GitHub 问题跟踪器处理。
欢迎贡献 – 请参阅 CONTRIBUTING.md 获取指南。

简而言之

AlphaCode 是一款 Rust 原生、跨平台的 AI 编码助手，超越了仅聊天的建议。它能够编辑代码、运行 Shell、驱动真实 Firefox 浏览器并控制桌面应用，全部通过终端界面完成，并内置安全防护和对多种 LLM 提供商的支持。

以上信息均直接取自仓库的 README，未添加任何外部假设。

dragonked2/alphacode