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

# 빠른 시작

> 세 가지 붙여넣기식 Node 스크립트로 스왑, CPMM 풀 생성, CLMM 풀 생성을 수행합니다. 최소 설정, 5분 이내에 실제 온체인 결과를 얻습니다.

<Info>
  **이 페이지는 AI 자동 번역입니다. 모든 내용은 영문판을 기준으로 합니다.**

  [영문판 보기 →](/quick-start/index)
</Info>

<Info>
  **이 장의 내용.** 파일에 붙여넣고 몇 가지 환경 변수를 설정한 후 실행할 수 있는 세 가지 엔드투엔드 Node 스크립트입니다. 각 스크립트는 Raydium을 통해 실제 온체인 작업을 수행합니다. 더 큰 프로젝트를 시작하기 전에 이들을 사용하여 설정을 검증하세요.

  **이 장의 내용이 아닌 것.** 참조 문서입니다. 전체 빌더 API, 매개변수 참조, 엣지 케이스는 [SDK & API](/ko/sdk-api)와 제품별 `code-demos` 페이지를 참고하세요.
</Info>

## 사전 준비

다음을 한 번 실행하세요:

```bash theme={null}
mkdir raydium-quickstart && cd raydium-quickstart
npm init -y
npm install @raydium-io/raydium-sdk-v2 @solana/web3.js @solana/spl-token bn.js
```

필요한 것들:

* **Node 18 이상** ESM 지원 포함 (`package.json`에 `"type": "module"` 또는 `.mjs` 확장자).
* **Solana 키페어** (`~/.config/solana/id.json` 위치 또는 다른 곳 — `KEYPAIR` 설정).
* **자금이 있는 지갑.** 이 장의 모든 스크립트는 약 0.05 SOL이 필요합니다.
* **RPC URL.** 테스트용 무료 공개 RPC를 사용할 수 있지만, 스모크 테스트 이상을 원하면 유료 공급자를 사용하세요.

셸당 한 번 설정하세요:

```bash theme={null}
export RPC_URL="https://api.mainnet-beta.solana.com"
export KEYPAIR="$HOME/.config/solana/id.json"
```

<Info>
  **클러스터.** 세 스크립트 모두 메인넷을 기본값으로 사용합니다. 데브넷에서 실행하려면 `RPC_URL=https://api.devnet.solana.com`을 설정하고 스크립트 내의 `cluster: "mainnet"`을 `cluster: "devnet"`으로 변경하세요. 데브넷의 풀 시드 유동성이 제한적임을 주의하세요. 테스트 토큰을 직접 생성해야 할 수 있습니다.
</Info>

## 세 가지 스크립트

<CardGroup cols={3}>
  <Card title="CLI에서 스왑" icon="right-left" href="/ko/quick-start/swap-from-cli">
    모든 CPMM 풀을 통해 한 토큰을 다른 토큰으로 스왑합니다. Raydium을 스크립트에서 실행할 수 있는지 가장 빠르게 확인합니다.
  </Card>

  <Card title="CPMM 풀 배포" icon="droplet" href="/ko/quick-start/deploy-cpmm-pool">
    선택한 토큰 쌍의 새로운 CPMM 풀을 생성합니다. 0.25% 수수료 등급을 선택하고 초기 유동성을 제공합니다.
  </Card>

  <Card title="CLMM 풀 배포" icon="chart-line" href="/ko/quick-start/deploy-clmm-pool">
    선택한 수수료 등급과 단일 집중 포지션을 사용하여 새로운 CLMM 풀을 생성합니다.
  </Card>
</CardGroup>

## 이 장 이후

각 스크립트는 최소한의 출력(풀 ID, 트랜잭션 서명)과 수행한 작업에 대한 [SDK & API](/ko/sdk-api) 장의 다음 페이지를 가리키는 한 줄을 제공합니다. 자신만의 통합을 작성할 준비가 되면:

* **백엔드 및 봇** → [Trade API](/ko/sdk-api/trade-api).
* **프론트엔드 및 완전 제어 앱** → [TypeScript SDK](/ko/sdk-api/typescript-sdk).
* **온체인 구성** → [Rust CPI](/ko/sdk-api/rust-cpi).
* **선택 기준** → [SDK & API](/ko/sdk-api)의 상단 비교 표.

## 버전 정보

```
SDK:       @raydium-io/raydium-sdk-v2@0.2.42-alpha
Programs:  see /reference/program-addresses
Cluster:   mainnet-beta (also runs on devnet with the change noted above)
Verified:  2026-04
```

새 SDK 버전에서 스크립트가 작동하지 않으면 SDK의 릴리스 노트를 확인하세요 — 빌더 반환 형태는 마이너 릴리스 간에 변경되었습니다.