Source: https://aiprimetech.io/pt/blog/claude-code-max-output-tokens/

Set 10, 2026 · 8 min · Guias para desenvolvedores 

# Entenda CLAUDE_CODE_MAX_OUTPUT_TOKENS: limites de saída e pastas de plugins no Claude Code 2.1.265 

 A  Por [AI Prime Tech](https://aiprimetech.io/pt/)  · Com auxílio de IA    

claude_code_max_output_tokens é a expressão de pesquisa para CLAUDE_CODE_MAX_OUTPUT_TOKENS, a variável de ambiente do Claude Code que define o número máximo de tokens de saída para a maioria das solicitações. Este guia explica os limites verificados até setembro de 10, 2026, como os exemplos de configuração devem ser interpretados e o que o Claude Code 2.1.265 muda nas pastas de plugins e nos resultados de ferramentas salvos. 

## O que claude_code_max_output_tokens controla 

A referência de variáveis de ambiente descreve CLAUDE_CODE_MAX_OUTPUT_TOKENS como a variável que define “o número máximo de tokens de saída para a maioria das solicitações”. Essa formulação é importante: ela descreve um orçamento de saída por solicitação, com valores padrão e limites que variam conforme o modelo. 

A variável é, portanto, relevante ao investigar um limite de saída do Claude Code. Ela não deve ser tratada como um limite universal para todos os tipos de dados que o Claude Code processa. A versão 2.1.265 também introduz um limite em disco para resultados de ferramentas salvos, mas esse limite mede os dados de ferramentas armazenados em gigabytes, não a saída gerada em tokens. 

Há uma ressalva histórica sobre a documentação de configuração. A [referência de variáveis de ambiente](https://code.claude.com/docs/en/env-vars) é atualizada continuamente, e sua revisão exata de setembro de 10 não foi recuperada. Sua descrição explica a finalidade da variável, mas a página não estabelece todos os valores padrão que se aplicavam ao Claude Code 2.1.265. 

Para um artigo com uma data de referência, a evidência numérica mais sólida vem das notas de versão identificadas por versão. Essas notas estabelecem mudanças anteriores específicas sem exigir que uma tabela completa de valores padrão seja inferida da documentação atual. 

### Três limites que devem ser diferenciados 

  | Limite  | A que se refere  | Informações verificadas disponíveis até a data de corte    

  | Orçamento de saída por solicitação  | Número máximo de tokens de saída para a maioria das solicitações  | Mudanças específicas por modelo documentadas na v2.1.77  

  | Janela de contexto do modelo  | A capacidade de contexto documentada do modelo  | Uma janela de 1 milhão de tokens para Sonnet 5, Opus 5 e Fable 5.1  

  | Limite de resultados de ferramentas salvos  | Resultados de ferramentas salvos em disco  | Um limite de 1 GB introduzido na v2.1.265    

Ao diagnosticar um limite, primeiro identifique qual deles se aplica. Uma configuração de orçamento de tokens e um limite de armazenamento em disco exigem interpretações diferentes, mesmo quando ambos aparecem durante a mesma sessão de desenvolvimento. 

## Valores padrão e limites máximos de saída verificados 

O [Notas de versão da v2.1.77](https://github.com/anthropics/claude-code/releases/tag/v2.1.77), datadas de março de 17, 2026, documentam duas mudanças relevantes: o valor padrão do Claude Opus 4.6 aumentou para 64k tokens de saída, e o limite superior para Opus 4.6 e Sonnet 4.6 aumentou para 128k tokens. Essas mudanças também estão preservadas no registro de alterações com a tag v2.1.265. 

Essa evidência impede que “32,000 por padrão, 64,000 no máximo” seja apresentado como uma regra universal do Claude Code. Ela também não justifica preencher os valores padrão ausentes de outros modelos. 

  | Modelo  | Valor padrão do Claude Code estabelecido pelas fontes datadas  | Limite superior documentado    

  | Claude Opus 4.6  | Aumentado para 64k na v2.1.77  | 128k na v2.1.77  

  | Claude Sonnet 4.6  | Não estabelecido pelas fontes datadas analisadas  | 128k na v2.1.77    

É preciso distinguir cuidadosamente uma mudança documentada de uma referência completa de configuração. A versão de março estabelece as mudanças acima; as fontes datadas disponíveis não estabelecem uma tabela completa de valores padrão por modelo para a v2.1.265. 

### Especificações de modelos mais recentes não estabelecem os valores padrão da CLI 

O [notas de lançamento dos modelos](https://platform.claude.com/docs/en/release-notes/overview) documentam uma saída máxima de 128k e uma janela de contexto de 1 milhão de tokens para Claude Sonnet 5, Claude Opus 5 e Claude Fable 5.1. Seus IDs exatos na API são claude-sonnet-5, claude-opus-5 e claude-fable-5-1, respectivamente. 

Esses anúncios estavam disponíveis antes da data de corte da publicação: Sonnet 5 em junho de 30, Opus 5 em julho de 24 e Fable 5.1 em setembro de 1, 2026. No entanto, as especificações desses modelos não são evidência do orçamento padrão por solicitação do Claude Code. 

Para desenvolvedores que estão escolhendo um modelo, o [guia de modelos do Claude Code](/pt/claude-code/models/) oferece uma leitura relacionada. Mantenha o máximo publicado do modelo separado do orçamento de saída padrão usado pela CLI. 

## Definir a variável e entender a compactação 

A documentação atual permite definir a variável antes de iniciar claude, ou colocá-la sob a env chave em settings.json. Como a revisão exata da documentação disponível em setembro de 10 não foi recuperada, os exemplos abaixo são padrões de configuração documentados sujeitos a essa ressalva histórica. 

### Configuração no shell 

O exemplo de shell fornecido define o orçamento de saída como 64,000 tokens: 

```
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000

```

O padrão documentado é definir a variável antes de iniciar o Claude Code. O número neste exemplo é um valor de configuração escolhido; ele não afirma que 64,000 seja o valor padrão ou máximo para todos os modelos. 

Ao registrar a configuração de um projeto ou de uma sessão de diagnóstico, identifique o modelo selecionado junto com o orçamento solicitado. Sem o modelo, um valor isolado não explica se corresponde a um valor padrão documentado ou se está dentro de um limite superior documentado. 

### Configuração em settings.json 

O exemplo equivalente fornecido de JSON coloca a variável sob env: 

```
{"env":{"CLAUDE_CODE_MAX_OUTPUT_TOKENS":"64000"}}

```

O valor é uma string neste exemplo. Assim como na configuração do shell, o trecho expressa um orçamento solicitado, em vez de comprovar um valor padrão específico do modelo. 

Para informações relacionadas ao uso da linha de comando, consulte o [referência da CLI do Claude Code](/pt/claude-code/cli/). A evidência histórica aqui sustenta a função da variável e os exemplos de configuração fornecidos, mas deixa sem resolução o conjunto completo de valores padrão da v2.1.265. 

### O que foi verificado sobre a compactação? 

O registro de alterações com a tag v2.1.265 registra uma correção anterior na v2.1.69 para CLAUDE_CODE_MAX_OUTPUT_TOKENS que estava sendo ignorada durante a compactação da conversa. Essa é uma conexão verificada entre essa configuração e o comportamento de compactação. 

A referência atual de variáveis de ambiente também explica que aumentar essa configuração reduz o contexto efetivo disponível antes da compactação automática. A data de publicação dessa explicação é incerta, portanto ela não pode ser apresentada como uma descrição verificada de setembro de 10. 

A configuração, portanto, não deve ser descrita como algo que amplia a janela de contexto publicada do modelo. A evidência datada estabelece um controle do orçamento de saída e uma correção relacionada à compactação; ela não estabelece um limiar preciso de compactação para todos os modelos na v2.1.265. 

## Como o Claude Code 2.1.265 carrega pastas de plugins 

[Claude Code v2.1.265](https://github.com/anthropics/claude-code/releases/tag/v2.1.265) foi lançado em setembro de 8, 2026, com o commit de lançamento 8e02f6d. Sua mudança no carregamento de pastas permite que --plugin-dir aponte para uma pasta que contém vários plugins. 

A invocação fornecida é: 

```
claude --plugin-dir ./plugins

```

A versão descreve diretamente a regra de descoberta: “cada subpasta com um manifesto é carregada”. Ela também informa que adições e remoções são detectadas enquanto o Claude Code está em execução. 

Isso torna a pasta pai a unidade útil ao gerenciar vários plugins em conjunto. O comportamento documentado se refere a subpastas que contêm manifestos; as notas de versão não especificam descoberta recursiva. Não presuma que uma árvore de diretórios com níveis arbitrários de aninhamento será pesquisada. 

### Estrutura do manifesto e a ressalva histórica 

A referência atual de plugins coloca o manifesto em .claude-plugin/plugin.json e diretórios de componentes, como skills/, commands/ e hooks/ na raiz do plugin. Essa referência não foi recuperada como um retrato datado da v2.1.265. 

Para o artigo de setembro de 10, diferencie essa orientação atual sobre a estrutura da garantia explícita da versão: subpastas com manifestos são carregadas. A versão estabelece a descoberta de pastas com vários plugins sem estabelecer todos os detalhes da documentação de estrutura daquele período. 

### Correções de plugins incluídas na versão 

A versão 2.1.265 também corrige três problemas de plugins:  
- Um caminho de plugin contendo barras invertidas podia contornar a restrição de contenção de links simbólicos no macOS e no Linux. 
- Diretórios que começavam com dois pontos eram rejeitados incorretamente. 
- Pastas padrão de componentes sem permissão de leitura eram ignoradas silenciosamente; agora elas aparecem em /plugin com um código de erro.  

Essas correções se referem a caminhos de plugins e ao carregamento de componentes. Se uma pasta de plugin não for carregada, elas fornecem contexto relevante sobre a versão, mas a configuração de tokens de saída não explica esses problemas de tratamento de diretórios. 

## O limite de 1 GB para resultados de ferramentas salvos é um limite separado 

A versão 2.1.265 adiciona um limite de 1 GB para resultados de ferramentas salvos em disco. A prévia da conversa informa o truncamento. 

Esse limite se refere aos dados de ferramentas armazenados. CLAUDE_CODE_MAX_OUTPUT_TOKENS se refere ao número máximo de tokens de saída para a maioria das solicitações. A versão não descreve a variável de ambiente como um controle do limite em disco, portanto aumentar seu valor não deve ser apresentado como uma solução para o truncamento de resultados de ferramentas salvos. 

As notas de versão também não especificam se o limite de 1 GB se aplica por resultado, por sessão ou a outro agrupamento. Preserve essa incerteza ao documentar o comportamento: “limite de 1 GB para resultados de ferramentas salvos em disco” é a descrição verificada. 

Uma distinção útil no diagnóstico é a evidência mostrada ao desenvolvedor. Uma prévia da conversa que informa truncamento está relacionada ao novo comportamento dos resultados salvos. Uma dúvida sobre o orçamento de saída gerada de um modelo deve ser analisada em conjunto com o modelo selecionado e a configuração de tokens. Um código de erro de plugin em /plugin está relacionado ao carregamento de plugins. 

Esses são controles e diagnósticos distintos, introduzidos ou discutidos no contexto da mesma versão. Tratá-los separadamente evita que uma alteração na configuração de tokens seja usada para explicar comportamentos não relacionados de armazenamento ou pastas. 

## A atualização do gateway disponível até 10 de setembro 

A versão 2.1.266 também foi lançada em 8 de setembro, portanto está dentro da data de corte deste artigo. A [Notas de versão da v2.1.266](https://github.com/anthropics/claude-code/releases/tag/v2.1.266) corrige uma regressão na autenticação do gateway da v2.1.265 envolvendo CLAUDE_CODE_USE_GATEWAY. 

O erro relevante é “Não conectado ao gateway da nuvem”. As notas da versão afirmam que nenhuma alteração de configuração é necessária. 

Para um desenvolvedor que encontre exatamente essa regressão na v2.1.265, a atualização posterior é diretamente relevante. Aumentar o limite de tokens de saída ou reorganizar as pastas de plugins não é a correção documentada. 

Os mesmos fluxos de trabalho podem ser executados por meio de um gateway de API como o AI Prime Tech; consulte [como usar o Claude Code com uma chave de API](/pt/learn/claude-code-api-key-setup/) para orientações de configuração relacionadas. A AI Prime Tech opera de forma independente e não é afiliada à Anthropic nem à OpenAI. 

## Principais conclusões  
- CLAUDE_CODE_MAX_OUTPUT_TOKENS define o número máximo de tokens de saída para a maioria das solicitações; os valores padrão e os limites variam conforme o modelo. 
- A v2.1.77 aumentou o valor padrão do Opus 4.6 para 64k e o limite superior do Opus 4.6/Sonnet 4.6 para 128k. Uma tabela completa de valores padrão da v2.1.265 ainda não foi verificada. 
- O máximo de saída do modelo, a capacidade de contexto do modelo e o armazenamento de resultados de ferramentas salvos são limites distintos. 
- Na v2.1.265, --plugin-dir pode carregar vários plugins de subpastas com manifestos e detectar adições e remoções durante a execução. 
- A v2.1.265 introduz o limite de 1 GB para resultados de ferramentas salvos; a v2.1.266 corrige a regressão na autenticação do gateway sem exigir alterações de configuração.  

## Perguntas frequentes 

### O que CLAUDE_CODE_MAX_OUTPUT_TOKENS controla? 

CLAUDE_CODE_MAX_OUTPUT_TOKENS define o número máximo de tokens de saída para a maioria das solicitações. Seus valores padrão e limites variam conforme o modelo, e esse controle é separado do limite de 1 GB da v2.1.265 para resultados de ferramentas salvos em disco. 

### Quais são os limites de saída padrão e máximo? 

A v2.1.77 aumentou o valor padrão do Claude Opus 4.6 para 64k tokens de saída e o limite superior do Opus 4.6/Sonnet 4.6 para 128k. As fontes datadas analisadas não estabelecem o valor padrão do Sonnet 4.6 nem uma tabela completa de valores padrão por modelo para a v2.1.265. 

### Aumentar essa configuração amplia a janela de contexto? 

A finalidade documentada é definir um limite de tokens de saída, não ampliar a janela de contexto publicada do modelo. A v2.1.69 corrigiu o problema em que a variável era ignorada durante a compactação, mas a explicação da documentação atual sobre seu efeito na compactação automática tem uma data de publicação incerta. 

### Como --plugin-dir descobre vários plugins? 

No Claude Code 2.1.265, --plugin-dir pode apontar para uma pasta principal, e cada subpasta com um manifesto é carregada. Adições e remoções são detectadas enquanto o Claude Code está em execução; a descoberta recursiva não é especificada nas notas da versão. 

[Claude](/pt/blog/tag/claude/)[Programação](/pt/blog/tag/coding/)[API](/pt/blog/tag/api/) 

A

[AI Prime Tech](https://aiprimetech.io/pt/)

A AI Prime Tech publica este blog. Os artigos são redigidos com assistência de IA; confira detalhes específicos de cada versão, como IDs de modelos, preços e limites, na documentação oficial antes de se basear neles. 

 Obtenha acesso mais barato à API do Claude 

Uma única chave de API para Claude Opus 5.5, Sonnet 5, Haiku 4.5 e Fable 5.1, além de GPT-6 modelos. Pague conforme o uso, sem assinatura. [Obtenha Sua Chave de API →](/register)  

A AI Prime Tech é um gateway de API independente de terceiros. Claude™ e Anthropic® são marcas comerciais da Anthropic, PBC. Não há afiliação nem endosso implícitos.