# OpenHands CLI 使用指南

旧版 OpenHands 终端客户端，供现有安装维护与迁移参考。

Canonical URL: https://aiidelist.com/zh/blog/traeide-openhands-cli-zh

Language: zh

Published: 2026-10-03

Updated: 2026-10-03

> 本文基于 2026 年 9 月的资料整理。价格、模型和界面名称可能变化；这是一份操作指南，并非实时产品状态。

旧版 OpenHands 终端客户端，供现有安装维护与迁移参考。

**已不再积极维护**

官方仓库已说明该 CLI 不再积极维护，并推荐迁移到 Agent Canvas。

编程 Agent · OpenHands · macOS · Linux

 

## 适合的工作流

适合维护现有 OpenHands CLI 安装并了解其配置。

## 限制与计费

官方仓库已说明该 CLI 不再积极维护，并推荐迁移到 Agent Canvas。

## 已核实的功能

Agent 工作流 · 命令行界面 · MCP · 自带 API 密钥

这里只列出有依据的功能，并非完整功能清单。未列出的能力尚未在这条资料中核实。

## 价格与用量

**查看官方价格**

旧版客户端；另计服务商和基础设施费用。按量使用或外部 Agent 的费用可能与订阅分开计算。

## 模型与访问权限

配置已安装版本所支持的 LLM 服务商。

<span id="cli-setup"></span>

## 安装并启动 CLI

旧版安装需要 Python 3.12+ 和 uv 0.11.6+；安装前先阅读迁移说明。

```
uv tool install openhands --python 3.12
```

在终端打开项目目录，然后运行：

```
openhands
```

## 账户与身份验证

首次启动向导用于配置旧版客户端所使用的 LLM 服务商。

## 项目配置与工具

设置存放于 ~/.openhands/；已核对版本需要 --override-with-envs 才能用环境变量覆盖。

## 建议尝试的首个任务

先检查现有安装及服务商设置，再决定是否迁移。

## 脚本用法

此示例请求生成项目概览。工具权限仍然生效；提示词不等于沙箱隔离。

```
openhands --headless -t "Summarize the project structure without modifying files."
```

## 相关 CLI 工具

[查看全部 AI CLI →](/zh/blog/traeide-coding-agents-zh)

[goose](/zh/blog/traeide-goose-zh) — 开源 Agent，连接模型服务商、MCP 工具与可复用的任务配方。

[OpenCode](/zh/blog/traeide-opencode-zh) — 开源编程 Agent，提供终端界面并支持配置不同模型服务商。

[Mistral Vibe](/zh/blog/traeide-mistral-vibe-zh) — Mistral 编程 Agent，支持终端、脚本及可配置的本地或托管模型。

## 项目评估步骤

1. 打开一个熟悉的小型项目，确认必要的语言工具能够正常工作。
2. 给 Agent 一项范围明确的修改任务，并设定可观察的验收标准。
3. 审查差异、运行项目检查，并与现有工作流的结果比较。
4. 任务结束后查看用量，据此估算同类工作一个月的费用，包括单独的模型或 Agent 账单。

## TRAE 站内延伸阅读

- [TRAE 产品详情与教程入口](/zh/ide/trae)
- [Trae IDE / TraeCode 下载指南](/zh/blog/traeide-download-zh)
- [TraeCode 使用指南](/zh/blog/traeide-traecode-zh)
- [TraeWork 使用指南](/zh/blog/traeide-traework-zh)
- [TRAE 价格：TraeCode 与 TraeWork](/zh/blog/traeide-pricing-zh)
- [TRAE 模型与访问权限](/zh/blog/traeide-models-zh)
- [TraeWork 与 TraeCode（Trae IDE）比较](/zh/blog/traeide-traework-vs-traecode-zh)
- [TRAE MCP 配置与故障排查](/zh/blog/traeide-mcp-zh)