Skip to main content

​
1. Obter a API Key

Abra a lista de aplicações do Ace Data Cloud, entre em uma aplicação disponível e copie a API Key. Obter a API Key do Ace Data Cloud

​
2. Instalar o OpenCode

Também é possível usar npm:

​
3. Definir a API Key

Para que tenha efeito permanente, adicione esta linha a ~/.zshrc ou ~/.bashrc e reabra o terminal.

​
4. Configurar o Provider

Edite ~/.config/opencode/opencode.json:
Acesse o catálogo de modelos para ver os nomes dos modelos (por exemplo, claude-opus-5, gpt-6-sol) e substitua todos os MODEL_ID pelo mesmo nome; para validação precisa, use o valor de id na resposta de /v1/models como referência. Esse valor é o nome do modelo usado pelo parâmetro model da API, não o UUID do serviço ou da API. O Ace Data Cloud usa Chat Completions aqui, portanto o adapter é @ai-sdk/openai-compatible.

​
5. Verificar e iniciar

Em seguida, execute opencode no diretório do projeto. Se o modelo não aparecer, verifique o caminho do arquivo de configuração, a sintaxe JSON e as variáveis de ambiente; 401 indica que a Key é inválida ou não foi exportada. A extensão da IDE reutiliza a mesma configuração de runtime do OpenCode; consulte OpenCode IDE Extension.

​
Referências oficiais