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

# Primeiros passos

> Instale a CLI, entre e inicie o primeiro chat.

## Visão geral

Quatro etapas cobrem instalação, login e primeiro chat para enviar pedidos pelo terminal.

## Pré-requisitos

Prepare dois itens:

* Node.js 20 ou posterior
* Conta NoimosAI ativa ([cadastro](https://noimosai.com))

## Configurar a CLI

Siga quatro etapas.

### 1. Instalar a CLI

Instale `@noimosai/cli` globalmente com seu gerenciador.

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

Com npm, use este comando.

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

Verifique a versão exibida.

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

### 2. Entrar no NoimosAI

Escolha autenticação interativamente com este comando.

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

Dois métodos:

* **Navegador (OAuth)** — Entre pelo navegador; adequado ao terminal local.
* **Chave API** — Chave da aba API nas configurações da equipe; adequada sem navegador, como CI/CD.

Para escolher diretamente, use estes comandos.

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

Passar a chave por `--api-key <key>` pode expô-la a outros processos do computador. Use `--api-key-stdin` sem interação.

> [!NOTE]
>
> A chave é para espaços normais. Chaves Developer Platform `nmp_` não funcionam aqui.

### 3. Iniciar o primeiro chat

Após entrar, abra uma sessão interativa.

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

Pergunte ao agente, solicite materiais de marketing ou refine conteúdos conversando.

Para um pedido único, use `-p`.

```bash theme={null}
noimosai chat -p "Crie três rascunhos de lançamento para LinkedIn em japonês"
```

### 4. Consultar comandos

Exiba comandos e opções da versão instalada.

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

Veja os comandos publicados em [Consultar comandos](https://docs.noimosai.com/pt/developers/cli/commands.md).

## Resolver problemas de conexão

Verifique conforme o erro:

* **`Not authenticated`** — Execute `noimosai login` novamente.
* **`Workspace ID not configured`** — Escolha o espaço no login ou use `-w <workspace-id>` nos comandos compatíveis.
* **Comando ou opção ausente** — Reinstale a última versão publicada e veja `noimosai --version` e `noimosai <command> --help`.
* **JSON não publica** — Confira destino, texto e caminhos com `noimosai post posts.json --now --dry-run`.

Use `noimosai logout` para apagar credenciais antes de entrar novamente.

## Páginas relacionadas

Estas páginas explicam comandos e outras conexões.

* [Consultar comandos](https://docs.noimosai.com/pt/developers/cli/commands.md)
* [Usar chat e sessões](https://docs.noimosai.com/pt/developers/cli/chat-and-sessions.md)
* [Entender os fundamentos](https://docs.noimosai.com/pt/developers/mcp/overview.md)


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