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