Configuração do OpenCode
O OpenCode é um assistente de código com IA para terminal de código aberto. É ideal para perguntas e respostas sobre código, modificações de arquivos e alternância de modelos dentro do diretório de um projeto. Iniciantes devem primeiro usar seu próprio assistente de conexão e evitar escrever o JSON completo manualmente logo no início.
Informações oficiais Downloads e documentação estão sujeitos ao site oficial.
O que é esta ferramenta e para que serve
Localização do arquivo de configuração
| Sistema | Localização do arquivo de configuração | Descrição |
|---|---|---|
| Windows | C: \Users\YourUsername\. config\opencode\opencode.json | Se o arquivo não existir, crie um novo |
| macOS / Linux | ~/. config/opencode/opencode.json | Se o arquivo não existir, crie um novo |
Comece pelo assistente de conexão
Assistente de Conexão do OpenCode
cd YOUR_TEST_PROJECT opencode /connectVerificar Modelo no OpenCode
cd YOUR_TEST_PROJECT opencode /modelsO que observar ao configurar manualmente
Edite o arquivo de configuração apenas se a documentação do seu provedor especificar claramente o campo Provider do OpenCode, onde colocar a Base URL e a Key. Os campos podem variar entre versões; não copie exemplos de JSON de outras ferramentas diretamente no OpenCode.
| Itens a verificar | Descrição |
|---|---|
| Tipo de Provedor | Não misture protocolos da OpenAI, Claude, Gemini ou outros |
| Base URL | Use o endereço completo fornecido pelo provedor para o OpenCode ou para o protocolo correspondente |
| Key | Use a Key correspondente ao provedor atual |
| Nome do Modelo | Copie a lista de modelos do painel do provedor |
Como testar após salvar
- Após entrar no diretório de um projeto de teste, execute
opencode. - Primeiro use
/modelspara confirmar se o modelo recém-configurado está visível. - Após selecionar o modelo, envie 'Por favor, responda apenas: Configuração do OpenCode realizada com sucesso'.
- Na primeira vez, não permita que ele modifique arquivos; apenas peça para explicar o diretório ou o arquivo atual.
- Se falhar, volte primeiro para
/connectou verifique o provedor, a base URL, a key e o nome do modelo na documentação do provedor.
| Sintoma | Verificação prioritária | Solução |
|---|---|---|
/models Não há nenhum modelo listado | Se o provedor foi salvo com sucesso e se a lista de modelos pode ser obtida | Adicione manualmente o ID do modelo / nome do modelo do painel do provedor |
| Falha na conexão | Se a Base URL pertence ao protocolo do provedor atual | Não misture endereços de Claude, Gemini e OpenAI |
| O arquivo de configuração é inválido | Formato JSON, vírgulas, aspas | Priorize gerar a configuração usando o assistente de conexão e depois faça pequenos ajustes manuais. |
Site Oficial do OpenCode Veja instruções de instalação, autenticação e comandos.
Referência de Configuração de Provedor de IA no OpenCode Consulte a abordagem de configuração do opencode.json.