{"meta":{"title":"O que são GitHub Codespaces?","intro":"Saiba o que são os GitHub Codespaces.","product":"Codespaces","breadcrumbs":[{"href":"/pt/codespaces","title":"Codespaces"},{"href":"/pt/codespaces/about-codespaces","title":"Introdução"},{"href":"/pt/codespaces/about-codespaces/what-are-codespaces","title":"O que são Codespaces?"}],"documentType":"article"},"body":"# O que são GitHub Codespaces?\n\nSaiba o que são os GitHub Codespaces.\n\n## Introdução\n\nUm codespace é um ambiente de desenvolvimento hospedado na nuvem. Você pode personalizar seu projeto para o GitHub Codespaces realizando o commit dos arquivos de configuração no seu repositório (geralmente conhecido como Configuração-como-Código), criando uma configuração de codespace que pode ser repetida para todos os usuários do projeto. Confira [Introdução aos contêineres de desenvolvimento](/pt/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers).\n\nCada codespace criado é hospedado por GitHub em um contêiner do Docker em execução em uma máquina virtual. Você pode escolher entre uma seleção de tipos de máquina virtual, de 2 núcleos, 8 GB de RAM e 32 GB de armazenamento, até 32 núcleos, 128 GB de RAM e 128 GB de armazenamento.\n\nPor padrão, o ambiente de desenvolvimento dos codespaces é criado com base em uma imagem do Ubuntu Linux que inclui uma seleção de linguagens e ferramentas populares, mas você pode usar uma imagem com base em uma distribuição do Linux de sua escolha e configurá-la para requisitos específicos. Independentemente do sistema operacional local, o codespace será executado em um ambiente Linux. Windows e macOS não são sistemas operacionais suportados para o contêiner de desenvolvimento remoto.\n\nVocê pode se conectar aos seus codespaces pelo navegador, pelo Visual Studio Code ou usando o GitHub CLI. Ao se conectar, você é colocado dentro do contêiner do Docker. Você tem acesso limitado ao host externo da máquina virtual do Linux.\n\n![Diagrama mostrando a relação entre um editor de código e um codespace em execução em uma máquina virtual Azure.](/assets/images/help/codespaces/codespaces-diagram.png)\n\n## Como usar o GitHub Codespaces\n\nPara começar o desenvolvimento usando recursos de computação baseados na nuvem, crie um codespace com base em um modelo ou em qualquer branch ou faça commit em um repositório. Ao criar um codespace com base em um modelo, você pode começar com um modelo em branco ou escolher um modelo adequado para o trabalho que está fazendo.\n\nPara começar a usar o GitHub Codespaces, confira [Guia Rápido para GitHub Codespaces](/pt/codespaces/quickstart). Para obter mais informações sobre como criar um codespace, confira [Como criar um codespace para um repositório](/pt/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository) ou [Como criar um codespace com base em um modelo](/pt/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template). Se você quiser retornar a um codespace que já criou, confira [Como abrir um codespace existente](/pt/codespaces/developing-in-codespaces/opening-an-existing-codespace). Para saber mais sobre como funciona o GitHub Codespaces, confira [Aprofundamento de GitHub Codespaces](/pt/codespaces/about-codespaces/deep-dive).\n\n### Como usar codespaces pertencentes à sua conta pessoal\n\nTodas as contas pessoais do GitHub têm uma cota mensal de uso gratuito do GitHub Codespaces incluída no plano Gratuito ou Pro. Comece a usar o GitHub Codespaces na sua conta pessoal sem alterar nenhuma configuração ou fornecer detalhes de pagamento.\n\nSe você criar um codespace por meio de um repositório de propriedade da organização, o uso do codespace será cobrado para a organização (se a organização estiver configurada para isso) ou para sua conta pessoal.\n\nVocê pode continuar usando o GitHub Codespaces além do uso mensal incluído de armazenamento e computação fornecendo detalhes de pagamento e definindo um limite de gastos. Confira [Cobrança do GitHub Codespaces](/pt/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/about-billing-for-github-codespaces).\n\n### Como utilizar codespaces pertencentes à organização\n\nOs proprietários de organizações nos planos GitHub Team e GitHub Enterprise podem pagar pelo uso do GitHub Codespaces por seus membros e colaboradores. Isso se aplica aos codespaces criados com base em repositórios pertencentes à organização. Confira [Como escolher quem tem a propriedade e paga pelos codespaces em sua organização](/pt/codespaces/managing-codespaces-for-your-organization/choosing-who-owns-and-pays-for-codespaces-in-your-organization). Defina um limite de gastos para uso do GitHub Codespaces na sua organização ou na sua conta corporativa. Confira [Definir orçamentos para controlar gastos com produtos limitados](/pt/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/managing-the-spending-limit-for-github-codespaces).\n\nSe o uso de um codespace for cobrado para uma organização ou uma empresa, isso será mostrado quando o codespace for criado. Confira [Como criar um codespace para um repositório](/pt/codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository). Os codespaces cobrados de uma organização ou de sua empresa-mãe pertencem à organização e podem ser excluídos por um proprietário dela. Confira [Excluir um codespace](/pt/codespaces/developing-in-a-codespace/deleting-a-codespace#deleting-codespaces-in-your-organization).\n\nA capacidade de criar codespaces com base em repositórios de propriedade da organização depende de vários fatores, como a visibilidade do repositório e as configurações da organização ou da empresa-mãe. Para saber mais, confira [Solucionar problemas de criação e exclusão de codespaces](/pt/codespaces/troubleshooting/troubleshooting-creation-and-deletion-of-codespaces#no-access-to-create-a-codespace).\n\n### Como personalizar o GitHub Codespaces\n\nPara personalizar os runtimes e as ferramentas em seu codespace, você pode criar uma ou mais configurações de contêiner de desenvolvimento para seu repositório. A adição de configurações de contêiner de desenvolvimento ao seu repositório permite que você defina uma escolha de diferentes ambientes de desenvolvimento apropriados para o trabalho que as pessoas farão em seu repositório.\n\nSe você criar um codespace por meio de um repositório sem nenhuma configuração de contêiner de desenvolvimento, o GitHub Codespaces clonará seu repositório em um ambiente com a imagem do contêiner de desenvolvimento padrão que inclui muitas ferramentas, linguagens e ambientes de runtime. Se você criar um codespace com base em um modelo, poderá começar com uma configuração inicial baseada na imagem padrão. Confira [Introdução aos contêineres de desenvolvimento](/pt/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers).\n\nPersonalize aspectos do ambiente do codespace usando um repositório de [dotfiles](https://dotfiles.github.io/tutorials/) público. Use dotfiles para definir aliases e preferências de shell ou para instalar sua preferência pessoal das ferramentas que deseja usar. Se você usar o GitHub Codespaces no navegador ou no Visual Studio Code, use [a Sincronização de Configurações](https://code.visualstudio.com/docs/editor/settings-sync) para fornecer ao editor de codespace as configurações, os atalhos de teclado, as extensões e os snippets idênticos que você configurou na instalação local do Visual Studio Code.\n\nConfira [Personalizando seu codespace](/pt/codespaces/customizing-your-codespace).\n\n## Cobrança do Codespaces\n\nPara obter mais informações sobre preços, armazenamento e uso do GitHub Codespaces, confira [Cobrança do GitHub Codespaces](/pt/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/about-billing-for-github-codespaces).\n\nSe sua conta não tiver uma forma de pagamento válida registrada, o uso será bloqueado quando você usar sua cota.\n\nSe você tiver uma forma de pagamento válida arquivada, os gastos poderão ser limitados por um ou mais orçamentos. Verifique os orçamentos definidos para sua conta para garantir que sejam apropriados para suas necessidades de uso. Confira [Definir orçamentos para controlar gastos com produtos limitados](/pt/billing/managing-your-billing/using-budgets-control-spending).\n\nOs custos de GitHub Codespaces são sempre cobrados mensalmente, mesmo que os outros itens de sua conta sejam cobrados anualmente. Para obter informações sobre como os proprietários de organizações e os gerentes de cobrança podem gerenciar o limite de gastos do GitHub Codespaces de uma organização, confira [Definir orçamentos para controlar gastos com produtos limitados](/pt/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/managing-the-spending-limit-for-github-codespaces)."}