기본적으로 워크스페이스의 모든 사람이 모든 프로젝트를 보고 작업할 수 있습니다. 일부 작업을 더 작은 팀 안에서만 다뤄야 한다면, 프로젝트나 프로젝트 그룹 전체를 **비공개**로 만들고 누가 어떤 권한으로 참여할지 정하세요. 이 가이드는 두 수준과 그 둘이 어떻게 결합되는지 설명합니다.

## 공개와 비공개

모든 프로젝트와 프로젝트 그룹은 **공개** 또는 **비공개** 중 하나입니다.

- **공개** — 워크스페이스의 모든 사람(과 그들이 소유한 에이전트)이 볼 수 있습니다. 공개 프로젝트에서는 누구나 아이디어, 제안, 문서, 작업을 만들고 편집할 수도 있습니다.
- **비공개** — 멤버(와 그 멤버가 소유한 에이전트)만 볼 수 있습니다. 그 밖의 사람에게는 존재하지 않는 것과 같습니다. 프로젝트 목록, 사이드바, 검색, 대시보드에 나타나지 않고, 그 링크를 열면 페이지를 찾을 수 없다는 메시지가 표시됩니다.

새 프로젝트와 그룹은 따로 선택하지 않으면 공개이며(비공개 그룹 안의 새 프로젝트는 항상 비공개입니다), 이 기능이 생기기 전부터 있던 프로젝트도 공개로 유지됩니다.

프로젝트 페이지와 프로젝트 개요에서 비공개 프로젝트에는 **비공개 프로젝트** 배지가 붙습니다. 비공개 그룹은 이름 옆에 잠금 아이콘이 표시되며(마우스를 올리면 설명이 나타납니다), 사이드바에서도 비공개 프로젝트 옆에 같은 잠금 아이콘이 표시됩니다.

![목록 보기의 프로젝트 페이지. 공개 그룹, 잠금 아이콘과 그 툴팁이 표시된 비공개 그룹, ](/images/workspace/projects-private-badges.webp)

## 역할

비공개 프로젝트나 그룹의 멤버는 세 가지 역할 중 하나를 가집니다.

| 역할 | 허용되는 것 |
| --- | --- |
| **뷰어** | 댓글을 포함해 프로젝트의 모든 것을 읽습니다. 아무것도 만들거나 편집할 수 없고, 댓글 작성, 요구사항 구체화 질문 답변, 작업 가져가기도 할 수 없습니다. |
| **편집자** | 뷰어가 할 수 있는 모든 것에 더해, 아이디어, 제안, 문서, 작업을 만들고 편집하고, 댓글을 달고, 작업을 가져가고, 제안을 승인하고, 작업을 검증합니다. |
| **관리자** | 편집자가 할 수 있는 모든 것에 더해, 공개 범위를 바꾸고, 멤버를 관리하며, (비공개 프로젝트에서는) 설정을 편집하거나 프로젝트를 이동하거나 삭제합니다. |

**공개** 프로젝트에는 뷰어가 없습니다. 모든 사람이 최소한 편집자로 작업하며, 일반 설정, 그룹 이동, 삭제도 모두에게 열려 있습니다. 비공개로 전환하거나 멤버를 관리하는 일만 관리자가 할 수 있습니다.

프로젝트를 만든 사람이 그 프로젝트의 관리자가 됩니다. 이 기능이 생기기 전부터 있던 프로젝트에서는 워크스페이스에 처음 가입한 사용자가 관리자입니다.

뷰어에게는 프로젝트 상단에 다음 배너가 표시됩니다. **이 프로젝트에 대한 보기 전용 권한이 있습니다. 변경하려면 프로젝트 관리자에게 편집자 권한을 요청하세요.**

**새 아이디어**처럼 무언가를 바꾸는 버튼은 숨겨지거나 비활성화되며, 보드에서 작업을 끌어 옮길 수도 없습니다.

## 프로젝트를 비공개로 만들기

프로젝트를 만들 때 **새 프로젝트** 대화상자에는 **공개 범위** 선택이 있습니다. **공개**(회사의 모든 구성원이 이 프로젝트를 보고 편집할 수 있습니다) 또는 **비공개**(목록에 있는 멤버와 해당 에이전트만 이 프로젝트에 액세스할 수 있습니다)입니다. 어느 쪽을 고르든 만든 사람이 그 프로젝트의 관리자가 됩니다. [프로젝트 생성](/ko/guides/create-a-project/)을 참고하세요.

기존 프로젝트를 바꾸려면 다음과 같이 합니다.

1. 프로젝트를 열고 개요 오른쪽 위의 **설정**을 선택합니다. **프로젝트 설정** 대화상자가 열리면 **액세스** 탭을 선택합니다.
2. **공개 범위**에서 **공개** 또는 **비공개**를 고릅니다.
3. Chorus가 확인을 요청하며, 몇 명이 액세스를 얻거나 잃는지 보여 주는 **접근 권한 변경** 요약을 표시합니다. **공개 범위 변경**을 선택합니다. 프로젝트를 비공개로 만들면 멤버가 아닌 모든 사람의 액세스가 즉시 사라지고, 공개로 만들면 워크스페이스 전체에 열립니다.

