Source: https://aiprimetech.io/pt/learn/use-claude-api-with-factory-droid/

[Início](/pt/) / [Aprenda](/pt/learn/) / Execute o Factory Droid com Claude 

# 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. 

Copiar

```
// ~/.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 

 Como executo o Factory Droid com Claude?

Adicione uma entrada customModels em ~/.factory/settings.json com provider anthropic, baseUrl https://aiprimetech.io,, seu ID de modelo e apiKey. Alterne com /model. Qual valor de provider usar para Claude?

anthropic para a interface nativa Messages. openai ou generic-chat-completion-api são voltados a endpoints no estilo OpenAI. apiKey pode ficar vazio?

Não — o Droid exige um valor. Use uma referência ${VAR}, como ${AIPRIME_API_KEY}; a expansão funciona em settings.json, mas não no arquivo legado config.json. Como alterno entre modelos?

Use o comando /model na CLI do Droid para alternar entre quaisquer entradas da sua lista customModels.  

Comece a usar o Claude em minutos

Obtenha uma chave de API — sem precisar de conta na Anthropic nem de lista de espera.[Obtenha sua chave de API](/register) 

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.    

## Mais guias da API do Claude

[Como obter uma chave de API do Claude](/pt/learn/how-to-get-a-claude-api-key/)[Preços da API Claude explicados](/pt/learn/claude-api-pricing-explained/)[A maneira mais barata de usar a API do Claude](/pt/learn/cheapest-way-to-use-claude-api/)[Cursor ilimitado com a API do Claude](/learn/use-claude-api-with-cursor/)[Acesso ilimitado ao Claude Code](/pt/learn/use-claude-api-with-claude-code/)[Gateway da API do Claude vs. acesso direto à Anthropic](/pt/learn/claude-api-vs-anthropic-direct/)[Como usar Claude por meio de uma API compatível com OpenAI](/pt/learn/openai-compatible-claude-api/)[Modelos Claude explicados: uma comparação entre Claude Opus, Sonnet, Haiku e Fable — todos os modelos da API Claude, nomes e preços dos modelos Anthropic (2026)](/pt/learn/claude-api-models-compared/)[Pagamento da API do Claude com criptomoedas](/pt/learn/claude-api-with-crypto-payment/)[Acesso à API do Claude sem lista de espera](/pt/learn/claude-api-without-waitlist/)[Como reduzir o uso de tokens do Claude](/pt/learn/how-to-reduce-claude-token-usage/)[Cline ilimitado com a API do Claude](/pt/learn/use-claude-api-with-cline/)[Roo Code ilimitado com a API do Claude](/pt/learn/use-claude-api-with-roo-code/)[Claude ilimitado nas IDEs da JetBrains](/pt/learn/use-claude-api-with-jetbrains/)[Aider ilimitado com a API do Claude](/pt/learn/use-claude-api-with-aider/)[Claude ilimitado no VS Code](/pt/learn/use-claude-api-with-vscode/)[Configuração do OpenCode para Claude: configuração do opencode.json, modelos e erros comuns](/pt/learn/use-claude-api-with-opencode/)[Como executar um agente Hermes ilimitado no Claude](/pt/learn/run-hermes-agent-with-claude-api/)[Executando OpenClaw ilimitado com Claude](/pt/learn/run-openclaw-with-claude-api/)[O que significa uma API compatível com a Anthropic](/pt/learn/anthropic-compatible-api/)[Chave de API do Claude Code — ANTHROPIC_API_KEY: como obtê-la, configurá-la e quando usar claude setup-token em seu lugar](/pt/learn/claude-code-api-key-setup/)[Custos da API do Claude Code — Preços e como reduzi-los](/pt/learn/claude-code-api-costs/)[Erros da API Claude explicados: erro de servidor 500, sobrecarga 529, limite de requisições 429, requisição inválida 400 — e a correção para cada um](/pt/learn/claude-api-errors-troubleshooting/)[Como comprar créditos da API do Claude — e por que um crédito do Claude é melhor do que qualquer oferta de "comprar conta do Claude"](/pt/learn/buy-claude-api-credits/)[API Claude gratuita: existe uma chave de API Claude gratuita e o que realmente é gratuito em 2026?](/pt/learn/claude-api-free-trial/)[API do Claude vs assinatura Claude Pro/Max — Qual escolher](/pt/learn/claude-api-vs-subscription/)[Como executar a CLI do Codex no Claude](/pt/learn/use-claude-api-with-codex/)[Conectando Claude ao n8n](/pt/learn/use-claude-api-with-n8n/)[Roteando LiteLLM para Claude](/pt/learn/use-claude-api-with-litellm/)[Usando Claude no Kilo Code](/pt/learn/use-claude-api-with-kilo-code/)[Integre Claude ao GitHub Copilot](/pt/learn/use-claude-api-with-github-copilot/)[Conecte o Zed ao Claude por meio do gateway](/pt/learn/use-claude-api-with-zed/)[Conecte o Cherry Studio ao Claude](/pt/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic no LangChain: importação, base_url, streaming, ferramentas e erros](/pt/learn/use-claude-api-with-langchain/)[SDK de Python da Anthropic: instale, defina base_url, use streaming e trate erros](/pt/learn/anthropic-python-sdk/)[Claude com o Vercel AI SDK: baseURL de createAnthropic, streaming e correções](/pt/learn/use-claude-api-with-vercel-ai-sdk/)[A API do Claude Code, explicada](/pt/learn/claude-code-api/)[Como integrar a API do Claude à sua aplicação](/pt/learn/claude-api-integration/)[Como obter uso ilimitado do Claude — e por que não existe "Claude Code crackeado"](/pt/learn/get-unlimited-claude-usage/)