OpenHands：71K星的AI编程Agent平台，5种用法从CLI到云端全搞定

你是不是也这样？

每天写代码，一半时间在查报错、补测试、改Bug，真正写业务逻辑的时间少得可怜。招了个AI助手吧，聊聊天还行，让它帮你跑个命令、改个文件，它只会说"建议你这样做"——说的比做的多。要是有个AI能直接动手帮你写代码、跑终端、改文件，还能在云端同时跑几百个任务，那该多好？

OpenHands 是什么？

OpenHands（原名 OpenDevin）是一个 AI 驱动的编程 Agent 平台，GitHub 上已收获 71,589 颗星，被 TikTok、Netflix、Amazon、NVIDIA、Google、Apple 等公司工程师使用。它不只是聊天，而是能真正动手写代码、操作终端、编辑文件的 AI 开发搭档。

核心功能一览

• Software Agent SDK：用 Python 代码定义 Agent，支持本地运行或云端扩展到 1000+ 并发 Agent
• CLI 命令行：终端里直接用，类似 Claude Code / Codex 的体验，最低上手门槛
• 本地 GUI：浏览器里跑的 Web 界面，类似 Devin / Jules，Docker 一键部署
• OpenHands Cloud：托管版本，免费试用，集成 Slack、Jira、Linear
• 企业版：自建 VPC 部署，Kubernetes 原生支持，安全合规
• SWE-Bench 得分 77.6%：在知名代码修复基准测试中表现优异
• 3 种确认模式：逐条确认、自动全批准、LLM 安全审查，灵活控制权限
• MCP 服务器支持：可扩展外部工具能力，像插 USB 设备一样接入新能力
• IDE 集成：支持 VSCode、JetBrains 等主流编辑器
• Chrome 扩展：浏览器中直接使用 Agent 能力

安装步骤

方式一：CLI 安装（推荐上手最快）

前提条件：Python 3.12+ 和 uv 0.11.6+

macOS / Linux

# 先安装 uv（Python 包管理器，速度极快）
curl -LsSf https://astral.sh/uv/install.sh | sh

# 用 uv 安装 OpenHands
uv tool install openhands --python 3.12

# 验证安装
openhands --version

Windows

# 安装 uv
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# 安装 OpenHands
uv tool install openhands --python 3.12

# 验证安装
openhands --version

独立二进制安装（不需要 Python）

# macOS / Linux
curl -fsSL https://install.openhands.dev/install.sh | sh

# Windows 用户可在 PowerShell 中执行
# 需要先安装 curl 或使用浏览器下载安装脚本

💡 国内用户加速提示：如果 pip 下载慢，可以设置国内镜像源： ``bash pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/ ` 如果 uv 下载慢，可以设置环境变量： `bash export UVINDEXURL=https://mirrors.aliyun.com/pypi/simple/ ``

方式二：SDK 安装（开发者用代码编排 Agent）

# 国内用户建议先换源
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

pip install openhands-sdk

方式三：Docker 部署 GUI（适合团队使用）

# 确保 Docker 已安装并运行
docker --version

# 拉取并运行 OpenHands GUI
docker run -it --rm   -p 3000:3000   -v /var/run/docker.sock:/var/run/docker.sock   ghcr.io/openhands/openhands:latest

部署完成后，浏览器访问 http://localhost:3000 即可使用。

💡 国内 Docker 拉取加速：配置 Docker 镜像加速器可大幅提升拉取速度。

使用方法

1. CLI 基础用法

首次运行 openhands 会引导你配置 LLM（大语言模型），需要提供 API Key：

# 启动交互式会话
openhands

# 首次运行会提示配置 LLM，按引导操作即可

配置文件存储在 ~/.openhands/ 目录下，包括：

• agent_settings.json：Agent 设置
• cli_config.json：CLI 配置
• mcp.json：MCP 服务器配置

无头模式——命令行直接给任务

适合脚本化、CI/CD 流水线场景：

# 直接指定任务，无需交互
openhands --headless -t "Write unit tests for auth.py"

# 恢复上次会话（中断后继续）
openhands --resume

自动批准模式——让 Agent 自主干活

默认模式下，Agent 每执行一步操作都要你确认。如果你信任它的判断：

# 自动批准所有操作
openhands --always-approve

# 或者用更简短的写法（yolo 模式）
openhands --yolo

# LLM 安全审查模式——由另一个 LLM 来审核操作安全性
openhands --llm-approve

⚠️ 注意：yolo 模式下 Agent 会自动执行所有操作，包括运行命令和修改文件，请确保在安全环境中使用。

MCP 服务器扩展

