infinitemodel DOCS

Claude Desktop

O app desktop da Anthropic funciona com o infinitemodel: você aponta o gateway dele para o nosso endereço e usa a sua chave. Tudo pela interface, sem terminal.

A linha do instalador já configura o Desktop

A mesma linha que a introdução entrega para o terminal (Começando) procura o Claude Desktop na máquina e, se ele estiver instalado, grava a configuração do gateway com a sua chave. Depois, feche o app por completo e abra de novo (no Windows, saia também pelo ícone da bandeja; no macOS, use Cmd+Q): a configuração é lida na abertura. Não precisa ativar modo nenhum nem abrir menu nenhum. Se o Desktop ainda não estava instalado quando você colou a linha, instale e cole a mesma linha de novo. E se o app já estiver com uma conta da Anthropic, a linha não mexe nele (ele pode ser o seu chat pessoal): ela avisa e diz como forçar, com IM_DESKTOP=1 antes da linha no macOS e Linux, ou $env:IM_DESKTOP=1; no PowerShell.

O passo a passo abaixo é o caminho manual, para quem preferir fazer à mão ou quiser conferir o que a linha gravou. São seis passos e cerca de dois minutos. Se você prefere o terminal, o caminho é outro: Instalar o Claude Code.

Antes de começar, tenha a sua chave em mãos

Ela é a mesma do CLI. Não tem uma? Gere em Chaves no painel — a chave aparece uma única vez e fica presa ao IP que você informar (por quê).

Se preferir fazer à mão: passo a passo

  1. Baixe e instale o aplicativo

    Baixe direto da Anthropic, em claude.com/download — nós não distribuímos o instalador. A mesma página serve macOS, Windows e Linux (este último em beta, Ubuntu e Debian).

    Instale e abra o aplicativo. Todo o resto passa pelo menu ☰, no canto superior esquerdo.

    O menu ☰ fica no alto, à esquerda — acima da barra lateral. Ele não muda de lugar em nenhuma tela do app.

  2. Ative o modo Desenvolvedor

    O ajuste de gateway mora numa área que começa desligada. Para ligá-la, vá em ☰AjudaSolução de Problemas e clique em Ativar Modo Desenvolvedor.

    O item fica no meio da lista, logo abaixo de "Record Net Log". Ignore o resto — nada mais aqui é necessário.
    O aplicativo reinicia sozinho

    É esperado. Espere ele voltar antes de continuar — a opção do próximo passo só existe depois desse reinício.

  3. Abra a configuração do gateway

    Com o app de volta, apareceu um menu novo entre Visualizar e Ajuda: ☰DesenvolvedorConfigurar Inferência de Terceiros…

    O menu Desenvolvedor só existe depois do reinício do passo 2.

  4. Escolha Gateway e preencha os campos

    Abre uma janela de configurações, na aba Conexão. O primeiro seletor decide para onde o app manda as requisições — mude para Gateway. Só depois disso os campos abaixo passam a valer.

    CampoO que colocar
    Tipo de credencialChave de API estática
    URL base do gatewayhttps://api.infinitemodel.app
    Chave de API do gatewaya sua chave sk-…
    Esquema de autenticação do gatewaybearer

    Os demais campos ficam como estão — Origem do iframe e Cabeçalhos personalizados não são usados aqui.

    Libere a saída de rede. Na mesma janela, procure o campo Hosts de saída permitidos (no grupo Restrições gerais) e coloque *. Sem isso, o Cowork e as sessões do Code só alcançam o nosso endereço: git clone, pip install, npm install e a instalação de plugins falham com a mensagem de que o site está bloqueado. Se preferir uma lista fechada, ponha um host por entrada, por exemplo github.com, *.githubusercontent.com, pypi.org, files.pythonhosted.org e registry.npmjs.org. A linha do instalador já deixa esse campo em *.

    A URL não leva barra no fim. O botão "Testar conexão", no topo do bloco, confere tudo na hora.

  5. Clique em Aplicar alterações

    O botão fica no canto inferior direito da janela. Existe um Salvar alterações ao lado — o que coloca a configuração em uso é o Aplicar. Não é preciso reiniciar de novo.

  6. Confira

    Na mesma janela, Testar conexão valida a chave e o endereço, e Testar descoberta de modelos (na seção Modelos) mostra o que o seu plano roteia: Sonnet 5 e Opus 5 no Core; no Max e no Passe de 7 dias aparece também o Fable 5.1.

    Fechada a janela, o seletor de modelos do chat passa a listar os mesmos. O consumo do Desktop aparece em Uso no painel, junto com o do CLI.

Problemas comuns

SintomaO que verificar
Colei a linha do instalador e o Desktop continua no claude.aia configuração só é lida quando o app abre. Encerre por completo — no Windows, saia também pelo ícone da bandeja; no macOS, use Cmd+Q — e abra de novo. Se o app foi instalado depois de a linha rodar, cole a mesma linha de novo: ela só configura o que já existe na máquina.
O menu Desenvolvedor não apareceuo app precisa reiniciar depois de ativar o modo Desenvolvedor. Se ele não reiniciou sozinho, encerre por completo — no Windows, saia também pelo ícone da bandeja; no macOS, use Cmd+Q — e abra de novo.
Seletor de modelos vazio, ou "no usable models"o app não está alcançando o serviço com a sua chave. Confira nesta ordem: a URL base é exatamente https://api.infinitemodel.app (sem barra no fim); o esquema é bearer; a chave é a atual, não uma revogada; e o IP desta máquina é o autorizado na chave (Chaves e IP).
No Cowork ou no Code, git clone, pip install ou a instalação de um plugin falham com "O acesso a este site está bloqueado pelas configurações de saída de rede da sua organização"o campo Hosts de saída permitidos está vazio. No modo de gateway, o app só deixa as ferramentas alcançarem o endereço da inferência até você dizer quais sites elas podem acessar. Abra ☰DesenvolvedorConfigurar Inferência de Terceiros…, coloque * nesse campo, clique em Aplicar alterações e feche e abra o app. Colar a linha do instalador de novo faz o mesmo.
Aparecem os modelos, mas o Fable 5.1 nãoo Fable 5.1 é do plano Max e do Passe de 7 dias. O catálogo mostra só o que o seu plano roteia, de propósito — anunciar um modelo que não responderia quebraria o app um passo depois.
Erro 401 ou 403 ao conversarmesmas causas do CLI: chave, IP ou plano. Tabela completa em Erros e soluções.

Importante saber

  • A mesma chave serve para o CLI e o Desktop, desde que os dois rodem na máquina do IP autorizado.
  • Trocou de rede — de casa para o escritório, ou um Wi-Fi novo? O IP mudou. Atualize a whitelist da chave no painel; leva segundos.
  • O modo Desenvolvedor não muda mais nada no app: ele só expõe o menu de configuração do gateway.