# 빠른 시작

> AI 계정 없이, 가상의 팀으로 Trina AX를 내 컴퓨터에서 10분쯤 만에 띄워요.

데모를 실행하면 시작용 스킬 6개가 들어 있는 가상의 팀이 만들어져요. AI는 꺼 둔 상태라 AI 계정이 없어도 돼요.

> **주의:** 데모는 실제 운영용 설치가 아니에요. OS 격리가 없어요. 가상의 데이터만 써야 해요.

## 시작하기 전에

| 필요한 것 | 버전 |
|---|---|
| macOS 또는 Linux | Windows 사용자는 준비된 서버를 브라우저로 열어요 |
| Git | 최근 버전이면 돼요 |
| Bun | 1.3.12 (CI에 고정된 버전) |
| Go | 1.27 이상 |
| 네이티브 빌드 도구 | macOS에서는 Xcode 명령줄 도구 |
| 비어 있는 포트 | 19760 |

## 데모 시작하기

1. **내려받고 설치하기**

   ```sh
   git clone https://github.com/trina-app/trina-ax.git
   cd trina-ax
   bun install --frozen-lockfile
   ```

2. **데모 시작하기**

   ```sh
   bun run demo
   ```
   이 터미널은 켜 둔 채로 둬요. 빌드한 뒤 http://127.0.0.1:19760 에서 시작하고, 가상의 팀을 채워 넣어요.

3. **로그인하기**

   http://127.0.0.1:19760 을 열고 `alice` / `teamax-demo-1`로 로그인해요. 다른 계정은 `bob`, `admin1`, 그리고 팀장 `dion`이에요. 비밀번호는 일부러 공개해 둔 거예요.

   ![Trina AX 로그인 화면: 사용자 이름(Username)과 비밀번호(Password) 칸, 로그인(Sign in) 버튼](../../images/quickstart/sign-in.webp "로그인 화면")

4. **폴더 권한 확인하기**

   **파일 → 전사 공유 → 팀-용어집.md**를 열어요. 그다음 시크릿 창에서 `bob`으로 로그인해요. Bob에게는 재무 부서는 보이지만 마케팅 부서는 안 보여요.

   ![파일 화면: 왼쪽 막대 옆에 팀 폴더 목록이 있고, 전사 공유 폴더가 열려 있으며, 옆 패널에 용어집 파일이 보여요](../../images/quickstart/files-glossary.webp "파일 화면에서 연 용어집")

> **팁:** `localhost` 대신 `127.0.0.1`을 써요. 둘은 쿠키 출처가 달라서 로그인을 또 해야 해요.

## 더 해 보기

가장 빨리 시작하는 방법은 데모예요. 더 해 보고 싶으면 아래에서 골라요.

**포트와 언어**

다른 포트, 새 데이터 폴더, 한국어 화면으로 띄워요.

```sh
bun run demo --port 19761 --data "$HOME/.trina-evaluation-new" --locale ko
```

데이터 폴더는 아직 없는 폴더여야 해요. 포트가 이미 쓰이고 있거나 폴더가 이미 있으면 거절해요.

**AI 써 보기**

데모는 AI를 부를 수 없어요. 내 Claude Code나 Codex 로그인을 쓰는 개발 서버를 띄우려면, 먼저 데모를 멈추고 이렇게 실행해요.

```sh
TEAM_AX_DEV_DIR="$HOME/.trina-ai-evaluation-new" TEAM_AX_DEV_PORT=19761 bun run dev --no-relay
# In a second terminal, before you create a team:
TEAM_AX_DEV_DIR="$HOME/.trina-ai-evaluation-new" bun run demo:seed --base http://127.0.0.1:19761
```

> **주의:** 개발 모드에서는 엔진이 내 OS 사용자로 돌아가고, 운영용 격리가 없어요. 이렇게 써도 되는 계정만 연결해야 해요.

**tailnet에 공유하기**

Tailscale 네트워크에 있는 동료가 미리보기를 눌러 볼 수 있게 하려면, AI를 끄고 허용 출처를 하나 더 넣은 개발 서버를 띄워요.

1. **AI를 끈 설정 파일 만들기**

   `~/.trina-preview`처럼 짧은 새 폴더에 `preview.json`으로 저장해요. 데모가 쓰는 설정과 똑같아요.
   ```json
   {"mode":"dev","listen":{"host":"127.0.0.1","port":19780},
    "engine":{"authMode":"local-login","claudeBin":"/nonexistent/trina-demo-no-ai","codexBin":""},
    "relay":{"url":null,"officialAvailable":false},"update":{"feedUrl":null,"auto":false}}
   ```

2. **tailnet 출처를 넣어 서버 시작하기**

   `<your-tailnet-host>`를 이 컴퓨터의 Tailscale 이름으로 바꿔요.
   ```sh
   MYCEL_CONFIG="$HOME/.trina-preview/preview.json" MYCEL_HOST=127.0.0.1 \
   TEAM_AX_DEV_DIR="$HOME/.trina-preview" TEAM_AX_DEV_PORT=19780 \
   MYCEL_PUBLIC_ORIGINS="https://<your-tailnet-host>:8443,http://127.0.0.1:19780" \
   bun scripts/dev.ts --no-relay
   ```

3. **가상의 팀 채우기**

   ```sh
   TEAM_AX_DEV_DIR="$HOME/.trina-preview" bun run demo:seed --base http://127.0.0.1:19780
   ```

4. **tailnet 안에서만 열기**

   ```sh
   tailscale serve --bg --https=8443 http://127.0.0.1:19780
   ```
   `tailscale funnel`은 절대 쓰지 말고 `tailscale serve`를 써요. funnel은 인터넷 전체에 공개해요.

5. **데모 비밀번호 바꾸기**

   데모 비밀번호는 공개돼 있어요. 주소를 공유하기 전에 모든 계정의 비밀번호를 바꿔야 해요.

멈추려면 서버 터미널에서 Ctrl-C를 누르고 `tailscale serve --https=8443 off`를 실행해요.

## 다음 단계

- [기본 개념](/docs/ko/get-started/key-concepts.md): 이 문서 전체에서 쓰는 용어.
- [로컬 개발 (영어)](/docs/develop/local-development.md): 코드를 빌드하고, 테스트하고, 바꿔요.
