사전 준비

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

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 "[email protected]"

이 이름과 이메일이 챕터 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로 갑니다.