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

# 조직 (Organizations)

> CloudThinker 조직 설정, 멤버, 청구를 관리하세요

Organizations는 [워크스페이스](/ko/guide/workspaces), 팀 멤버, 청구를 단일 계정 아래에 묶는 CloudThinker의 최상위 엔티티입니다. 모든 사용자는 가입 시 개인 조직을 자동으로 받습니다.

## 개요

CloudThinker의 Organizations가 제공하는 기능:

* **중앙화된 청구**: 모든 워크스페이스에서 공유되는 단일 구독 및 사용량 쿼터
* **팀 관리**: 조직 전반에서 멤버를 초대하고 역할을 할당
* **워크스페이스 컨테이너**: 조직 내에서 여러 워크스페이스 생성
* **[BYOK](/ko/guide/byok) 지원**: 조직 수준에서 자체 AWS Bedrock 자격 증명 구성

<Info>
  모든 CloudThinker 사용자는 가입 시 개인 조직을 자동으로 받습니다. 이 조직은 사용자 이름을 따서 명명되며 (예: "John's Organization") 기본 워크스페이스 컨테이너 역할을 합니다.
</Info>

***

## 조직 구조

<style>
  {`
    .org-structure { background: #fff; border-color: #e5e7eb; }
    .org-structure .org-grid { background: #e5e7eb; }
    .org-structure .org-cell { background: #fff; }
    .dark .org-structure { background: #0f1117; border-color: #2a3142; }
    .dark .org-structure .org-grid { background: #2a3142; }
    .dark .org-structure .org-cell { background: #0f1117; }
    `}
</style>

<div style={{ borderWidth: '1px', borderStyle: 'solid', borderRadius: '10px', overflow: 'hidden', fontFamily: 'system-ui, -apple-system, sans-serif', fontSize: '13px' }} className="not-prose org-structure">
  <div style={{ background: '#09AAAA', padding: '8px 14px', display: 'flex', alignItems: 'center', gap: '8px' }}>
    <span style={{ fontSize: '14px' }}>🏢</span>
    <span style={{ color: '#fff', fontWeight: 700 }}>Organization</span>
    <span style={{ color: 'rgba(255,255,255,0.85)', fontSize: '12px' }}>— 최상위 엔티티, 가입 시 자동 생성</span>
  </div>

  <div className="org-grid" style={{ display: 'grid', gridTemplateColumns: '1fr 1fr', gap: '1px' }}>
    <div className="org-cell" style={{ padding: '12px 14px' }}>
      <div style={{ color: '#09AAAA', fontSize: '11px', fontWeight: 700, textTransform: 'uppercase', letterSpacing: '0.06em', marginBottom: '8px' }}>Members</div>

      {[
                  { label: 'Owner', desc: '전체 제어 · 청구 · BYOK', color: '#f59e0b' },
                  { label: 'Admin', desc: '멤버 및 워크스페이스 관리', color: '#3b82f6' },
                  { label: 'Developer', desc: '운영 실행 · 에이전트 사용', color: '#10b981' },
                  { label: 'Viewer', desc: '읽기 전용 접근', color: '#8b5cf6' },
                ].map(r => (
                  <div key={r.label} style={{ display: 'flex', alignItems: 'baseline', gap: '6px', marginBottom: '5px' }}>
                    <span style={{ color: r.color, fontWeight: 600, minWidth: '72px' }}>{r.label}</span>
                    <span style={{ color: 'var(--gray-600, #4b5563)', fontSize: '12px' }}>{r.desc}</span>
                  </div>
                ))}
    </div>

    <div className="org-cell" style={{ padding: '12px 14px' }}>
      <div style={{ color: '#09AAAA', fontSize: '11px', fontWeight: 700, textTransform: 'uppercase', letterSpacing: '0.06em', marginBottom: '8px' }}>Workspaces</div>

      <div style={{ display: 'flex', alignItems: 'baseline', gap: '6px', marginBottom: '5px' }}>
        <span style={{ color: '#09AAAA', fontWeight: 600, minWidth: '72px' }}>기본</span>
        <span style={{ color: 'var(--gray-600, #4b5563)', fontSize: '12px' }}>자동 생성 · 즉시 사용 가능</span>
      </div>

      <div style={{ display: 'flex', alignItems: 'baseline', gap: '6px', marginBottom: '8px' }}>
        <span style={{ color: 'var(--gray-700, #374151)', fontWeight: 600, minWidth: '72px' }}>추가</span>
        <span style={{ color: 'var(--gray-600, #4b5563)', fontSize: '12px' }}>팀 · 환경 · 클라우드 공급자별</span>
      </div>

      <div style={{ color: 'var(--gray-500, #6b7280)', fontSize: '11px' }}>각각 포함: Agents · Connections · Knowledge Base · Operations</div>
    </div>

    <div className="org-cell" style={{ padding: '12px 14px' }}>
      <div style={{ color: '#09AAAA', fontSize: '11px', fontWeight: 700, textTransform: 'uppercase', letterSpacing: '0.06em', marginBottom: '8px' }}>Billing</div>

      {['좌석당 요금제', '워크스페이스 간 공유 크레딧 풀', 'Owner 전용 접근'].map(item => (
                  <div key={item} style={{ display: 'flex', alignItems: 'center', gap: '6px', marginBottom: '4px' }}>
                    <div style={{ width: '4px', height: '4px', borderRadius: '50%', background: '#09AAAA', flexShrink: 0 }} />
                    <span style={{ color: 'var(--gray-600, #4b5563)', fontSize: '12px' }}>{item}</span>
                  </div>
                ))}
    </div>

    <div className="org-cell" style={{ padding: '12px 14px' }}>
      <div style={{ color: '#09AAAA', fontSize: '11px', fontWeight: 700, textTransform: 'uppercase', letterSpacing: '0.06em', marginBottom: '8px' }}>BYOK <span style={{ color: 'var(--gray-400, #9ca3af)', textTransform: 'none', letterSpacing: 0, fontWeight: 400 }}>(선택 사항)</span></div>

      {['자체 AWS Bedrock 키 사용', '크레딧 시스템 우회', '데이터가 내 AWS 계정에 유지'].map(item => (
                  <div key={item} style={{ display: 'flex', alignItems: 'center', gap: '6px', marginBottom: '4px' }}>
                    <div style={{ width: '4px', height: '4px', borderRadius: '50%', background: '#f59e0b', flexShrink: 0 }} />
                    <span style={{ color: 'var(--gray-600, #4b5563)', fontSize: '12px' }}>{item}</span>
                  </div>
                ))}
    </div>
  </div>
