---
title: "Guia rápido da CLI"
description: "Instale a interface de linha de comando do AI Glot, autentique-se via OAuth ou chave de API e verifique o acesso ao workspace pelo terminal."
canonical: "https://ai-glot.com/docs/pt/cli/overview"
updated: "2026-08-12"
---

# Guia rápido da CLI

A CLI do AI Glot encapsula a REST API para facilitar o uso por humanos, jobs de CI e agentes de codificação. É necessário ter o Node.js 20 ou superior.

## Instalação

```bash title="Executar sem instalar"
npx @ai-glot/cli account
```

```bash title="Instalação global"
npm install --global @ai-glot/cli
aiglot --help
```

## Autenticação

**Login via navegador**

```bash
aiglot auth login
```

A CLI abre o AI Glot, solicita que você aprove o workspace e os escopos e, em seguida, armazena a credencial OAuth de forma segura. Esta é a rota recomendada para usuários.

**Máquina remota**

```bash
aiglot auth login --device
```

Use o login por dispositivo via SSH ou em máquinas que não conseguem abrir um navegador.

**Chave de API**

```bash
aiglot auth login --key "$AIGLOT_API_KEY"
```

Use uma chave de workspace para CI ou servidores. Passar a chave diretamente na linha de comando pode deixá-la salva no histórico do shell; usar uma variável de ambiente é mais seguro.

## Verificar a conexão

```bash
aiglot auth status
aiglot account
aiglot doctor
```

O comando `account` exibe o workspace, o plano, as funcionalidades e os escopos. O `doctor` verifica a conectividade, a autenticação, a versão da CLI e a sincronização do relógio (clock skew).

> **Info: Limitações da v1**
>
> A CLI ainda não permite fazer upload de arquivos CSV ou iniciar traduções. Ela gerencia traduções e glossários existentes e lê dados de conta, créditos e uso sem consumir créditos.

**Continuar com a CLI**

Veja cada comando em detalhes e como a CLI se comporta em ambientes de CI.

[Comandos](/docs/cli/commands)

[Automação](/docs/cli/automation)