> ## 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.

# Project Management

A “project” is the core organizational unit in Cloud Code. Each project corresponds to an independent cloud sandbox environment with its own Claude Code environment, file system, and other resources.

## Create a Project

<Steps>
  <Step title="Click New">
    Click the **+ New Project** button in the sidebar
  </Step>

  <Step title="Enter a Name">
    Enter a project name (for example: `my-first-app`)

    <Info>
      We recommend using English letters, numbers, and hyphens for project names, and avoiding special characters.
    </Info>
  </Step>

  <Step title="Confirm Creation">
    Click the **Create Project** button
  </Step>
</Steps>

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

## Project Status

After you create a project, Cloud Code automatically configures a cloud sandbox environment for it. The project will go through the following statuses:

| Status       | Icon                                           | Description                                               |
| ------------ | ---------------------------------------------- | --------------------------------------------------------- |
| **creating** | <Icon icon="spinner" />                        | Initializing the cloud sandbox                            |
| **running**  | <Icon icon="circle-play" color="green" />      | The sandbox is ready and can be used                      |
| **error**    | <Icon icon="circle-exclamation" color="red" /> | The sandbox is running abnormally. Please try again later |

## Manage Projects

<Warning>
  Please note: Deleting a project will permanently delete all files and session history. This action cannot be undone. Make sure you have backed up important data.
</Warning>

<Columns cols={3}>
  <Card title="Switch Projects" icon="arrow-right-arrow-left">
    Click a project name in the left sidebar to switch to it
  </Card>

  <Card title="Delete a Project" icon="trash">
    Click the delete icon to the right of the specified project to delete it
  </Card>

  <Card title="Modify a Project" icon="pencil">
    Click the edit icon to the right of the specified project to modify its name
  </Card>
</Columns>

## Related Documentation

<Columns cols={3}>
  <Card title="Session Management" icon="message" href="/en/docs/cc/session">
    Manage sessions in a project
  </Card>

  <Card title="File Management" icon="folder" href="/en/docs/cc/files">
    Manage files in a project
  </Card>

  <Card title="Git Integration" icon="code-branch" href="/en/docs/cc/git-integration">
    Version control and code backup
  </Card>
</Columns>