> ## Documentation Index
> Fetch the complete documentation index at: https://docs.happycapy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI 工具

> 在 Happycapy 沙箱中运行命令行工具。

## 概览

CLI（command-line interface，命令行界面）是通过命令运行的工具，而不是通过按钮操作。很多服务都会提供 CLI，让用户用程序化方式管理代码仓库、文档、部署、日志和工作区数据。

在 Happycapy 中，你不需要记住这些命令。直接用自然语言描述你想完成什么，Happycapy 可以安装 CLI、选择合适的命令、在沙箱中运行、读取输出，并在同一个项目里继续后续工作。

CLI 可能连接 GitHub、Notion、Lark、Fly.io 这类外部服务，也可能只是处理沙箱中文件、代码、媒体或数据的本地工具。

## 什么时候用 CLI 工具

当某个服务把有用的操作提供为命令时，就适合用 CLI 工具：

* 处理代码仓库、Pull Request、Issue、日志和部署
* 读取或更新 Notion、Lark 这类工作区系统
* 运行云服务、数据库或基础设施命令
* 把可重复的命令行工作变成项目工作流

## CLI 还是 MCP？

CLI 和 MCP 在 Happycapy 里的使用体验可能很像：你都可以用自然语言说明目标，让智能体判断需要调用哪些工具或写哪些命令。

区别主要在连接方式。CLI 工具是 Happycapy 在沙箱里写并运行命令行程序；[MCP](/zh/integrations/mcp) 是 Happycapy 调用 MCP 服务器提供的工具能力。

如果某个服务有维护良好的官方 CLI，或者任务涉及部署、日志、脚本、文件处理、一次性配置，CLI 往往更直接。如果某个服务有维护良好的 MCP 服务器，或者你希望工具动作通过更结构化的接口提供给智能体，MCP 可能更合适。如果两者都支持，优先选择官方维护、权限清楚、配置最简单的方式。

## 开始前准备

最好先提供这些信息：

* 官方 CLI 名称或安装链接
* 要连接的账号、工作区、代码仓库或应用
* 需要的认证方式，例如登录流程、token、API key 或工作区权限
* 配置完成后希望 Happycapy 完成的结果

## 第一次使用

把工具和目标一起告诉 Happycapy：

```text theme={null}
在 Happycapy 沙箱中安装 [CLI 名称]。
继续之前，先告诉我需要哪种认证。
准备好之后，用它完成 [目标]。

CLI 链接：[官方链接]
```

## 推荐 CLI

这些 CLI 很适合在 Happycapy 沙箱中使用，因为它们把真实工作系统提供为命令，智能体可以安装、配置并运行。

<CardGroup cols={2}>
  <Card title="GitHub CLI" icon="https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/github.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=679bb093797d36e654af372f853a460a" href="https://cli.github.com" width="560" height="560" data-path="images/integrations/logos/github.png">
    处理代码仓库、Pull Request、Issue 和 GitHub Actions。
  </Card>

  <Card title="ntn" icon="https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/notion.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=534c589e6711180fe51fa3b632720e51" href="https://developers.notion.com/cli" width="64" height="64" data-path="images/integrations/logos/notion.png">
    搜索 Notion 页面、创建内容、查询数据库。
  </Card>

  <Card title="lark-cli" icon="https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/lark.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=adc21fbe2f882fafdd5006135fb05128" href="https://github.com/larksuite/cli" width="48" height="48" data-path="images/integrations/logos/lark.png">
    处理 Lark/飞书消息、文档、表格、日历、任务、邮件和会议。
  </Card>

  <Card title="flyctl" icon="https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/flyio.svg?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=d9342a993c06f2170919e5f5a526a3d3" href="https://fly.io/docs/flyctl/" width="167" height="151" data-path="images/integrations/logos/flyio.svg">
    部署和运维 Fly.io 应用、Machines、日志、密钥和发布记录。
  </Card>
</CardGroup>

## 示例工作流

```text theme={null}
使用 GitHub CLI。
查看这个代码仓库最近一次失败的 GitHub Actions 运行记录。
总结失败原因，并给出最小修复建议。
```

```text theme={null}
使用 ntn。
在我们的 Notion 工作区里搜索入门文档。
总结当前流程，并列出缺口。
```

```text theme={null}
使用 lark-cli。
从 Lark 文档收集本周项目更新。
整理成一份简短团队报告。
```

```text theme={null}
使用 flyctl。
检查这个 Fly.io 应用的状态和最近日志。
告诉我最新部署是否健康。
```

## 认证和权限

* 先说明 CLI 要连接的账号、工作区、代码仓库或项目。
* 尽量不要把密钥写进提示词。优先使用 CLI 自己的正常认证流程。
* 在批准认证前，可以让 Happycapy 说明它需要哪些权限。
* 如果使用 token，服务支持的话优先使用限定权限的 token 或短期 token。
* 对于有破坏性的操作，可以先让 Happycapy 展示命令和预期影响，再运行。

## 故障排查

### CLI 无法安装

提供官方安装链接，并让 Happycapy 检查沙箱环境、包管理器和平台要求。

### 登录失败

确认 CLI 需要的是浏览器登录、token 登录、工作区授权，还是环境变量。

### 权限不足

让 Happycapy 说明缺少哪个权限，以及是否需要换 token、角色、工作区、代码仓库或组织。

### 输出太宽泛

用代码仓库、项目、日期范围、文件路径、应用名称或命令目标缩小范围。

## 下一步

* 想了解另一种集成方式，可以继续看 [MCP](/zh/integrations/mcp)。MCP 和 CLI 的使用体验相近，但底层是调用 MCP 服务器提供的工具，而不是在沙箱里运行命令行程序。
* 当同一个 CLI 工作流需要按计划重复运行时，使用 [Automations](/zh/features/automations)。