이 페이지는 로그인, 워크스페이스 선택, 첫 실행 온보딩 마법사, 언어와 테마 설정, 로그아웃 등 계정과 관련된 모든 것을 다룹니다. 자신의 컴퓨터에 Chorus를 처음
설치한다면 먼저 [시작하기](/ko/guides/getting-started/)를 보세요. 로컬 이메일/비밀번호 설치는 그 페이지에서 다루며, 여기서는 반복하지 않습니다.

## 로그인

Chorus는 이메일로 로그인합니다. 이메일 주소를 입력하고 **계속**을 선택하면, 계정 설정에 따라 다음 화면이 달라집니다.

- **싱글 사인온(SSO).** 이메일이 ID 제공자를 사용하는 워크스페이스 하나에 속해 있으면, Chorus가 그 제공자로 보내 인증하게 한 뒤 다시 Chorus로 돌아옵니다. (배포를 운영하며 SSO를 켜야 한다면 [슈퍼 관리자와 SSO 설정](/ko/guides/authentication-setup/)을 보세요.)
- **여러 로그인 방법 중 선택.** 같은 이메일로 여러 방법으로 로그인할 수 있으면, Chorus가 비밀번호, SSO, 슈퍼 관리자 등 사용할 방법을 고르게 합니다.
- **워크스페이스 선택.** 이메일이 여러 SSO 워크스페이스에 속해 있으면, Chorus는 아래에 설명하는 워크스페이스 선택 화면으로 안내합니다.

설치 환경에서 내장 이메일/비밀번호 로그인([시작하기](/ko/guides/getting-started/)의 로컬 단일 사용자 구성)을 사용한다면 이메일과 비밀번호를 입력합니다. 워크스페이스가 SSO도 지원하면 같은 화면에서 SSO로 전환할 수 있습니다.

## 워크스페이스 선택

이메일 하나가 여러 워크스페이스에 속할 수 있습니다. 이 경우 Chorus는 워크스페이스를 이름과 ID 제공자별로 나열한 선택 화면을 보여 줍니다. 하나를 고르면 Chorus가 그 워크스페이스의 로그인 과정으로 안내합니다. 이 화면에서 다른 이메일로 전환할 수도 있습니다.

## 첫 실행 온보딩

새 워크스페이스에 처음 들어가면 Chorus가 6단계로 된 온보딩 마법사를 엽니다. 건너뛰었다가 나중에 마칠 수도 있습니다. 마법사는 다음 단계를 안내합니다.

1. **환영**: 작업이 거쳐 가는 파이프라인을 한눈에 보여 줍니다.
   **아이디어 → 제안 → 작업 → 실행 → 검증 → 완료**.
2. **에이전트 만들기**: AI 에이전트에 이름을 붙이고 권한을 선택하면 Chorus가 그 에이전트의 API 키를 생성합니다. (전체 에이전트 설정은 [에이전트 액세스 준비](/ko/guides/administrator-setup/)에서 다루며, 이 단계는 그 간단한 버전입니다.)
3. **API 키 복사**: 안전한 곳에 저장하세요. 한 번만 표시됩니다.
4. **설치**: 에이전트 클라이언트(Claude Code, Codex, Kiro, OpenCode, OpenClaw 등)를 고르고,
   표시되는 설정 단계를 따릅니다.
5. **테스트**: Chorus가 에이전트가 연결될 때까지 기다렸다가 연결을 확인합니다.
6. **완료**: 설정 요약과 함께 프로젝트와 설정으로 가는 바로 가기가 표시됩니다.

마법사는 언제든 **설정**에서 다시 열 수 있습니다.

:::note[에이전트가 하는 일]
**에이전트 만들기** 단계에서 AI 에이전트의 신원을 설정하고, **테스트** 단계에서 이를 확인합니다. 에이전트를 만들고 클라이언트를 설치하면 에이전트가 스스로 Chorus에 연결하며, **테스트** 단계는 그 연결을 기다려 확인할 뿐입니다. 각 클라이언트 플랫폼이 어떻게 연결되고 동작하는지는 [에이전트 플랫폼 참고 문서](/ko/reference/agents/)를 보세요.
:::

![온보딩 마법사의 Welcome 단계. 6단계 표시기와 Idea에서 Done까지의 파이프라인이 보인다](/images/workspace/onboarding-wizard.webp)

## 언어와 테마

표시 관련 설정은 사이드바 하단에 있습니다.

- **테마**: **라이트**, **다크**, **시스템**(운영체제 설정을 따름) 중에서 고릅니다.
- **언어**: **English**, **中文**, **한국어**, **日本語** 중에서 고르면 인터페이스가 즉시 바뀝니다. **설정** 페이지에서도 언어를 바꿀 수 있습니다.

## 로그아웃

사이드바 하단에 **로그아웃** 버튼이 있습니다. 선택하면 세션이 종료되고 로그인 화면으로 돌아가며, 그 화면에서 같은 이메일이나 다른 이메일로 다시 로그인할 수 있습니다.

## 다음

계정과 에이전트가 준비되면 [AI-DLC 워크플로](/ko/guides/ai-dlc-workflow/)를 읽고 작업이 아이디어에서 완료까지 어떻게 진행되는지 확인하세요. 곧바로 [아이디어 기록](/ko/guides/capture-an-idea/)으로 넘어가도 됩니다.
