> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Guia de Configuração do Gateway de Inferência de Terceiros do Claude Desktop

> Claude AI API guide - Ace Data Cloud

Este guia configura o **Third-Party Inference Gateway** do Claude Desktop, não o Claude Code, nem o MCP Connector do Claude Desktop.

## 1. Obter a API Key

Abra a [lista de aplicativos do Ace Data Cloud](https://platform.acedata.cloud/console/applications), entre em um aplicativo disponível e copie a API Key.

![Obter a API Key do Ace Data Cloud](https://cdn.acedata.cloud/dvc3cg.jpg)

## 2. Abrir a configuração de inferência de terceiros

Na página de login do Claude Desktop, abra sucessivamente **Help → Troubleshooting → Enable Developer Mode** e, em seguida, selecione **Developer → Configure Third-Party Inference…**.

![Abrir o Third-Party Inference no Claude Desktop](https://cdn.acedata.cloud/713ffd7104a3.png)

> A imagem vem do repositório Bifrost Apache-2.0 e é usada apenas para localizar o menu do Claude Desktop; a interface de diferentes versões pode variar ligeiramente.

## 3. Configurar o Gateway

Selecione **Gateway** e, em seguida, preencha:

| Campo | Valor |
| - | - |
| Gateway base URL | `https://api.acedata.cloud` |
| Gateway API key | A API Key copiada agora |
| Gateway auth scheme | `bearer` |
| Credential kind | `Static API key` |

![Interface de configuração do Gateway do Claude Desktop](https://cdn.acedata.cloud/68d41fe682cb.png)

Clique em **Apply Changes** e, em seguida, clique em **Save & Restart**.

## 4. Verificar

Após reiniciar, selecione um modelo disponível, crie uma nova conversa e envie `Reply only OK`, depois execute uma tarefa simples de ferramenta. Os registros de chamadas podem ser visualizados em [Histórico de uso](https://platform.acedata.cloud/console/usages).

O Ace Data Cloud Gateway oferece suporte a `/v1/models` usado pelo Claude Desktop, `/v1/messages` em streaming com autenticação Bearer, chamadas de ferramentas e continuação de `tool_result`. Os campos de cache de prompts serão preservados; quando os valores de gravação e leitura do cache forem ambos 0, isso não significa que ocorreu um acerto de cache.

401 geralmente indica que a Key está incorreta; quando um modelo não for encontrado, verifique novamente a configuração e reinicie completamente o Claude Desktop. Ao relatar problemas, forneça o trace ID nos registros de chamadas, não forneça a API Key.

## Referências oficiais

* [Instalação e configuração em máquina única da inferência de terceiros do Claude Desktop](https://claude.com/docs/third-party/claude-desktop/installation)
* [Referência de configuração da inferência de terceiros do Claude Desktop](https://claude.com/docs/third-party/claude-desktop/configuration)

Retornar ao [Guia de integração do Claude App](https://platform.acedata.cloud/documents/mcp-tutorials-claude-desktop).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.