Conectar o OpenCode
Use o OpenCode com modelos, ferramentas MCP e habilidades por meio do Unity Gateway. A Unity Gateway CLI (ug) gerencia o login e a configuração do workspace, ou você pode configurar a conexão manualmente.
Before you begin
Você precisa da URL do workspace do Databricks e de acesso aos modelos, serviços MCP e skills que deseja usar. Para a configuração manual, instale o OpenCode e tenha um token de acesso pessoal do Databricks.
Para a configuração manual, substitua o <workspace-hostname> pelo hostname do seu workspace do Databricks e o <databricks-pat> pelo seu token. Use os nomes de modelo completos disponíveis no seu workspace e faça o merge das entradas de configuração nos arquivos existentes, mantendo as configurações não relacionadas.
Se o seu administrador já tiver configurado o seu dispositivo, siga as instruções de configuração da sua organização.
Use a Unity Gateway CLI
Instale o ug e execute o seguinte comando a partir do diretório do seu projeto:
ug opencode
Selecione seu workspace e faça login quando solicitado. O comando abre o OpenCode com seus modelos de gateway configurados. Comece a programar ou digite /models para escolher outro modelo configurado.
Configurar modelos manualmente
Instale o OpenCode e, em seguida, faça o merge desta configuração em ~/.config/opencode/opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"model": "databricks-anthropic/system.ai.claude-sonnet-4-6",
"provider": {
"databricks-anthropic": {
"npm": "@ai-sdk/anthropic",
"options": {
"baseURL": "https://<workspace-hostname>/ai-gateway/anthropic/v1",
"apiKey": "<databricks-pat>",
"headers": {
"Authorization": "Bearer <databricks-pat>"
}
},
"models": {
"system.ai.claude-sonnet-4-6": {
"options": {
"toolStreaming": false
}
}
}
}
}
}
Substitua o nome do modelo em ambos os locais se você escolher outro modelo Claude. Mantenha toolStreaming: false para compatibilidade com o gateway. Comece o OpenCode com opencode.
For Gemini models, add a separate provider using @ai-sdk/google, base URL https://<workspace-hostname>/ai-gateway/gemini/v1beta, the same authentication fields, and your Gemini model names. See OpenCode's provider documentation.
Para reduzir o custo por token em tarefas rotineiras, selecione um modelo de código aberto como system.ai.glm-5-2 como seu modelo. Consulte Controlar gastos.
Adicionar ferramentas MCP
Use a Unity Gateway CLI
execução:
ug mcp add --agents opencode
Select your serviços, then restart with ug opencode.
Configure os serviços MCP manualmente
Fazer merge desta entrada em ~/.config/opencode/opencode.json:
{
"mcp": {
"dbsql": {
"type": "remote",
"url": "https://<workspace-hostname>/ai-gateway/mcp-services/system.ai.dbsql",
"oauth": false,
"headers": {
"Authorization": "Bearer <databricks-pat>"
}
}
}
}
Para outro serviço, altere o nome do servidor e substitua system.ai.dbsql pelo nome de três partes do Unity Catalog. Reinicie o OpenCode e peça para ele usar uma ferramenta conectada. Consulte a documentação do MCP do OpenCode.
ug opencode usa ~/.ucode/opencode-xdg/opencode/opencode.json. Use esse arquivo para entradas manuais de MCP ao iniciar por meio de ug.
Add skills
Use a Unity Gateway CLI
Fazer download de habilidades publicadas:
ug skills add
Escolha suas habilidades e reinicie o OpenCode. Ele lê os downloads de ~/.agents/skills/ e carrega as habilidades relevantes conforme você trabalha.
Configurar habilidades manualmente
Para arquivos que você já possui, coloque cada pasta de habilidade completa em ~/.agents/skills/ ou em .opencode/skills/ do seu projeto. Consulte a documentação de habilidades da OpenCode.
Para acessar o registro de habilidades publicado por meio do MCP, adicione um segundo servidor usando o exemplo do MCP acima, chame-o de databricks-skill-registry e defina url como https://<workspace-hostname>/ai-gateway/skills/. Mantenha a barra à direita, o cabeçalho bearer e oauth: false. Peça ao agente para usar uma habilidade pelo nome completo.
As habilidades do Unity Gateway estão em Beta. Consulte Govern skills para saber mais sobre a ativação e as permissões.
Solução de problemas
A model request fails: Check the gateway URL, token expiration, model name, and permissions.
Um servidor MCP está ausente: reinicie o agente. Se você o configurou com ug, inicie-o com ug opencode para que ele use as mesmas configurações. Para a configuração manual, verifique ~/.config/opencode/opencode.json e o token do portador.
Uma download skill está ausente: Verifique se a pasta completa dela contém SKILL.md em um diretório compatível. Execute novamente ug skills add com as mesmas opções para fazer refresh das skills baixadas.
Para problemas de login no workspace ou de configuração de ug, execute ug doctor.