English 中文 العربية 日本語 Português

OpenCode: OpenCode CLI Commands

Última atualização: 2026-08-31

--- title: Uso do CLI do OpenCode description: Domine o sistema completo de comandos da interface de linha de comando do OpenCode, incluindo run, serve, agent, auth e outros comandos centrais order: 8 lang: pt-br

O CLI do OpenCode não é apenas a porta de entrada para o TUI, mas uma interface de desenvolvimento com IA programável.

1. O Que Você Vai Aprender

2. Arquitetura de 3 Camadas do CLI

Camada Comandos Descrição
Interação tui / web / attach Interfaces para o usuário
Execução run / agent / mcp / github Execução de tarefas
Serviço serve / acp Provisão de API

3. Uso Básico

BASH 
# Iniciar TUI (padrão)
opencode

# Diretório específico
opencode /path/to/project

# Modo não-interativo
opencode run Explique o princípio de closures em JavaScript

4. Comandos Centrais

Comando Função Subcomandos
agent Gerenciar agentes create / list
auth Gerenciar autenticação login / list / logout
attach Conectar a backend remoto —
github Automação GitHub install / run
mcp Gerenciar serviços MCP add / list / auth / debug
models Listar modelos —
run Execução não-interativa —
serve Iniciar serviço API —
web Serviço Web UI —
session Gerenciar sessões list
stats Estatísticas de tokens/custo —
upgrade Atualizar versão —

5. Comando run (Mais Usado)

Para execução não-interativa, ideal para scripts e CI/CD:

BASH 
opencode run Analise o uso de contexto neste projeto Go

Parâmetros Comuns

Parâmetro Curto Descrição
--continue -c Continuar sessão
--session -s Especificar sessão
--model -m Especificar modelo
--agent — Especificar agente
--file -f Anexar arquivo
--format — Formato de saída (json)
--share — Compartilhar sessão
--attach — Conectar a serviço existente

Conectar a Serviço Backend

BASH 
opencode serve
opencode run --attach http://localhost:4096 Explique async/await

6. Outros Comandos

BASH 
opencode auth login        # Login
opencode auth list         # Provedores conectados
opencode models            # Todos os modelos
opencode models anthropic  # Filtrar por provedor
opencode agent create      # Criar agente
opencode agent list        # Listar agentes
opencode serve             # Iniciar API
opencode web               # Iniciar Web UI
opencode stats             # Estatísticas de tokens

7. Variáveis de Ambiente

Variável Tipo Função
OPENCODE_AUTO_SHARE boolean Compartilhar automaticamente
OPENCODE_CONFIG string Caminho de configuração
OPENCODE_DISABLE_AUTOUPDATE boolean Desativar atualização
OPENCODE_SERVER_PASSWORD string Senha de autenticação API
OPENCODE_EXPERIMENTAL boolean Ativar recursos experimentais

8. Recomendações de Uso

Cenário Comando Recomendado
Desenvolvimento diário opencode (TUI)
Automação/scripts opencode run
CI/CD opencode serve + run --attach
Alta frequência opencode serve + cliente
Web UI opencode web

❓ FAQ

P: Qual a diferença entre run e TUI?

R: run é modo não-interativo que retorna resultados diretamente, ideal para scripts. TUI é modo interativo com múltiplas rodadas de diálogo e comandos slash.

P: Como usar o OpenCode em CI/CD?

R: Inicie opencode serve, depois use opencode run --attach para conectar e executar tarefas, evitando cold starts repetidos.

📖 Resumo

📝 Exercícios

  1. Básico: Use opencode run para uma análise de código não-interativa.

  2. Intermediário: Inicie opencode serve e conecte via run --attach.

  3. Avançado: Escreva um script Shell usando opencode run para analisar código e gerar relatório.

Web-Tutorial.com

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

100%