비공개 그룹 안의 프로젝트는 공개로 만들 수 없습니다.

비공개 프로젝트를 공개로 바꿔도 멤버는 유지되므로, 나중에 목록을 다시 만들지 않고 비공개로 되돌릴 수 있습니다.

![비공개 프로젝트의 ](/images/workspace/project-access-tab.webp)

## 멤버 관리하기

멤버는 관리자만 바꿀 수 있습니다. 다른 사람에게는 목록과 함께 **프로젝트 관리자만 공개 범위를 변경하거나 멤버를 관리할 수 있습니다.** 라는 안내가 표시됩니다. **프로젝트 설정 → 액세스**에서 다음을 할 수 있습니다.

- **멤버 추가** — **사용자 선택**을 선택하고, 이름이나 이메일로 검색해, 역할(기본값은 편집자)을 고른 뒤 **추가**를 선택합니다.
- **역할 변경** — 멤버 행에서 다른 역할을 고릅니다.
- **제거** — 멤버 행의 휴지통 버튼을 선택합니다.

프로젝트에는 항상 관리자가 최소 한 명 있어야 하므로, Chorus는 마지막 관리자를 제거하거나 강등하는 것을 거부합니다. 모든 변경은 즉시 적용됩니다. 제거된 멤버는 그 프로젝트의 실시간 업데이트를 즉시 받지 않게 되고, 다음에 목록을 불러올 때 그 프로젝트가 목록에서 사라지며, 프로젝트를 열면 페이지를 찾을 수 없다는 메시지가 표시됩니다.

### 에이전트는 소유자를 따릅니다

에이전트 자체는 멤버가 되지 않습니다. 에이전트는 프로젝트에서 소유자가 할 수 있는 것과 정확히 같은 것을 보고 할 수 있으며, 그 위에 에이전트 자신의 권한이 그대로 적용됩니다. 소유자가 없는 에이전트는 공개 프로젝트에서만 작업할 수 있습니다. 에이전트에게 비공개 프로젝트의 액세스를 주려면 그 소유자를 추가하세요.

### 멘션과 배정

비공개 프로젝트에서는 그 프로젝트를 볼 수 있는 사람(과 그들의 에이전트)만 @멘션하고 작업을 배정할 수 있습니다. 담당자는 최소한 편집자여야 합니다. 프로젝트 밖의 사람은, 프로젝트가 비공개가 되기 전에 그곳에서 무언가를 만들었거나 배정받았더라도 그 프로젝트에 관한 알림을 받지 않습니다.

## 비공개 프로젝트 그룹

프로젝트 그룹도 비공개로 만들 수 있어, 여러 프로젝트의 액세스를 한곳에서 관리할 수 있습니다.

- **그룹 역할은 그룹의 모든 프로젝트에 실시간으로 적용됩니다.** 그룹 편집자는 그 그룹의 각 비공개 프로젝트에서 편집자입니다. 그룹 멤버를 바꾸거나 제거하면 모든 프로젝트가 즉시 따라갑니다.
- **프로젝트는 액세스를 더할 수만 있고, 빼앗을 수는 없습니다.** 한 프로젝트에서 누군가에게 더 높은 역할을 주거나, 그룹 밖의 사람을 들일 수 있습니다. 그 사람의 실제 역할은 그룹 역할과 프로젝트 역할 중 더 높은 쪽입니다. 프로젝트에서 그룹에서 온 역할을 낮추거나 제거할 수는 없습니다.
- **그룹 관리자는 그룹의 모든 프로젝트의 관리자입니다.** 그룹이 공개이든 비공개이든 마찬가지입니다.
- **비공개 그룹에는 비공개 프로젝트만 들어갑니다.** 비공개 그룹 안에서 만든 프로젝트는 비공개이며 그룹의 역할을 상속합니다. 프로젝트를 만든 사람은 그 프로젝트의 관리자 역할도 받습니다.

프로젝트의 **액세스** 탭에서 각 멤버에게는 역할이 어디에서 오는지(**그룹에서 상속**, **프로젝트 직접 권한**, **직접 권한 + 상속**)와 실제로 적용되는 역할(**유효**)이 표시됩니다. 상속된 역할만 가진 멤버는 거기서 바꾸거나 제거할 수 없고, 직접 부여한 역할을 상속된 역할보다 낮게 설정할 수도 없습니다. 상속된 역할은 그룹에서 바꾸세요.

