메인 콘텐츠로 건너뛰기
세션은 한 사람의 컴퓨터(실행 기기)에서 돌아가는 Claude Code와의 대화예요. 팀원도 보고 참여할 수 있어요.

세션을 시작하고 폴더 고르기

  1. 새 세션을 누르세요.
  2. 첫 메시지를 보내기 전에 폴더 칩(작업 폴더 선택)을 열고 폴더를 고르세요.
    • 폴더 고르기… 또는 새 폴더 만들기…: 이 컴퓨터에 있는 폴더예요.
    • 최근 폴더.
    • 스페이스 레포지토리: 이 스페이스에 등록된 레포지토리예요. 아직 이 컴퓨터에 없는 레포지토리에는 이 기기에 없음이 보여요. 이미 가진 사본을 쓰려면 **이 기기에 있는 사본 고르기…**를, 내려받으려면 **새로 받을 위치 고르기…**를 고르세요.
    • 레포지토리 추가로 다른 GitHub 레포지토리를 스페이스에 등록해요.
  3. 처음 고른 폴더가 작업 폴더(“여기서 작업을 시작해요”)가 돼요. 그다음에 고른 폴더는 추가 폴더(“함께 열고 고쳐요”)예요. git 폴더라면 시작 브랜치를 고를 수 있어요.
새 세션 화면에서 연 폴더 칩: 작업 폴더와 브랜치, 폴더 고르기, 새 폴더, 최근 폴더, 스페이스 레포지토리 알아 두세요.
  • git 레포지토리 안의 폴더를 고르면 세션은 그 레포지토리의 맨 위 폴더를 써요.
  • 홈 폴더 전체를 고르면 보따리가 경고해요. AI가 그 안의 모든 것을 읽고 바꿀 수 있기 때문이에요.
  • 세션 하나에는 레포지토리 사본을 하나만 둘 수 있어요.
  • 폴더가 GitHub에 없으면 세션은 비공개로 시작해요. 나중에 공유에서 공개 범위를 넓힐 수 있어요.

격리된 사본에서 작업하기(Worktree)

새 세션 화면의 워크트리 칩으로 세션이 어디서 작업할지 골라요.
  • 끔: 내 폴더에서 바로 작업해요.
  • 켬: 작업 폴더의 세션 전용 사본에서 작업해요.
이 사본은 작업 폴더의 git worktree이고, 별도 브랜치(bottari/<name>-…)를 써요. 추가 폴더는 원래 자리에 그대로 있어요. git 레포지토리가 아닌 폴더, 커밋이 하나도 없는 레포지토리, 직접 만든 worktree에서는 이 칩이 나오지 않아요.

폴더는 세션마다 따로 있어요

세션마다 자기 폴더 목록이 있어요. 하위 세션은 상위 세션의 폴더를 물려받아요. 두 세션이 같은 폴더에서 바로 작업하면(Worktree 끔) 그 안의 파일을 함께 써요.

세션을 시작한 뒤 폴더 바꾸기

작업 폴더는 세션을 시작한 뒤에는 바꾸거나 뺄 수 없어요. 셸에서 다른 폴더로 옮겨도(예를 들어 cd) 작업 폴더는 바뀌지 않아요. 다른 폴더나 체크아웃에서 작업하려면 그 폴더로 새 세션을 시작하거나, 이 세션에 추가 폴더로 넣으세요. 필요한 체크아웃이 이미 세션에 있으면(예를 들어 다른 브랜치의 worktree를 추가 폴더로 넣어 둔 경우) 그대로 쓰세요. 작업 폴더에 맞추려고 브랜치를 바꾸거나 체크아웃을 옮길 필요는 없어요. 세션 레일(세션 레일 열기)을 열고 환경 카드를 쓰세요. 맨 위 줄이 작업 폴더, 그 아래 줄들이 추가 폴더, 마지막 줄이 브랜치예요. 각 줄에는 「작업 폴더」 같은 말 대신 폴더 이름과 브랜치 이름이 보여요. 줄에 마우스를 올리면 작업 폴더, 추가 폴더, 브랜치가 보여요. 레일을 연 세션: 환경 카드에 작업 폴더, 추가 폴더, 브랜치가 보여요
  • 작업 폴더 줄(맨 위 폴더 이름)을 누르고 폴더 추가를 고르면 추가 폴더를 넣을 수 있어요. 다음 차례부터 쓸 수 있어요. 편집 권한이 필요해요. GitHub에 없는 폴더는 실행 기기에서만 넣을 수 있어요.
  • 세션에서 빼기(추가 폴더만)를 고르면 다음 차례부터 그 폴더가 빠져요. 레포지토리는 스페이스에 등록된 채로 남고, 컴퓨터에 있는 폴더도 그대로 있어요. 전체 권한이 필요하고, 차례가 진행 중일 때는 뺄 수 없어요.
  • 브랜치 줄에서 **worktree로 옮기기…**를 고르면 세션이 지금 HEAD에서 갈라진 격리된 사본으로 옮겨가요. 커밋하지 않은 변경은 지금 폴더에 남아요. **worktree에서 나가기…**를 고르면 세션이 레포지토리 폴더로 돌아가요. 이때 worktree 남기기와 worktree 지우기 중에서 골라요. 둘 다 다음 차례부터 적용되고, 실행 기기에서만 할 수 있어요.
