Skip to main content
O Cowork acessa um endpoint de terceiros através do modo de gateway. O gateway deve implementar a API Anthropic Messages, que executamos em POST /v1/messages. O Cowork não oferece um local para definir start_within, então o prazo é definido na chave. Crie uma primeiro (consulte chaves de agente). Uma duração compete com o nível mais barato do Claude em chaves gerenciadas, sem streaming, dentro de uma janela de três a dez minutos. Uma sessão interativa faz streaming, então escolha um nível aqui em vez de Flex race. Consulte Durações do Claude precisam de uma janela mais longa. Sua organização precisa ser capaz de executar o Anthropic antes de começar. Em suas próprias chaves, isso significa uma chave de provedor Anthropic na aba Provider keys, porque não revendemos inferência. Em Managed Keys, significa que o Anthropic está ativado e financiado. O Cowork mantém essas configurações atrás de menus, então esta página não possui um prompt de configuração de agente. Use Exportar abaixo para aplicar a mesma configuração em uma frota.

​
Ativar modo de desenvolvedor

O menu Developer permanece oculto até que você o ative.
  1. Abra o Claude Desktop.
  2. Vá para Ajuda, depois Solução de problemas.
  3. Pressione Ativar Modo de Desenvolvedor.
O Developer aparecerá então na barra de menu.

​
Configurar Cowork

  1. Vá para Developer, depois Configurar Inferência de Terceiros….
  2. Defina Inference provider como Gateway.
  3. Defina Gateway base URL para o roteador, sem o sufixo /v1.
  4. Cole sua chave de agente em Gateway API key.
  5. Deixe Credential kind em Static API key.
  6. Deixe Gateway auth scheme em Bearer. Recusamos x-api-key.
  7. Escolha um modelo claude-* no seletor de modelos.
O Cowork lê nossa resposta GET /v1/models para preencher o seletor. Ele lista apenas os modelos que reconhece como Claude, que é o que você deseja aqui.

​
Implantar em uma frota

Clique em Exportar na mesma janela para um .mobileconfig no macOS ou um .reg no Windows, e então o distribua com seu MDM. Três chaves mantêm a integração. Defina inferenceModels para uma lista explícita apenas se o seletor não apresentar um modelo que você espera.

​
Mantenha os recursos beta desativados

O Cowork desativa os recursos beta experimentais do Claude Code por padrão, porque gateways estritos rejeitam os cabeçalhos anthropic-beta e os campos de solicitação que eles adicionam. Somos um desses gateways e não encaminhamos esses cabeçalhos. Deixe toolSearchEnabled indefinido pela mesma razão. Ativá-lo envia cabeçalhos beta que não encaminhamos, e as solicitações falham.

​
Confirmar a aplicação da chave

Toda resposta vem com x-flexinference-defaults-applied. O Cowork não mostra os cabeçalhos de resposta, então leia a solicitação no painel em Logs.

​
Solução de problemas

Não há menu Developer. O modo de desenvolvedor está desativado e oculta o menu completamente. Ative-o em Ajuda, depois Solução de problemas, depois Ativar Modo de Desenvolvedor. 401 missing_api_key. Gateway auth scheme está definido como x-api-key, que não lemos. Mude para Bearer. O seletor de modelos está vazio. O Cowork filtra GET /v1/models para IDs que ele reconhece como Claude. Confirme se sua organização pode executar modelos claude-*, ou defina inferenceModels você mesmo. 400 em cada solicitação após ativar a pesquisa de ferramentas. toolSearchEnabled faz com que o Cowork envie cabeçalhos e campos anthropic-beta experimentais que não encaminhamos. Deixe-o indefinido. 400 unsupported_parameter nomeando output_config. O seletor escolheu um modelo que não é Claude, e o Cowork envia campos nativos do Anthropic que nos recusamos a traduzir incorretamente. Escolha um modelo claude-*. Consulte erros para cada recusa que retornamos, chaves de agente para aquelas que não são específicas do Cowork, e Claude Code para o cliente de terminal.