# 2. 설치 및 초기 설정
← [[openspec-01-what-is-openspec|1. OpenSpec이란?]] | 다음 → [[openspec-03-core-concepts|3. 핵심 개념 이해]]
---
## 2.1 사전 요구사항
> [!warning] Node.js 버전 확인 필수
> Node.js **20.19.0 이상**이 필요하다.
```bash
node --version # v20.19.0 이상이어야 함
```
Node.js가 없다면 [nodejs.org](https://nodejs.org)에서 LTS 버전을 설치한다.
## 2.2 패키지 매니저별 설치
```bash
# npm (가장 일반적)
npm install -g @fission-ai/openspec@latest
# pnpm
pnpm add -g @fission-ai/openspec@latest
# yarn
yarn global add @fission-ai/openspec@latest
# bun (Node.js도 별도 필요)
bun add -g @fission-ai/openspec@latest
```
**Nix 환경:**
```bash
# 직접 실행 (설치 없이)
nix run github:Fission-AI/OpenSpec -- init
# 프로필에 설치
nix profile install github:Fission-AI/OpenSpec
```
개발 환경 `flake.nix`에 통합:
```nix
{
inputs = {
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
openspec.url = "github:Fission-AI/OpenSpec";
};
outputs = { nixpkgs, openspec, ... }: {
devShells.x86_64-linux.default = nixpkgs.legacyPackages.x86_64-linux.mkShell {
buildInputs = [ openspec.packages.x86_64-linux.default ];
};
};
}
```
> [!note] bun 사용 시 주의
> bun으로 글로벌 설치할 수 있지만, OpenSpec은 Node.js로 실행된다. Node.js 20.19.0 이상이 `PATH`에 있어야 한다.
## 2.3 설치 확인
```bash
openspec --version
```
## 2.4 프로젝트 초기화
```bash
cd your-project
openspec init
```
초기화 시 대화형 프롬프트가 두 가지를 묻는다:
1. **AI 도구 선택:** 사용하는 AI 코딩 어시스턴트를 선택 (복수 선택 가능) → [[openspec-09-supported-tools-and-integration|지원 도구 목록]]
2. **프로필 선택:** `core`(권장) 또는 `custom`
> [!tip] 비대화형 초기화 (CI/CD 또는 스크립트)
> ```bash
> openspec init --tools claude,cursor --profile core
> openspec init --tools all # 모든 도구
> openspec init --tools none # 도구 없이 (CLI만 사용)
> openspec init --force # 레거시 파일 자동 정리
> ```
## 2.5 첫 번째 변경 제안 (빠른 시작)
초기화 직후 AI 채팅에서 바로 시작:
```
/opsx:propose add-hello-world
```
> [!success] 자동 생성 파일
> - `proposal.md` — 의도, 범위, 접근 방식
> - `specs/` — Delta Specs
> - `design.md` — 기술적 구현 방법
> - `tasks.md` — 구현 체크리스트
전체 워크플로우는 [[openspec-05-core-workflows|5장 핵심 워크플로우]]를 참고한다.
---
← [[openspec-01-what-is-openspec|1. OpenSpec이란?]] | 다음 → [[openspec-03-core-concepts|3. 핵심 개념 이해]]