Conecte ferramentas externas à API do OpenDesign Cloud

Gerencie suas chaves de API do OpenDesign pela web e use os modelos compatíveis com seu plano em um agente externo. O app para desktop do OpenDesign não é necessário. A configuração com um clique importa a conexão pelo CC Switch no seu computador.

Escolha a conexão necessária

Para adicionar uma chave de provedor ao OpenDesign, siga a configuração de BYOK. Este guia aborda o caminho inverso: usar a API de modelos do OpenDesign Cloud em uma ferramenta externa, como Claude Code ou Codex.

Antes de começar

A Cloud API do OpenDesign está disponível nos planos Go, Plus, Pro e Max. O plano Free não é compatível. A lista de modelos da sua conta determina quais modelos de texto você pode usar; os modelos mostrados nas capturas de tela são exemplos, não benefícios garantidos para todos os planos.

Os agentes compatíveis são Claude Code, Codex, Grok Build, OpenCode, OpenClaw e Hermes Agent. Primeiro, instale o agente escolhido. Se o CC Switch já estiver instalado, você poderá pular a etapa de instalação.

Abra API keys na web

Entre no gerenciamento da conta do OpenDesign pela web e escolha API keys na barra lateral. Selecione One-click agent setup no canto superior direito. Você pode começar sem uma chave existente.

A página completa de API keys: One-click agent setup fica no canto superior direito; Connection setup contém os formatos de API e seus respectivos Base URLs.

Para a configuração manual, abra Connection setup (configuração da conexão), selecione o formato de API exigido pela sua ferramenta — Chat Completions, Responses ou Messages — e copie a API base URL (URL base da API). Mantenha o endpoint e o protocolo correspondentes. As etapas abaixo mostram a importação com um clique.

Etapa 1: instale e abra o CC Switch

Em One-click agent setup, selecione Download for Mac ou Download for Windows.
Instale e abra o CC Switch. Pule esta etapa se ele já estiver instalado.

Etapa 2: escolha um agente e um modelo

Selecione o agente de destino. Claude Code vem selecionado por padrão.
Escolha, na lista Model, um modelo de texto disponível para o seu plano. Se nenhum modelo estiver disponível, escolha outro agente ou verifique seu plano; copiar o nome de um modelo de uma captura de tela não concede acesso.

A caixa de diálogo de configuração: escolha o agente de destino e, depois, um modelo disponível para sua conta.

Etapa 3: importe e reinicie

Selecione Import into CC Switch. Isso cria uma nova chave com o nome do agente e do sistema, como Claude Code · Mac, e abre o CC Switch.
Autorize Open CC Switch na solicitação do navegador. Confira API Endpoint, a chave e o modelo no CC Switch e selecione Import.
Volte à página da web e selecione Done ou Set up another agent para configurar outra conexão.
Reinicie o agente de destino. No Claude Code, encerre a sessão atual e execute claude em um novo terminal.

A janela de confirmação do CC Switch: verifique o endpoint e o modelo antes de importar. A chave nesta captura de tela está mascarada.

Cada configuração com um clique cria uma nova chave; não é possível reutilizar uma chave existente. As chaves existentes não são afetadas. A configuração anterior do agente permanece disponível no CC Switch.

Verifique a conexão ativa

Envie uma mensagem curta no agente reiniciado e confirme se ele responde.
No Claude Code, execute /status e compare o modelo com sua seleção. Nos outros agentes, use a visualização de status equivalente.
Na página de API keys na web, verifique se o horário de Last used da nova chave é atualizado.

Se o modelo antigo ainda estiver ativo, feche a sessão antiga e reinicie o agente. Se o navegador não tiver aberto o CC Switch, verifique a solicitação de confirmação próxima à barra de endereços, abra o CC Switch e selecione Open novamente. Alterações posteriores de modelo podem ser feitas no CC Switch sem repetir a configuração.

Volte à configuração anterior ou revogue o acesso

No CC Switch, encontre a configuração anterior do agente e ative-a para voltar. Remover uma configuração do CC Switch não desativa a API Key. Revogue a chave na página de API keys na web quando quiser que ela pare de funcionar.

Consulte a página da conta para verificar seu plano atual e a disponibilidade de modelos. Veja o tutorial de configuração de agente com um clique para acessar a gravação completa e as capturas de tela, ou Assinaturas e cobrança para configurar a conta.

As chamadas de API compartilham os créditos do app?

Sim. As chamadas normais de API compartilham os limites do plano e as janelas de uso com o app. Criar outra chave ou trocar de agente não os redefine. Créditos promocionais podem ter termos de elegibilidade separados para a API. Consulte créditos e uso.

Abra o console do Cloud para gerenciar chaves e uso. Ferramentas como o Zcode, que aceitam um endpoint de modelo personalizado e uma chave, podem ser configuradas para o protocolo de API correspondente. Isso não significa que o OpenDesign possa iniciar essa ferramenta como um agente local integrado.

As solicitações com imagens excedem o limite de tamanho

As orientações atuais do suporte especificam um limite de 50 MiB para o corpo das solicitações de API. Esse limite se aplica ao corpo inteiro, não a cada imagem; a codificação da imagem também aumenta seu tamanho. Reduza o número ou as dimensões das imagens e tente novamente com uma solicitação pequena. Se ainda assim falhar, informe ao suporte o status da resposta, o horário da solicitação e o modelo, sem expor sua chave.