10分钟用OpenHands跑通3个实操任务AI编码代理的完整上手路径【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHandsOpenHands 是一个可自托管的 AI 编码代理控制台能把 OpenHands、Claude Code、Codex 这类代理跑在你自己的机器上直接对话、执行任务。读完本文你能完成首次本地安装、配置模型 API key并跑通第一个代码生成任务和一个事件触发的自动化。 它替你干的三件事你手里有个小需求想让 AI 写代码但聊天机器人只会输出代码块还得自己粘进编辑器、自己跑、自己排错。你希望仓库里每个新 PR 都有人审但没人能 7×24 盯着。你想多试几个模型和代理却得给每个单独搭环境。OpenHands 的做法是让代理直接跑在有终端和文件权限的环境里它不只给代码而是写完、跑通、再把结果给你看。 第一次运行OpenHands 从克隆到看到结果开始前准备四样东西Node.js 22.12 以上以及 uv 工具4GB 以上可用内存10GB 以上空闲磁盘稳定网络首次要下载依赖然后依次执行三条命令git clone https://gitcode.com/GitHub_Truck/ope/OpenHands把项目代码克隆到本地实际使用https://gitcode.com/GitHub_Trending/ope/OpenHands。cd OpenHands npm install安装前端依赖。npm run dev启动完整本地栈agent server、自动化后端和前端监听 8000 端口。首次运行约 3~5 分钟主要花在下载依赖上。终端提示服务就绪后浏览器打开http://localhost:8000。第一个任务在页面左下角的 Getting started 清单里点 Add LLM API key填入 OpenAI 或其他模型服务商的 key再新建会话发一句 hello 验证连通。注意本地模式下代理可以直接读写你的文件系统建议先在信任的机器或虚拟机上试。️ 三个直接能跑的任务AI 编码代理实操任务1生成一个带分页的列表组件并在浏览器里看效果为什么做用最短路径验证代理确实能跑代码而不只是输出。你输入什么写一个 React 组件把 /api/users 分页接口的前 10 条渲染成表格带上一页/下一页按钮本地跑起来给我看效果。它做了什么在项目目录创建组件文件 → 起本地服务运行 → 遇到报错自行修正 → 展示最终结果。你得到什么一个可运行的组件文件和浏览器里的实际效果不满意可以直接追问改样式。任务2让它写一个带过滤和分页的用户查询 API为什么做接口层是真实工作里最高频的部分一次看清代理怎么处理写 API 自验证。你输入什么在项目目录新建一个 Node.js 服务暴露 /api/users 接口支持 page 和 status 查询参数返回 JSON跑在 3000 端口并用 curl 验证返回。它做了什么创建服务文件 → 在 3000 端口启动进程 → 自己发 curl 请求核对两种参数的返回 → 缺依赖时自行补装。你得到什么一个能返回数据的查询接口换成你的数据源就能直接用。任务3上线一个 PR 自动审查的自动化为什么做这是 OpenHands 和聊天机器人的最大差别——任务可以定时或按事件自动跑不用你盯着。你输入什么创建一个自动化仓库有新 PR 打开时对代码做一次审查把发现作为评论发到 PR 上。它做了什么生成触发条件PR 打开事件、审查提示词和通知方式 → 保存后出现在 Dashboard 列表里状态为 Active。你得到什么一个运行中的自动化条目之后每次有 PR 打开都会自动触发审查并回帖。⚠️ 新手最常卡住的三个点npm run dev提示端口被占用8000 是入口端口释放端口或用--port 8100换端口后重启。配好 key 后聊天长时间无响应先核对模型名拼写首次会话还要拉取运行时环境等几分钟属正常。代理执行时提示命令不存在本地模式下代理能直接操作你的机器让它自行安装缺失的包或改用 Docker 沙箱模式隔离。 从一个人用到团队用的配置演进阶段关键调整单人默认本地模式状态存~/.openhands每人配自己的 API key小组改用 Docker 沙箱运行把项目目录挂载到容器内代理只碰挂载目录团队在 UI 里注册多个 agent 后端共享 VM 和个人机器同一界面切换自动化从模板页一键创建 深入之前先看这几个地方docs/SELF_HOSTING.md — 部署到团队服务器前看docs/ACP_AGENTS.md — 接入 Claude Code 等外部代理时看docs/DEVELOPMENT.md — 想改这个项目源码前看去 Templates 页面点一下 GitHub Code Review Agent把你的第一个自动化跑起来。【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
