Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Gemini Code Assist permite excluir arquivos do seu contexto para geração, preenchimento, transformação e chat de código. Para usuários do Enterprise, isso também inclui a personalização de código.
Em muitos casos, você tem arquivos ou subárvores específicos que não quer incluir no contexto.
É possível excluir esses arquivos usando um arquivo .aiexclude ou .gitignore.
Configurar exclusões de contexto
Nesta seção, mostramos como configurar as definições dos arquivos .aiexclude e .gitignore.
Mude o arquivo .aiexclude para o arquivo que você preferir.
Por padrão, a exclusão por contexto é definida para usar .aiexclude. Para mudar essa configuração na sua IDE, siga estas etapas:
VS Code
Na barra de atividades, clique em
ConfiguraçõesGerenciar >
Configurações.
Na janela Configurações, navegue até Extensões >
Gemini Code Assist. Role a tela até encontrar Arquivo de exclusão de contexto.
No campo de texto, mude .aiexclude para o local de sua preferência.
O arquivo escolhido agora está definido como o arquivo de exclusão de contexto.
IntelliJ
A configuração de arquivos .aiexclude e .gitignore não é compatível com os ambientes de desenvolvimento integrado do JetBrains.
Mudar a exclusão de contexto do .gitignore
Por padrão, o arquivo .gitignore está ativado para exclusão de contexto. O arquivo
precisa estar na pasta de trabalho raiz do
Gemini Code Assist. Os arquivos .gitignore localizados em subdiretórios
não serão considerados nem mesclados.
Para desativar os arquivos .gitignore da exclusão por contexto, siga estas etapas:
Na barra de atividades, clique em
ConfiguraçõesGerenciar >
Configurações.
Na janela Configurações, navegue até Extensões >
Gemini Code Assist. Role a tela até encontrar Context Exclusion Gitignore.
Desmarque a caixa de seleção.
Os arquivos .gitignore agora estão desativados para especificar o arquivo que o Gemini Code Assist precisa ignorar.
Gravar um arquivo .aiexclude
Um arquivo .aiexclude segue a seguinte sintaxe:
Exemplos
Os exemplos a seguir mostram como configurar um arquivo .aiexclude:
Bloqueie todos os arquivos com o nome apikeys.txt no diretório ou abaixo dele que contenha o arquivo .aiexclude:
apikeys.txt
Bloqueie todos os arquivos com a extensão .key no diretório ou abaixo dele que contém o arquivo .aiexclude:
*.key
Bloqueie apenas o arquivo apikeys.txt no mesmo diretório de .aiexclude, mas não subdiretórios:
/apikeys.txt
Bloqueie todos os arquivos no diretório my/sensitive/dir e todos os subdiretórios.
O caminho precisa ser relativo ao diretório que contém o arquivo .aiexclude.
my/sensitive/dir/
Bloqueia todos os arquivos no diretório foo e nos subdiretórios, exceto o arquivo
chamado bar.txt no diretório foo.
foo/*
!foo/bar.txt
Controlar o acesso ao índice para personalização de código
Para evitar a exposição de código que você não quer usar no contexto,
use padrões de ramificação para
controlar o acesso ao seu índice
e use uma ramificação estável, como main.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003eGemini Code Assist indexes all supported code files in your repositories by default, but you can exclude specific files or subtrees using an \u003ccode\u003e.aiexclude\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eAn \u003ccode\u003e.aiexclude\u003c/code\u003e file uses a similar syntax to \u003ccode\u003e.gitignore\u003c/code\u003e, but an empty file blocks all files in its directory and subdirectories, and negation with an exclamation point is not supported.\u003c/p\u003e\n"],["\u003cp\u003eYou can block specific files, file types, or entire directories by listing their names, extensions, or relative paths in the \u003ccode\u003e.aiexclude\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eIf a file is added to \u003ccode\u003e.aiexclude\u003c/code\u003e after being indexed, it will be removed from the index within 24 hours.\u003c/p\u003e\n"]]],[],null,["\u003cbr /\u003e\n\nGemini Code Assist supports excluding files from your context for code\ngeneration, code completion, code transformation, and chat. For Enterprise\nusers, this also includes code customization.\n\nIn many scenarios, you'll have specific files or subtrees that you don't want\nto have included in your context.\n\nYou can exclude these files through the use of an `.aiexclude` or `.gitignore`\nfile.\n| **Note:** For [code customization](/gemini-code-assist/docs/code-customization-overview) only the `.aiexclude` file is used.\n\nConfigure context exclusion settings\n\nThis section shows you how to configure settings for `.aiexclude` and\n`.gitignore` files.\n\nChange .aiexclude file to your preferred file\n\nBy default, context exclusion is set to use `.aiexclude`. To change this setting\nin your IDE, follow these steps: \n\nVS Code\n\n1. In the activity bar, click\n settings **Manage** \\\u003e\n **Settings**.\n\n2. In the **Settings** window, navigate to **Extensions** \\\u003e\n **Gemini Code Assist** . Scroll until you find **Context Exclusion File**.\n\n3. In the text field, change `.aiexclude` to your preferred location.\n\nYour preferred file is now set as the context exclusion file.\n\nIntelliJ\n\nConfiguring settings for `.aiexclude` and `.gitignore` files isn't\nsupported in JetBrains IDEs.\n\nChange .gitignore context exclusion\n\nBy default, the `.gitignore` file is enabled for context exclusion. The file\nmust be located in the root working folder for\nGemini Code Assist. `.gitignore` files located in subdirectories\nwon't be considered or merged.\n\nTo disable `.gitignore` files from context exclusion, follow these steps:\n\n1. In the activity bar, click\n settings **Manage** \\\u003e\n **Settings**.\n\n2. In the **Settings** window, navigate to **Extensions** \\\u003e\n **Gemini Code Assist** . Scroll until you find **Context Exclusion Gitignore**.\n\n3. Unselect the checkbox.\n\n `.gitignore` files are now disabled for specifying file Gemini Code Assist to ignore.\n\nWrite an `.aiexclude` file **Note:** In the event that a conflict exists between `.aiexclude` and `.gitignore`, the `.aiexclude` directive preempts `.gitignore` directives.\n\nAn `.aiexclude` file follows the same syntax as a `.gitignore` file.\n\nExamples\n\nThe following examples demonstrate how you can configure an `.aiexclude` file:\n\n- Block all files named `apikeys.txt` at or below the directory that contains\n the `.aiexclude` file:\n\n apikeys.txt\n\n- Block all files with the `.key` file extension at or below the directory that\n contains the `.aiexclude` file:\n\n *.key\n\n- Block only the `apikeys.txt`file at the same directory as the `.aiexclude`\n file, but not any subdirectories:\n\n /apikeys.txt\n\n- Block all files in the directory `my/sensitive/dir` and all subdirectories.\n The path should be relative to the directory that contains the `.aiexclude`\n file.\n\n my/sensitive/dir/\n\n- Blocks all the files in directory `foo` and its subdirectories except file\n named `bar.txt` in the foo directory.\n\n foo/*\n !foo/bar.txt\n\nControl access to index for code customization\n\nBy default, code customization indexes all the\n\n[supported code files](/gemini-code-assist/docs/code-customization-overview#limitations)\nin your specified repositories.\n\nTo prevent exposure of code that you don't want to be used in the context, you\ncan use branch patterns to\n\n[control access to your index](/gemini-code-assist/docs/code-customization#control_access_to_your_index_using_repository_groups)\nand use a stable branch, such as `main`.\n\nAlternatively, you can also exclude files from the context by\n[creating an `.aiexclude` file](#write_an_aiexclude_file)."]]
