Claude-Autopilot
扫码查看

自动执行Claude Code任务的VS Code扩展

Claude-Autopilot

综合介绍

Claude-Autopilot是一款专为VS Code和Cursor编辑器设计的扩展程序,它能让你自动化处理与Claude Code相关的编码任务。 这款工具的核心功能是提供一个智能的任务队列管理系统,你可以将成百上千个任务一次性添加到队列中。 之后,Claude-Autopilot会全天候自动执行这些任务,即便是遇到Claude本身的使用限制,它也能在限制解除后自动恢复工作,无需你手动干预。

该扩展还内置了睡眠保护功能,可以防止计算机在处理任务期间进入休眠状态,确保长时间运行的任务能够顺利完成。 对于开发者来说,它还提供了丰富的配置选项和开发模式,允许你根据自己的需求进行细致的调整和调试。 此外,Claude-Autopilot提供了一个可视化的操作界面,你可以通过它实时监控任务进度、管理队列,并浏览历史记录,让整个自动化流程直观且易于管理。

功能列表

  • 24/7 自动化处理: 你可以预设数百个任务,让Claude-Autopilot在你休息或处理其他事务时自动完成。
  • 自动恢复: 当Claude因为使用频率达到上限而暂停服务时,此扩展会自动监测并在服务恢复后继续执行队列中的任务。
  • 防止休眠: 内置功能可阻止电脑在任务执行期间进入睡眠模式,保障通宵或长时间的批量处理不被中断。
  • 智能队列管理: 自动处理多个Claude Code任务,并以智能化的方式管理整个队列。
  • 批量处理: 高效处理大量工作,尤其适合在周末或夜间进行大规模的代码重构或生成任务。
  • 依赖检查: 扩展启动时会自动检测并验证Claude Code和Python的依赖是否正确安装。
  • 跨平台支持: 可以在Windows、macOS和Linux系统上无缝运行。
  • IDE兼容性: 完全支持VS Code和Cursor两款主流编辑器。
  • 错误恢复: 包含全面的错误处理机制,在遇到问题时会自动尝试重新执行。
  • 健康监控: 持续监控Claude Code进程的健康状况,确保其稳定运行。
  • 可视化界面: 提供一个交互式的网页视图,用于管理队列、监控进度和查看历史运行记录。

使用帮助

Claude-Autopilot的设计初衷是为了让你能够“设置好就不用管了”,它极大地简化了与Claude Code交互的重复性工作。下面将详细介绍如何安装、配置并使用这款强大的自动化工具。

安装流程

在开始之前,请确保你的开发环境满足以下基本要求:

  • Claude Code: 你需要先安装Anthropic官方提供的Claude Code工具。
  • Python: 需要Python 3.8或更高版本,这是扩展进行流程管理所必需的。
  • 编辑器: VS Code 1.74.0+ 或 Cursor 编辑器。

安装Claude-Autopilot有以下几种方式:

  1. 通过VS Code市场安装(推荐):
    • 打开VS Code或Cursor。
    • 点击侧边栏的“扩展”图标。
    • 在搜索框中输入“Claude Autopilot”。
    • 找到该扩展并点击“安装”按钮。
  2. 通过命令面板安装:
    • 使用快捷键 Cmd/Ctrl+Shift+P 打开命令面板。
    • 输入 Extensions: Install Extensions 并回车。
    • 在搜索框中查找并安装“Claude Autopilot”。
  3. 从VSIX文件安装:
    • 首先,从项目的GitHub Releases页面下载后缀为 .vsix 的文件。
    • 在VS Code中,使用快捷键 Cmd/Ctrl+Shift+P 打开命令面板。
    • 输入 Extensions: Install from VSIX... 并回车。
    • 选择你已下载的VSIX文件进行安装。或者通过以下终端命令安装:
      code --install-extension claude-autopilot-0.0.1.vsix
      

      请注意将文件名替换为你下载的实际版本。

基本操作流程

