> ## Documentation Index
> Fetch the complete documentation index at: https://help.bottari.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 시작하기

보따리 데스크톱 앱은 내 컴퓨터에서 돌아가요. 세션은 내 컴퓨터에서 내 Claude Code를 실행하고, 팀원은 데스크톱 앱이나 폰 앱에서 세션을 따라보고 함께할 수 있어요.

## 필요한 것

* Apple Silicon(M1 이상) Mac. 보따리 데스크톱 앱은 지금은 macOS 전용이에요. Windows는 곧 지원할 예정이고, Intel Mac은 지원하지 않아요.
* Claude 계정으로 로그인한 Claude Code 2.1.306 이상. 설치되어 있지 않으면 설정 중에 보따리가 대신 설치해 줄 수 있어요(아래 4단계 참고).
* 스페이스에 레포지토리를 등록하고, 푸시하거나 PR을 열고, 에이전트 데이터베이스를 쓰려면 GitHub 계정이 필요해요. 세션은 GitHub 없이 로컬 폴더에서도 작업할 수 있어요. 설정 중에 GitHub를 건너뛰고 나중에 연결해도 돼요.

## 설치

1. [https://bottari.ai/download](https://bottari.ai/download) 에 가서 “Bottari for Mac”을 내려받으세요.
2. 앱을 여세요.

폰 앱은 Android용으로 Google Play에 있어요. iOS 앱은 곧 나올 예정이에요.

## 로그인

데스크톱에서 **Google로 계속하기** 또는 **GitHub로 계속하기**를 고르세요.

나중에 같은 인증된 이메일 주소를 주는 다른 방법으로 로그인하면 같은 계정으로 들어가요.

## 처음 설정

누군가 나를 초대했다면 먼저 초대가 보여요(**…에 참가하세요** 또는 **…에 게스트로 참여하세요**, 초대가 여러 개면 **초대받았어요!**). **수락**을 누르면 그 팀으로 들어가요. 대신 **내 팀 만들기**를 할 수도 있어요.

아직 팀이 없다면(다른 팀의 게스트도 아니라면) 설정이 아래 주요 단계를 안내해요(3단계 뒤에 스페이스 멤버를 고르는 선택 단계가 나올 수 있어요).

1. **먼저 팀을 만들어 볼까요?** — 팀 이름을 정해요.
2. **…에 팀원을 초대해 보세요** — **건너뛰기**할 수 있어요.
3. **첫 스페이스를 만들어요** — 스페이스에는 채널, 세션, 문서, 데이터베이스가 들어 있어요.
4. **Claude Code를 연결하세요** — **연결하기**를 누르세요. Claude Code가 없으면 보따리가 설치한 뒤 브라우저에서 Claude 로그인을 열어요. 이 컴퓨터에서 이미 로그인되어 있으면 이 단계는 건너뛰어요. 잘 안 되면 **터미널에서 연결**을 쓰세요.
5. **GitHub를 연결하세요** — 보따리가 GitHub CLI(`gh`)로 로그인하고, 없으면 설치해요. 이 단계는 건너뛸 수 있어요. 건너뛰면 6단계와 7단계도 건너뛰어요. 연결은 언제든 **설정** › **계정** › **연결**에서 끊을 수 있어요.
6. **어떤 레포지토리를 연결할까요?** — 스페이스에 등록할 레포지토리를 골라요. 아직 내려받지는 않아요. 건너뛸 수 있어요.
7. **에이전트에게 할 일을 맡겨 보세요** — 레포지토리를 하나 이상 골랐을 때만 보여요. 승인 정책을 고르고 **시작하기**를 눌러 에이전트 데이터베이스를 만들거나([에이전트 데이터베이스](https://help.bottari.ai/ko/09-agent-database.md) 참고), **건너뛰기**를 눌러 스페이스로 가세요.

이미 팀이 있지만 아직 스페이스가 없다면 **새 스페이스를 만들어요**에서 시작해요.

## 첫 세션 시작하기

**새 세션**을 누르세요(위쪽의 펜 아이콘, 또는 ⌘O). 사이드바 **세션** 탭에서 스페이스 옆의 ＋를 눌러도 돼요.

![새 세션 화면: 왼쪽에 사이드바의 세션 탭, 아래에 폴더 칩이 있는 입력창](https://mintcdn.com/bottari-help/o1rPaomCoB7ZyaSB/images/ko/01-new-session.png?fit=max\&auto=format\&n=o1rPaomCoB7ZyaSB\&q=85\&s=69ebc49d41cec94919793b16beabb3db)

첫 메시지를 보내기 전에 세션이 작업할 폴더를 고를 수 있어요. 고르지 않으면 첫 세션은 폴더 없이 시작하고(이후 세션은 바꾸지 않는 한 그 스페이스에서 마지막 세션의 작업 폴더에서 시작해요), 남길 파일이 생기면 보따리가 **새 폴더 기본 위치** 아래에 폴더를 만들어요(설정해 두지 않았다면 처음에 물어봐요). [세션, 폴더, 레포지토리](https://help.bottari.ai/ko/02-sessions-and-folders.md)를 참고하세요.

세션은 팀 멤버만 시작할 수 있어요. 게스트는 시작할 수 없어요.

이 컴퓨터에서 Claude Code가 준비되지 않았으면 입력창 위 배너에 **준비된 구독 모델이 없어요**와 그 까닭이 보여요. Claude Code가 설치되어 있지 않거나 로그인되어 있지 않으면 **Claude 연결하기**를 누르세요. 버전이 너무 낮으면 **터미널에서 업데이트**를 누르세요.

팀이 세션 한도에 닿았으면 **팀 세션 상한에 닿아 새 세션을 만들 수 없어요**가 보여요.

## 폰 앱

폰 앱에서는 세션, 채널, 문서를 따라보고 세션이 묻는 것에 답할 수 있어요. 폰에서는 세션을 시작할 수 없으니 데스크톱 앱에서 시작하세요. [폰 앱](https://help.bottari.ai/ko/10-phone-app.md)을 참고하세요.

<sub>Bottari manual 13 pages (#940)</sub>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.