GitHubAntes de começar
- Um terminal e uma pasta de projeto local.
- Credenciais do provedor de modelos escolhido. Os modelos disponíveis e o uso dependem desse provedor.
- Já usa o OpenCode 1? Faça uma cópia da configuração e leia o guia de migração antes de trocar. V1 e V2 compartilham os locais de configuração.
A autenticação e o acesso são gerenciados diretamente por cada fornecedor.
Instale a CLI
Este guia cobre o OpenCode 2. No macOS, escolha o instalador ou o Homebrew. No Linux, use o instalador. No Windows, baixe a CLI independente para sua arquitetura na documentação oficial de configuração; a V2 não oferece suporte a gerenciadores de pacotes do Windows.
Continuar na documentação oficial
Escolha um método de instalação. Copie o comando do seu sistema e execute no seu próprio terminal.
curl -fsSL https://opencode.ai/v2/install | bashbrew install anomalyco/tap/opencode-v2Verifique a instalação
Confira se a versão exibida começa com 2. Se aparecer 1, outra instalação do OpenCode pode estar tendo prioridade no seu PATH.
opencode --versionEntre e comece
Abra um terminal na pasta de um projeto com o qual deseja trabalhar e inicie a CLI:
opencodeDentro do OpenCode, execute /connect, escolha seu provedor e siga as etapas de autenticação. Depois execute /models e selecione um modelo disponível. Esses comandos são para a interface do OpenCode, e não para o shell.
/connect/modelsExperimente sua primeira tarefa
Comece pedindo uma explicação do projeto. Revise a resposta antes de solicitar alterações.
Explique a estrutura deste projeto sem modificar arquivos.
Se algo der errado
O terminal não encontra opencode
Abra um novo terminal e confira se o diretório da instalação está incluído no PATH.
Nenhum modelo está disponível
Repita /connect e /models dentro do OpenCode. Confira as credenciais e o acesso aos modelos no seu provedor.
A sessão não inicia
Confira o serviço em segundo plano com o comando abaixo. Consulte o guia oficial de solução de problemas antes de alterar arquivos do serviço ou dados das sessões.
Plugins existentes falham após a troca de versão
As implementações de plugins da V1 precisam ser migradas para a V2. Consulte o guia de migração antes de ativá-las.
opencode service statusMantenha a ferramenta atualizada
Continue usando o mesmo canal de instalação da V2. Confira as instruções atuais de atualização na documentação oficial de configuração e verifique opencode --version novamente.
Fontes oficiais
- OpenCode · Configuração
- OpenCode · CLI
- OpenCode · Provedores
- OpenCode · Solução de problemas
- OpenCode · Migração da V1
Estes são guias independentes das ferramentas dos fornecedores. A disponibilidade das integrações do ORQST segue o roadmap do produto.