Ir para conteúdo principal

Perguntas Frequentes sobre Claude Code

Este artigo é uma compilação de perguntas frequentemente feitas sobre Claude Code relacionadas a autenticação, integrações, configuração e muito mais. Se você estiver interessado em aprender mais sobre Claude Code, consulte nossa documentação do Claude aqui: Visão geral do Claude Code.

Como configuro o logon único (SSO) para Claude Code?

Temos instruções detalhadas para configurar o logon único em uma organização de Equipe, Empresa ou Console aqui: Configurar logon único (SSO).

Existe uma maneira de desabilitar o acesso ao modelo Opus em toda a nossa organização no Claude Code?

Se você é um usuário do Claude Console, isso pode ser configurado através de limitação de taxa na sua organização Console. Se você estiver usando Bedrock ou Vertex, defina o limite de taxa do Opus como 0 nas configurações do seu projeto Vertex/Bedrock. Observe que mesmo se desabilitado no Vertex, os usuários podem conseguir alternar modelos no Claude Code, portanto a limitação de taxa é a abordagem mais eficaz.

O que são fluxos de trabalho dinâmicos do Claude Code e como controlamos o acesso?

Os fluxos de trabalho dinâmicos (disponíveis para planos Claude Enterprise) permitem que o Claude execute grandes tarefas de engenharia—migrações, auditorias, buscas de bugs em toda a base de código—do início ao fim em uma única sessão do Claude Code. Eles ficam disponíveis e são ativados por padrão para toda a sua organização Enterprise em 8 de junho de 2026. Como uma única execução pode durar horas e usar mais tokens do que uma sessão típica, os administradores devem decidir quem tem acesso antes dessa data.

Você tem três maneiras de controlar o acesso:

  1. No nível de função (planos Enterprise com funções personalizadas): Conceda ou restrinja a capacidade de fluxos de trabalho dinâmicos do Claude Code por grupo. Isso afeta apenas membros cuja função está definida como "Personalizada". Consulte Gerenciar funções personalizadas em planos Enterprise.

  2. Desabilitar em toda a organização via managed-settings.json: Adicione "disableWorkflows": true às suas configurações gerenciadas. Isso vale antes e depois de 8 de junho.

  3. Em toda a organização: Após 8 de junho, um proprietário pode desabilitar fluxos de trabalho dinâmicos para todos indo para Configurações da organização > Claude Code e desativando Fluxos de trabalho.

Aplicamos a mais restritiva de suas configurações gerenciadas e permissões de função personalizada por usuário. Se qualquer uma desabilitar fluxos de trabalho para um determinado usuário, esse usuário não terá acesso.

Claude Code suporta integração do Microsoft Visual Studio IDE (não VS Code)?

Nenhuma integração atual do Visual Studio 2022 existe. Claude Code atualmente suporta VS Code, Cursor (e outros forks do VS Code), Intellij, Pycharm (e outros IDEs Jetbrains).

Como podemos implementar automação de revisão de PR com Claude Code?

Embora não haja ainda uma solução de revisor de PR pronta para usar, você pode usar a integração do Claude Code com GitHub Actions para revisões automatizadas. Por enquanto, você pode usar a ação de revisão de segurança como um modelo e personalizá-la para revisões gerais de PR. Este também é um bom caso de uso para o SDK do Claude Code.

Estou recebendo uma mensagem de erro que "Claude Max ou Pro é necessário para conectar ao Claude Code", mas deveria ter acesso através do plano Team ou Enterprise da minha organização. Como posso solucionar?

Isso indica que você selecionou o método de login errado na tela de configuração do Claude Code. Tente executar /login novamente e selecione a conta associada ao seu endereço de email de trabalho principal. Se você ainda não conseguir se conectar, consulte Tendo problemas ao usar sua conta Team ou Enterprise para acessar Claude Code?

Quais dados são enviados para a Anthropic ao usar Claude Code com chaves de API Bedrock/Vertex?

Quando configurado com Bedrock/Vertex e CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC está definido, apenas telemetria essencial é enviada. Todas as solicitações de API do modelo vão diretamente para seus endpoints Bedrock/Vertex. Consulte a documentação de fluxo de dados para detalhes completos.

Existe uma maneira de acessar Claude Code via Bedrock/Vertex sem expor uma chave secreta/chave de acesso?

Sim. Nossos guias de configuração para Bedrock e Vertex mostram como você pode habilitar isso. Por exemplo, no caso do Bedrock, você pode executar `aws configure` para configurar a CLI do AWS antes de adicionar as configurações necessárias e executar Claude Code com o Bedrock, ou você pode usar chaves de API do Bedrock, que é um novo recurso da AWS que permite chaves de API para uso do Bedrock que não requerem credenciais completas da AWS.

Como podemos implantar Claude Code com variáveis de ambiente personalizadas e permissões em toda a nossa organização?

