华为云码道代码智能体新手首次使用全流程指引
从 AtomGit 建仓、首次 AI 开发任务,到由华为云码道 Agent 创建 Pull Request 的完整流程
| 文档目标 完成一次可验证的仓库级 AI 开发任务:创建代码仓库 → 关联仓库 → 发起任务 → 生成并修改代码 → 提交变更 → 创建 Pull Request → 在 AtomGit 验证结果。 |
华为云码道 Agent : https://atomgit.com/dashboard
完成后你将能够
• 在 AtomGit 创建并初始化一个代码仓库。
• 在 Agent 对话中选择“华为云码道 Agent”,并关联目标仓库。
• 通过自然语言让 Agent 读取项目、生成或修改代码,并完成 Git 提交。
• 由 Agent 将变更推送至 AtomGit,创建 Pull Request,并在仓库页面核验 PR 状态。
| 操作建议 首次上手建议选择结构简单、权限明确的测试仓库进行演示,并在创建 PR 后先进行检查,不直接合并到主分支。 |
一、注册并登录 AtomGit
首次使用前,需要先准备 AtomGit 账号。已完成注册并登录的用户可直接进入下一节。
1. 进入 AtomGit 官网(https://atomgit.com)。 点击页面右上角“注册”。

图 1 AtomGit 注册入口
2. 填写注册信息。 根据页面提示填写用户名、手机号和验证码,阅读并同意相关协议后完成注册。

图 2 AtomGit 注册页面
注册完成后登录 AtomGit,即可进入工作台并开始创建项目。
二、创建代码仓库
华为云码道 Agent (https://atomgit.com/dashboard)需要基于具体代码仓库读取项目上下文并执行开发任务,因此首先创建一个用于本次操作的 AtomGit 项目。
1. 打开新建菜单。 点击页面右上角“新建”,选择“新建项目”。

图 3 新建项目入口
2. 配置项目信息。 按实际需求填写项目名称、所有者、项目路径和项目介绍,并选择项目可见性。
• 建议勾选“添加初始化 README 文件”,便于仓库创建后立即具备可读取的基础内容。
• 如无特殊要求,默认分支保持为 main。

图 4 新建项目配置页面
3. 创建项目。 点击“创建项目”,进入仓库页面;能够看到默认分支和初始化文件即表示建仓完成。
三、选择华为云码道 Agent
进入 Agent 对话页面 ( https://atomgit.com/dashboard)后,在输入区的执行者选择入口中选择“华为云码道 Agent”。每个对话使用一个执行者,建议在同一任务链中保持执行者不变,以便连续使用当前会话上下文。

图 5 选择“华为云码道 Agent”
| 首次授权 如页面提示首次使用需要授权,请按界面提示完成授权后继续。授权完成后即可在当前对话中调用华为云码道 Agent。 |
四、关联目标仓库
在提交开发任务前,需要让 Agent 关联目标 AtomGit 仓库。关联后,Agent 才能基于仓库内容进行代码分析、文件修改、命令执行及后续 Git 操作。
1. 点击输入框下方“选择仓库”。
2. 从仓库列表中选择本次需要操作的项目。 如需使用指定分支,可在仓库设置区域切换引用分支。

图 6 选择并关联代码仓库
完成选择后,输入框下方会显示当前已关联的仓库。此时即可开始第一次 AI 开发任务。
五、完成第一次 AI 开发任务
首次任务建议选择目标清晰、改动范围较小的开发需求。下面以“生成一个可直接运行的自动化测试 Demo”为例,演示完整操作过程。
示例指令
| 请基于当前仓库,生成一个简单、可直接运行的自动化测试 Demo。 |
发送后,Agent 会根据任务需要读取仓库内容,并自主进行分析、生成或修改文件、执行必要命令等操作。执行过程会在会话中持续展示。

图 7 Agent 正在读取仓库并执行开发任务
检查并完善变更
代码生成完成后,可继续要求 Agent 检查运行条件、补充说明文档或修复发现的问题,再进入提交阶段。
示例指令
| 请检查刚刚生成的 Demo,确认代码是否可以正常运行,并补充必要的 README 使用说明,包括项目用途、运行方式和主要文件说明。 |
六、提交代码变更并创建 Pull Request
完成代码检查后,建议通过独立功能分支提交变更,避免直接修改主分支。随后由华为云码道 Agent 将分支推送至 AtomGit,并创建 Pull Request。
1. 创建分支并提交变更
示例指令
| 请确认当前代码修改无明显问题,然后为本次修改创建一个新的 Git 分支并提交当前全部变更。 |
Agent 完成提交后,应能返回新建分支、Commit 以及变更文件等信息。
2. 推送分支并创建 PR
示例指令
| 请将当前分支的代码推送到 AtomGit,并基于当前修改创建一个 Pull Request。 |

图 8 由 Agent 执行推送并创建 Pull Request
| 权限提示 如果仓库访问或 PR 创建需要额外鉴权,请按照页面提示完成授权。涉及访问令牌时,应遵循最小权限和最短有效期原则,避免在公开内容中暴露敏感凭据。 |
3. 查看交付结果
PR 创建成功后,Agent 会返回 PR 地址、编号、标题、源分支、目标分支和当前状态等信息。此时无需继续执行合并操作。

图 9 Agent 返回 Pull Request 创建结果
七、在 AtomGit 验证 Pull Request
打开 Agent 返回的 PR 地址,或进入目标仓库的“Pull Requests”页面进行核验。
确认以下信息后,即可判定本次新手任务已经完整跑通:
• Pull Request 已成功创建,并显示在仓库 PR 列表中。
• 源分支为本次开发分支,目标分支为 main 或实际指定的目标分支。
• PR 标题与描述能够准确说明本次代码变更。
• PR 当前处于开启状态,尚未合并。

图 10 AtomGit 中查看已创建的 Pull Request
| 流程完成 至此,已完成“建仓 → 关联仓库 → 首次 AI 开发任务 → 代码修改 → Git 提交 → 创建 PR → AtomGit 验证”的完整链路。 |
八、额度说明
华为云码道的订阅与额度规则会随产品版本调整。自 2026 年 9 月起,新用户首次订购已切换为积分计费模式;旧版套餐中的体验版、基础版和专业版仍保留 Token 额度规则,适用于存量旧套餐。
| 旧版套餐 | Token 额度 | 额度口径 |
| 体验版 | 500 万 Tokens / 月 | 套餐内总配额(输入 + 输出) |
| 基础版 | 2000 万 Tokens / 席位 / 月 | 单席位配额(输入 + 输出) |
| 专业版 | 6000 万 Tokens / 席位 / 月 | 单席位配额(输入 + 输出) |
新用户当前应以华为云码道最新“个人订阅/企业订阅”页面显示的积分额度为准;存量旧套餐用户以账号实际套餐和官方计费页面为准。
| 注意 额度、活动福利和支持模型可能调整,正式使用时请以华为云码道官方页面的最新展示为准。 |
九、常见问题
1. Agent 无法读取仓库怎么办?
先确认当前对话已选择正确仓库和分支,并检查仓库访问权限。若页面提示需要授权,完成授权后重新执行任务。
2. Agent 已修改代码,但没有创建 PR 怎么办?
可以继续明确要求 Agent 完成“创建分支 → Commit → Push → 创建 Pull Request”,并要求返回 PR 地址和状态;如果缺少权限,让 Agent 明确提示所需授权。
3. PR 创建后是否要立即合并?
不建议在首次演示中直接合并。先在 AtomGit 查看文件变更、提交记录和 PR 描述,确认无误后再按照项目协作规范进行评审和合并。
相关官方资料
• AtomGit 帮助文档:https://docs.atomgit.com/
更多推荐



所有评论(0)