# 添加一个 MCP 服务器（比如 Tavily 搜索）
openhands mcp add tavily --transport stdio npx -- -y mcp-remote "https://mcp.tavily.com/mcp/?apiKey=YOUR_KEY"

# 查看已添加的 MCP 服务器
openhands mcp list

Cloud 模式——把任务发到云端

# 直接把任务发送到 OpenHands Cloud 运行
openhands cloud -t "Fix the login bug"

启动 Web 界面和完整服务

# 在浏览器中打开 Web 界面
openhands web

# 启动完整的 GUI Server（供团队使用）
openhands serve

2. SDK 编程用法——用代码编排 Agent

这是 OpenHands 的杀手锏功能。你可以用 Python 定义 Agent 的行为，然后选择本地运行或者扩展到云端并行跑上千个 Agent：

import os
from openhands.sdk import LLM, Agent, Conversation, Tool
from openhands.tools.file_editor import FileEditorTool
from openhands.tools.task_tracker import TaskTrackerTool
from openhands.tools.terminal import TerminalTool

# 1. 配置 LLM
llm = LLM(
    model="anthropic/claude-sonnet-4-5-20250929",
    api_key=os.getenv("LLM_API_KEY"),
)

# 2. 创建 Agent，给它配备工具
agent = Agent(
    llm=llm,
    tools=[
        Tool(name=TerminalTool.name),       # 终端操作
        Tool(name=FileEditorTool.name),     # 文件编辑
        Tool(name=TaskTrackerTool.name),    # 任务跟踪
    ],
)

# 3. 创建会话，指定工作目录
cwd = os.getcwd()
conversation = Conversation(agent=agent, workspace=cwd)

# 4. 发送任务并运行
conversation.send_message("Write 3 facts about the current project into FACTS.txt.")
conversation.run()

SDK 的真正威力在于批量编排：你可以写一个脚本，让 1000 个 Agent 同时在云端处理 1000 个仓库的代码审查、Bug 修复、测试补充。这是 CLI 工具做不到的事。

💡 国内模型支持：LLM 的 model 参数支持多种模型格式，如果你有国内大模型的 API，也可以尝试配置。关键是需要一个兼容 OpenAI 接口格式的 API Key。

3. OpenHands Cloud 使用

1. 打开 https://app.all-hands.dev
2. 用 GitHub 或 GitLab 账号登录
3. 可以选择 Minimax 模型免费试用
4. 支持集成 Slack（消息触发任务）、Jira（工单驱动开发）、Linear（项目管理联动）

Cloud 模式特别适合：

• 本地算力不足的场景
• 需要同时跑大量任务的情况
• 团队协作需要统一管理 Agent 的场景

实际使用场景

跟同类产品对比

核心优势总结：OpenHands 是目前唯一同时覆盖 CLI、GUI、SDK、Cloud、企业版五种使用方式的开源 AI 编程 Agent 平台。无论你是个人开发者想在终端里快速用，还是团队需要 Web 界面协作，又或者企业要自建私有化部署，OpenHands 都有一套方案。特别是 SDK 模式，用代码定义 Agent 的能力在其他产品中几乎找不到。

IDE 集成

OpenHands 支持通过 ACP（Agent Communication Protocol）集成到主流 IDE：

# 启动 IDE 集成（支持 VSCode、JetBrains 等）
openhands acp

这样你就能在熟悉的编辑器环境中直接使用 OpenHands 的全部能力，不用切换窗口。

3 种确认模式详解

OpenHands 提供了灵活的权限控制，满足不同安全需求：

这三种模式给了开发者极大的灵活性：初学者可以用默认模式边看边学，熟练后切到 yolo 模式提效，生产环境用 LLM 审查模式保安全。

学术背景

OpenHands 团队发表了论文 《OpenHands: An Open Platform for AI Software Developers as Agents》，详细介绍了系统架构和 SWE-Bench 基准测试结果。这是开源 AI 编程 Agent 领域的重要学术贡献，77.6% 的 SWE-Bench 得分有据可查。

相关资源

• GitHub：https://github.com/OpenHands/OpenHands（71,589 标星）
• 官方文档：https://docs.openhands.dev
• 论文：https://arxiv.org/abs/2511.03690
• Chrome 扩展：https://github.com/OpenHands/openhands-chrome-extension/
• Cloud 试用：https://app.all-hands.dev

一句话总结：OpenHands 是目前最全面的开源 AI 编程 Agent 平台——CLI 开箱即用，SDK 随心定制，Docker 自部署无门槛，Cloud 托管零运维，企业版安全合规。71K 星不是白来的，值得一试。