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

# 설치하기

> Sonamu VS Code Extension 설치 방법

Sonamu 개발을 위한 VS Code 확장을 설치하는 방법입니다.

## Marketplace에서 설치

[VS Code Marketplace](https://marketplace.cursorapi.com/items/?itemName=CartaNova.sonamu)에서 직접 설치할 수 있습니다.

1. VS Code에서 Extensions 탭 열기 (Cmd+Shift+X)
2. "Sonamu" 검색
3. Install 버튼 클릭

<Frame caption="Marketplace에서 Sonamu Extension 검색">
  <img src="https://mintcdn.com/cartanova-7788888c/gHShQ4W7H-WpAKgp/images/vscode-extension4.png?fit=max&auto=format&n=gHShQ4W7H-WpAKgp&q=85&s=7fe848d39a2732b9c3e306844a4fd560" alt="Marketplace에서 Sonamu Extension 검색" width="2340" height="1890" data-path="images/vscode-extension4.png" />
</Frame>

## 직접 빌드하여 설치

소스코드를 직접 빌드하여 설치할 수도 있습니다:

```bash theme={null}
cd ~/Projects/vscode-sonamu
pnpm install && pnpm build
cd packages/extension && pnpm package
code --install-extension sonamu-*.vsix
```

### 업데이트

이미 설치된 Extension을 업데이트하려면 `--force` 옵션을 추가합니다:

```bash theme={null}
code --install-extension sonamu-*.vsix --force
```

## 활성화 확인

Extension이 제대로 설치되면 워크스페이스에 `sonamu.config.ts` 파일이 있을 때 자동으로 활성화됩니다.

활성화 여부는 다음과 같이 확인할 수 있습니다:

1. Command Palette 열기 (Cmd+Shift+P)
2. "Sonamu" 입력
3. Sonamu 관련 명령어들이 표시되는지 확인

<Frame caption="Sonamu 명령어 확인">
  <img src="https://mintcdn.com/cartanova-7788888c/gHShQ4W7H-WpAKgp/images/vscode-extension5.png?fit=max&auto=format&n=gHShQ4W7H-WpAKgp&q=85&s=a1a4db6f3ea8a3a42d8ed8ef608624eb" alt="Sonamu 명령어 확인" width="1410" height="400" data-path="images/vscode-extension5.png" />
</Frame>