Documentação

Documentação › Chat

Chat

O Claude Code e o Codex também abrem como chat, com a mesma conversa do terminal. Você vê os passos agrupados, responde permissões e perguntas com uma tecla, troca modelo, modo e Effort, e acompanha o contexto e os limites do plano.

Chat | Terminal

MacWindowsLinuxdesde a 1.0.1

Cada Claude Code ou Codex tem duas faces com a mesma conversa: o chat do Octopus e a interface do próprio agente, no terminal. Você troca de uma para a outra a qualquer hora.

A mesma conversa no chat e no terminal

Passo a passo

  1. No Novo terminal, deixe “Mostrar como chat” ligado para o agente já abrir no chat.
  2. Num cartão aberto, aperte ⌘JCtrl+Shift+J ou use o seletor chat | terminal na barra do cartão. No botão direito: “Ver como chat” e “Ver como terminal”.
  3. No Mac, com o agente trabalhando no terminal, abrir o chat pergunta antes: “Abrir no chat agora” interrompe o que ele faz, e a conversa continua no chat.
  4. Do chat para o terminal com algo rodando: no Mac, “Esperar e abrir” troca sozinho quando tudo terminar e “Abrir agora” encerra o que roda; no Windows e no Linux o cartão espera sem perguntar, e Ctrl+Shift+J de novo abre já. Enquanto espera, o chat mostra “o terminal abre quando terminar”, e “Ficar no chat” desiste.
Alternar chat e terminal⌘JCtrl+Shift+J

Comandos que só existem na interface do agente (como o /doctor do Claude Code) ficam no terminal: troque de face para usá-los.

Veja tambémNovo terminalComandos “/”: /resume e /btw

A caixa de mensagem

MacWindowsLinuxdesde a 1.0.0

Escreva e envie com Enter. Enquanto o agente trabalha, a próxima mensagem entra na fila; se for urgente, ela passa na frente.

Uma mensagem na fila, com Enviar agora
Uma mensagem na fila, com Enviar agora

Passo a passo

  1. Escreva na caixa (“Responder ao Claude…” ou “Responder ao Codex…”). ↩Enter envia. ⇧↩Shift+Enter quebra a linha.
  2. Com o agente trabalhando, o que você envia fica “Na fila”: ele lê quando terminar o que está fazendo.
  3. Para entregar já, clique em “Enviar agora” na mensagem da fila, ou envie com ⌘↩Ctrl+Enter: o agente interrompe o que faz e lê a mensagem.
  4. Esc ou o botão de parar interrompem o agente. Se ele ainda não tinha respondido, a sua mensagem volta para a caixa, para você mudar e enviar de novo.
  5. O microfone ao lado do enviar dita a mensagem com a voz.
Enviar↩Enter
Nova linha⇧↩Shift+Enter
Enviar já, interrompendo⌘↩Ctrl+Enter
Parar o agenteEsc

Uma mensagem que o agente não chegou a ler, porque foi parado antes, fica marcada: “Não enviada: o agente foi parado antes de lê-la”.

Veja tambémRascunhosAvisos do chatOnde ditar

Anexos e @ arquivos

MacWindowsLinux

Mande imagens junto com a mensagem e cite arquivos do projeto com @. Outros arquivos e pastas vão pelo caminho.

Um print anexado e a busca de arquivos com @
Um print anexado e a busca de arquivos com @

Passo a passo

  1. Clique no “+” (“Anexar arquivos”) e escolha os arquivos. Fotos vão junto com a mensagem; outros arquivos e pastas vão pelo caminho.
  2. Também dá para colar uma imagem na caixa ou arrastar arquivos do Finder (no Windows e no Linux, do gerenciador de arquivos) até o chat. A miniatura aparece acima da caixa; o × tira.
  3. Digite @ e parte do nome para buscar um arquivo do projeto. ↑ e ↓ escolhem; ↩Enter ou ⇥Tab inserem.
  4. Prints grandes são reduzidos antes de ir, e a conversa continua respondendo enquanto a imagem chega.

