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

# Skills 설치

> Cursor, Claude Code, ClawHub 등에 ChainStream Agent Skills 설치하기

## 설치 방법

ChainStream Skills는 사용 중인 에이전트 플랫폼에 따라 여러 채널을 통해 설치할 수 있습니다. `npx skills add` 경로가 가장 빠르며 — 하나의 명령으로 Cursor, Claude Code, Codex, OpenCode, OpenClaw에 걸쳐 동작합니다.

| 방법                                              | 내용                                               | 설치 시간 |
| ----------------------------------------------- | ------------------------------------------------ | ----- |
| [`npx skills add` (권장)](#npx-skills-add로-설치-권장) | 크로스 플랫폼 설치기: 대상 에이전트에 세 가지 ChainStream 스킬을 모두 추가 | \~20초 |
| [ClawHub](#clawhub)                             | `openclaw skills install`을 통한 마켓플레이스 설치          | \~30초 |
| [Cursor](#cursor)                               | 저장소 클론 + `.cursor-plugin/` 자동 인식                 | \~1분  |
| [Claude Code](#claude-code)                     | `/plugin install chainstream`                    | \~30초 |
| [Codex](#codex)                                 | Git clone + `~/.agents/skills/`에 심볼릭 링크          | \~1분  |
| [OpenCode](#opencode)                           | Git clone + `~/.agents/skills/`에 심볼릭 링크          | \~1분  |
| [Gemini CLI](#gemini-cli)                       | `gemini extensions install`                      | \~30초 |

***

## `npx skills add`로 설치 (권장)

하나의 명령으로 세 가지 ChainStream 스킬(`chainstream-data`, `chainstream-graphql`, `chainstream-defi`)을 모두 대상 에이전트에 설치합니다. 설치 대상은 `-a <agent>` 옵션으로 선택하세요.

<Tabs>
  <Tab title="Cursor">
    ```bash theme={null}
    npx skills add chainstream-io/skills -a cursor
    ```
  </Tab>

  <Tab title="Claude Code">
    ```bash theme={null}
    npx skills add chainstream-io/skills -a claude-code
    ```
  </Tab>

  <Tab title="OpenClaw">
    ```bash theme={null}
    npx skills add chainstream-io/skills -a openclaw
    ```
  </Tab>

  <Tab title="Codex">
    ```bash theme={null}
    npx skills add chainstream-io/skills -a codex
    ```
  </Tab>

  <Tab title="OpenCode">
    ```bash theme={null}
    npx skills add chainstream-io/skills -a opencode
    ```
  </Tab>
</Tabs>

설치 후 CLI와 MCP 도구가 동작하도록 API Key를 구성하세요:

```bash theme={null}
npx @chainstream-io/cli login                               # 지갑 생성 + nano trial (50K CU) 자동 지급
# 또는 이미 키가 있는 경우:
npx @chainstream-io/cli config set --key apiKey --value <your-api-key>
```

<Note>
  `npx skills add`는 매 실행 시 스킬의 최신 버전을 가져오므로 재실행하면 업데이트됩니다. 전체 OpenClaw 설치 플로우(스킬 검증, 다중 에이전트 타겟팅)는 [Ecosystem → OpenClaw → Skills Install](/ko/docs/ecosystem/openclaw/skills-install)을 참고하세요.
</Note>

***

## ClawHub

ChainStream Skills는 OpenClaw 스킬 마켓플레이스인 [ClawHub](https://clawhub.ai)에 게시되어 있습니다.

| Skill               | ClawHub URL                                                              | 버전 |
| ------------------- | ------------------------------------------------------------------------ | -- |
| chainstream-data    | [clawhub.ai/chainstream-data](https://clawhub.ai/chainstream-data)       | 최신 |
| chainstream-graphql | [clawhub.ai/chainstream-graphql](https://clawhub.ai/chainstream-graphql) | 최신 |
| chainstream-defi    | [clawhub.ai/chainstream-defi](https://clawhub.ai/chainstream-defi)       | 최신 |

```bash theme={null}
# ClawHub CLI를 통해 설치
openclaw skills install chainstream-data
openclaw skills install chainstream-graphql
openclaw skills install chainstream-defi
```

또는 ClawHub 웹 UI에서 설치할 수 있습니다 — 스킬 페이지에서 **Install** 버튼을 클릭하고 안내를 따르세요.

***

## Cursor

Skills는 스킬 저장소에 포함된 `.cursor-plugin/plugin.json` 설정을 통해 자동으로 인식됩니다.

<Steps>
  <Step title="스킬 저장소 클론">
    ```bash theme={null}
    git clone https://github.com/chainstream-io/skills.git
    ```
  </Step>

  <Step title="Cursor에서 열기">
    클론한 `skills/` 디렉토리를 Cursor에서 엽니다. `.cursor-plugin/plugin.json`이 Cursor에 스킬을 자동으로 로드하도록 지시합니다.
  </Step>

  <Step title="API Key 설정">
    CLI 및 MCP 접근을 위해 API Key를 설정합니다:

    ```bash theme={null}
    npx @chainstream-io/cli config set --key apiKey --value <your-api-key>
    ```
  </Step>

  <Step title="사용 시작">
    AI 어시스턴트에게 질문해 보세요:

    ```
    search for meme tokens on Solana
    is <token_address> safe to buy?
    swap 0.1 SOL for <token_address>
    ```
  </Step>
</Steps>

<Note>
  Cursor는 향후 ChainStream을 마켓플레이스 플러그인으로도 제공할 예정입니다. 출시되면 Cursor 설정 > 확장에서 직접 설치할 수 있습니다.
</Note>

***

## Claude Code

```bash theme={null}
/plugin install chainstream
```

스킬 저장소의 `.claude-plugin/plugin.json`이 Claude Code에 플러그인 메타데이터를 제공합니다.

<Note>
  Claude Code 마켓플레이스 플러그인은 곧 출시됩니다. 출시 후에는 Claude Code 플러그인 스토어에서 직접 설치할 수 있습니다.
</Note>

***

## Codex

<Steps>
  <Step title="저장소 클론">
    ```bash theme={null}
    git clone https://github.com/chainstream-io/skills.git ~/.agents/skills/chainstream
    ```
  </Step>

  <Step title="설정 따르기">
    클론한 저장소 내 `.codex/INSTALL.md`의 안내를 참조하세요.
  </Step>
</Steps>

***

## OpenCode

<Steps>
  <Step title="저장소 클론">
    ```bash theme={null}
    git clone https://github.com/chainstream-io/skills.git ~/.agents/skills/chainstream
    ```
  </Step>

  <Step title="설정 따르기">
    클론한 저장소 내 `.opencode/INSTALL.md`의 안내를 참조하세요.
  </Step>
</Steps>

***

## Gemini CLI

```bash theme={null}
gemini extensions install https://github.com/chainstream-io/skills
```

저장소 루트의 `gemini-extension.json`이 Gemini CLI가 컨텍스트 파일을 로드하도록 설정합니다.

***

## MCP Server 설정

Skills는 ChainStream MCP Server와 함께 사용할 때 가장 효과적입니다. MCP 클라이언트 설정에 다음을 추가하세요:

<Tabs>
  <Tab title="Cursor / VS Code">
    ```json theme={null}
    {
      "mcpServers": {
        "chainstream": {
          "url": "https://mcp.chainstream.io/mcp",
          "headers": { "X-API-KEY": "<your-api-key>" }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Desktop">
    `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) 또는 `%APPDATA%\Claude\claude_desktop_config.json` (Windows)에 추가하세요:

    ```json theme={null}
    {
      "mcpServers": {
        "chainstream": {
          "url": "https://mcp.chainstream.io/mcp",
          "headers": { "X-API-KEY": "<your-api-key>" }
        }
      }
    }
    ```
  </Tab>
</Tabs>

<Note>
  API Key는 [ChainStream Dashboard](https://app.chainstream.io) 또는 [x402 / MPP 결제](/ko/docs/platform/billing-payments/x402-payments)를 통해 발급받을 수 있습니다.
</Note>

***

## 설치 확인

설치 후 간단한 쿼리로 테스트해 보세요:

```bash theme={null}
# CLI를 통해
npx @chainstream-io/cli token search --keyword PUMP --chain sol

# AI 어시스턴트를 통해 (스킬이 로드된 경우)
# 질문: "search for PUMP tokens on Solana"
```

## 다음 단계

<CardGroup cols={2}>
  <Card title="chainstream-data" icon="magnifying-glass" href="/ko/docs/ai-agents/agent-skills/chainstream-data">
    데이터 조회 기능: 토큰, 시장, 지갑
  </Card>

  <Card title="chainstream-graphql" icon="diagram-project" href="/ko/docs/ai-agents/agent-skills/chainstream-graphql">
    커스텀 GraphQL 분석 및 JOIN
  </Card>

  <Card title="chainstream-defi" icon="right-left" href="/ko/docs/ai-agents/agent-skills/chainstream-defi">
    DeFi 실행: 스왑, 런치패드, 트랜잭션
  </Card>

  <Card title="OpenClaw Skills 설치" icon="cube" href="/ko/docs/ecosystem/openclaw/skills-install">
    `npx skills`의 전체 플래그와 다중 에이전트 타겟팅
  </Card>
</CardGroup>