사전 준비

이 단계는 한 번만 하면 됩니다. 이미 갖춘 항목은 건너뛰면 됩니다.

book-studio는 외부 API에 거의 의존하지 않습니다. 책을 쓰는 데 결제 계정도 API 키도 필요 없습니다. 그래서 사전 준비가 다른 base보다 간단합니다. 외부 검색이나 삽화가 필요할 때만 그때 따로 키를 안내합니다.

운영체제별 차이

항목	macOS	Windows	Linux
사용하는 터미널	Terminal.app 또는 iTerm2	WSL2 위의 Ubuntu를 권장합니다	배포판이 제공하는 셸
검증 상태	검증됐습니다	WSL2를 먼저 설치한 다음 그 안에서 모든 명령을 실행합니다	검증됐습니다

Windows에서는 WSL2 설치 안내를 먼저 끝낸 다음 이쪽으로 돌아오세요.

1) git

챕터별로 commit을 남겨 버전을 관리하기 때문에 git이 필요합니다.

macOS

xcode-select --install

작은 다이얼로그 창이 떠서 동의를 받고 설치가 시작됩니다. git이 이미 설치돼 있으면 안내 메시지만 한 줄 띄우고 끝납니다.

Linux와 WSL2

sudo apt update && sudo apt install -y git

설치 검증과 본인 정보 등록

git --version    # git version 2.x.x
git config --global user.name "Your Name"
git config --global user.email "your@example.com"

이 이름과 이메일이 챕터 commit의 작성자로 기록됩니다.

2) Markdown 뷰어는 선택

챕터는 markdown 파일로 쌓입니다. 작업 중 미리보기를 보고 싶다면 markdown 뷰어가 있으면 편합니다. VS Code나 Typora가 무난합니다. 꼭 필요하지는 않습니다. AI가 글을 쓰고 챕터 파일에 저장하기 때문에, 텍스트 편집기 아무거나로 열어 봐도 됩니다.

3) Claude Code

공식 설치 안내는 docs.claude.com/ko/docs/claude-code/quickstart에 있습니다. 설치 후 claude를 한 번 실행해 로그인하거나 API 키를 등록합니다.

claude --version    # 버전 번호가 뜨면 준비 완료

Claude Code 대신 OpenAI Codex CLI를 써도 됩니다. 그 경우 진입점은 저장소 루트의 AGENTS.md이고 같은 흐름이 그대로 적용됩니다. 처음이라면 Claude Code를 권합니다.

4) 외부 검색과 삽화는 선택

research 스킬(외부 검색)과 illustration 스킬(삽화 생성)은 기본 흐름에서 켜지지 않습니다. 기술서처럼 사실 확인이 필요하거나, 소설 표지가 필요할 때만 본인이 명시로 요청하면 그때 키를 안내받습니다. 첫 책을 쓰는 데는 둘 다 없어도 됩니다.

다음

git과 Claude Code를 모두 설치했다면 clone-and-install로 갑니다.