BMad 설치 방법

npx bmad-method install로 프로젝트에 BMad를 설치하고 AI 코딩 도구와 연동할 수 있습니다. 나중에 업데이트할 때도 같은 명령을 사용합니다.

사용 시점

새 프로젝트나 기존 프로젝트에 BMad를 설치할 때
지원되는 AI 코딩 도구에 BMad 스킬을 연결할 때
기존 BMad 설치를 업데이트할 때
모듈을 추가·제거하거나 도구와 설치 설정을 변경할 때

BMad 설치 및 확인

1. 대상 프로젝트 열기

터미널에서 BMad를 설치할 프로젝트로 이동하세요. 다른 위치를 지정하지 않으면 현재 디렉터리에 설치됩니다.

2. 설치 프로그램 실행

npx bmad-method install

화면의 안내를 따르세요. 선택 항목은 모듈과 도구 연동이 바뀌면서 달라질 수 있지만 설치 프로그램이 사용 가능한 모듈과 설정, 지원되는 AI 코딩 도구를 차례로 안내합니다.

오류나 경고가 표시되면 함께 제시된 조치에 따르세요. uv 누락 경고는 설치를 중단하지 않지만 uv가 필요한 스킬은 설치하기 전까지 사용할 수 없습니다.

3. 완료 요약 확인

설치가 끝나면 BMAD is ready to use! 메시지와 설치 경로가 표시됩니다. 추가 조치가 필요한 경고도 함께 나옵니다.

4. 도구 연동 확인

프로젝트 디렉터리에서 선택한 AI 코딩 도구를 열고 bmad-help 스킬을 실행하세요. 다음에 무엇을 해야 하는지 물어보면 됩니다. 도구가 스킬을 인식해 실행한다면 연동이 끝난 것입니다.

BMad 업데이트 또는 재설정

1. 설치 프로그램 다시 실행

_bmad 디렉터리가 있는 프로젝트에서 다음 명령을 실행하세요.

npx bmad-method install

2. 감지된 경로 선택

설치 프로그램은 기존 설치를 감지하고 현재 상태에 맞는 업데이트 또는 수정 경로를 보여줍니다. 기존 설정을 새로 고치려면 업데이트를, 모듈·도구·설정을 바꾸려면 수정을 선택하세요. 이후 화면의 안내를 따르면 됩니다.

3. 업데이트된 연동 확인

완료 요약을 확인하고 필요하면 AI 코딩 도구를 다시 연 뒤 bmad-help를 실행하세요.

사전 릴리스 설치

사전 릴리스 버전의 core와 BMM을 설치하고 이번 실행에서 선택한 외부 모듈에도 사전 릴리스 선택을 적용하려면 다음 명령을 사용하세요.

npx bmad-method@next install

사전 릴리스 설치를 업데이트할 때도 같은 명령을 다시 실행합니다. 사전 릴리스 빌드는 더 자주 바뀌고 완료되지 않은 변경이 포함될 수 있으므로, 일반적인 프로젝트 작업에는 안정 버전을 사용하세요.

헤드리스 CI 설치

새 환경에서 BMM을 Claude Code용으로 설정하는 일반적인 헤드리스 설치 명령은 다음과 같습니다.

npx bmad-method install --yes --modules bmm --tools claude-code

현재 자동화 플래그는 npx bmad-method install --help로, 올바른 도구 ID는 npx bmad-method install --list-tools로 확인하세요. 자동화에서 @next나 특정 패키지 버전을 사용한다면 도움말을 확인하고 설치할 때도 같은 태그나 버전을 사용해야 합니다.

설치 결과

BMad 스킬은 선택한 AI 도구가 사용하는 스킬 디렉터리에 설치됩니다. 프로젝트의 _bmad 디렉터리에는 스킬이 공통으로 사용하는 설정과 지원 스크립트가 저장됩니다. 설치가 끝나면 설정된 도구와 남아 있는 경고를 확인할 수 있습니다.