> ## 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-Hant/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-Hant/integrations/mcp)。MCP 和 CLI 的使用體驗相近，但底層是呼叫 MCP 伺服器提供的工具，而不是在沙箱裡執行命令列程式。
* 當同一個 CLI 工作流程需要按計劃重複執行時，使用 [Automations](/zh-Hant/features/automations)。