让 AI 帮你写代码：OpenHands 安装与上手

想象你不是程序员，却总在心里嘀咕：“要是有这么个小脚本就好了”——批量重命名 200 张照片、给小店做个迷你网页、把每月收据整理成表格。OpenHands 就是开源的 AI 编程 agent（GitHub 约 8.2 万星），替你写代码、改代码甚至运行代码。你用大白话描述任务，它负责干活，你还能一步步看着它做。

开始前需要准备什么

一台装了 Python 3.10–3.12 的电脑（从 python.org 下载，安装时勾选 “Add to PATH”），以及一个大模型的 API 密钥——OpenAI、Anthropic、Gemini 都行。密钥是唯一要花钱的地方，OpenHands 本身免费。如果 pip 遇到麻烦，新版本 Python 也可以用 “uv tool install openhands --python 3.12”。

第一步：安装 OpenHands

打开 PowerShell 运行：

pip install openhands-ai

等它装完——会同时安装命令行工具和图形界面组件。用 “openhands --version” 验证一下。

第二步：接入模型 API 密钥

运行 “openhands auth login”，选择你的服务商（OpenAI/Anthropic/Gemini），按要求粘贴 API 密钥。或者把它设成环境变量——无论哪种方式，这个密钥就是给你 AI 程序员供电的电池。

第三步：启动工作台

运行 “openhands serve”（终端模式直接 “openhands”）。它会启动一个本地网页工作台并打印一个 localhost 地址——浏览器打开它。这就是你的驾驶舱：左边聊天面板、中间实时代码和文件视图、下面终端显示 agent 正在跑什么。

第四步：交给它第一个任务

输入一句生活化的话，比如：“做一个倒计时到春节的简单网页，蓝色背景，好看一点。”看着 OpenHands 规划、写文件、运行。它请求批准执行代码时，由你决定——这就是你的安全开关。下载或复制结果，你刚刚让 AI 帮你做了个软件。

新手常见坑

• 提示 “pip” 不是命令——Python 没加入 PATH；重装时勾选 “Add Python to PATH”，或者用 “py -m pip install openhands-ai”。
• 登录失败或 “invalid API key”——去服务商后台重新复制密钥，重跑 “openhands auth login”，注意别带多余空格。
• 它请求运行代码而你犹豫——沙箱里批准是正常且安全的，但先看看它要跑什么；在有重要数据的电脑上，绝不批准你不认识的命令。
• 任务太模糊——OpenHands 喜欢具体目标（做什么、给谁用、有没有风格偏好），效果会好很多。
• 长任务很慢——编程 agent 会反复调用模型，短小而单一的任务更快也更省钱。

小结

OpenHands 最接近“雇了个按 API 密钥价收费、还全程亮给你看的初级程序员”。从小的个人任务开始，看看它怎么干活，很快你就能自动化自己的小脚本了。