</div>

### 워크스페이스와의 관계

| 측면           | Organization | Workspace              |
| ------------ | ------------ | ---------------------- |
| **생성**       | 가입 시 자동 생성   | 수동으로 생성                |
| **청구**       | 중앙화된 구독      | 조직에서 상속                |
| **멤버**       | 모든 팀 멤버      | 워크스페이스 접근 권한이 있는 하위 집합 |
| **클라우드 공급자** | 해당 없음        | 워크스페이스당 단일 공급자         |
| **리소스**      | 공유 쿼터 풀      | 격리된 에이전트, 연결, KB       |

<Card title="워크스페이스 자세히 알아보기" icon="building" href="/ko/guide/workspaces">
  조직 내에서 워크스페이스를 생성하고 관리하세요
</Card>

***

## 조직 설정 접근

오른쪽 상단 사용자 메뉴에서 **Admin Settings**로 이동합니다. Admin Settings 사이드바에서 모든 조직 관리 페이지에 접근할 수 있습니다:

| 페이지                     | 설명                              |
| ----------------------- | ------------------------------- |
| **Organization**        | 조직 이름 편집, 통계 보기, 멤버 관리          |
| **Workspaces**          | 워크스페이스 생성 및 관리                  |
| **Billing**             | 구독 및 사용량 보기 (Owner 전용)          |
| **Usage**               | 크레딧 사용량 및 쿼터 모니터링 (Owner 전용)    |
| **BYOK**                | AWS Bedrock 자격 증명 구성 (Owner 전용) |
| **Identity and access** | 도메인 인증, SSO, 프로비저닝              |

<Note>Admin Settings는 조직 Owner와 Admin에게만 표시됩니다.</Note>

***

## 조직 설정

### 일반 설정

조직의 기본 정보를 편집하세요:

| 필드                    | 가이드라인                                                                                   |
| --------------------- | --------------------------------------------------------------------------------------- |
| **Organization Name** | 명확하고 설명적인 이름을 선택하세요. 팀 또는 회사 식별자를 포함하세요. 예: "Acme Corp", "Platform Team", "My Projects" |
| **Description**       | 조직의 목적을 설명하세요. 주요 팀 또는 사용 사례를 기록하세요. 간결하고 유익하게 유지하세요                                    |

