---
id: "arquivos-caminhos-e-apps"
titulo: "Caminhos, sistema e apps externos"
resumo: "Copiar o caminho de um arquivo, revelá-lo no gerenciador do sistema, abrir em editores externos e promover uma pasta a projeto."
idioma: "pt-br"
tipo: "guia"
categoria: "arquivos-git"
aplicavelDesde: "0.0.16"
capabilities: ["fileTree.copyPath", "fileTree.revealInOs", "fileTree.openInExternal", "fileTree.project.promote"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/pt-br/ferramentas/arquivos/caminhos-e-apps/"
fonte: "pt-br/ferramentas/arquivos/caminhos-e-apps.md"
caminhoPublico: "docs/publica/pt-br/ferramentas/arquivos/caminhos-e-apps.md"
hashFonte: "sha256:6b974c9b7578c039704dc0530a2d0159a56c6f8ee52ae010e266927b46cd52ed"
hashDestaPagina: "sha256:6b974c9b7578c039704dc0530a2d0159a56c6f8ee52ae010e266927b46cd52ed"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
## Copiar o caminho

- **Caminho absoluto** e **caminho relativo** são itens distintos do menu da linha.
- Com **múltipla seleção**, os rótulos passam ao plural e a ação copia o conjunto.
- O **cabeçalho do editor** também oferece copiar o caminho, e o menu do gutter copia o caminho **com o número da linha** do cursor.

O caminho relativo é relativo ao workspace — é o formato que você cola em comando, issue ou mensagem para o agente.

## Revelar no gerenciador do sistema

O rótulo muda por plataforma:

| Plataforma | Rótulo |
|---|---|
| macOS | Finder |
| Windows | Explorador |
| Linux | abrir a pasta que contém |

> **Abrir um caminho local pode ser bloqueado por configuração de conexão remota.** Em worktree remoto, revelar no sistema **não** tem o efeito esperado: o caminho é do host, não da sua máquina. Use **baixar** quando o objetivo é ter o arquivo localmente.

## Abrir em aplicativos externos

A barra de ações do painel tem **abrir no** — gerenciador de arquivos ou editores configurados — e um item para **personalizar os aplicativos**.

- A lista de aplicativos vem das suas preferências.
- O rótulo do gerenciador de arquivos também depende do sistema.
- Se a abertura falhar, o app mostra um aviso orientando conferir o comando ou o gerenciador configurado.

**Abrir em app externo não muda nada no workspace:** é uma janela do sistema apontando para a mesma pasta.

## Adicionar ou promover uma pasta a projeto

Uma pasta dentro do workspace pode virar um projeto:

- **Adicionar como projeto** — cria um projeto a partir da pasta.
- **Promover a projeto** — a mesma intenção, para uma pasta já reconhecida como candidata.

A disponibilidade depende de a pasta poder ser tratada como projeto. A ação abre o fluxo de criação de projeto já preenchido com os dados da pasta.

> O **projeto** é a unidade que abre as telas e define o repositório do git. Criar um projeto a partir de uma subpasta cria uma nova unidade de trabalho — não é o mesmo que navegar na árvore.

## Limites

- **Revelar no sistema** e **abrir em app externo** dependem do sistema operacional e das suas preferências; em workspace remoto, o caminho não é local.
- **Copiar caminho** usa o formato do workspace: confira se você precisa do absoluto ou do relativo antes de colar.
- As três primeiras ações desta página **não** alteram arquivos.

## Relacionados

- [Atalhos para outras superfícies](/docs/pt-br/ferramentas/arquivos/atalhos-entre-superficies/)
- [Abrir e visualizar arquivos](/docs/pt-br/ferramentas/arquivos/abrir-e-visualizar/)