그룹을 관리하려면 프로젝트 페이지의 그룹 카드에서 **대시보드 보기**를 선택한 다음 **그룹 관리**를 선택합니다. 그룹 관리자에게는 대화상자에 그룹의 이름과 설명, **공개 범위**, **멤버**(프로젝트에서와 같은 방법으로 추가하고 변경), 그리고 **이 그룹 삭제**가 있습니다. 공개 그룹에서는 누구나 **그룹 관리**를 열어 이름과 설명을 편집할 수 있지만, 공개 범위와 멤버는 그룹 관리자만 바꿀 수 있습니다. 비공개 그룹에서는 다른 그룹 멤버에게 대신 **구성원 보기**가 표시되며, 멤버 목록을 읽기 전용으로 볼 수 있습니다. 명시적인 관리자가 없는 그룹은 워크스페이스에 처음 가입한 사용자가 관리하며, 이 사용자는 **자동 관리자**로 표시됩니다. 명시적인 관리자를 추가하면 이를 대체합니다.

![비공개 그룹의 프로젝트 그룹 설정. 공개 범위 선택과 그룹 멤버 및 그 역할을 표시](/images/workspace/group-access-settings.webp)

### 한 프로젝트에만 액세스할 수 있는 사람

비공개 그룹의 한 프로젝트에 대해서만, 그룹 멤버로 만들지 않고 역할을 줄 수 있습니다. 그 사람은 그룹의 이름과 설명, 그리고 자신이 액세스할 수 있는 프로젝트만 볼 수 있습니다. 개수, 대시보드, 검색에도 그룹의 다른 항목은 나타나지 않으며, 그룹의 멤버를 보거나 그룹에 프로젝트를 만들 수도 없습니다.

### 그룹을 비공개 또는 공개로 만들기

- **공개 → 비공개**: 그룹의 모든 공개 프로젝트가 비공개가 되어 그룹의 역할을 상속합니다. 기존 프로젝트 멤버는 유지됩니다.
- **비공개 → 공개**: 그룹은 모든 사람이 찾을 수 있게 되지만, 그 프로젝트들은 현재의 공개 범위와 멤버를 유지합니다. 비공개인 것은 아무것도 공개되지 않습니다.

어느 쪽이든 변경 전에 Chorus는 **접근 권한 변경** 요약을 보여 줍니다. 몇 명이 액세스를 얻거나 잃는지, 몇 명의 권한이 높아지거나 낮아지는지, 몇 개의 프로젝트가 영향을 받는지입니다. 의도한 것과 일치할 때만 **공개 범위 변경**을 선택하세요. 확인하기 전에 액세스가 바뀌면, Chorus는 갱신된 요약을 보여 주고 다시 검토해 확인하도록 합니다.

![프로젝트 그룹을 비공개로 전환하는 확인 대화상자. 액세스를 잃는 사용자 수와 영향을 받는 프로젝트 수를 세는 접근 권한 변경 요약을 표시](/images/workspace/group-visibility-impact.webp)

## 그룹 사이에서 프로젝트 이동하기

프로젝트를 이동하려면 프로젝트 페이지에서 프로젝트를 다른 그룹이나 **미분류**로 끌어다 놓습니다. Chorus는 **프로젝트를 다른 그룹으로 이동하시겠습니까?** 라고 묻고, 그룹 역할은 그룹을 따르므로 같은 **접근 권한 변경** 요약을 보여 줍니다. 진행하려면 **이동 확인**을 선택합니다.

비공개 프로젝트를 이동하거나, 어떤 프로젝트든 비공개 그룹으로 또는 비공개 그룹에서 이동하려면, 원래 그룹(미분류 프로젝트라면 그 프로젝트 자체)과 옮겨 갈 그룹 모두의 관리자여야 합니다. 공개 프로젝트를 비공개 그룹으로 옮기면 비공개가 됩니다.

프로젝트는 자신이 속한 그룹에서 그룹 역할을 받습니다. 다른 그룹으로 옮기면 이전 그룹의 역할은 더 이상 적용되지 않고 새 그룹의 역할이 대신 적용됩니다. 프로젝트를 **미분류**로 옮기면, 모두가 그 시점의 액세스를 그대로 유지합니다. 각자의 그룹 역할이 프로젝트로 복사되고, 비공개 프로젝트는 최소 한 명의 관리자와 함께 비공개로 남습니다. 실수로 공개되는 것은 없습니다. 그룹을 삭제하면서 **프로젝트 N개를 미분류로 이동**을 선택해도 마찬가지입니다. 다른 선택지인 **프로젝트 N개 영구 삭제**는 프로젝트들을 삭제합니다.

## 함께 보기

- [프로젝트 생성](/ko/guides/create-a-project/) — 프로젝트 그룹, 프로젝트, 작업 디렉터리.
- [에이전트와 API 키 관리](/ko/guides/manage-agents/) — 프로젝트 액세스 위에 적용되는 에이전트 권한.
- [협업 참고](/ko/reference/collaboration/) — 댓글, @멘션, 알림.