5 分钟跑通 OpenHands3 个任务让 AI 编程助手真正帮你干活【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands想让 AI 写出来的代码不只看起来对而是真的在你机器上跑起来OpenHands 就是干这个的一个可自托管的 AI 开发助手适合想少写样板代码的前端、后端和全栈开发者。这篇 OpenHands 快速上手带你从零跑起来再用三个任务把用法摸清。它和问 AI 要代码差在哪在聊天工具里问 AI 要代码你拿到的是文字自己复制、建文件、装依赖、跑起来报错再粘回去继续问。OpenHands 里挂着一个常驻的 agent serveragent 直接在你的机器或容器沙箱里干活建文件、装依赖、执行命令、读报错日志再自己修。你最后看到的是 diff 和运行结果不是一段建议你这样写。这就是 AI 自动写代码最容易被误解的地方价值不在生成得快而在生成后能当场验证。它也不绑定某一家模型你可以自带 API key 换模型通过 ACP 协议还能接 Claude Code、Codex、Gemini 这类第三方 agent。 5 分钟跑通本地环境先备齐这几样Node.js 22.12 及以上npmuvPython 工具开发栈靠它启动 Python 侧的 agent server几个 GB 磁盘给依赖和会话状态留够然后从源码启动git clone https://gitcode.com/GitHub_Trending/ope/OpenHands cd OpenHands npm install npm run dev服务起来后浏览器访问 http://localhost:8000 就是控制台。左上角 New Chat 新建一个会话选好要操作的项目目录第一句提示词可以很小比如新建 hello.py打印当前时间并运行。提醒一句从源码启动时 agent 直接跑在你本机能读写你的文件系统。不想让它碰本地文件就改用 Docker 方式启动README 里的 Option 2agent 只在容器里跑只挂载你指定的项目目录。️ 上手先试这三件事把一句需求变成能跑的原型提示词在 projects/todo 下用 Express 写个待办后端GET /todos 列出全部POST /todos 新增一条内存存储就够写完跑起来并用 curl 自测两个接口。它会产出 server.js、package.json 这类真实文件外加一段 curl 自测的运行日志。重点检查接口是否真的通、文件有没有建在你指定的目录、它装的依赖和写法你能不能接受。前后端接口对不齐时让它补提示词前端调 /api/users 期望字段 name 和 avatar后端实际返回 displayName 和 avatarUrl帮我把两端对齐并加一个联调用例防回归。产出是两端的 diff 加一个能跑的联调用例。重点检查改动是不是最小化——它是只改字段映射还是顺手重构了一大片如果改到了不该动的那一端比如有别的调用方依赖旧字段及时叫停。给老代码补测试提示词给 src/utils/parse.ts 补单元测试重点覆盖空输入和抛错的分支写完跑一遍确保全绿。产出是测试文件加执行结果。重点检查断言是不是真的在断言而不是一堆 console.log有没有为了让测试通过偷偷改源码——一旦发现直接看它的源码 diff。⚙️ 配置只改这两处LLM profile设置里填一个模型 API key。不配这个agent 没有大脑发什么消息都不会有实质回应。工作目录新建会话时指定 agent 能碰的项目目录Docker 模式则对应 PROJECTS_PATH 挂载的目录。端口、远程部署、安全加固这些都不用动默认值够用细节看 docs/SELF_HOSTING.md。左侧 Customize → Skills 这里可以开关 agent 可用的技能新手保持默认即可。 常见卡点现象、原因、怎么办npm run dev 起不来或后端一直加载不出→ 多半是没装 uv 或它不在 PATH开发栈靠 uvx 下载并运行 Python 侧 agent server → 装好 uv 再重试。agent 说找不到文件、拒绝动某个目录→ 那个目录不在它的工作空间里 → 新建会话时指定正确目录或 Docker 模式把目录加进 PROJECTS_PATH。发第一句话后没反应→ LLM profile 没配 → 先去设置里把模型和 API key 填上。 接下来去哪文档入口在 docs/想搞懂前端和 agent server 怎么分工看 docs/architecture.md想用容器跑 ACP 协议的外部 agent参考 examples/acp-docker/仓库职责边界和贡献者约定写在仓库根目录的 AGENTS.md 里别一上来就让它重构整个项目。今天就从最小的一步开始挑你项目里一个几百行的小模块让它把单元测试补上然后打开生成的测试文件读一遍自己跑一次确认。跑通这一个来回你对它的脾气就基本有数了。【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考