Execute o Factory Droid com o Claude

O Droid da Factory é uma CLI agêntica da mesma categoria do Claude Code e permite usar seus próprios modelos por meio de um arquivo de configuração. Apontá-lo para o gateway da AI Prime Tech faz com que os ciclos do agente Droid sejam executados com Claude, junto com quaisquer outros modelos disponibilizados pelo gateway.

Edite o arquivo de configurações

O Droid lê ~/.factory/settings.json. Adicione um array customModels, em que cada entrada descreve um modelo que você deseja disponibilizar. Esse é o caminho atual de configuração; o antigo config.json é legado e não oferece suporte a tudo o que settings.json oferece.

Um único arquivo abrange toda a configuração do Droid, portanto uma única lista customModels define todos os modelos entre os quais a CLI pode alternar. Mantenha-a no nível do usuário, em vez de por projeto.

Saber que settings.json é o arquivo atual evita muita confusão, pois anotações e discussões antigas ainda fazem referência a config.json, e alguns recursos se comportam de maneira diferente nos dois arquivos. Quando algo funciona em um deles e não no outro, settings.json quase sempre é o arquivo em que se deve confiar. Quando as orientações entram em conflito, dar preferência a settings.json em vez de config.json resolve a maior parte das divergências. O arquivo mais recente é o que a Factory mantém ativamente, e é nele que a sintaxe de variáveis realmente funciona.

Descreva o modelo

Cada entrada customModels recebe um ID de modelo, um baseUrl, um apiKey, um provider e maxOutputTokens. Defina model como o ID do gateway, por exemplo claude-sonnet-4-5, e baseUrl como o host do gateway.

Juntos, esses campos informam ao Droid exatamente como acessar o modelo. Como o Droid não pressupõe um único provedor, você especifica cada componente, o que lhe dá flexibilidade suficiente para usar um gateway.

Essa definição explícita permite que uma instalação do Droid dê acesso a vários modelos Claude no mesmo gateway, cada um com sua própria entrada customModels, compartilhando baseUrl e a chave. A CLI os trata como modelos distintos que podem ser selecionados, embora todos apontem para o mesmo endpoint no serviço upstream. É justamente essa definição explícita dos campos que permite a uma instalação dar acesso a vários modelos Claude por meio de um único endpoint. Cada entrada compartilha baseUrl e a chave, mas mantém seu próprio ID de modelo, de modo que o gateway faz o roteamento e o Droid apenas escolhe um nome.

Escolha o modo do provedor

O campo provider define o formato de comunicação. Use anthropic para a interface nativa Messages do gateway, openai para o estilo Responses ou generic-chat-completion-api para um endpoint de chat /v1 no estilo OpenAI. Para Claude no gateway, anthropic é a escolha natural.

Alinhar provider à interface efetivamente oferecida pelo gateway evita erros na primeira execução. Com provider anthropic, o Droid usa o formato nativo que o gateway disponibiliza para Claude.

Os três modos de provedor também correspondem claramente às interfaces que um gateway multimodelo pode expor. Assim, se o mesmo gateway disponibilizar um modelo no estilo OpenAI, você o adicionará como uma entrada separada com generic-chat-completion-api. Manter o provider de cada entrada alinhado à sua interface é a regra que evita erros em uma configuração mista. Alinhar provider à interface em todas as entradas é a regra que mantém uma configuração de gateway misto organizada. Uma entrada nativa do Claude e outra no estilo OpenAI podem coexistir sem problemas.

Configure a chave de API

Coloque a chave em apiKey, de preferência como uma referência ${VAR}, por exemplo ${AIPRIME_API_KEY}, para que o segredo permaneça no ambiente em vez de no arquivo. Observe que a expansão de ${VAR} funciona em settings.json, mas não no arquivo legado config.json.

O campo apiKey também não pode estar vazio, mesmo para um gateway que tecnicamente aceitaria uma solicitação anônima. O Droid verifica se o campo tem um valor, portanto sempre forneça a chave ou a variável que a contém.

Esses dois fatos explicam um erro comum: as pessoas colocam ${VAR} no antigo config.json, onde ela não é expandida, e o Droid vê uma string literal não resolvida. Use settings.json para a forma com variável e certifique-se de que a variável esteja realmente exportada no shell que inicia o Droid. Confirmar que a variável está exportada no shell de inicialização é o último detalhe que as pessoas costumam esquecer. O Droid só vê as variáveis presentes no ambiente em que foi iniciado.

Alterne e execute

Na CLI do Droid, alterne entre os modelos configurados com o comando /model. Adicione uma segunda entrada para claude-opus-4-8 e você poderá mudar para ela em tarefas mais difíceis sem alterar a configuração novamente.

A partir daí, o Droid executa seu ciclo de agente usando Claude no gateway. Como a configuração fica em settings.json, ela é aplicada sempre que você inicia a CLI.

Ter uma entrada Sonnet e uma Opus prontas permite escolher o modelo conforme a tarefa durante a sessão — Sonnet para implementação consistente, Opus quando um problema exige raciocínio mais complexo — tudo pelo gateway, sem reconfiguração. O comando /model permite fazer essa troca com uma única linha no meio da sessão. Uma troca de uma linha com /model durante a sessão torna simples escolher o modelo adequado à tarefa. Você passa de Sonnet para Opus sem sair da sessão.

// ~/.factory/settings.json
{
  "customModels": [
    {
      "model": "claude-sonnet-4-5",
      "baseUrl": "https://aiprimetech.io",
      "apiKey": "${AIPRIME_API_KEY}",
      "provider": "anthropic",
      "maxOutputTokens": 8192
    }
  ]
}
// export AIPRIME_API_KEY=<key>   (apiKey must NOT be empty)
// Switch models in the CLI with /model

Perguntas frequentes

AI Prime Tech é um gateway de API independente. Não tem afiliação com a Anthropic, não é endossado por ela e não é seu revendedor. Claude e os nomes dos modelos relacionados são marcas comerciais de seus respectivos proprietários.