🙌

OpenHands

⭐ 80k开源免费

开源版「Devin」，AI 自主写代码、跑命令、改整个项目。

它能帮你做什么

用大白话描述需求，让 AI 自己写代码、建文件、跑命令，做出一个小功能或脚本
修 bug：把报错信息或需求丢给它，它自己定位并改代码
做小工具/网站原型：描述你想要的，它从零搭起来
帮你读懂一个陌生项目、加注释、补文档

解读

OpenHands 是开源版的「Devin」——一个能自己写代码、跑命令、装依赖、改整个项目的编程 agent。你用大白话描述需求，它就在一个隔离环境里自主完成开发。

和「代码补全」类工具不同，它是端到端把一个任务做完：建文件、写代码、跑测试、遇到报错自己改，你只在关键处点头确认。适合让 AI 独立做一个小功能、一个脚本，或修一个 bug。

门槛：需要装 Docker、配一个较强的模型密钥（Claude 效果最好）。有一点编程概念用起来最顺。

适合谁

想让 AI 独立写代码的人，尤其有一点编程概念、但懒得自己敲的人。需要装 Docker、配一个较强的模型 Key（推荐 Claude）。完全不懂技术也能描述需求让它做，只是出问题时不好判断。

开始前的准备

电脑装好 Docker 并启动。
一个较强的模型 API Key：推荐 Claude（Anthropic）或 GPT，写代码效果最好（按用量付费）。
8G+ 内存，约 5G 硬盘。

手把手教程

装 Docker：去 docker.com 下载 Docker Desktop，安装并启动。
拉起 OpenHands：打开终端，粘贴官方文档 docs.all-hands.dev 上给的那条 docker run 命令（一条即可），回车，等它下载镜像并启动。
打开界面：浏览器访问 localhost:3000。
填模型 Key：进设置，选模型提供商（如 Anthropic Claude），粘贴 API Key 保存。
派任务：在对话框用中文描述，例如「帮我写一个把文件夹里所有图片批量压缩的 Python 脚本」，回车。
看它干活：它会自己建文件、写代码、跑测试，全过程你都看得到；需要确认操作时点同意即可。

常见问题 / 踩坑

一定要会编程吗？

不必精通，但懂一点「文件、脚本、运行」的概念会顺很多。完全不懂也能用，只是遇到问题不好判断对错。

用哪个模型效果好？

写代码类任务，Claude 系列通常最强，其次 GPT。模型越强完成得越好，费用也越高。

会不会乱动我电脑里的文件？

它在隔离的 Docker 容器里干活，默认不碰你主机的文件；只有你主动把某个项目目录挂载进去时才会操作，注意选对目录。

免费吗？

软件免费；模型 API 按用量付费。也可指向本地 Ollama 免费跑，但小模型写代码效果一般。

进阶技巧

任务描述越具体越好：说清输入、输出、用什么语言，成功率明显更高。
复杂需求拆成几个小任务分步派，比一次性丢一个大需求更稳。

打不开 GitHub / 国内访问

文档站 docs.all-hands.dev 可访问；Docker 镜像从境外拉慢，就配一个国内 Docker 镜像加速器。用境外模型需自行解决网络访问，或改用国内可直连的模型接口。