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

# Git 集成

Cloud Code 内置完整的 Git 支持，您可以通过 Git 来对您的项目内容进行版本控制。

## 配置 Git 用户信息

首次使用需要配置用户信息：

<Steps>
  <Step title="打开设置">
    进入 **设置 > Git**
  </Step>

  <Step title="填写信息">
    输入用户名和邮箱
  </Step>

  <Step title="保存">
    点击保存按钮
  </Step>
</Steps>

```
用户名：Your Name
邮箱：your.email@example.com
```

<Info>
  此信息用于 Git 提交记录，建议使用与 GitHub 账户相同的邮箱。
</Info>

<Frame>
  <img src="https://mintcdn.com/jiekou/680GrIEScnQsSrRs/docs/cc/assets/cc-git-config-user.png?fit=max&auto=format&n=680GrIEScnQsSrRs&q=85&s=266562fad0d76b392df90873a5c94283" alt="Git 用户信息配置" width="1626" height="1306" data-path="docs/cc/assets/cc-git-config-user.png" />
</Frame>

## 连接远程仓库

### 配置 GitHub 凭据

<Steps>
  <Step title="打开 Git 设置">
    进入 **设置 > Git**
  </Step>

  <Step title="添加凭据">
    在「Git Credentials」区域点击 **+ 添加** 按钮
  </Step>

  <Step title="输入 Username">
    输入你的 GitHub Username
  </Step>

  <Step title="输入 Token">
    输入你的 GitHub Personal Access Token（点击输入框右上角 **创建 Tokens** 按钮，按照提示创建即可）
  </Step>

  <Step title="点击保存">
    点击 **保存凭据** 按钮
  </Step>
</Steps>

如果配置成功，你会看到「Git Credentials」区域显示你的凭据信息，显示为「已激活」。

<Frame>
  <img src="https://mintcdn.com/jiekou/680GrIEScnQsSrRs/docs/cc/assets/cc-git-credentials.png?fit=max&auto=format&n=680GrIEScnQsSrRs&q=85&s=37b3ef5da4b8ae2f0dbe520ea7242bda" alt="Git 凭据配置" width="1634" height="520" data-path="docs/cc/assets/cc-git-credentials.png" />
</Frame>

## 初始化 Git 仓库

<Steps>
  <Step title="打开 Git 面板">
    点击顶部标签栏的 **源代码管理** 标签
  </Step>

  <Step title="创建仓库">
    在 GitHub 上创建一个新的空仓库
  </Step>

  <Step title="初始化">
    输入远程仓库地址，并点击 **绑定** 按钮，即可完成 Git 仓库的初始化
  </Step>
</Steps>

初始化成功后，你会看到「源代码管理」页面下会显示如下界面：

<Frame>
  <img src="https://mintcdn.com/jiekou/680GrIEScnQsSrRs/docs/cc/assets/cc-git-bind-succ.png?fit=max&auto=format&n=680GrIEScnQsSrRs&q=85&s=b7cd8ecec49063985aa2d7a42f7388a9" alt="Git 仓库列表" width="2490" height="1398" data-path="docs/cc/assets/cc-git-bind-succ.png" />
</Frame>

## 提交更改

<Steps>
  <Step title="暂存文件">
    点击文件旁的 **+** 按钮暂存单个文件，或点击 **全部暂存** 暂存所有更改
  </Step>

  <Step title="编写提交信息">
    在提交信息输入框中描述你的更改
  </Step>

  <Step title="提交">
    点击 **提交** 按钮将你的更改提交到本地仓库
  </Step>

  <Step title="发布">
    点击 **发布** 按钮发布你的更改到远程仓库
  </Step>
</Steps>

## 查看历史

在 Git 面板中可以查看提交历史：

* **提交列表** — 显示所有提交记录
* **提交详情** — 点击提交查看更改的文件
* **文件差异** — 查看具体的代码更改

<Frame>
  <img src="https://mintcdn.com/jiekou/680GrIEScnQsSrRs/docs/cc/assets/cc-git-repo-history.png?fit=max&auto=format&n=680GrIEScnQsSrRs&q=85&s=3b0d503397e1268beaaefc86acfcc089" alt="Git 仓库提交历史" width="2484" height="686" data-path="docs/cc/assets/cc-git-repo-history.png" />
</Frame>

## 通过 Claude Code 操作 Git

你可以让 Claude Code 帮你执行 Git 操作：

| 请求                    | Claude Code 操作 |
| --------------------- | -------------- |
| "提交这些更改"              | 暂存文件并创建提交      |
| "推送到 GitHub"          | 执行 git push    |
| "创建新分支 feature/login" | 创建并切换分支        |
| "查看提交历史"              | 显示 git log     |
| "回滚到上一个提交"            | 执行 git reset   |

## 相关文档

<Columns cols={2}>
  <Card title="项目管理" icon="folder" href="/docs/cc/project">
    管理项目信息
  </Card>

  <Card title="Chat 模式" icon="message-bot" href="/docs/cc/chat-mode">
    Chat 模式下，你可以通过对话框的形式，让 Claude Code 帮你完成任务。
  </Card>
</Columns>