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

# 시작하기

> CLI를 설치하고 로그인하여 첫 채팅을 시작합니다.

## 개요

설치, 로그인, 첫 채팅의 네 단계를 마치면 터미널에서 요청할 수 있습니다.

## 사전 준비

다음 두 가지를 준비합니다.

* Node.js 20 이상
* 활성 NoimosAI 계정([가입](https://noimosai.com))

## CLI 설정하기

다음 네 단계를 진행합니다.

### 1. CLI 설치하기

패키지 관리자로 `@noimosai/cli`를 전역 설치합니다.

```bash theme={null}
pnpm add -g @noimosai/cli
```

npm은 다음 명령을 사용합니다.

```bash theme={null}
npm install -g @noimosai/cli
```

설치 후 버전이 표시되는지 확인합니다.

```bash theme={null}
noimosai --version
```

### 2. NoimosAI 로그인하기

이 명령으로 인증 방식을 대화형으로 선택합니다.

```bash theme={null}
noimosai login
```

두 가지 방식이 있습니다.

* **브라우저 로그인(OAuth)** — 브라우저로 로그인하며 로컬 터미널에 적합합니다.
* **API 키** — 팀 설정의 API 탭에서 발급합니다. CI/CD처럼 브라우저가 없는 환경에 적합합니다.

방식을 직접 지정하려면 다음 명령을 사용합니다.

```bash theme={null}
noimosai login --oauth
printenv NOIMOS_API_KEY | noimosai login --api-key-stdin
```

`--api-key <key>`로 키를 전달하면 같은 컴퓨터의 다른 프로세스에 노출될 수 있습니다. 비대화형에서는 `--api-key-stdin`을 사용하세요.

> [!NOTE]
>
> 일반 워크스페이스용 키입니다. `nmp_`로 시작하는 Developer Platform 키는 사용할 수 없습니다.

### 3. 첫 채팅 시작하기

로그인 후 대화형 세션을 엽니다.

```bash theme={null}
noimosai chat
```

질문하거나 마케팅 결과물을 요청하고 대화로 내용을 조정할 수 있습니다.

한 번만 요청하려면 `-p`로 내용을 지정합니다.

```bash theme={null}
noimosai chat -p "일본어로 LinkedIn 출시 게시물 초안 3개를 작성해 줘"
```

### 4. 명령 조회하기

설치된 버전의 명령과 옵션을 표시합니다.

```bash theme={null}
noimosai --help
noimosai <command> --help
```

공개 명령의 전체 개요는 [명령 조회하기](https://docs.noimosai.com/ko/developers/cli/commands.md)를 참조하세요.

## 연결 문제 해결하기

표시된 오류에 따라 점검합니다.

* **`Not authenticated`** — `noimosai login`을 다시 실행합니다.
* **`Workspace ID not configured`** — 로그인할 때 워크스페이스를 선택하거나 지원 명령에 `-w <workspace-id>`을 지정합니다.
* **명령 또는 옵션 없음** — 최신 공개 버전을 재설치하고 `noimosai --version`, `noimosai <command> --help`을 봅니다.
* **JSON 게시 실패** — `noimosai post posts.json --now --dry-run`로 대상, 본문, 미디어 경로를 확인합니다.

다시 로그인하기 전에 `noimosai logout`로 인증 정보를 지웁니다.

## 관련 페이지

명령과 다른 연결 방법은 다음 페이지에 있습니다.

* [명령 조회하기](https://docs.noimosai.com/ko/developers/cli/commands.md)
* [채팅과 세션 사용하기](https://docs.noimosai.com/ko/developers/cli/chat-and-sessions.md)
* [기본 이해하기](https://docs.noimosai.com/ko/developers/mcp/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.