---
title: Teste e análise de apps
url: https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/app-review
description: Como um novo app de Linked billing sai do teste e se abre para seus clientes, e o que acontece quando você altera um app ativo.
---

<Warning>
  O Claude Platform OAuth é um Beta Service: software de pré-lançamento fornecido nos termos do seu contrato com a Anthropic, como os [Termos de Serviço Comerciais](https://www.anthropic.com/legal/commercial-terms), e os [Termos Específicos de Serviço](https://www.anthropic.com/legal/service-specific-terms). Endpoints, parâmetros e comportamento podem mudar durante o beta. Ele pode não ser adequado para uso em produção.
</Warning>

Com o [Linked billing](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/organization-billing-connections), um cliente vincula sua organização Claude ao seu app OAuth. Um novo app de Linked billing começa em teste, onde apenas os “test users” (usuários de teste) que você indica podem vincular suas organizações a ele. Para abrir o app aos seus clientes, você o publica, e a Anthropic o analisa.

Se sua organização tem cobrança por fatura, a Anthropic não analisa seu app. Consulte [Cobrança por fatura](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/app-review#invoiced-billing).

Um app está ativo quando a Anthropic o aprovou ou quando você o publicou com cobrança por fatura. Qualquer [cliente elegível](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/organization-billing-connections#eligible-customers-and-endpoints) pode vincular sua organização a um app ativo, e os vínculos que seus usuários de teste fizeram permanecem. Na página de apps OAuth no Claude Console, o status de um app ativo aparece como **Active**.

Até que o app esteja ativo, o Console mostra um destes status para ele:

| Status           | O que significa                                                                            |
| ---------------- | ------------------------------------------------------------------------------------------ |
| **Testing**      | Você não publicou o app.                                                                   |
| **In review**    | A Anthropic está analisando o app ou uma alteração que você fez enquanto ele estava ativo. |
| **Not approved** | A Anthropic analisou o app ou a alteração e não a aprovou.                                 |

Um app que volta para análise após uma alteração não fica ativo novamente até que a Anthropic aprove a alteração. Cada app de Linked billing tem seu próprio status e seus próprios usuários de teste. Consulte a nota em [Etapa 1: Criar o app](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/organization-billing-connections#step-1-create-the-app) no guia de Linked billing.

## Antes de começar

Conclua o [Processo de configuração](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/organization-billing-connections#setup-process) no guia de Linked billing.

## Gerenciar usuários de teste

### Adicionar usuários de teste

1. Abra a página do app a partir da [página de apps OAuth](https://platform.claude.com/settings/oauth-apps) no Console.
2. Na aba **Settings**, vá até a lista **Test users** em **Who can link**.
3. Insira o endereço de e-mail da conta Claude de um usuário de teste e clique em **Add**. Repita para cada usuário de teste.
4. Clique em **Save changes**.

Depois que você salva, as pessoas na lista podem vincular suas organizações ao seu app. Até que seu app esteja ativo, a página de aprovação do Claude, onde uma pessoa aprova o vínculo, recusa qualquer outra pessoa. Para saber o que seu app recebe então, consulte [Seu URI de redirecionamento recebe `error=access_denied`](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/organization-billing-connections#access-denied) no guia de Linked billing.

**Who can link** permanece em **Test users only** enquanto o app não está ativo, e você não pode alterar isso. A lista comporta até 10 usuários de teste. Cada endereço precisa corresponder exatamente ao endereço da conta, mas maiúsculas e minúsculas não importam. Um endereço com uma tag de sinal de mais, como `name+test@example.com`, conta como um endereço diferente de `name@example.com`.

### Vincular a organização de um usuário de teste

Um usuário de teste vincula sua organização a partir do seu app e aprova o vínculo na página que seus clientes usam. Ele precisa ter a função Admin ou Faturamento nessa organização. As etapas são as Etapas 4 a 8 do guia de Linked billing. [Testar como cliente](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/organization-billing-connections#test-as-a-customer) nesse guia conduz você por elas e diz como verificar se o vínculo foi feito.

Para testar o app você mesmo, adicione seu próprio endereço de e-mail à lista. A organização proprietária do app não pode se vincular a ele, então use uma segunda organização Claude sua.

Depois que um usuário de teste tiver vinculado sua organização, [envie solicitações que você fatura para ela](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/organization-billing-connections#step-3-update-calls-to-claude) para experimentar seu app. O teste usa dinheiro real. A Anthropic cobra da organização de cada usuário de teste pelas solicitações que você fatura para ela, como faz com qualquer cliente.

Até que seu app esteja ativo, cada novo vínculo precisa de um “spend cap” (teto de gastos) mensal de $50 USD ou menos. Para as regras do teto, consulte [Enquanto seu app está em teste](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/organization-billing-connections#while-your-app-is-in-testing) no guia.

### Remover um usuário de teste

A remoção de um usuário de teste entra em vigor imediatamente. Ela encerra cada vínculo com seu app que a pessoa aprovou. Depois que um vínculo termina, a Claude API recusa as solicitações que você fatura para essa organização. Consulte [Erros esperados](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/organization-billing-connections#expected-errors).

1. Se a aba **Settings** tiver alterações não salvas, clique em **Save changes** ou **Discard**. Até que você faça isso, o Console não permite que você remova um usuário de teste salvo.
2. Remova o endereço do usuário de teste da lista **Test users**.
3. Quando o Console pedir, clique em **Remove** para confirmar. Você não precisa clicar em **Save changes**.

## Publicar o app

A publicação pode pedir que você comprove que controla o domínio do seu app, adicionando um registro DNS. A Anthropic então analisa o app. Uma alteração de DNS leva tempo, então comece antes de precisar que os clientes vinculem.

Antes de publicar, verifique estes itens:

* A autenticação do cliente está configurada. Você não pode publicar o app até que ela esteja.
* Seu app tem uma página inicial, que você define na aba **Appearance**.
* Você pode alterar os registros DNS do domínio da página inicial.
* Cada URI de redirecionamento está no domínio da página inicial ou em um de seus subdomínios.

Para saber o que conta como o domínio da página inicial e quais são as exceções, consulte [Regras de domínio](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/app-review#domain-rules).

Siga estas etapas para publicar o app:

1. Na página do app no Console, clique em **Publish app**. Uma caixa de diálogo se abre.
2. Se a caixa de diálogo mostrar **Prove your domain**, adicione o registro DNS TXT que ela fornece no local onde você gerencia o DNS do seu domínio. Caso contrário, vá para a etapa 5.
3. Clique em **Check**. Se o domínio ainda mostrar **Not proven yet**, consulte [Se você não conseguir comprovar o domínio](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/app-review#if-you-cant-prove-the-domain).
4. Quando o domínio mostrar **Proven**, clique em **Continue**.
5. Se a caixa de diálogo mostrar uma caixa de seleção para aceitar os Termos do Linked Billing, marque-a. Em seguida, clique em **Publish app** na caixa de diálogo para confirmar.

Enquanto a Anthropic analisa o app, seu status é **In review**. Para os resultados, consulte [A análise](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/app-review#the-review).

### Se você não conseguir comprovar o domínio

* **O domínio ainda mostra Not proven yet:** Uma alteração de DNS pode levar até 48 horas para entrar em vigor. Você pode fechar a caixa de diálogo e voltar mais tarde. Se você estava publicando, clique em **Publish app** novamente. Se você estava alterando um app ativo, faça a mesma edição novamente, e o Console fornece o mesmo registro até que ele expire.
* **Check informa que o registro expirou:** O registro DNS funciona por 30 dias a partir de quando o Console o mostra pela primeira vez. Depois disso, clique em **Get a new record** e adicione o novo registro. Um domínio que mostra **Proven** permanece comprovado.
* **A caixa de diálogo mostra uma mensagem em vez de um registro:** Por exemplo, a mensagem pode dizer que sua organização já tem 20 nomes de domínio. Você não pode continuar até que isso seja resolvido. Se precisar de ajuda, [entre em contato com o suporte](https://support.claude.com/en/articles/9015913-how-to-get-support).

### Regras de domínio

Um domínio é um hostname sem um `www.` no início, e seu domínio é o da sua página inicial. Por exemplo, o domínio de uma página inicial em `https://www.example.com` é `example.com`. Um domínio comprovado cobre a si mesmo e seus subdomínios.

* **Domínios compartilhados:** Um domínio compartilhado de um serviço de hospedagem não se qualifica, então use um domínio próprio.
* **URIs de redirecionamento locais:** URIs de redirecionamento em `localhost`, `127.0.0.1` ou `[::1]` não precisam estar no domínio da página inicial.
* **Subdomínios irmãos:** Se sua página inicial está em `app.example.com`, seu domínio é esse subdomínio, e ele não cobre um URI de redirecionamento em `auth.example.com`. Uma forma de usar ambos é colocar sua página inicial em `example.com`, que cobre os dois.
* **Um domínio que sua organização já comprovou:** Sua organização pode ter comprovado um domínio anteriormente, por exemplo para outro app. Se ele cobrir sua página inicial e cada URI de redirecionamento que não é local, a caixa de diálogo pula **Prove your domain**. Os URIs de redirecionamento então não precisam estar no domínio da página inicial. Por exemplo, com `example.com` comprovado, a página inicial e um URI de redirecionamento podem estar em subdomínios diferentes dele.

## A análise

Quando a análise termina, a página do app no Console mostra o resultado:

* **A Anthropic aprova o app:** O app fica ativo. **Who can link** passa então a mostrar **Any Claude user** sem nenhuma ação sua, e o Console oculta a lista **Test users**.
* **A Anthropic não aprova o app:** O status do app muda para **Not approved**.

Durante a análise e após um resultado **Not approved**, seus usuários de teste mantêm seus vínculos, e você ainda pode adicionar e remover usuários de teste.

### Se o app não for aprovado

Você não pode publicar o app novamente por conta própria. Para perguntar sobre a decisão, [entre em contato com o suporte](https://support.claude.com/en/articles/9015913-how-to-get-support). Você ainda pode [alterar o app](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/app-review#change-an-app-that-isnt-live), mas uma alteração não inicia uma nova análise.

## Alterar um app ativo

Uma alteração no nome, no logotipo, na página inicial ou nos URIs de redirecionamento de um app ativo envia o app de volta para análise. Até que a Anthropic aprove a alteração, apenas seus usuários de teste podem vincular suas organizações ao app. Consulte [Até que a Anthropic aprove a alteração](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/app-review#until-anthropic-approves-the-change). Outras alterações, como permissões ou autenticação do cliente, não enviam o app de volta para análise.

Siga estas etapas para alterar o nome, a página inicial ou os URIs de redirecionamento:

1. Altere o app na aba **Appearance** (nome e página inicial) ou na aba **Settings** (URIs de redirecionamento).

2. Clique em **Save changes**. Uma caixa de diálogo se abre antes que algo seja salvo.

3. Se a caixa de diálogo mostrar **Prove your domain**, comprove cada domínio que ela indicar:

   1. Adicione o registro DNS TXT do domínio. Em seguida, clique em **Check**. Se o domínio ainda mostrar **Not proven yet**, consulte [Se você não conseguir comprovar o domínio](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/app-review#if-you-cant-prove-the-domain).
   2. Quando o domínio mostrar **Proven**, clique em **Next domain** se restar outro domínio. Caso contrário, clique em **Continue**.

4. Clique em **Save and send to review**.

O Console então salva a alteração, e a alteração entra em vigor sem esperar pela análise. Enquanto a Anthropic analisa a alteração, o status do app é **In review**.

Para alterar o logotipo, escolha-o ou remova-o na aba **Appearance**. A caixa de diálogo se abre imediatamente. Clique em **Send to review**. Se você cancelar, o logotipo não muda.

Para alterar o app novamente enquanto seu status é **In review** ou **Not approved**, consulte [Alterar um app que não está ativo](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/app-review#change-an-app-that-isnt-live).

### Quando o Console pede que você comprove um domínio

O Console pergunta apenas se você alterou a página inicial ou um URI de redirecionamento. Ele também verifica a página inicial e os URIs de redirecionamento que você não alterou, então a caixa de diálogo também pode indicar os domínios deles. Ela indica apenas domínios que nenhum domínio comprovado da sua organização cobre. Ele não verifica URIs de redirecionamento locais, mas uma alteração em um deles ainda envia o app de volta para análise.

Após uma alteração, os URIs de redirecionamento podem estar em domínios diferentes do da página inicial, se sua organização comprovar cada um.

### Até que a Anthropic aprove a alteração

Estas regras se aplicam a partir de quando você envia a alteração para análise:

* **Clientes que já vincularam:** As organizações deles permanecem vinculadas, e as solicitações que você fatura para eles continuam funcionando. Um cliente que desvincula não pode vincular novamente, a menos que a pessoa que vincula esteja na lista **Test users**.
* **Novos vínculos:** A configuração **Who can link** volta para **Test users only**. O Console mostra a lista **Test users** novamente, com as pessoas que estavam nela antes.
* **Usuários de teste:** Você pode adicionar e remover pessoas da lista. Remover uma pessoa também encerra um vínculo que ela fez com a organização de um cliente enquanto o app estava ativo. Consulte [Remover um usuário de teste](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/app-review#remove-a-test-user).
* **Tetos de gastos de organizações vinculadas:** Uma organização vinculada mantém sua configuração atual de [teto de gastos](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/organization-billing-connections#spend-caps), mesmo que seu teto esteja acima de $50 USD ou que ela não tenha teto. Uma configuração que ela altere precisa seguir as regras em [Enquanto seu app está em teste](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/organization-billing-connections#while-your-app-is-in-testing).

### Quando a análise da alteração termina

A análise termina de uma de duas formas:

* **A Anthropic aprova a alteração:** O app fica ativo novamente. Qualquer cliente elegível pode vincular, o Console oculta a lista **Test users**, e as regras de teto para um app que não está ativo deixam de se aplicar.
* **A Anthropic não aprova a alteração:** O status do app muda para **Not approved**. A alteração permanece em vigor, e as regras em [Até que a Anthropic aprove a alteração](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/app-review#until-anthropic-approves-the-change) continuam se aplicando. Consulte [Se o app não for aprovado](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/app-review#if-the-app-isnt-approved).

## Alterar um app que não está ativo

Siga estas etapas enquanto o status do app é **Testing**, **In review** ou **Not approved**:

1. Altere o app na aba **Appearance** (nome, logotipo e página inicial) ou na aba **Settings** (URIs de redirecionamento).
2. Clique em **Save changes**. Uma alteração de logotipo é salva quando você escolhe ou remove o logotipo.

Nenhuma caixa de diálogo pede que você confirme, e a alteração não modifica o status do app.

Quando você salva uma alteração na página inicial ou em um URI de redirecionamento, o Console verifica domínios apenas enquanto o status é **In review**. Um app em teste passa pela verificação de domínio quando você publica. Durante uma análise, a página inicial do app alterado e cada URI de redirecionamento que não é local precisam estar em domínios comprovados da sua organização. Caso contrário, o Console recusa a alteração e não pede que você comprove um domínio. Para mudar para um domínio que não está comprovado, espere até que a análise termine.

## Cobrança por fatura

Com a cobrança por fatura, a Anthropic emite faturas para a organização proprietária do seu app pelo uso da API, e essa organização não compra créditos pré-pagos. Seu app ainda começa em teste, e as regras para usuários de teste e o teto de gastos ainda se aplicam. Depois disso, três coisas são diferentes:

* **[Publicar o app](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/app-review#publish-the-app):** Na página do app, clique em **Publish app**. Em seguida, clique em **Publish app** na caixa de diálogo para confirmar. A Anthropic não analisa o app, então ele fica ativo assim que você o publica.
* **Página inicial e domínio:** Você não comprova nenhum domínio, então a caixa de diálogo pula **Prove your domain**. Seu app não precisa de página inicial para ser publicado, e a regra para URIs de redirecionamento em [Publicar o app](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/app-review#publish-the-app) não se aplica. A autenticação do cliente ainda precisa ser configurada primeiro.
* **[Alterar um app ativo](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/app-review#change-a-live-app):** O Console salva uma alteração quando você clica em **Save changes** ou quando escolhe ou remove um logotipo. Ele não pede que você comprove um domínio nem que confirme, e nenhuma análise se segue.