폴더 없이 시작한 세션은 환경 카드에 바로 폴더 추가 줄이 보여요. 처음 넣은 폴더가 작업 폴더가 돼요.

실행 기기와 담당자

세션은 담당자의 컴퓨터에서 돌아가요. 다른 사람이 담당자라면 이 세션은 다른 사람이 맡고 있어요가 보여요. 내가 맡기를 누르면 내가 담당자가 되어 내 컴퓨터에서 실행해요. 세션의 담당자를 바꾸려면 전체 권한이 필요해요(하위 세션은 편집 권한으로 충분해요). 세션의 레포지토리가 세션을 만든 컴퓨터에만 있으면 아직 가져올 수 없어요가 보여요. 먼저 그 컴퓨터에서 레포지토리를 GitHub에 올리세요. 세션이 내 다른 컴퓨터에서 돌아가는데 그 컴퓨터가 오프라인이면 여기서 이어가기를 골라 이 컴퓨터에서 실행할 수 있어요.

세션 공유하기

공유를 누르고 사람마다 권한 수준을 고르세요. 공유 패널: 스페이스 멤버의 권한 수준 메뉴를 연 모습 스페이스 밖의 사람은 코멘트 권한까지만 받을 수 있어요. 게스트는 편집 권한까지만 받을 수 있어요. 코멘트 권한이나 보기 권한이 있는 사람은 편집 권한 요청하기를 고를 수 있어요. 세션에 전체 권한이 있는 사람이면 누구나 허락할 수 있어요. 누군가에게 편집 권한이나 전체 권한을 주기 전에 보따리가 다음 안내를 보여 줘요(다시 보지 않기를 고르기 전까지).
편집자는 여기서 보따리에게 지시를 보내요. 보따리는 실행 기기에서 돌아가요. 터미널처럼 그 기기에서 세션 폴더 밖의 파일도 읽을 수 있고, 그 기기를 통해 실행하는 사람이 열 수 있는 팀 데이터에도 닿을 수 있어요. 이렇게 읽은 기록은 팀 감사 로그에 남아요. 또 실행하는 사람의 Claude 메모리를 쓰기 때문에 편집자의 지시로 그 메모리를 읽고 저장할 수 있어요.

보따리와 대화하기 또는 코멘트하기

세션에서 「보따리」는 그 세션을 실행하는 Claude Code를 말해요. 보따리와 Claude Code를 보세요. + 옆의 코멘트 토글(⌘⇧C)로 입력창을 보따리에게 보내는 메시지와 사람에게 남기는 코멘트 사이에서 바꿔요. 코멘트를 켜면 메시지가 보따리에게 가지 않아요. 코멘트 권한이 있는 사람은 늘 코멘트를 써요.

멘션

세션에서 @를 입력하면 팀원, 문서, 데이터베이스, 세션을 멘션할 수 있어요. 편집자는 세션 폴더의 파일도 멘션할 수 있어요. 사람을 멘션한 메시지는 팀원에게 코멘트로 가고, 에이전트는 답하지 않아요. 세션에서는 @Bottari가 나오지 않아요. 채널에서 @Bottari는 보따리 서버에서 돌아가는 별도의 어시스턴트예요. 문서에서는 같은 어시스턴트를 보따리로 이 페이지 고치기로 열어요. 보따리와 Claude Code를 보세요.

슬래시 명령

슬래시 명령은 터미널에서처럼 Claude Code로 가요. 다만 다음은 달라요.

셸 모드

빈 입력창에 !를 입력하면 셸 모드(셸)로 바뀌어요. 명령은 세션의 실행 기기에서 실행돼요. 나가려면 칩의 ×(셸 모드 끄기)를 누르거나 Esc를 누르세요. 셸 명령에는 첨부 파일을 붙일 수 없고, 최대 8,000자까지 쓸 수 있어요.

모드와 권한 카드

모드 메뉴(모드 변경)에는 다음이 있어요. 실행하는 사람의 Claude 설정이나 모델이 고른 모드를 허용하지 않으면 세션은 다른 모드로 돌아가고, 모드 팁에 그 사실이 나와요. Claude에 권한이 필요하면 카드가 물어봐요. 예를 들어 보따리가 이 명령을 실행해도 될까요? 허용 또는 거부를 고를 수 있어요. 요청에 따라 카드에 이 세션에서 다시 묻지 않기나 허용하고 자동 모드로 바꾸기 같은 선택지가 더 나오기도 해요. 편집 권한이 있는 사람만 답할 수 있어요.

폴더 신뢰

Claude Code가 내 컴퓨터의 어떤 폴더에서 처음 작업할 때 보따리가 **… 폴더를 신뢰할까요?**라고 물어요. 신뢰하면 Claude Code가 이 폴더의 파일을 읽고, 고치고, 실행할 수 있어요. 신뢰하고 시작 또는 신뢰하지 않음을 고르세요. 터미널의 Claude Code에서 이미 신뢰한 폴더라면 묻지 않아요. 그 폴더의 Claude Code 파일(설정, 훅, CLAUDE.md, .mcp.json, 스킬 등)이 바뀌면 다시 물어요. Bottari manual 13 pages (#940)