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

# NPM 설치

> React 애플리케이션용 Moss SDK의 NPM 설치 단계별 안내서입니다.

# NPM 설치 안내서

이 안내서는 React 애플리케이션용 NPM 설치를 다룹니다. React를 사용하지 않는 애플리케이션이나 간단한 스크립트 태그 통합의 경우 [CDN 설치 안내서](/ko/cdn-installation)를 참조하세요.

## 설치 방법

Moss SDK는 두 가지 설치 방법을 제공합니다:

| 방법                                 | 최적 용도                      | 설정 복잡도 |
| ---------------------------------- | -------------------------- | ------ |
| **[CDN 설치](/ko/cdn-installation)** | React 미사용 앱, 간단한 통합        | ⭐ 간단   |
| **NPM 설치** (이 안내서)                 | React 앱, 완전한 TypeScript 지원 | ⭐⭐ 보통  |

## 전제 조건

* React 애플리케이션 (v17 이상)
* 활성화된 Node.js 환경 (v18 이상 권장)

## 1. SDK 설치하기

Moss SDK는 공개 NPM 레지스트리에 게시되어 있습니다. 인증이나 `.npmrc` 설정이 필요하지 않습니다.

```bash theme={null}
npm install @viamoss/moss-sdk
```

또는

```bash theme={null}
pnpm add @viamoss/moss-sdk
```

또는

```bash theme={null}
yarn add @viamoss/moss-sdk
```

## 2. 통합

설치 후에는 [**빠른 시작 안내서**](/ko/quickstart)에 설명된 대로 SDK를 애플리케이션에 통합할 수 있습니다.

## 대안: CDN 설치

더 간단한 설정을 선호하거나 React를 사용하지 않는다면 [**CDN 설치**](/ko/cdn-installation) 방법을 고려하세요:

```html theme={null}
<!-- 한 줄 설치 -->
<script src="https://cdn.moss.ai/moss-sdk@latest?applicationId=YOUR_APP_ID"></script>
```

이 방법은 빌드 도구, 패키지 관리자 또는 React 종속성이 필요하지 않습니다.