Crie scripts de wrapper que definem variáveis de ambiente antes de executar Claude Code. Para permissões, use arquivos .claude/settings.json com listas de permissão/bloqueio. Observe que padrões com caracteres curinga (*) nem sempre correspondem conforme esperado - teste as permissões completamente. Equipes Enterprise frequentemente injetam arquivos Claude.md padronizados para configurações consistentes.

Claude Code tem filtragem de código público ou recursos de atribuição no roteiro?

Não, filtragem de código público e recursos de atribuição não estão atualmente no roteiro. Alguns clientes usam BlackDuck para varredura de código, embora o feedback sobre custo e falsos positivos tenha sido misto. Estamos cientes de que isso é um bloqueador para dimensionar Claude Code para mais usuários e estamos investigando soluções.

Os subagentos estão disponíveis no SDK do Claude Code e GitHub Actions?

Os subagentos estão disponíveis via SDK do Claude Code. Eles ainda não estão integrados ao GitHub Actions, mas estamos considerando isso. A UX recolhe saídas quando mais de três subagentos são executados em paralelo para gerenciar a complexidade.

Os subagentos podem ser configurados para usar ferramentas MCP específicas?

Sim, ao criar um subagentos, você pode especificar quais ferramentas ele tem acesso usando o campo `tools` na configuração. No arquivo de configuração do subagentos, você pode omitir o campo tools para herdar todas as ferramentas da thread principal, ou pode especificar ferramentas individuais como uma lista separada por vírgulas para um controle mais granular. Saiba mais sobre isso em nossa documentação do Claude: Subagentos - Ferramentas disponíveis.

Como podemos gerenciar os custos do Claude Code, especialmente para fluxos de trabalho automatizados?

Para fluxos de trabalho automatizados como revisões de segurança, mude de Opus para Sonnet usando a opção de configuração claude --model <alias|name> para economizar custos. Você também pode monitorar o uso através do painel do seu console e definir limites de taxa apropriados. Observe que você pode usar Workspaces para definir limites de gastos mais granulares para diferentes grupos de usuários. Leia mais sobre Workspaces aqui: Criando e gerenciando Workspaces no Claude Console. Também permitimos que você visualize gastos por chave de API no Console. Consulte este artigo para mais informações: Relatório de Custo e Uso no Claude Console.

Claude Code pode funcionar através de proxies corporativos como LiteLLM?

Sim, Claude Code suporta configurações de proxy corporativo desde que suportem a especificação da API Anthropic. Siga as instruções de configuração de proxy em nossa documentação do Claude: Configuração de proxy. Problemas comuns surgem de restrições de porta em ambientes restritos.

Como adicionamos usuários ao Claude Code ao usar uma conta Console?

Adicione usuários diretamente à sua organização Console com uma função de Usuário do Claude Code ou Desenvolvedor - é tudo o que é necessário. Os usuários então executam /login dentro do Claude Code e selecionam a conta Console pretendida. Não tente criar manualmente chaves de API no workspace do Claude Code.

Existe memória baseada em equipe ou compartilhamento de conhecimento além de arquivos Claude.md?

Atualmente, arquivos Claude.md são o mecanismo principal. Equipes de TI podem injetar arquivos Claude.md padronizados no diretório .claude de cada máquina para configurações em toda a organização. Recursos de memória de equipe mais avançados estão sendo explorados, mas ainda não estão disponíveis.

Como as permissões funcionam no Claude Code e por que minhas listas de permissão não estão sendo respeitadas?

As permissões usam correspondência de padrão em .claude/settings.json ou settings.local.json. A sintaxe de caracteres curinga pode ser complicada - "Bash(atlassian-api:*)" deve funcionar, mas pode precisar de correspondência exata de comando. Use "Sim, e não pergunte novamente para comandos semelhantes" para construir permissões incrementalmente. Verifique os arquivos de configurações globais (~/.claude/settings.json) e locais.

Claude Code indexa toda a minha base de código ou usa um banco de dados vetorial para armazenar informações sobre minha base de código?

Não. Claude Code tem acesso a um prompt do sistema e a uma série de ferramentas que pode usar para navegar pela sua base de código sob demanda. Por exemplo, se Claude Code precisar entender algo sobre sua base de código, ele usará uma ferramenta de busca para pesquisar sua base de código e ler arquivos sob demanda. Descobrimos que isso é mais eficaz e flexível do que indexação completa de base de código: Claude Code é realmente bom em saber como peneirar uma base de código para reunir o contexto de que precisa na hora!

Claude Code pode se integrar com plataformas de CI/CD, controle de versão e observabilidade?

Sim, Claude Code se integra com GitHub Actions para CI/CD, suporta operações git e pode se conectar a várias plataformas via servidores MCP. Consulte nossa documentação do Claude para mais informações:

Por que estou vendo erros "Validação de fluxo de trabalho falhou" no GitHub Actions?

Isso normalmente ocorre com fluxos de trabalho reutilizáveis. Verifique se a sintaxe do seu fluxo de trabalho está correta e se todos os parâmetros necessários são passados. Se o erro persistir, abra um problema aqui com sua configuração de fluxo de trabalho: github.com/anthropics/claude-code-action.

Isto respondeu à sua pergunta?