5분 만에 시작하기

다운로드부터 첫 번째 에이전트 실행까지. 설정 파일도, CLI 설정도, 터미널 분할도 필요 없다.

시작하기 전에

  • macOS 14+ (Sonoma 이상)
  • Claude CLI 설치 필요
    npm install -g @anthropic-ai/claude-code
  • 활성화된 Claude 구독 또는 API 키
1

다운로드 및 설치

.dmg 파일을 다운로드하고, 열고, AgentsRoom을 응용 프로그램 폴더로 드래그하세요. Spotlight 또는 응용 프로그램 폴더에서 실행하세요.

Tip: AgentsRoom은 자동으로 업데이트를 확인합니다. 새 버전이 나오면 알림을 받습니다.

2

첫 번째 프로젝트 만들기

사이드바에서 + 버튼을 클릭하세요. 머신의 아무 폴더나 선택하세요 — Claude 에이전트가 작업할 곳입니다. 프로젝트 이름을 정하고 존에 배정하세요.

Tip: 각 프로젝트는 실제 폴더에 매핑됩니다. 에이전트는 터미널에서 직접 실행하는 것처럼 해당 디렉토리에서 claude를 실행합니다.

3

첫 번째 에이전트 추가하기

프로젝트 안에서 에이전트 추가를 클릭하세요. 역할을 선택하세요 — Fullstack이 시작하기 좋습니다. 모델을 선택하세요 (Sonnet 추천). 프롬프트를 작성하고 실행을 누르세요.

Tip: 간단하게 시작하세요: "실패하는 테스트를 고쳐줘" 또는 "로딩 스피너를 추가해줘". 익숙해지면 더 구체적으로.

4

작업 과정 지켜보기

터미널이 실시간 출력을 보여줍니다 — 모든 파일 읽기, 모든 편집. 상태가 바뀝니다: 생각 중 → 코딩 중 → 완료. 완료되면 macOS 알림을 받습니다.

Tip: 여러 에이전트를 동시에 실행할 수 있습니다. 각각 자체 터미널을 가지고 독립적으로 작업합니다.

5

설정 커스터마이징

AgentsRoom에서 직접 CLAUDE.md를 편집하여 에이전트에게 더 나은 컨텍스트를 제공하세요. 모델을 변경하고, 권한을 조정하고, 훅을 구성하세요. 다른 역할의 에이전트를 더 추가하세요.

Tip: 아키텍처에는 Opus. 개발에는 Sonnet. 테스트 같은 빠른 작업에는 Haiku.

팁 & 트릭

1.아키텍처 결정에는 Opus, 일상 코딩에는 Sonnet, 빠른 작업에는 Haiku를 사용하세요

2.프로젝트를 존(업무, 개인, 사이드 프로젝트)별로 그룹화하여 더 잘 정리하세요

3.AgentsRoom에서 CLAUDE.md를 편집하여 에이전트에게 더 나은 프로젝트 컨텍스트를 제공하세요

4.macOS 알림을 활성화하여 에이전트가 작업하는 동안 멀티태스킹하세요

5.프로젝트당 에이전트 하나로 시작하고, 익숙해지면 더 추가하세요

문제 해결

"Claude CLI not found"

설치하세요: npm install -g @anthropic-ai/claude-code. PATH에 포함되어 있는지 확인하세요.

에이전트가 "생각 중"에서 멈춤

Claude 구독이나 API 키가 활성 상태인지 확인하세요. 터미널에서 claude를 직접 실행해 보세요.

프로젝트가 표시되지 않음

프로젝트 생성 시 유효한 폴더를 선택했는지 확인하세요. 폴더가 디스크에 존재해야 합니다.

다음 단계

시작할 준비가 되었나?

AgentsRoom을 다운로드하고 30초 만에 첫 번째 에이전트를 실행하세요.

AgentsRoom 다운로드

무료 — 3개 프로젝트, 무제한 에이전트