<Note>조직 Owner와 Admin만 조직 설정을 편집할 수 있습니다.</Note>

***

## 조직 멤버

조직 내에서 협업할 팀 멤버를 초대하세요. 멤버는 역할 기반 접근 제어로 특정 워크스페이스에 할당될 수 있습니다.

### 멤버 추가

<Steps>
  <Step title="조직 설정 열기">
    **Admin Settings > Organization**으로 이동하여 Members 섹션까지 스크롤하세요
  </Step>

  <Step title="Invite Members 클릭">
    Members 섹션에서 **Invite Members** 버튼을 클릭하세요
  </Step>

  <Step title="이메일 주소 입력">
    한 번에 최대 10개의 이메일 주소를 추가하세요
  </Step>

  <Step title="역할 선택">
    초대받는 사람에게 적절한 조직 역할을 선택하세요
  </Step>

  <Step title="워크스페이스 할당 (선택 사항)">
    새 멤버가 접근할 수 있는 워크스페이스를 선택하세요
  </Step>

  <Step title="초대장 전송">
    **Send Invites**를 클릭하여 초대 이메일을 전송하세요
  </Step>
</Steps>

### 조직 역할

| 역할            | 권한                                                                                         |
| ------------- | ------------------------------------------------------------------------------------------ |
| **Owner**     | **전체 제어** — 모든 조직 설정 관리, 청구 및 구독 처리, 모든 멤버 및 역할 관리, 모든 워크스페이스 접근 (암묵적), BYOK 설정 구성, 소유권 이전 |
| **Admin**     | **관리 접근** — 조직 멤버 관리, 워크스페이스 생성 및 삭제, 모든 워크스페이스 접근 (암묵적); 청구 또는 BYOK 관리 불가                 |
| **Developer** | **표준 접근** — 할당된 워크스페이스에만 접근, 에이전트 사용 및 운영 실행, 워크스페이스 리소스 보기 및 사용; 워크스페이스 생성 불가             |
| **Viewer**    | **읽기 전용 접근** — 할당된 워크스페이스만 보기, 리소스 수정 불가, 운영 실행 불가; 관찰 및 감사 목적                             |

### 역할 권한 요약

| 권한            | Owner | Admin | Developer | Viewer |
| ------------- | :---: | :---: | :-------: | :----: |
| 조직 설정 편집      |   ✓   |   ✓   |     -     |    -   |
| 청구/구독 관리      |   ✓   |   -   |     -     |    -   |
| BYOK 구성       |   ✓   |   -   |     -     |    -   |
| 멤버 초대/제거      |   ✓   |   ✓   |     -     |    -   |
| 멤버 역할 변경      |   ✓   |   ✓   |     -     |    -   |
| 워크스페이스 생성     |   ✓   |   ✓   |     -     |    -   |
| 모든 워크스페이스 접근  |   ✓   |   ✓   |     -     |    -   |
| 할당된 워크스페이스 접근 |   ✓   |   ✓   |     ✓     |    ✓   |
| 운영 실행         |   ✓   |   ✓   |     ✓     |    -   |

### 멤버 관리

| 작업               | 방법                                                 |
| ---------------- | -------------------------------------------------- |
| **역할 변경**        | 멤버 옆의 역할 드롭다운을 클릭하고 새 역할 선택                        |
| **워크스페이스 접근 편집** | 그리드 아이콘을 클릭하여 Developer/Viewer가 접근할 수 있는 워크스페이스 관리 |
| **멤버 제거**        | 휴지통 아이콘을 클릭하고 제거 확인                                |
| **초대장 재발송**      | 대기 중인 초대의 경우 새로 고침 아이콘 클릭                          |
| **초대 취소**        | 대기 중인 초대의 경우 X 아이콘 클릭                              |

<Info>
  Admin Settings > Organization에서 워크스페이스 접근을 편집할 때 (그리드 아이콘을 통해), 워크스페이스별로 역할 재정의를 설정할 수 있습니다. 이를 통해 Viewer가 특정 워크스페이스에서 Developer 접근을 갖거나, Developer가 필요한 곳에서 Admin 접근을 가질 수 있습니다.
</Info>

<Warning>
  조직에서 멤버를 제거하면 해당 조직 내의 모든 워크스페이스에서도 제거됩니다.
</Warning>

***

## 구독 및 청구

조직 Owner는 구독 탭에서 구독을 관리하고 사용량을 확인할 수 있습니다.

