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

# Helius CLI

> Helius를 위한 완전한 기능의 명령줄 인터페이스. 계정 관리, 블록체인 쿼리, 트랜잭션 전송, 웹훅, 스트리밍, 스테이킹 등을 위한 95개 이상의 명령어를 제공합니다. 에이전트와 자동화를 위해 설계되었습니다.

[Helius CLI](https://www.npmjs.com/package/helius-cli)는 Helius 플랫폼을 위한 완전한 기능의 명령줄 인터페이스입니다. 계정 관리, 블록체인 데이터 쿼리, 트랜잭션 전송, 웹훅, 실시간 스트리밍, 스테이킹, ZK Compression 등을 위한 95개 이상의 명령어를 제공하며, 모든 명령에 기계 판독 가능한 JSON 출력을 제공합니다.

<Tip>
  **MCP 호환 AI 도구를 사용 중인가요?** [Helius MCP 서버](/docs/ko/agents/mcp)는 AI 에이전트가 Helius와 상호 작용하는 데 권장되는 방법입니다. 구조화된 입력/출력을 갖춘 10개의 라우팅 도구를 제공하며, 계정 등록이 내장되어 있습니다. MCP를 사용할 수 없을 때는 셸 스크립트, CI/CD 파이프라인 등을 위해 CLI를 사용하십시오.
</Tip>

## 설치

```bash theme={"system"}
npm install -g helius-cli
```

## 빠른 시작 — 기존 사용자

이미 Helius API 키가 있다면 설정하고 시작하십시오:

```bash theme={"system"}
helius config set-api-key YOUR_API_KEY
```

키는 [dashboard.helius.dev](https://dashboard.helius.dev)에서 가져오십시오. 그것으로 끝입니다 — 아래의 가입 단계를 건너뛰십시오.

## 빠른 시작 — 신규 사용자

<Note>
  모든 `helius signup` 호출은 `--email`, `--first-name`, `--last-name`가 필요합니다 — 에이전트 플랜을 포함하여.
</Note>

<Steps>
  <Step title="키페어 생성">
    ```bash theme={"system"}
    helius keygen
    ```

    출력:

    ```
    ✓ Keypair generated
    Path: ~/.helius/keypair.json
    Address: 7xKp...3nQm

    To use this wallet, fund it with:
      • ~0.001 SOL for transaction fees
      • 1 USDC for Helius signup
    ```

    위의 자금 조언은 자동 결제를 사용할 경우에만 적용됩니다 — 호스팅된 링크를 통해 결제할 계획이라면 자금을 건너뛰십시오.
  </Step>

  <Step title="계정 생성">
    두 가지 결제 방식: 호스팅된 링크로 결제(지갑으로 결제, 자금 필요 없음) 또는 자동 결제(로컬 키페어에서 USDC 결제, 약 0.001 SOL + 계획 금액이 있어야 함).

    ```bash theme={"system"}
    # Default: print a hosted payment link, pay with any wallet in the browser
    helius signup --email you@example.com --first-name Jane --last-name Doe

    # After paying via link, finalize the account
    helius signup --resume

    # Or autopay from the local keypair
    helius signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe
    ```
  </Step>

  <Step title="API 키 및 엔드포인트 가져오기">
    ```bash theme={"system"}
    helius projects
    helius apikeys <project-id>
    helius rpc <project-id>
    ```
  </Step>
</Steps>

<Warning>
  API 키는 Helius 계정에 대한 액세스를 부여하는 민감한 정보입니다. 클라이언트 측 코드, 공개 저장소 또는 브라우저에서 접근 가능한 영역에 노출하지 마십시오.
</Warning>

## 요금제 및 가격

CLI를 통해 Helius 공유 요금제를 직접 구매할 수 있습니다. 가입 중 `--plan`를 전달하거나 나중에 `helius upgrade`를 사용하십시오:

| 플랜    | 가격      | 크레딧         | `--plan` 값     |
| ----- | ------- | ----------- | -------------- |
| 에이전트  | \$1 일회성 | 1,000,000   | `agent`        |
| 개발자   | \$49/월  | 10,000,000  | `developer`    |
| 비즈니스  | \$499/월 | 100,000,000 | `business`     |
| 프로페셔널 | \$999/월 | 200,000,000 | `professional` |

<Note>
  **에이전트** 플랜 (`agent`)은 기본 설정입니다. 남용을 방지하기 위해 \$1(USDC로 지불)을 필요로 하며, 1,000,000 크레딧을 제공합니다. 높은 속도 제한과 더 많은 크레딧을 위해 유료 요금제에 가입하거나 나중에 업그레이드하십시오.
</Note>

### 특정 요금제로 가입

```bash theme={"system"}
# Default: Agent plan ($1)
helius signup --email you@example.com --first-name Jane --last-name Doe

# Developer plan ($49/mo)
helius signup --plan developer --email you@example.com --first-name Jane --last-name Doe

# Yearly billing (paid plans only)
helius signup --plan business --period yearly --email you@example.com --first-name Jane --last-name Doe
```

### 기존 계정 업그레이드

```bash theme={"system"}
helius upgrade --plan developer --email you@example.com --first-name Jane --last-name Doe
```

### 갱신 결제

구독 갱신이 필요할 때(매월 또는 매년), Helius는 **결제 의도**를 생성합니다 — 고유 ID, 금액, 만료일을 가진 보류 중인 결제입니다. 이메일이나 [대시보드](https://dashboard.helius.dev)를 통해 결제 의도 ID를 받게 됩니다.

```bash theme={"system"}
helius pay <payment-intent-id>
```

명령어는 의도 세부 정보를 가져오고, 금액과 만료일을 보여준 후 확인을 요청한 다음, 키페어 지갑에서 USDC 결제를 전송합니다.

## 명령어 참조

CLI는 14개의 카테고리에서 95개 이상의 명령어를 제공합니다. 모든 명령은 기계 판독 가능한 출력과 `--api-key <key>` / `--network <net>` 전역 재정의를 지원합니다.

<Card title="전체 명령어 참조" icon="terminal" href="/docs/ko/agents/cli/commands">
  모든 95개 이상의 명령어 — 계정 관리, 블록체인 쿼리, DAS API, 지갑, 웹훅, 트랜잭션 전송, 웹소켓, 스테이킹, ZK 압축 등
</Card>

## JSON 출력 모드

기계 판독 가능한 출력을 위해 어느 명령에나 `--json` 를 추가하십시오:

```bash theme={"system"}
helius projects --json
helius balance Gh9ZwEm... --json
helius asset owner 86xCnPe... --json
```

예시:

```json theme={"system"}
{
  "projects": [
    {
      "id": "67b9d260-726b-4ba3-8bb0-dbbf794641bf",
      "name": "My Project",
      "plan": "free"
    }
  ]
}
```

## 종료 코드

에이전트는 신뢰할 수 있는 자동화를 위해 종료 코드를 확인해야 합니다:

| 코드 | 의미            |
| -- | ------------- |
| 0  | 성공            |
| 1  | 일반 오류         |
| 10 | 로그인되지 않음      |
| 11 | 키페어를 찾을 수 없음  |
| 20 | SOL 부족        |
| 21 | USDC 부족       |
| 30 | 프로젝트를 찾을 수 없음 |
| 31 | 프로젝트를 찾을 수 없음 |
| 40 | API 오류        |

## 설정

설정은 `~/.helius/` 에 저장됩니다:

```
~/.helius/
├── config.json    # JWT token, API key, network, default project
└── keypair.json   # Solana keypair (if generated with keygen)
```

설정을 다음을 통해 관리하십시오:

```bash theme={"system"}
helius config show              # View current config
helius config set-api-key <key> # Set API key
helius config set-network devnet # Switch to devnet
helius config set-project <id>  # Set default project
helius config clear             # Reset everything
```

### API 키 해결 순서

API 키는 다음 순서로 해결됩니다:

1. `--api-key <key>` 플래그 (명령별 재정의)
2. `HELIUS_API_KEY` 환경 변수
3. `~/.helius/config.json` (`helius config set-api-key`를 통해 설정됨)

## 전역 옵션

모든 명령은 다음 플래그를 수락합니다:

| 플래그                    | 설명                               |
| ---------------------- | -------------------------------- |
| `--api-key <key>`      | 구성된 API 키 재정의                    |
| `--network <net>`      | 네트워크 재정의 (`mainnet` 또는 `devnet`) |
| `--json`               | JSON 형식으로 출력                     |
| `-k, --keypair <path>` | 키페어 파일 경로 (서명 필요 명령)             |

## 전체 에이전트 워크플로우

```bash theme={"system"}
# Step 1: Generate keypair
helius keygen

# Step 2: Create account (default: hosted payment link, pay from any wallet)
helius signup --email you@example.com --first-name Jane --last-name Doe
helius signup --resume   # Finalize after paying via link
# Or autopay from the local keypair (requires ~0.001 SOL + plan USDC):
# helius signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe

# Step 3: Get API keys
helius projects
helius apikeys <project-id>

# Step 4: Get RPC endpoints
helius rpc <project-id>

# Step 5: Start querying
helius balance <address>
helius asset owner <wallet-address>
helius tx history <address> --limit 10
```

## 다음 단계

<CardGroup cols={2}>
  <Card title="에이전트 개요" icon="robot" href="/docs/ko/agents/overview">
    에이전트에 대한 API 가이드, 워크플로 및 오류 처리
  </Card>

  <Card title="Helius MCP" icon="plug" href="/docs/ko/agents/mcp">
    AI 도구를 Helius API에 직접 연결
  </Card>

  <Card title="요금제 보기" icon="credit-card" href="/docs/ko/billing/plans">
    Helius 요금제 이해 및 업그레이드 옵션
  </Card>

  <Card title="대시보드" icon="chart-line" href="https://dashboard.helius.dev">
    API 사용량 모니터링 및 키 관리
  </Card>
</CardGroup>

## 지원

<CardGroup cols={2}>
  <Card title="Discord 커뮤니티" icon="discord" href="https://discord.com/invite/6GXdee3gBj">
    실시간 도움말 및 커뮤니티 지원을 위해 Discord에 참여하십시오
  </Card>

  <Card title="이메일 지원" icon="envelope" href="mailto:support@helius.xyz">
    지원 팀에 직접 연락하십시오
  </Card>
</CardGroup>