> For the complete documentation index, see [llms.txt](https://orbitron.gitbook.io/orbitron-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://orbitron.gitbook.io/orbitron-docs/documentation/ko/getting-started/quickstart.md).

# 빠른 시작

이 섹션에서는 지능형 터미널 기반 AI 어시스턴트인 Orbitron의 **초기 설정 및 사용법**을 안내합니다.

### 1️⃣ Orbitron 설치

자동 설치 스크립트를 사용하면 가장 빠르게 설정할 수 있습니다:

#### **macOS / Linux**

```bash
curl -fsSL https://orbitron.megaone.com/api/install.sh | bash
```

#### **Windows (PowerShell)**

```powershell
irm https://orbitron.megaone.com/api/install.ps1 | iex
```

설치가 완료된 후 터미널을 재시작하고 확인하세요:

```bash
orbitron --help
```

👉 수동 다운로드 옵션 및 자세한 설명은 [설치 가이드](https://github.com/AlphaCode-AI/orbitron-docs/tree/main/docs/ko/user-guide/installation/README.md)를 참조하세요.

***

### 2️⃣ 실행 및 인증

Orbitron을 시작하려면 로그인이 필요합니다.

* 처음 사용하는 사용자는 **로그인 다이얼로그**가 자동으로 표시됩니다.
* 또는 수동으로 로그인을 실행할 수 있습니다:

  ```bash
  /login
  ```

  또는 `Ctrl + A`를 누르세요

인증 방법:

* **브라우저 기반 로그인**
* [Orbitron Web](https://orbitron.megaone.com) → \_설정 > 인증 토큰\_에서 **수동 토큰 입력**

👉 자세한 내용은 [인증](/orbitron-docs/documentation/ko/user-guide/authentication.md)을 참조하세요.

***

### 3️⃣ AI 모델 선택

다음을 사용하여 선호하는 모델을 선택할 수 있습니다:

* 명령어: `/model`
* 단축키: `Ctrl + O`

지정하지 않으면, Orbitron은 사용 가능한 모델 중 가장 높은 우선순위의 사용 가능한 모델을 기본으로 사용합니다.

👉 전체 목록은 [모델 선택](/orbitron-docs/documentation/ko/user-guide/supported-ai-models.md)을 참조하세요.

***

### 4️⃣ (선택사항) 컨텍스트 로드

개인화된 응답과 메모리 기반 기능을 활성화하려면 컨텍스트를 불러오세요:

* 명령어: `/context`, `/context:tag`, 또는 `/context:category` 사용
* 단축키: `Ctrl + K`를 눌러 기존 컨텍스트에서 선택 (Orbitron Web에 저장됨)

👉 [Orbitron Web](/orbitron-docs/documentation/ko/user-guide/orbitron-web.md)에서 자세히 알아보세요.

***

### 5️⃣ Orbitron 실행

인증 및 구성이 완료되면 모든 준비가 완료되었습니다🎉

**🌐 대화형 모드**

```bash
orbitron
```

**⚙️ 비대화형 모드**

```bash
orbitron -p "S3 버킷을 어떻게 만들어요?" -q -f json
```

👉 [Orbitron 사용법](/orbitron-docs/documentation/ko/user-guide/usage.md)을 참조하세요.

***

### 🔒 보안 및 데이터 관리 주의사항

* 모든 API 키와 구성이 `~/.orbitron`에 **로컬로** 저장됩니다.
* 대화는 **기본적으로 클라우드에 저장되지 않습니다**.
* 보안 강화 및 오프라인 환경에 적합합니다.

👉 자세한 내용은 [보안 및 개인정보 보호](/orbitron-docs/documentation/ko/user-guide/security-and-privacy.md)를 참조하세요.

***

💡 `/`로 명령 팔레트를 열거나 앱 내의 단축키를 통해 더 많은 작업을 수행할 수 있습니다!

***