# 로그인 및 계정 — AI Game Dev 앱 & CLI · AI Game Developer Wiki

AI Game Dev 앱과 gamedev CLI에 로그인하고, 계정을 전환하고, 플랜과 사용량 비율을 이해하고, 다른 기기를 관리하는 방법을 설명합니다.

이 페이지는 영어에서 기계 번역되었습니다. [영어 원문 읽기](https://ai-game.dev/docs/wiki/app/sign-in-and-account).

AI Game Dev 앱을 사용하려면 AI Game Developer 계정이 필요합니다. 로그인하면 앱이 ai-game.dev를 통해 여러분의 플랜, 모델 목록, 엔진 연결과 연동됩니다. 이 페이지에서는 데스크톱 앱과 `gamedev` CLI에서 로그인이 어떻게 동작하는지, 플랜과 사용량이 어떻게 표시되는지, 그리고 다른 기기에서 앱을 사용하는 방법을 설명합니다.

## 데스크톱 앱에 로그인하기

1. 앱을 실행합니다. 로그인되어 있지 않으면 로그인 화면이 표시됩니다.
2. **Sign in**을 선택합니다. 기본 브라우저에서 ai-game.dev 로그인 페이지가 열립니다.
3. 로그인하거나 계정을 만든 뒤 요청을 승인합니다.
4. 앱으로 돌아옵니다. 앱이 계정을 확인하고 모델을 불러옵니다.

복사하거나 붙여넣을 것은 없습니다. API 키도, 토큰도 필요하지 않습니다. 브라우저 창이 열리지 않으면 기본 브라우저를 설정하고 다시 시도하세요. 회사 프록시 뒤에 있다면 ai-game.dev로 나가는 HTTPS가 허용되어야 합니다.

## gamedev CLI에 로그인하기

`gamedev`를 실행하고, 아직 컴퓨터가 로그인되어 있지 않다면 다음을 입력하세요:

```text
/login
```

CLI가 코드와 주소를 표시합니다. 아무 기기에서나 그 주소를 열고 코드가 일치하는지 확인한 뒤 승인하세요. 표준 기기 인증(device-authorization) 흐름이므로 SSH를 통해서나 브라우저가 없는 머신에서도 동작합니다.

로그아웃하려면:

```text
/logout
```

## 컴퓨터당 하나의 로그인

데스크톱 앱, CLI, 그리고 ACP 클라이언트용 `gamedev acp` 에이전트는 한 컴퓨터에서 하나의 로그인을 공유합니다. 이들 중 아무 곳에서나 한 번 로그인하면 나머지도 같은 계정을 사용합니다. T3 Code 같은 ACP 클라이언트에서 시작한 로그인은 이미 로그인되어 있는 컴퓨터의 계정을 바꾸지 않습니다.

CLI에서 이 컴퓨터의 계정을 변경하려면 다음을 사용하세요:

```text
/login --switch
```

리프레시 토큰은 프로젝트 파일이 아니라 운영체제의 자격 증명 저장소(macOS의 Keychain, Windows의 Credential Manager, Linux의 Secret Service)에 보관됩니다.

**참고**

세션이 만료되거나 취소되면 데스크톱 앱은 사유와 함께 로그인 화면으로 돌아가고, CLI는 `/login`을 다시 실행하도록 요청합니다. 채팅과 설정은 그대로 유지됩니다.

OAuth 흐름의 세부 사항, CI용 Personal Access Token, 직접 MCP 클라이언트를 연결하는 방법은 [인증 가이드](https://ai-game.dev/docs/auth)에 있습니다.

## 플랜

플랜에 따라 에이전트가 사용할 수 있는 모델과 유료 도구가 결정됩니다. 현재 플랜은 **Free**, **Indie**, **Studio**, **Studio Max**이며 무료 체험이 제공됩니다. [가격 페이지](https://ai-game.dev/pricing)에서 비교해 보세요.

간단히 말하면:

- 일부 기능은 자체 MCP 클라이언트와 함께 쓰는 엔진 플러그인, Blender, SuperCollider를 사용한 음악, 자체 GPU에서의 로컬 이미지 생성처럼 모든 플랜에서 동작합니다.
- 호스팅 채팅 모델과 클라우드 이미지, 3D, 비디오, 오디오 생성은 플랜에 따라 달라집니다. 일부 모델과 도구는 Studio 이상이 필요합니다.
- 플랜에서 사용할 수 없는 모델이나 도구도 이름 아래에 사유(예: 업그레이드 안내)와 함께 표시되므로 무엇이 제공되는지 확인할 수 있습니다.

## 사용량

앱은 사용량을 **월간 허용량 대비 백분율**로 표시합니다. 100%가 플랜의 전체 허용량입니다. 각 채팅 턴과 Tripo 3D 모델이나 클라우드 비디오 같은 유료 작업은 허용량의 일부를 사용합니다. 같은 작업이라면 더 빠르고 작은 모델이 가장 큰 모델보다 더 적은 비율을 사용합니다.

허용량이 소진되면 계정 페이지에서 Extended usage를 켠 경우에만 추가 잔액으로 사용을 계속할 수 있으며, 켜기 전까지는 꺼져 있습니다. 유료 작업은 항상 먼저 확인을 요청합니다. 작업 카드에 해당 작업이 사용하는 양이 표시되고, 한 번만 승인하거나, 세션 전체에 대해 승인하거나, 허용량의 백분율로 설정한 예산까지 승인할 수 있습니다.

자체 컴퓨터에서 실행되는 로컬 모델은 허용량을 사용하지 않습니다.

## 지역 및 제공 여부

사용할 수 있는 모델은 청구지 주소의 국가에 따라서도 달라지며, 일부 모델은 계정의 연령 확인에도 영향을 받습니다. 최신 목록은 [모델 제공 여부 페이지](https://ai-game.dev/model-availability)에 있습니다. 앱의 모델 선택기는 제공 여부 판단 기준이 되는 지역을 표시하고, 해당 지역에서 사용할 수 없는 모델을 표시합니다.

## 다른 기기

앱은 같은 계정으로 로그인한 다른 컴퓨터와 기기에서 이 컴퓨터에 접근할 수 있게 해 줍니다. 예를 들어 다른 머신에서 채팅을 따라가거나 도구 호출을 승인할 수 있습니다.

- 데스크톱 앱에서는 **Settings**, **Devices**를 엽니다.
- CLI에서는 `gamedev remote status`, `gamedev remote pair` 및 기타 `remote` 하위 명령을 사용하거나, 대화형 CLI에서 `/remote`를 입력합니다.

페어링 시 다른 기기가 채팅을 볼 수 있는지, 제어할 수 있는지, 이 컴퓨터의 공유 모델을 사용할 수 있는지를 각각 따로 묻습니다. 모든 하위 명령은 [CLI 레퍼런스](https://ai-game.dev/ko/docs/wiki/app/cli#remote)를 참고하세요.

계정에 대한 권한을 보유한 편집기 세션과 기기는 ai-game.dev의 계정 Connected devices 페이지에 나열되며, 여기에서 권한을 취소할 수 있습니다.

## 계정에 속한 설정

데스크톱 앱의 **Settings** 창은 모든 항목을 한곳에 모아 둡니다: **General**, **Appearance**, **AI assistant**, **Voice**, **Permissions**, **MCP servers**, **Claude Plugins**, **Model storage**, **Devices**, **Privacy**, **Account**, **About**. **Account**에는 계정과 구독 정보가 표시되고, **Privacy**에서는 사용 데이터, 오류 보고서, 익명 ID를 제어합니다.

## 다음 단계

- [프로젝트를 열고](https://ai-game.dev/ko/docs/wiki/app/projects-and-engines) 엔진을 연결하세요.
- 첫 채팅에 사용할 [모델을 선택](https://ai-game.dev/ko/docs/wiki/app/agents-and-models)하세요.
- 로그인에 문제가 있나요? [문제 해결](https://ai-game.dev/ko/docs/wiki/app/troubleshooting#sign-in)을 참고하세요.

---

Source (HTML): https://ai-game.dev/ko/docs/wiki/app/sign-in-and-account

Machine-translated (ko) from the English page: https://ai-game.dev/docs/wiki/app/sign-in-and-account