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

# CLI

> 터미널에서 직접 CloudThinker 에이전트 대화를 실행하고, 리소스를 조회하며, 운영을 관리하세요

<Note>
  **미리 보기** — CloudThinker CLI는 얼리 액세스 단계입니다. 명령어 이름, 플래그, 설정 형식은 정식 출시 전에 변경될 수 있습니다. 미리 보기 참여를 원하시면 [문의하기](https://cloudthinker.io/contact)를 클릭하세요.
</Note>

`cloudthinker` CLI는 에이전트 대화, 리소스 조회, 운영 관리 기능을 터미널로 가져옵니다. 셸 스크립팅, CI 파이프라인, 콘솔보다 키보드를 선호하는 엔지니어에게 유용합니다.

***

## 사용 가능한 기능

| 기능         | 설명                                                |
| ---------- | ------------------------------------------------- |
| 에이전트와 대화   | 터미널에서 Alex, Oliver, Tony, Kai, 또는 Anna와 대화형 세션 시작 |
| 단일 프롬프트 실행 | `@agent #tool ...` 프롬프트를 한 번 실행하고 결과를 다른 도구로 파이프  |
| 스크립트 작업    | 반복적인 클라우드 운영 작업을 셸 스크립트로 래핑하여 CI에서 실행             |
| 리소스 관리     | 연동, 리소스, 권장 사항, 인시던트 검사                           |

***

## 설치

| 플랫폼         | 방법                                                 |
| ----------- | -------------------------------------------------- |
| **macOS**   | `brew install cloudthinker/tap/cloudthinker`       |
| **Linux**   | `curl -fsSL https://install.cloudthinker.io \| sh` |
| **Windows** | `winget install CloudThinker.CLI`                  |
| **Docker**  | `docker run cloudthinker/cli`                      |

***

## 인증

```bash theme={null}
cloudthinker login
```

CLI는 REST API와 동일한 워크스페이스 [API 키](/ko/guide/api/overview)를 사용합니다. 키는 OS 키체인에 저장되며 평문 설정 파일에는 기록되지 않습니다.

***

## 명령어

| 명령어                                  | 용도                                             |
| ------------------------------------ | ---------------------------------------------- |
| `cloudthinker chat`                  | 대화형 에이전트 세션 시작                                 |
| `cloudthinker ask "@alex #cost ..."` | 단일 프롬프트 실행, 응답 출력                              |
| `cloudthinker resources list`        | 통합 리소스 인벤토리 조회                                 |
| `cloudthinker recommendations list`  | 활성 비용, 보안, 안정성 권장 사항 목록 조회                     |
| `cloudthinker incidents create`      | 터미널에서 인시던트 생성                                  |
| `cloudthinker skills run <name>`     | [워크스페이스 Skill](/ko/guide/skills/overview) 실행   |
| `cloudthinker connections list`      | 구성된 [연동](/ko/guide/connections/overview) 목록 조회 |

***

## 출력 형식

| 플래그             | 형식                              |
| --------------- | ------------------------------- |
| `--format text` | 기본값 — 터미널에서 읽기 쉬운 형식            |
| `--format json` | `jq`, 스크립트, CI로 파이프하기 위한 기계 가독형 |
| `--format yaml` | 설정 친화적 출력                       |

***

## 관련 항목

<CardGroup cols={2}>
  <Card title="API" icon="code" href="/ko/guide/api/overview">
    HTTPS 엔드포인트를 통한 동일한 작업 수행
  </Card>

  <Card title="MCP Server" icon="plug" href="/ko/guide/mcp/overview">
    MCP 호환 AI 클라이언트에서 CloudThinker 사용
  </Card>

  <Card title="작업 & 스케줄링" icon="calendar-check" href="/ko/guide/automation/tasks">
    반복 작업 예약
  </Card>

  <Card title="Slack 연동" icon="slack" href="/ko/guide/slack-integration">
    Slack에서 동일한 작업 실행
  </Card>
</CardGroup>