# Conecte o seu agente

> O Nolan Edit vem com o nolanlabs. Ou rode o Claude Code, o Codex, o Gemini CLI ou qualquer agente ACP com o próprio login: o que cada um precisa e como adicionar o seu.

Page: https://nolanlabs.io/pt-br/docs/agents

Um agente vem com o app: o Nolan Edit, no NolanX, o modelo que o nolanlabs roda. Ou o chat roda um que você já tem, na sua própria conta. Esta página diz quais agentes funcionam e o que cada um precisa.

## Nolan Edit

O Nolan Edit é o agente integrado ao nolanlabs, e o NolanX é o modelo em que ele roda. Na primeira vez que o app abre, ele o oferece, e daí em diante ele fica no seletor no topo do chat, com a marca do nolanlabs e **NolanX**, o modelo dele, ao lado. Não há mais nada para instalar e nenhuma outra conta: o app o configura sozinho, e até isso terminar o seletor diz **Preparando…**.

- **Créditos.** O uso do NolanX é contado em créditos. Toda conta tem 100 por mês, sem plano. Uma mudança pequena, como um título ou um trim, gasta cerca de 4. Enquanto ele está selecionado, o cabeçalho do chat mostra o que resta depois do nome do modelo, e **Configurações** > **Conta** mostra o saldo deste mês e o seu plano, com **Ver planos** (ou **Gerenciar plano** em um plano pago). Ao chegar a zero, ele para até o dia primeiro do mês seguinte, ou até você passar para um plano maior, e avisa; o editor e os seus outros agentes continuam funcionando. Também há um limite diário. Os planos que trazem mais estão em [Preços](https://nolanlabs.io/pt-br/pricing), e como comprar, mudar e cancelar um está em [Planos e cobrança](https://nolanlabs.io/pt-br/docs/plans).
- **O que ele pergunta antes.** Ele edita a timeline, lê arquivos e olha quadros sem perguntar. Um comando de shell, um arquivo que ele grava, a internet, trazer mídia, renderizar e configurações precisam da sua resposta no chat: **Allow once**, **Always allow** ou **Deny**.
- **O que sai do seu computador.** O que você escreve, o que ele lê no projeto e os quadros que ele olha passam por nolanlabs.io até a empresa que roda o NolanX. O nolanlabs.io guarda contagens de uso, nunca o conteúdo, e envia essas contagens ao PostHog, onde o nolanlabs as lê. Veja a [Política de Privacidade](https://nolanlabs.io/privacy#nolanx).
- **Em um estúdio.** Um arquivo chamado `policy.json` na pasta do app dizendo `{"models": "off"}` desliga o Nolan Edit naquele computador, e então ele deixa de ser oferecido.

O Nolan Edit roda sobre o Claude Code, que o app instala na sua pasta pessoal. Ele não precisa de conta Claude.

## O seu próprio agente

Escolha um no topo do chat. O seletor lista cada agente e como ele está neste computador.

| Agente | O que precisa |
| --- | --- |
| **Nolan Edit** | Uma conta nolanlabs, conectada. Veja acima |
| **Claude Code** | Claude Code instalado e conectado neste computador |
| **Codex** | Codex instalado e conectado (`codex login`), e o adaptador ACP dele, `codex-acp` |
| **Gemini CLI** | Gemini CLI instalado, com uma chave paga da API do Gemini ou um plano Gemini Code Assist Standard ou Enterprise. O Google [encerrou o login pessoal](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/) (gratuito, AI Pro e Ultra) em 18 de junho de 2026 |
| O seu | Qualquer agente que fale ACP, o Agent Client Protocol, e o comando dele |

Não há chave para colar no nolanlabs. Todo agente recebe as mesmas oito ferramentas, então cada um trabalha pelas mesmas operações dos botões. Os cards de pergunta e de plano são do Nolan Edit e do Claude Code.

## O que o estado dele quer dizer

O seletor mostra uma nota ao lado de cada agente.

| Nota | O que quer dizer |
| --- | --- |
| **Conectado**, ou o nome do seu plano | Está instalado e conectado. Escolha e peça |
| **Não conectado** | Ele está aqui, mas a sua conta não. Entre com o próprio comando do agente |
| **Não instalado** | Ele, ou a peça que o conecta, não está aqui, como o Codex sem o `codex-acp` |
| **Not on this computer** | O Claude Code não está instalado |
| **Sets itself up when you pick it** | O Nolan Edit antes do primeiro uso. Escolha, e o app instala aquilo em que ele roda |

## O que vem junto com o Claude Code

O agente Claude Code é uma sessão completa do Claude Code na pasta do projeto, com as ferramentas do editor acrescentadas. Ele não tem limite.

- O próprio shell, arquivos, internet, subagentes e lista de tarefas.
- As suas configurações do Claude Code, o `CLAUDE.md` e as skills (as de `~/.claude`), e as skills do próprio editor.
- Da pasta do projeto, só o `CLAUDE.md` e o `.claude/skills` dela. As configurações, hooks, servidores MCP, `CLAUDE.local.md` e `.claude/rules` dela não são lidos, então uma pasta que alguém lhe mandou não consegue rodar nada sozinha.
- Sem limite de turnos e sem tempo limite próprio para as ferramentas. A conversa se compacta sozinha à medida que cresce.

## Adicione o seu

Escolha **Adicionar seu próprio agente…** no fim do seletor, ou edite o `agents.json` na pasta de dados do app:

```json
{
  "default": "claude",
  "agents": [
    { "id": "my-agent", "name": "My agent", "command": "/usr/local/bin/my-agent", "args": ["--acp"] }
  ]
}
```

`default` é o agente com que o chat começa. O editor dá a cada agente instruções curtas junto com a primeira mensagem de cada conversa, então um agente que não sabe nada do editor ainda funciona do mesmo jeito.

## O que o agente alcança

A timeline só muda pela proposta, que você desfaz como um passo só. Veja [Propostas](https://nolanlabs.io/pt-br/docs/proposals).

Trazer mídia, renderizar, mudar configurações e usar o próprio shell, arquivos e internet precisam da sua resposta no chat, a menos que ele só olhe. **Configurações do projeto › O agente pode** muda isso para “Usar tudo sem perguntar”. O agente não consegue mudar essa configuração sozinho.

Cada projeto aberto tem os próprios processos de agente, rodando na pasta daquele projeto, e nenhum alcança o projeto de outro.

Os quadros que o agente olha vão para o agente que você escolheu, assim como as imagens que você cola no chat. O seu material em si fica onde está no disco.

## Próximos passos

Faça [seu primeiro corte](https://nolanlabs.io/pt-br/docs/first-cut), ou leia sobre [o chat](https://nolanlabs.io/pt-br/docs/chat).
