Saltar para o conteúdo principal

Utilizar o Painel do Explorador de Ficheiros

Escrever @ na caixa de entrada é a forma integrada do Claude Code de referenciar ficheiros. Funciona muito bem para um ou dois ficheiros. Mas à medida que o seu projeto cresce, o atrito acumula-se:

  • Memorização de caminhos: Tem de se lembrar dos caminhos exatos dos ficheiros. Diretórios profundamente aninhados tornam isto penoso e propenso a erros.
  • Interferência do IME: Se utiliza um editor de método de entrada para texto não inglês, alternar constantemente entre o IME e o símbolo @ quebra o seu fluxo.

O painel do explorador de ficheiros resolve ambos os problemas. Encontra-se no topo da barra de ferramentas da barra lateral esquerda — um clique e pode navegar, pesquisar e inserir referências a ficheiros sem digitar um único caminho.

O painel de ficheiros do projeto oferece uma forma mais conveniente e intuitiva de trabalhar com ficheiros

1. Abrir o Painel do Explorador de Ficheiros​

Clique no primeiro botão na barra de ferramentas da barra lateral esquerda, ou prima Ctrl + Shift + E para abrir ou fechar o painel.

2. Navegar por Ficheiros​

O painel utiliza a mesma vista em árvore que já conhece do VS Code, Cursor e outros editores:

  1. Vista completa do projeto: Todos os ficheiros do seu projeto são visíveis na árvore. Deixe de adivinhar estruturas de diretórios.
  2. Filtragem consciente do Git: O painel respeita as suas regras .gitignore por defeito. Diretórios como node_modules são ocultados automaticamente, para que veja apenas o que interessa.
  3. Navegação por teclado: Utilize as setas para cima e para baixo para se mover pela árvore, e as setas para a esquerda e direita para contrair e expandir pastas.

3. Pesquisar Ficheiros​

Escreva uma palavra-chave para pesquisar rapidamente em todo o projeto

Há uma barra de pesquisa no topo do painel. Escreva parte do nome de um ficheiro e a árvore filtra-se instantaneamente para mostrar os resultados correspondentes. É muito mais rápido do que clicar por pastas aninhadas uma a uma.

4. Inserir Referências a Ficheiros​

Esta é a principal razão para utilizar o painel. Em vez de digitar caminhos @ manualmente:

  1. Clique duas vezes num ficheiro para inserir uma referência @ diretamente na caixa de entrada da conversa. O Deep Code lê o ficheiro e inclui-o no contexto.
  2. Adicione múltiplos ficheiros clicando duas vezes neles em sucessão — ideal para revisões de código ou comparações de implementações lado a lado. Pode também selecionar um ficheiro e premir Ctrl + Enter.
  3. Diretórios também funcionam: Clique duas vezes numa pasta para inserir uma referência a diretório, o que dá ao Deep Code uma listagem do seu conteúdo. Pode então indicar-lhe quais ficheiros específicos deve carregar.

Resumo​

O painel do explorador de ficheiros não é apenas uma alternativa a digitar caminhos @ — é a forma mais rápida de trabalhar. A pesquisa de caminhos, a procura de ficheiros e a inserção de referências acontecem todos numa única interface visual. Se ainda não o experimentou, prima Ctrl + Shift + E ou clique no primeiro botão na barra de ferramentas esquerda.