10分鐘用OpenHands跑通3個(gè)實(shí)操任務(wù)AI編碼代理的完整上手路徑【免費(fèi)下載鏈接】OpenHands OpenHands: AI-Driven Development項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ope/OpenHandsOpenHands 是一個(gè)可自托管的 AI 編碼代理控制臺(tái)能把 OpenHands、Claude Code、Codex 這類(lèi)代理跑在你自己的機(jī)器上直接對(duì)話、執(zhí)行任務(wù)。讀完本文你能完成首次本地安裝、配置模型 API key并跑通第一個(gè)代碼生成任務(wù)和一個(gè)事件觸發(fā)的自動(dòng)化。 它替你干的三件事你手里有個(gè)小需求想讓 AI 寫(xiě)代碼但聊天機(jī)器人只會(huì)輸出代碼塊還得自己粘進(jìn)編輯器、自己跑、自己排錯(cuò)。你希望倉(cāng)庫(kù)里每個(gè)新 PR 都有人審但沒(méi)人能 7×24 盯著。你想多試幾個(gè)模型和代理卻得給每個(gè)單獨(dú)搭環(huán)境。OpenHands 的做法是讓代理直接跑在有終端和文件權(quán)限的環(huán)境里它不只給代碼而是寫(xiě)完、跑通、再把結(jié)果給你看。 第一次運(yùn)行OpenHands 從克隆到看到結(jié)果開(kāi)始前準(zhǔn)備四樣?xùn)|西Node.js 22.12 以上以及 uv 工具4GB 以上可用內(nèi)存10GB 以上空閑磁盤(pán)穩(wěn)定網(wǎng)絡(luò)首次要下載依賴(lài)然后依次執(zhí)行三條命令git clone https://gitcode.com/GitHub_Truck/ope/OpenHands把項(xiàng)目代碼克隆到本地實(shí)際使用https://gitcode.com/GitHub_Trending/ope/OpenHands。cd OpenHands npm install安裝前端依賴(lài)。npm run dev啟動(dòng)完整本地棧agent server、自動(dòng)化后端和前端監(jiān)聽(tīng) 8000 端口。首次運(yùn)行約 3~5 分鐘主要花在下載依賴(lài)上。終端提示服務(wù)就緒后瀏覽器打開(kāi)http://localhost:8000。第一個(gè)任務(wù)在頁(yè)面左下角的 Getting started 清單里點(diǎn) Add LLM API key填入 OpenAI 或其他模型服務(wù)商的 key再新建會(huì)話發(fā)一句 hello 驗(yàn)證連通。注意本地模式下代理可以直接讀寫(xiě)你的文件系統(tǒng)建議先在信任的機(jī)器或虛擬機(jī)上試。? 三個(gè)直接能跑的任務(wù)AI 編碼代理實(shí)操任務(wù)1生成一個(gè)帶分頁(yè)的列表組件并在瀏覽器里看效果為什么做用最短路徑驗(yàn)證代理確實(shí)能跑代碼而不只是輸出。你輸入什么寫(xiě)一個(gè) React 組件把 /api/users 分頁(yè)接口的前 10 條渲染成表格帶上一頁(yè)/下一頁(yè)按鈕本地跑起來(lái)給我看效果。它做了什么在項(xiàng)目目錄創(chuàng)建組件文件 → 起本地服務(wù)運(yùn)行 → 遇到報(bào)錯(cuò)自行修正 → 展示最終結(jié)果。你得到什么一個(gè)可運(yùn)行的組件文件和瀏覽器里的實(shí)際效果不滿(mǎn)意可以直接追問(wèn)改樣式。任務(wù)2讓它寫(xiě)一個(gè)帶過(guò)濾和分頁(yè)的用戶(hù)查詢(xún) API為什么做接口層是真實(shí)工作里最高頻的部分一次看清代理怎么處理寫(xiě) API 自驗(yàn)證。你輸入什么在項(xiàng)目目錄新建一個(gè) Node.js 服務(wù)暴露 /api/users 接口支持 page 和 status 查詢(xún)參數(shù)返回 JSON跑在 3000 端口并用 curl 驗(yàn)證返回。它做了什么創(chuàng)建服務(wù)文件 → 在 3000 端口啟動(dòng)進(jìn)程 → 自己發(fā) curl 請(qǐng)求核對(duì)兩種參數(shù)的返回 → 缺依賴(lài)時(shí)自行補(bǔ)裝。你得到什么一個(gè)能返回?cái)?shù)據(jù)的查詢(xún)接口換成你的數(shù)據(jù)源就能直接用。任務(wù)3上線一個(gè) PR 自動(dòng)審查的自動(dòng)化為什么做這是 OpenHands 和聊天機(jī)器人的最大差別——任務(wù)可以定時(shí)或按事件自動(dòng)跑不用你盯著。你輸入什么創(chuàng)建一個(gè)自動(dòng)化倉(cāng)庫(kù)有新 PR 打開(kāi)時(shí)對(duì)代碼做一次審查把發(fā)現(xiàn)作為評(píng)論發(fā)到 PR 上。它做了什么生成觸發(fā)條件PR 打開(kāi)事件、審查提示詞和通知方式 → 保存后出現(xiàn)在 Dashboard 列表里狀態(tài)為 Active。你得到什么一個(gè)運(yùn)行中的自動(dòng)化條目之后每次有 PR 打開(kāi)都會(huì)自動(dòng)觸發(fā)審查并回帖。?? 新手最常卡住的三個(gè)點(diǎn)npm run dev提示端口被占用8000 是入口端口釋放端口或用--port 8100換端口后重啟。配好 key 后聊天長(zhǎng)時(shí)間無(wú)響應(yīng)先核對(duì)模型名拼寫(xiě)首次會(huì)話還要拉取運(yùn)行時(shí)環(huán)境等幾分鐘屬正常。代理執(zhí)行時(shí)提示命令不存在本地模式下代理能直接操作你的機(jī)器讓它自行安裝缺失的包或改用 Docker 沙箱模式隔離。 從一個(gè)人用到團(tuán)隊(duì)用的配置演進(jìn)階段關(guān)鍵調(diào)整單人默認(rèn)本地模式狀態(tài)存~/.openhands每人配自己的 API key小組改用 Docker 沙箱運(yùn)行把項(xiàng)目目錄掛載到容器內(nèi)代理只碰掛載目錄團(tuán)隊(duì)在 UI 里注冊(cè)多個(gè) agent 后端共享 VM 和個(gè)人機(jī)器同一界面切換自動(dòng)化從模板頁(yè)一鍵創(chuàng)建 深入之前先看這幾個(gè)地方docs/SELF_HOSTING.md — 部署到團(tuán)隊(duì)服務(wù)器前看docs/ACP_AGENTS.md — 接入 Claude Code 等外部代理時(shí)看docs/DEVELOPMENT.md — 想改這個(gè)項(xiàng)目源碼前看去 Templates 頁(yè)面點(diǎn)一下 GitHub Code Review Agent把你的第一個(gè)自動(dòng)化跑起來(lái)。【免費(fèi)下載鏈接】OpenHands OpenHands: AI-Driven Development項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考