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

# 项目管理

“项目” 是 Cloud Code 的核心组织单元。每个项目对应一个独立的云端沙箱环境，拥有独立的 Claude Code 环境、文件系统等资源。

## 创建项目

<Steps>
  <Step title="点击新建">
    在侧边栏点击 **+ 新建项目** 按钮
  </Step>

  <Step title="输入名称">
    输入项目名称（例如：`my-first-app`）

    <Info>
      项目名称建议使用英文字母、数字和连字符，避免使用特殊字符。
    </Info>
  </Step>

  <Step title="确认创建">
    点击 **创建项目** 按钮
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/jiekou/680GrIEScnQsSrRs/docs/cc/assets/cc-my-first-app.png?fit=max&auto=format&n=680GrIEScnQsSrRs&q=85&s=70e307a116efbc73db53e0429bb89cca" alt="my first app" width="2894" height="1964" data-path="docs/cc/assets/cc-my-first-app.png" />
</Frame>

## 项目状态

创建项目后，Cloud Code 会自动为该项目配置云端沙箱环境。项目会经历以下状态：

| 状态           | 图标                                             | 说明           |
| ------------ | ---------------------------------------------- | ------------ |
| **creating** | <Icon icon="spinner" />                        | 正在初始化云端沙箱    |
| **running**  | <Icon icon="circle-play" color="green" />      | 沙箱已就绪，可以开始使用 |
| **error**    | <Icon icon="circle-exclamation" color="red" /> | 沙箱运行异常，请稍后重试 |

## 管理项目

<Warning>
  请注意：删除项目会永久删除所有文件和会话历史，此操作不可撤销。请确保已备份重要数据。
</Warning>

<Columns cols={3}>
  <Card title="切换项目" icon="arrow-right-arrow-left">
    点击左侧边栏中的项目名称即可切换
  </Card>

  <Card title="删除项目" icon="trash">
    点击指定项目右侧的删除图标即可删除项目
  </Card>

  <Card title="修改项目" icon="pencil">
    点击指定项目右侧的修改图标即可修改项目名称
  </Card>
</Columns>

## 相关文档

<Columns cols={3}>
  <Card title="会话管理" icon="message" href="/docs/cc/session">
    管理项目中的会话
  </Card>

  <Card title="文件管理" icon="folder" href="/docs/cc/files">
    管理项目中的文件
  </Card>

  <Card title="Git 集成" icon="code-branch" href="/docs/cc/git-integration">
    版本控制与代码备份
  </Card>
</Columns>