安装完成后,你就可以开始使用Claude-Autopilot来自动化你的工作流了。

  1. 启动Claude Autopilot:
    • 使用快捷键 Cmd/Ctrl+Shift+P 打开命令面板。
    • 输入 Claude: Start Claude Autopilot 并回车。
    • 这会打开一个名为“Claude Autopilot”的Webview界面,这是你的主操作中心。
  2. 添加任务到队列:
    • 在Webview界面中,你可以看到一个输入框。在这里输入你想要Claude Code执行的指令或消息。
    • 你可以一次性添加多个任务,无论是10个、50个还是超过200个,它们都会被依次加入到处理队列中。
    • 也可以使用命令 Claude: Add Message to Queue 来添加任务。
  3. 开始处理:
    • 当你把所有任务都添加到队列后,只需点击界面上的“Start Processing”按钮。
    • 此时,你就可以离开电脑了。无论是去吃饭、陪家人,还是去度个周末,Claude-Autopilot都会在后台默默工作。
  4. 监控与管理:
    • Webview界面会实时更新任务的执行状态和进度。
    • 你可以随时暂停、编辑、重新排序或删除队列中的任务。
    • 处理完成或失败的任务会进入历史记录,你可以随时通过“History Browser”来查看和筛选过去的运行结果。

高级配置

Claude-Autopilot提供了丰富的设置选项,让你可以根据具体需求进行微调。你可以通过 File → Preferences → Settings → Extensions → Claude Autopilot 路径来访问这些配置。

  • 队列管理 (claudeAutopilot.queue.autoMaintenance):设置为 true 时,会自动清理已完成的任务,保持队列整洁。
  • 会话管理 (claudeAutopilot.session):
    • autoStart: 设置为 true 可在VS Code启动时自动开启Claude Autopilot会话。
    • skipPermissions: 允许在自动化过程中跳过权限检查,仅在受信任的环境中使用。
    • healthCheckInterval: 设置健康检查的间隔时间(毫秒),以确保Claude Code进程正常运行。
  • 防止休眠 (claudeAutopilot.sleepPrevention):
    • enabled: 设置为 true 以防止电脑在任务处理期间进入休眠状态。
    • method: 可以选择不同的方法来防止休眠,auto 会自动选择最适合当前操作系统的方式。
  • 历史与日志 (claudeAutopilot.history & claudeAutopilot.logging):
    • maxRuns: 设置历史记录中保存的最大运行次数。
    • autoSave: 自动保存处理历史。
    • logging.enabled: 启用或禁用日志记录功能,用于问题排查。

应用场景

  1. 周末代码重构你可以周五下班前,将整个星期积累的重构任务,例如将旧的React类组件转换为函数式组件,全部加入队列。等到周一早上回到办公室时,所有工作都已完成。
  2. 大型项目迁移当需要将一个大型JavaScript项目迁移到TypeScript时,可以批量为数百个文件添加类型定义。这个过程非常耗时,但通过Claude-Autopilot,你可以让它在夜间或周末自动完成。
  3. 批量代码生成无论是为组件生成单元测试、创建新的API文档,还是根据模板生成标准化代码,你都可以将这些任务批量化处理,从而节省大量重复劳动的时间。
  4. 文档自动化生成为整个代码库生成详细的文档是一项枯燥的工作。你可以设置好指令,让Claude-Autopilot在你放松休息的时候,自动从代码注释中提取信息并生成文档。

QA

  1. Claude Code和Claude-Autopilot有什么区别?Claude Code是Anthropic官方推出的AI编程助手,它能与你的IDE集成,提供代码建议、回答问题等功能。 而Claude-Autopilot是基于Claude Code的一个第三方自动化工具,它本身不提供AI能力,而是通过智能队列来管理和自动执行你下达给Claude Code的指令。你可以把Claude Code看作是“工人”,而Claude-Autopilot则是“工头”。
  2. 安装后提示“Claude Code Not Found”怎么办?这通常意味着Claude-Autopilot无法找到Claude Code的安装路径。请确保你已经按照官方指引正确安装了Claude Code,并且其路径已经添加到了系统的PATH环境变量中。安装或修改完成后,重启VS Code通常能解决问题。
  3. 为什么需要Python?Claude-Autopilot使用Python脚本来管理后台进程,包括启动、监控和恢复Claude Code的执行。因此,一个正常工作的Python 3.8+环境是必需的。如果在Windows上安装Python,建议勾选“Add Python to PATH”选项。
  4. 处理敏感数据时使用这个扩展安全吗?Claude-Autopilot所有的处理都在你的本地计算机上进行,不会收集或上传任何个人数据。但为了实现完全自动化,它可能会使用 --dangerously-skip-permissions 这样的参数来执行Claude Code,这会跳过一些安全检查。因此,官方建议仅在受信任的开发环境中使用此功能,如果处理的是敏感数据,建议在设置中禁用该选项。
微信微博Email复制链接