> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerenciamento de projetos

“Projeto” é a principal unidade organizacional do Cloud Code. Cada projeto corresponde a um ambiente de sandbox em nuvem independente, com recursos próprios, como ambiente Claude Code e sistema de arquivos.

## Criar projeto

<Steps>
  <Step title="Clique em Novo">
    Na barra lateral, clique no botão **+ Novo projeto**
  </Step>

  <Step title="Insira o nome">
    Insira o nome do projeto (por exemplo: `my-first-app`)

    <Info>
      Recomendamos usar letras, números e hifens no nome do projeto, evitando caracteres especiais.
    </Info>
  </Step>

  <Step title="Confirme a criação">
    Clique no botão **Criar projeto**
  </Step>
</Steps>

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/jiekou/pt/docs/cc/assets/cc-my-first-app.png" alt="meu primeiro app" />
</Frame>

## Status do projeto

Após criar o projeto, o Cloud Code configurará automaticamente um ambiente de sandbox em nuvem para ele. O projeto passará pelos seguintes status:

| Status       | Ícone                                          | Descrição                                                |
| ------------ | ---------------------------------------------- | -------------------------------------------------------- |
| **creating** | <Icon icon="spinner" />                        | Inicializando o sandbox em nuvem                         |
| **running**  | <Icon icon="circle-play" color="green" />      | O sandbox está pronto e já pode ser usado                |
| **error**    | <Icon icon="circle-exclamation" color="red" /> | O sandbox está com uma falha; tente novamente mais tarde |

## Gerenciar projetos

<Warning>
  Atenção: excluir um projeto removerá permanentemente todos os arquivos e o histórico de sessões. Esta ação não pode ser desfeita. Certifique-se de fazer backup dos dados importantes.
</Warning>

<Columns cols={3}>
  <Card title="Alternar projeto" icon="arrow-right-arrow-left">
    Clique no nome do projeto na barra lateral esquerda para alternar
  </Card>

  <Card title="Excluir projeto" icon="trash">
    Clique no ícone de exclusão à direita do projeto especificado para excluí-lo
  </Card>

  <Card title="Modificar projeto" icon="pencil">
    Clique no ícone de edição à direita do projeto especificado para modificar o nome do projeto
  </Card>
</Columns>

## Documentação relacionada

<Columns cols={3}>
  <Card title="Gerenciamento de sessões" icon="message" href="/pt/docs/cc/session">
    Gerencie as sessões do projeto
  </Card>

  <Card title="Gerenciamento de arquivos" icon="folder" href="/pt/docs/cc/files">
    Gerencie os arquivos do projeto
  </Card>

  <Card title="Integração com Git" icon="code-branch" href="/pt/docs/cc/git-integration">
    Controle de versão e backup de código
  </Card>
</Columns>