시작하기

KaizenAI 사용 시작

프로젝트에 KaizenAI를 설치, 구성 및 실행하는 방법에 대한 전체 안내서입니다.

[Screenshot Placeholder: KaizenAI Workspace Browser Interface]

요구사항

시작하기 전에 다음이 설치되어 있는지 확인하세요.

Bun: Bun(v1.3.5 이상) - Kaizen를 실행하는 데 필요합니다.
AI Provider: 하나 이상의 AI 공급자(예: Claude Code, Codex, Gemini 또는 Qwen Code)가 로컬로 설치됩니다.

다음을 설치하지 않고도 Kaizen를 직접 실행할 수 있습니다.

Terminal

npx kaizenai

더 쉽게 액세스하려면 전역적으로 Kaizen를 설치하세요.

Terminal

npm install -g kaizenai
kaizen

설치가 완료되면 터미널의 모든 프로젝트 디렉터리에서 Kaizen를 시작할 수 있습니다.

기본 설정으로 시작(포트 3210):

kaizen

사용자 정의 포트에서 시작:

kaizen --port 4000

특정 호스트에 바인딩:

kaizen --host dev-box

QR 핸드오프를 통해 다른 Tailscale 장치와 공유:

kaizen --remote

브라우저를 자동으로 열지 않고 시작합니다.

kaizen --no-open

[Screenshot Placeholder: Terminal startup showing local URL, Tailscale URL, and QR handoff]

`kaizen --remote`를 기본 원격 워크플로로 사용합니다. Kaizen는 안정적인 Tailscale URL과 다른 장치에서 핸드오프 페이지를 여는 QR code를 인쇄합니다.

[Screenshot Placeholder: scanning Kaizen QR handoff and opening the app]

검증된 패턴으로 시작하고 AI가 더 빠르게 확장하도록 도와주게 하세요.

Kaizen 실행

설치가 완료되면 터미널의 모든 프로젝트 디렉터리에서 Kaizen를 시작할 수 있습니다.

기본 설정으로 시작(포트 3210):

kaizen

사용자 정의 포트에서 시작:

kaizen --port 4000

특정 호스트에 바인딩:

kaizen --host dev-box

QR 핸드오프를 통해 다른 Tailscale 장치와 공유:

kaizen --remote

브라우저를 자동으로 열지 않고 시작합니다.

kaizen --no-open

[Screenshot Placeholder: Terminal startup showing local URL, Tailscale URL, and QR handoff]

Tailscale을 사용한 원격 액세스

`kaizen --remote`를 기본 원격 워크플로로 사용합니다. Kaizen는 안정적인 Tailscale URL과 다른 장치에서 핸드오프 페이지를 여는 QR code를 인쇄합니다.

개발 컴퓨터와 원격 장치에 Tailscale을 설치합니다.
Download Tailscale →

원격 플래그로 Kaizen를 시작하고 QR code를 스캔하면 다음이 인쇄됩니다.

Terminal

kaizen --remote

Kaizen는 플랫폼에서 지원하는 경우 설치된 앱을 열고, 그렇지 않으면 설치 지침에 따라 브라우저로 돌아갑니다.

[Screenshot Placeholder: scanning Kaizen QR handoff and opening the app]