Veja tambémColar imagens e arquivos no terminalEnviar para um agente

Modos de permissão

MacWindowsLinuxdesde a 1.0.0

O botão à esquerda, abaixo da caixa, diz quanto o agente pode fazer sem perguntar. Troque a qualquer hora, sem perder a conversa.

Os modos de permissão do Claude Code

Passo a passo

  1. Clique no botão do modo, abaixo da caixa de mensagem.
  2. No Claude Code: “Pedir permissão”, “Aceitar edições”, “Plano” e “Automático”.
  3. No Codex: “Pedir permissão” (pergunta antes de rodar comandos que mudam algo), “Automático” (edita e roda na pasta; pergunta para sair dela ou usar a rede), “Só leitura” e “Acesso total” (faz tudo sem perguntar).
  4. No modo “Plano”, o agente termina com o pedido “Aprovar o plano e começar?”: “Aprovar” ou “Continuar planejando”.

Se o agente foi aberto num modo que não pergunta nada, o botão mostra “Sem permissões” ou “Não perguntar”.

Veja tambémPermissões: 1–9 e Esc

Modelo e modo rápido

MacWindowsLinuxdesde a 1.0.0

O botão do modelo lista os modelos que o agente oferece na sua conta. Nos modelos que têm, “Modo rápido” dá respostas mais rápidas, com custo maior.

O menu do modelo com o Modo rápido
O menu do modelo com o Modo rápido

Passo a passo

  1. Clique no botão do modelo, à direita, abaixo da caixa de mensagem.
  2. Escolha um modelo. O marcado é o atual.
  3. Se o modelo tiver, ligue ou desligue “Modo rápido” no fim da lista.

A lista vem do próprio agente. Enquanto ele não informa, o menu diz “O agente ainda não disse quais modelos oferece.”

Veja tambémEffort e Ultracode

Effort e Ultracode

MacWindowsLinuxdesde a 1.0.0

Effort é quanto o modelo pensa antes de responder: à esquerda ele responde mais rápido, à direita pensa mais. Na ponta da régua, o Ultracode planeja e divide o trabalho entre vários agentes.

A régua do Effort, com o Ultracode na ponta
A régua do Effort, com o Ultracode na ponta

Passo a passo

  1. Clique no botão do Effort, ao lado do modelo.
  2. Clique numa marca da régua. Os níveis dependem do modelo (Nenhum, Mínimo, Baixo, Médio, Alto, Extra alto, Máximo), e a marca recomendada fica destacada.
  3. Sem escolha, vale o “Padrão do modelo”.
  4. Na ponta direita, quando o Claude Code oferece, fica o Ultracode. No Codex, o nível mais alto também aparece como Ultracode.

Com o Ultracode, o trabalho dos agentes aparece na caixa acima da mensagem e num cartão Workflow na conversa.

Veja tambémWorkflow e agentes em segundo plano

Contexto e limites do plano

MacWindowsLinuxdesde a 1.0.0

O anel no canto mostra quanto do contexto a conversa já usa. Clicando nele, você vê o que ocupa espaço, resume a conversa na hora e confere os limites do seu plano.

O painel do contexto e dos limites do plano
O painel do contexto e dos limites do plano

Passo a passo

  1. Passe o mouse no anel para ver a porcentagem e os tokens. Ele muda de cor perto do fim.
  2. Clique no anel. Em “Contexto”, a barra mostra o uso e quanto falta até o agente resumir a conversa sozinho.
  3. “Resumir agora” resume a conversa para liberar espaço. Ele fica apagado enquanto o agente trabalha.
  4. “Ver o que ocupa” lista as partes: prompt do sistema, ferramentas, MCP, memória, skills, mensagens e a reserva para resumir.
  5. Em “Limites do plano”, cada limite mostra a porcentagem usada e quando zera, como “Zera em 2 h”.
  6. Em “Sessão”, o ID da conversa, com “Copiar”.

No Codex, o resumo também está no menu “/”, como /compact.

