> ## 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をインストールし、NoimosAIへログインして最初のチャットを開始します。

## 概要

このページでは、CLIのインストール、ログイン、最初のチャットまでを進めます。4つのステップを完了すると、ターミナルからNoimosAIへ依頼できる状態になります。

## 事前確認

インストール前に、次の2点を準備します。

* Node.js 20以降
* 有効なNoimosAIアカウント（[新規登録](https://noimosai.com)）

## CLIをセットアップする

CLIのセットアップは、次の4ステップで進めます。

### 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
```

認証方法は次の2種類です。

* **ブラウザログイン（OAuth）** — ブラウザでNoimosAIへログインします。手元のターミナルで使う場合に適しています。
* **APIキー** — NoimosAIのチーム設定にあるAPIタブで発行したキーを使います。CI/CDなど、ブラウザを開けない環境に適しています。

認証方法をコマンドで直接指定する場合は、次のように実行します。

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

APIキーをコマンド引数へ直接書く`--api-key <key>`は、同じコンピューター上のほかのプロセスから見える可能性があります。非対話環境では`--api-key-stdin`を使用してください。

<Note>
  ここで使うAPIキーは、通常のNoimosAIワークスペース用です。`nmp_`から始まるDeveloper PlatformのAPIキーは使用できません。
</Note>

### 3. 最初のチャットを開始する

ログイン後、対話形式のセッションを開始します。

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

NoimosAIエージェントへ質問したり、マーケティング成果物を依頼したり、生成した内容を会話しながら調整できます。

1回の依頼だけを送る場合は、`-p`で依頼内容を指定します。

```bash theme={null}
noimosai chat -p "日本語でLinkedIn向けのローンチ投稿を3案作成して"
```

### 4. 利用できるコマンドを確認する

インストール済みのバージョンで使えるコマンドとオプションを表示します。

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

公開版に含まれるコマンドの全体像は、[コマンドを確認する](/ja/developers/cli/commands)で確認できます。

## 接続できない場合

CLIを利用できない場合は、表示されたエラーに応じて次の項目を確認します。

* **`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`を実行します。

## 関連ページ

利用できるコマンドとほかの接続方法は、次のページで確認できます。

* [コマンドを確認する](/ja/developers/cli/commands)
* [チャットとセッションを利用する](/ja/developers/cli/chat-and-sessions)
* [MCPサーバーの基本](/ja/developers/mcp/overview)