### 구독 기능

| 기능                 | 가능한 작업                                                      |
| ------------------ | ----------------------------------------------------------- |
| **Plan Overview**  | 현재 플랜 및 기능, 청구 주기 정보, 결제 수단 관리, 업그레이드/다운그레이드 옵션             |
| **Usage Tracking** | 모든 워크스페이스의 크레딧 사용량, 멤버 수 대 한도, 워크스페이스 수 대 한도, 시간에 따른 사용량 추세 |

### 좌석 및 멤버

구독 플랜은 **좌석당 청구** 방식을 사용합니다 — 구매한 각 좌석은 크레딧 할당량을 부여하고 한 명의 활성 멤버를 허용합니다. 멤버를 추가하기 전에 추가 좌석을 미리 구매하여 크레딧 풀을 늘릴 수도 있습니다.

최소 좌석 수는 플랜마다 다릅니다 — 현재 플랜별 좌석 범위 및 크레딧 할당량은 [요금제](/ko/guide/billing/pricing)를 참조하세요.

활성 멤버만 좌석 사용량에 포함됩니다 — 대기 중인 초대는 좌석을 소비하지 않습니다.

***

## BYOK (Bring Your Own Key)

조직 Owner는 AWS Bedrock 자격 증명을 구성하여 CloudThinker의 공유 풀 대신 자체 LLM 쿼터를 사용할 수 있습니다.

<Accordion title="BYOK란 무엇인가요?">
  **[Bring Your Own Key](/ko/guide/byok)** 를 사용하면:

  * LLM 호출에 자체 AWS Bedrock 계정 사용
  * LLM 사용에 대한 CloudThinker의 크레딧 시스템 우회
  * 무제한 LLM 운영 (AWS 쿼터 기준)
  * 자체 AWS 계정에서 데이터 레지던시 유지

  BYOK는 조직 수준에서 구성되며 모든 워크스페이스에 적용됩니다.
</Accordion>

<Card title="BYOK 구성" icon="key" href="/ko/guide/byok">
  AWS Bedrock 자격 증명 설정 방법 알아보기
</Card>

***

## 모범 사례

### 팀 구조

**역할 할당 (최소 권한 원칙):**

* Owner 역할은 최소한으로 할당 (1-2명)
* 워크스페이스 관리가 필요한 팀 리드에게 Admin 사용
* 대부분의 팀 멤버에게 Developer 사용
* 가시성만 필요한 이해관계자에게 Viewer 사용

**워크스페이스 접근 (체계적인 접근):**

* Admin/Owner는 모든 워크스페이스를 자동으로 봄
* Developer를 관련 워크스페이스에 명시적으로 할당
* 워크스페이스별 세밀한 제어를 위해 역할 재정의 사용
* 컴플라이언스를 위한 정기적인 접근 검토

### 일반적인 패턴

<Accordion title="소규모 팀 (2-5명)">
  **단순 구조:** - 1명의 Owner (팀 리드 또는 계정 소유자) - 1-2명의 Admin (시니어 엔지니어) - 나머지는 Developer - 단일 워크스페이스 또는 dev/prod 분리
</Accordion>

<Accordion title="중규모 팀 (5-20명)">
  **구조화된 접근:** - 1명의 Owner (엔지니어링 매니저) - 2-3명의 Admin (테크 리드) - 관련 워크스페이스에 할당된 Developer - 제품 매니저 또는 이해관계자를 위한 Viewer - 환경 또는 팀별 여러 워크스페이스
</Accordion>

<Accordion title="엔터프라이즈 팀 (20명 이상)">
  **거버넌스 중심:** - 1-2명의 Owner (플랫폼 팀 리드) - 팀 또는 부서별 Admin - 워크스페이스별 접근을 가진 Developer - 감사 및 컴플라이언스를 위한 Viewer - 팀, 환경, 프로젝트별 워크스페이스 - 비용 제어를 위해 [BYOK](/ko/guide/byok) 고려
</Accordion>

***

## 다음 단계

<CardGroup cols={2}>
  <Card title="워크스페이스 생성" icon="building" href="/ko/guide/workspaces">
    팀과 프로젝트를 위한 워크스페이스를 설정하세요
  </Card>

  <Card title="에이전트 구성" icon="robot" href="/ko/guide/agents">
    클라우드 운영을 위한 AI 에이전트를 설정하세요
  </Card>
</CardGroup>