CLI

O CLI do OpenCode fornece acesso por linha de comando à funcionalidade do OpenCode. Por padrão, executar opencode inicia a interface de usuário de terminal (TUI).

opencode

Passe comandos para interação programática:

opencode run "Explain how closures work in JavaScript"

Flags do TUI

Flag	Curto	Propósito
`--continue`	`-c`	Continuar sessão anterior
`--session`	`-s`	Especificar ID da sessão
`--prompt`	—	Fornecer prompt inicial
`--model`	`-m`	Definir modelo (provider/model)
`--agent`	—	Selecionar agente

Comandos

run

Executar OpenCode em modo não interativo:

opencode run [message..]

Flags:

--continue, -c: Continuar última sessão
--model, -m: Definir modelo
--file, -f: Anexar arquivo(s)
--format: Saída como default ou json

auth

Gerenciar credenciais:

opencode auth login    # Configurar chaves API
opencode auth list     # Mostrar provedores
opencode auth logout   # Remover credenciais

models

Listar modelos disponíveis:

opencode models [provider]
opencode models --refresh  # Atualizar lista em cache
opencode models --verbose  # Mostrar custos

session

Gerenciar sessões:

opencode session list
opencode session list --format json

serve

Iniciar servidor HTTP headless:

opencode serve --port 4096

web

Iniciar servidor com interface web:

opencode web --port 4096

agent

Gerenciar agentes:

opencode agent create  # Criar agente personalizado
opencode agent list    # Listar agentes

mcp

Gerenciar servidores MCP:

opencode mcp add       # Adicionar servidor
opencode mcp list      # Mostrar servidores
opencode mcp auth      # Autenticar
opencode mcp debug     # Depurar

stats

Mostrar estatísticas de uso:

opencode stats --days 30
opencode stats --models

upgrade

Atualizar OpenCode:

opencode upgrade           # Última versão
opencode upgrade v0.1.48   # Versão específica

Flags Globais

Flag	Curto	Propósito
`--help`	`-h`	Mostrar ajuda
`--version`	`-v`	Imprimir versão
`--print-logs`	—	Enviar logs para stderr
`--log-level`	—	Definir nível (DEBUG, INFO, WARN, ERROR)

Variáveis de Ambiente

Configuração Principal

Variável	Propósito
`OPENCODE_CONFIG`	Caminho do arquivo de configuração
`OPENCODE_CONFIG_DIR`	Diretório de configuração
`OPENCODE_CONFIG_CONTENT`	Configuração JSON inline

Recursos

Variável	Propósito
`OPENCODE_DISABLE_AUTOUPDATE`	Desativar atualizações
`OPENCODE_ENABLE_EXPERIMENTAL_MODELS`	Habilitar modelos experimentais
`OPENCODE_DISABLE_AUTOCOMPACT`	Desativar compactação

TUI IDE