스펙킷 설치할 때 막히는 부분만 짧게 정리해두기

Apr 23, 2026 updated Apr 23, 2026 codex setup spec-kit workflow

해당 문서는 스펙킷 설치 및 사용법을 정리하려고 적어둔 글입니다..
깃허브에 가면 친절하게 다 나와있긴 한데, 어차피 막히는 부분은 늘 비슷해서 작업 기준만 짧게 적어둡니다.

공식 저장소는 여기입니다.

https://github.com/github/spec-kit?tab=readme-ov-file

설치하기

제 기준에서는 uv부터 깔아두는 편이 제일 깔끔합니다.

curl -LsSf https://astral.sh/uv/install.sh | sh
source "$HOME/.local/bin/env"
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

이 정도면 스펙킷 자체 설치는 끝입니다.

프로젝트에 붙이기

코덱스 CLI도 같이 쓸 거면 이것도 먼저 깔아둡니다.

npm i -g @openai/codex

새 프로젝트라면:

specify init <PROJECT_NAME>

이미 있는 프로젝트에서 바로 붙일 거면:

specify init --here

쉘 선택까지 끝나고 나서 아래처럼 체크가 통과하면 일단 세팅은 된 겁니다.

specify check

그 다음에 바로 볼 것

초기 세팅이 끝나면 보통 다음 단계가 같이 뜹니다.

CODEX_HOME 환경 변수 잡기
/speckit.constitution
/speckit.specify
/speckit.plan
/speckit.tasks
/speckit.implement

여기서 중요한 건 결국 CODEX_HOME 같은 작업용 폴더 경계를 먼저 잡아두는 겁니다.
안 그러면 프로젝트 안에 생성되는 파일들이 어디 붙는지 나중에 다시 보게 됩니다.

꼭 같이 해두는 것

이건 별거 아닌 것 같아도 거의 무적권 해두는 편이 좋습니다.

.gitignore에 .codex 추가
필요하면 .claude 같은 AI 작업 폴더도 같이 추가

이거 안 해두면 나중에 쓸데없는 산출물까지 같이 올라가기 쉽습니다.

마무리

결국 설치 자체는 별거 없습니다.
uv, specify-cli, codex만 잡고 specify init, specify check까지 통과하면 끝입니다..

그 다음부터 중요한 건 설치가 아니라, 헌법이랑 스펙을 얼마나 제대로 적어두느냐 쪽입니다.