Veja tambémAvisos do chatCopiar ID da sessão e diagnóstico dos alertas

Passos agrupados e tarefas

MacWindowsLinuxdesde a 1.0.0

Como no Claude Code, o que o agente faz aparece em passos curtos, agrupados numa linha: leu, rodou, editou, buscou. A lista de tarefas dele fica fixa acima da caixa.

Passos agrupados e a lista de tarefas
Passos agrupados e a lista de tarefas

Passo a passo

  1. Cada linha diz o que o agente faz agora (“Lendo”, “Rodando”, “Editando”) e, quando acaba, o que fez (“Leu”, “Rodou”, “Editou”, “Buscou”, “Pesquisou”). Edições mostram as linhas a mais e a menos; falhas ficam marcadas.
  2. Clique numa linha para abrir os passos dela: o comando, o arquivo, o resultado.
  3. Subagentes e workflows aparecem como passos próprios.
  4. “Tarefas · 2 de 4” acompanha a lista de tarefas do agente, acima da caixa.
  5. No fim de cada resposta, uma linha resume a rodada, como “Concluído em 1 min 20 s”. Com chave de API, ela mostra também o custo em dólares.
  6. Lendo lá em cima, a seta “Ir para o fim” volta à última mensagem.

Veja tambémWorkflow e agentes em segundo plano

Copiar a resposta e o ID

MacWindowsLinuxdesde a 1.0.1

Copie o texto de uma resposta, em markdown, com um clique. O ID da conversa fica no painel do contexto.

Passo a passo

  1. Passe o mouse logo abaixo de uma resposta e clique em “Copiar a resposta”.
  2. Para o ID da conversa, clique no anel de contexto e use “Copiar” em “Sessão”, ou o botão direito no cartão › “Copiar ID da sessão”.

Veja tambémCopiar ID da sessão e diagnóstico dos alertas

Permissões: 1–9 e Esc

MacWindowsLinuxdesde a 1.0.0

Quando o agente pede para rodar um comando, editar um arquivo ou abrir um endereço, o pedido aparece no fim da conversa, com as opções numeradas. Uma tecla responde.

Um pedido de permissão com as opções numeradas
Um pedido de permissão com as opções numeradas

Passo a passo

  1. O pedido diz o que é, com o detalhe embaixo: “Rodar este comando?”, “Editar checkout.ts?”, “Abrir este endereço?”, “Pesquisar na web?” ou “Aprovar o plano e começar?”.
  2. Aperte 1 para “Permitir” (no plano, “Aprovar”).
  3. Os números seguintes são as sugestões do agente, como “Sempre permitir” um comando nesta sessão ou neste projeto, ou “Liberar” uma pasta.
  4. Esc ou a última opção negam (no plano, “Continuar planejando”).
  5. Para negar e dizer o que fazer em vez disso, escreva na caixa (“Ou diga ao Claude o que fazer em vez disso…”) e envie.
Permitir1
NegarEsc

As teclas valem com a caixa de mensagem vazia; com texto nela, os números são texto.

Veja tambémModos de permissãoPedindo você e Terminou

Perguntas uma por vez

MacWindowsLinuxdesde a 1.0.33

Quando o agente faz perguntas, elas aparecem uma de cada vez no fim da conversa, com as opções dele e espaço para outra resposta. O que veio antes continua à vista, acima.

Duas perguntas do agente, uma de cada vez
Duas perguntas do agente, uma de cada vez

Passo a passo

  1. Leia a pergunta e clique numa opção. Com o teclado fora da caixa de mensagem, o número da opção também escolhe. Numa escolha única, ele passa sozinho para a próxima pergunta.
  2. Para responder outra coisa, escreva em “Outra resposta…”.
  3. Use as abas do alto, “Anterior” e “Próximo” para revisar. Na última pergunta, “Responder” envia tudo.

Uma aba ganha um sinal de feito quando a pergunta dela já tem resposta.

Veja tambémPermissões: 1–9 e Esc

