Pular para o conteúdo

Todos os comandos

contextcode --help lista todos; contextcode <comando> --help mostra as opções de um deles.

ComandoO que faz
contextcode chatChat interativo no terminal. Usa uma interface de tela cheia se o terminal for interativo, e um REPL simples se a saída for para um arquivo; --tui e --plain forçam cada um. Aceita --modelo, --cwd e --continuar.
contextcode run "<prompt>"Um turno do agente e sai. Ideal para scripts e tarefas agendadas. Aceita --modelo.

São duas coisas diferentes e se confundem com frequência: login é a sua conta do Context Code; provider é o modelo de IA que o agente usa.

ComandoO que faz
contextcode login [--email <e-mail>]Faz login da licença. É a única via em um servidor sem tela.
contextcode login --statusEstado da licença, sem pedir nada.
contextcode logoutEsquece as credenciais deste computador (não cancela a assinatura).
contextcode provider login <provedor> [--key]Conecta o motor de IA: claude, gemini-api, openai, copilot, zai, ollama… Com --key sem valor, pede a chave sem exibi-la; --key - a lê do stdin.
contextcode provider statusProvedores configurados e qual está ativo.
contextcode modelos [--json]Modelos disponíveis por provedor, com o ativo marcado.
contextcode modelos usar <id>Define o modelo que chat e run usam, o mesmo do seletor do aplicativo.
contextcode uso [hoy|semana|mes|todo]Tokens e custo, como o painel de uso.
contextcode statusQuais runtimes empacotados (Node, uv, npx) serão usados de verdade.

Sobe o servidor web que o celular escaneia, sem abrir janela. Fica rodando até você cortar com Ctrl+C (ou para sempre, com --install).

OpçãoO que faz
--print-qrDesenha o QR do link no terminal. Com URL pública, o QR é o dela e a URL da rede local vai embaixo. A URL sai por stdout e os avisos por stderr, então contextcode serve --print-qr | head -1 dá a URL limpa.
--publicPublica por um túnel público em vez do IP da rede local. Usa a URL fixa da máquina se tiver ou puder pedir; se não, um túnel temporário cuja URL muda a cada início. Indispensável em um VPS.
--stableComo --public, mas sempre com a URL fixa da máquina. Exige o plano com servidores remotos.
--port NPorta de escuta (por padrão 8787, ou a do link salvo).
--bind 127.0.0.1IP de escuta. Atrás de nginx, caddy ou um túnel SSH, para não expor a porta em aberto.
--minutes NVida do link novo, de 1 a 43 200 minutos (30 dias).
--token-file <caminho>Token estável em um arquivo com permissões 0600, sem depender do chaveiro do sistema. É o que o serviço usa.
--installInstala o serve como serviço do usuário (systemd no Linux, LaunchAgent no macOS, tarefa agendada no Windows) e o inicia. Ao terminar, imprime a URL e o QR que o serviço vai usar.
--uninstallPara e remove o serviço.
ComandoO que faz
contextcode dispositivos [--json]Celulares pareados: nome, id, pareado, último uso e IP.
contextcode dispositivos revocar <id|nome>Retira o acesso na hora, mesmo com o servidor rodando. --todos para todos, --si sem confirmação.

Como deixar como serviço, qual URL o QR leva e o que verificar se o celular não conecta: Acesso remoto a partir de um servidor.

ComandoO que faz
contextcode remoto agregar <nome> <url> [--token T]Cadastra um Context Code remoto e se emparelha com ele.
contextcode remoto listar [--json]Os remotos configurados. Nunca imprime credenciais.
contextcode remoto usar <nome>Fixa qual é usado quando você não diz o nome.
contextcode remoto quitar <nome>Apaga a credencial deste computador.
contextcode remoto probar [<nome>]Confere que responde, que a credencial vale e o que há do outro lado.
contextcode chat --remoto [<nome>]Chat no terminal contra o agente de outra máquina.

Todo o detalhe em Outro Context Code daqui.

ComandoO que faz
contextcode canal telegram|slack|whatsappDeixa o agente escutando esse canal, sem janela, até Ctrl+C. Aceita --workspace e --model.
contextcode canal configurar <canal>Guarda e valida o token do bot, pedindo-o sem exibi-lo.
contextcode canal estadoQuais canais têm credenciais, sem mostrá-las.
contextcode automatizaciones listar|crear|borrar|activar|desactivar|ejecutarAs mesmas automações do aplicativo.
contextcode tickUma passada do agendador de automações e sai. É o que a tarefa agendada do sistema invoca.
ComandoO que faz
contextcode mcp listar|agregar|quitar|probarServidores MCP, nos mesmos escopos do aplicativo.
contextcode skills listar|instalar|quitarSkills do projeto e globais.
contextcode caja listar|guardar|rotar|borrarO cofre do projeto. Os valores são pedidos sem exibi-los.

Exemplos e opções em Administrar pelo terminal.

ComandoO que faz
contextcode conexionOnde está tudo e como eu me conecto — veja a página dele. contextcode conexion --qr mostra de novo o QR do serviço que está rodando.
contextcode instalar-cli [--mostrar]Deixa contextcode no PATH onde o instalador não conseguiu.
contextcode update [--check]Atualiza o binário (servidores Linux).
CódigoSignifica
0Sucesso (também --help e --version).
1A ação foi executada, mas falhou.
2Uso incorreto: argumento desconhecido ou falta um valor.

Sem nenhum comando, contextcode inicia o aplicativo de desktop; com --minimized, oculto na bandeja.