Digite / para ver os comandos do agente e os do Octopus. /resume abre outra conversa salva da pasta, e /btw faz uma pergunta rápida sem interromper o trabalho.

O menu de comandos do chat
O menu de comandos do chat

Passo a passo

  1. Digite / na caixa. A lista traz os comandos do próprio agente (no Claude Code, por exemplo, /clear, /compact e /review) e os do Octopus, e filtra enquanto você digita, inclusive pelos apelidos (/new acha o /clear). ↑ e ↓ escolhem; ↩Enter usa.
  2. “/resume” (“Retomar outra conversa salva desta pasta”) lista as conversas que o agente salvou na pasta, com a idade de cada uma, e abre a escolhida no mesmo cartão.
  3. “/btw” e uma pergunta, no Claude Code (desde a 1.0.20): a resposta aparece num painel acima da caixa e não entra na conversa. Esc fecha o painel.
  4. No Codex, o menu também traz as skills dele e o /compact, que resume a conversa.

Comandos que só funcionam na interface do agente não aparecem no chat. Para eles, troque para o terminal.

Veja tambémChat | TerminalConversa e Quantidade

Workflow e agentes em segundo plano

MacWindowsLinuxdesde a 1.0.3

Uma caixa acima da mensagem mostra os subagentes e workflows rodando, como o rodapé do terminal do Claude Code. Cada Workflow tem um cartão próprio na conversa, com fases, agentes, tempo e tokens.

A caixa de agentes rodando e um Workflow na conversa
A caixa de agentes rodando e um Workflow na conversa

Passo a passo

  1. Quando o agente põe subagentes ou um workflow para rodar, aparece a caixa “2 agentes rodando” acima da mensagem. Clique no título para recolher ou abrir.
  2. Cada linha diz o que aquele agente faz, há quanto tempo e quantos tokens já usou.
  3. Um Workflow aparece na conversa com o nome, a descrição e o script; aberto, mostra as fases e os agentes de cada uma.
  4. Entre uma resposta e outra, a linha de status lista o que ficou rodando: “Em segundo plano: …”.

Veja tambémEffort e UltracodeAgentes em segundo plano

Rascunhos

MacWindowsLinuxdesde a 1.0.9

O que você digitou e não enviou fica guardado em cada chat e volta quando o Octopus abre de novo.

Passo a passo

  1. Comece uma mensagem e deixe para depois. Ela continua na caixa daquele cartão.
  2. Mesmo fechando o Octopus, o rascunho volta na próxima vez.

Parar o agente antes de ele responder também devolve a sua última mensagem para a caixa.

Veja tambémA caixa de mensagem

Avisos do chat

MacWindowsLinux

A linha de status, no fim da conversa, diz o que o agente faz agora e há quanto tempo. Quando algo foge do normal, ela avisa e oferece o próximo passo.

A linha de status enquanto a conversa é resumida
A linha de status enquanto a conversa é resumida

Passo a passo

  1. “Trabalhando” (ou o que o agente faz) com o tempo e “esc para parar”. Enquanto pensa, “Pensando…”. Pedindo você: “Esperando você: o Claude pediu permissão” ou “perguntou”.
  2. “Sem notícias do Claude há…”: ele está calado há muito tempo. “Reconectar” refaz a ligação com o agente.
  3. “Resumindo a conversa…” (ou “Contexto cheio: resumindo a conversa…”), com o tempo. No fim, a linha “Conversa resumida”.
  4. No alto do cartão: “Sem conexão com o agente.” com “Tentar de novo”, ou “O Claude Code parou (código 1).” com “Reiniciar”. O botão “Terminal” mostra o agente na interface dele.
  5. No fim de uma rodada: “Parou” (a rodada foi interrompida), “Parou: limite de passos” ou “Terminou com erro”.
  6. Se o chat reconecta no meio de uma resposta, ele avisa quando ela termina.

Quando o Claude Code para por limite de uso, conta ou erro da API, o cartão também avisa em “Precisam de você”.

Veja tambémParou: limite de uso, conta ou erro da APIContexto e limites do plano