华为云码道(CodeArts)从零到上手:2026 AI 编程智能体完全入门教程
一、华为云码道是什么?
华为云码道(CodeArts) 是华为云于 2026 年推出的 AI 原生编程环境 ------它不是 VS Code 插件,而是一个独立的 AI IDE 客户端,将代码大模型、智能体自主开发、多智能体协作深度融为一体。
一句话:下载一个独立 IDE,登录华为云账号,就能让 AI 帮你从需求分析到代码交付全流程搞定。
与传统编程工具的对比
| GitHub Copilot | ChatGPT | Claude Code | 华为云码道 | |
|---|---|---|---|---|
| 产品形态 | IDE 插件 | 网页/App | CLI 命令行 | 独立 AI IDE |
| 代码生成 | 单行/函数补全 | 需手动复制 | 跨文件编辑 | 跨文件 + LSP 精准诊断 |
| 自主执行 | 不支持 | 不支持 | 单Agent | AgentTeam 多角色并行 |
| 开发模式 | 无 | 无 | 探索式 | 探索 + 规范驱动双模式 |
| 经验沉淀 | 无 | 自定义 GPTs | Skill 文件 | Skill 市场生态 |
| 鸿蒙/昇腾 | 不支持 | 不支持 | 不支持 | ArkTS 专属模型 + 昇腾生态 |
| 价格 | $10-39/月 | $20/月 | API 按量 | 体验版免费 |
二、下载与安装(五分钟上手)
2.1 系统要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10/11(64位)、macOS 11+、Linux(ARM64,glibc ≥ 2.31) |
| 内存 | 最低 4GB,推荐 8GB+ |
| 硬盘 | 至少 2GB 可用空间 |
| 网络 | 需要网络连接 |
| 浏览器 | Chrome / Edge(用于登录授权) |
2.2 下载安装包
访问华为云码道官网:**https://codearts.huaweicloud.com/download.html**,选择对应系统下载:
| 平台 | 格式 | 说明 |
|---|---|---|
| Windows x64 | .exe |
双击安装,建议纯英文路径 |
| macOS | .dmg / .zip |
拖入 Applications 文件夹 |
| Linux ARM64 | .deb |
命令行 dpkg -i 安装 |
2.3 Windows 安装
- 双击
codearts-agent-x64-xxx.exe - 阅读并同意许可协议,点击「下一步」
- 选择安装路径,建议用英文路径(如
D:\CodeArts) - 勾选「创建桌面快捷方式」
- 点击「安装」,完成后启动
静默安装:命令行执行
codearts-agent-x64-xxx.exe /SILENT
2.4 macOS 安装
- 双击
.dmg文件,将 CodeArts IDE 拖入「应用程序」 - 首次打开如果提示"无法验证开发者",进入 系统设置 → 隐私与安全性,点击「仍要打开」
2.5 Linux 安装(ARM64)
bash
wget https://cnnorth4-cloudide-marketplace.obs.cn-north-4.myhuaweicloud.com/codearts/ai/latest/codearts-agent-linux-arm64-xxx.deb
sudo dpkg -i codearts-agent-linux-arm64-xxx.deb
sudo apt-get install -f # 修复依赖
codearts-agent # 启动
2.6 首次启动与登录
- 启动 CodeArts IDE,进入欢迎页面,点击「开始使用」
- 看到「从 VS Code 导入」选项------可选择导入快捷键/主题,也可点「跳过」
- 点击右上角 「登录」,浏览器自动打开华为云登录页
- 输入华为云账号和密码完成登录
- 首次使用务必勾选「我已阅读并同意协议」,点击「立即开通」激活 AI 功能
- 返回 IDE,看到侧边栏出现蓝色码道图标,即完成配置
常见问题:浏览器未自动弹出?关闭弹窗拦截,或手动复制终端中的链接到浏览器打开。
三、界面概览与项目创建
3.1 界面布局
┌────────────────────────────────────────────┐
│ 菜单栏:文件 · 编辑 · 视图 · 终端 · 帮助 │
├────────┬───────────────────┬───────────────┤
│ │ │ 码道 AI 面板 │
│ 文件 │ │ ┌─────────┐ │
│ 资源 │ 代码编辑区 │ │ Chat │ │
│ 管理器 │ │ │ 对话窗口 │ │
│ │ │ │ │ │
│ │ │ │ [智能体] │ │
│ │ │ │ [问答] │ │
│ │ │ └─────────┘ │
├────────┴───────────────────┴───────────────┤
│ 状态栏:语言模式 · 分支 · 编码 · 通知 │
└────────────────────────────────────────────┘
3.2 创建项目
有三种方式开始工作:
| 方式 | 操作 |
|---|---|
| 新建项目 | 左上角「新建项目」→ 选存放位置 → 输入项目名(字母开头,≤64字符) |
| 克隆 Git 仓库 | 左上角「克隆仓库」→ 输入仓库 URL → 选本地路径 → 验证 |
| 打开本地文件夹 | 直接打开已有的项目文件夹,勾选「信任作者」即可 |
3.3 常用快捷键
| 功能 | Windows/Linux | macOS |
|---|---|---|
| 命令面板 | Ctrl+Shift+P |
Cmd+Shift+P |
| 文件搜索 | Ctrl+P |
Cmd+P |
| 全局搜索 | Ctrl+Shift+F |
Cmd+Shift+F |
| 打开终端 | `Ctrl+`` | `Cmd+`` |
| 格式化代码 | Shift+Alt+F |
Shift+Option+F |
四、四大核心开发模式
4.1 代码续写
编码时码道会自动理解上下文,给出补全建议:
| 操作 | Windows/Linux | macOS |
|---|---|---|
| 触发补全 | Alt+\ |
Option+\ |
| 接受建议 | Tab |
Tab |
| 逐词接受 | Ctrl+→ |
Cmd+→ |
| 取消建议 | Esc |
Esc |
| 重新生成 | Alt+R |
Option+R |
4.2 智能问答(Chat)
侧边栏聊天窗口中切换到 「问答」 模式:
- 解释代码:选中代码 → 右键 → "解释代码"
- 技术问答:直接问算法原理、框架对比、报错排查
- 多轮对话:支持连续追问,上下文保持连贯
- 一键应用:生成的代码可直接插入光标位置
4.3 智能体模式(Agent --- 自主开发)⭐
这是码道最核心的能力:AI 会自己规划、自己写代码、自己运行验证。
两种子模式
| 模式 | 适用场景 | 切换位置 |
|---|---|---|
| 探索模式(Vibe Coding) | 需求模糊、快速原型、创意试错 | 聊天框下方切换 |
| 规范驱动(Spec-Driven) | 需求明确、标准化交付的企业开发 | 聊天框下方切换 |
规范驱动开发(SDD)四阶段工作流
切换到「规范开发」模式后,Agent 按以下流程自动推进:
输入需求
↓
① 生成 spec.md(需求规格文档)
→ 人工审核确认
↓
② 生成 design.md(技术设计方案)
→ 含架构与接口描述
↓
③ 生成 tasks.md(编码任务清单)
→ 人工确认后执行
↓
④ 逐项执行编码实现
→ 自动修复报错,直到完成
斜杠命令(灵活调度)
在探索模式下,也可以用 / 命令按需调用各个阶段:
| 命令 | 功能 |
|---|---|
/sdd-new |
创建需求规格文档 |
/sdd-design |
创建技术设计方案 |
/sdd-tasks |
创建编码任务清单 |
/sdd-apply |
执行编码实现 |
实战示例
# 在智能体模式输入:
请帮我开发一个"公园植物百科"小程序:
- 游客可以扫描二维码查看植物信息
- 包含植物图鉴、AR识别、语音讲解三个功能
- 前端用 React,后端用 Node.js
# Agent 会依次:
1. 写出需求规格 spec.md → 等你确认
2. 设计技术方案 design.md → 等你确认
3. 拆解编码任务 tasks.md → 等你确认
4. 逐个实现各模块代码
4.4 Agent Space --- 多智能体与多会话
点击 IDE 左上角 模式切换 → Space,进入 Agent Space 界面:
- 多会话并行:同时进行多个对话,互不干扰
- AgentTeam 模式:Leader 拆解任务 + 多个 Teammate 并行执行
- 三栏式布局:会话管理 + 对话面板 + 工具面板
- 支持上传文件(单文件 ≤5MB,最多 5 个)
AgentTeam 实战
# 输入分角色任务:
我是一个一人公司,请分角色(产品、架构师、研发、测试、运维、QA)
阅读我的项目,阐述各角色对项目的认识及优化方向,
最后汇总输出到 docs/ 目录。
执行流程:
┌──────────────┐
│ Team Leader │ 拆解任务、分配角色
└──────┬───────┘
┌──────────────┼──────────────┐
▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌──────────┐
│ 产品经理 │ │ 架构师 │ │ 研发 │ ... 并行执行
│ 独立上下文│ │ 独立上下文│ │ 独立上下文│
└──────────┘ └──────────┘ └──────────┘
│ │ │
└──────────────┼──────────────┘
▼
┌──────────────┐
│ 汇总 Teammate│ 整合输出到 docs/
└──────────────┘
五、Skill 技能系统
5.1 Skill 是什么?
Skill 是把编码经验和最佳实践封装为可复用技能包的机制:
skill-name/
├── SKILL.md # 必填:YAML 元数据 + Markdown 指令
├── scripts/ # 可选:可执行脚本(Python / Bash)
├── references/ # 可选:参考文档、API规范
└── assets/ # 可选:模板、图标等资源
5.2 三级管理
| 级别 | 范围 | 存放位置 |
|---|---|---|
| 系统内置 | 全局生效 | 官方预设,不可修改 |
| 个人级 | 所有项目生效 | 用户自主管理 |
| 项目级 | 仅当前项目 | .codeartsdoer/skills/ |
5.3 使用 Skill
/命令调用 :在聊天框输入/,从菜单中选取技能(最多同时选 20 个)- 自然语言触发:输入包含技能名称的描述,自动匹配
- 导入技能包:在「设置 → 技能与规则 → 个人级」点击「导入」上传 ZIP
码道的 SKILL.md 格式和 Claude Code 互相兼容,同一份 Skill 文件可在两个平台无缝迁移。
5.4 实战:创建天气查询 Skill
第一步:创建目录结构
bash
mkdir weather-skill
cd weather-skill
第二步:编写 SKILL.md
markdown
---
name: weather-query
description: 查询指定城市的实时天气和未来天气预报
---
# 天气查询技能
## 使用方式
用户提供城市名称,我会调用 API 获取天气数据并格式化展示。
## 步骤
1. 确认用户提供的城市名称
2. 调用天气 API 查询
3. 输出:温度、湿度、风速、天气状况
4. 查询失败时提示用户检查城市名称
第三步 :编写查询脚本 scripts/weather.py
python
import json, sys, urllib.request
def get_weather(city, api_key):
url = f"http://api.openweathermap.org/data/2.5/weather?q={city}&appid={api_key}&units=metric&lang=zh_cn"
with urllib.request.urlopen(url) as resp:
data = json.loads(resp.read())
return {
"城市": data["name"], "温度": f"{data['main']['temp']}°C",
"湿度": f"{data['main']['humidity']}%", "天气": data["weather"][0]["description"],
}
if __name__ == "__main__":
city = sys.argv[1] if len(sys.argv) > 1 else "Beijing"
for k, v in get_weather(city, "YOUR_KEY").items():
print(f"{k}: {v}")
第四步 :打包为 weather-skill.zip,在码道设置中导入。
六、支持的模型与语言
| 维度 | 详情 |
|---|---|
| 接入模型 | GLM-5.0/5.1、DeepSeek-V3.2、华为自研模型 |
| 专属模型 | 鸿蒙 ArkTS 专属模型、昇腾生态优化 |
| 编程语言 | Java、Python、Go、JS/TS、C/C++、ArkTS 等 30+ 语言 |
| LSP 深度集成 | Java、TypeScript/JavaScript、Go |
| Codebase 索引 | 支持千万行级大仓库的端云协同理解 |
七、套餐与定价
| 套餐 | 价格 | 适用场景 |
|---|---|---|
| 体验版 | 免费 | 个人学习、新手入门(无需实名认证) |
| 基础版 | 需实名后购买 | 日常开发、小团队协作 |
| 专业版 | 需实名后购买 | 企业开发、大型项目 |
| 企业版 | 咨询服务 | 私有部署、定制化需求 |
八、常见问题 FAQ
Q: 和 VS Code 插件版有什么区别?
A: 独立 IDE 版功能更完整,AI 能力与编辑器深度集成,体验更流畅。VS Code 插件版是精简版。推荐使用独立 IDE。
Q: 代码安全吗?
A: 代码文件本地存储,云端数据"用后即焚"。高风险命令需用户二次确认。已通过等保三级、GDPR 合规认证。
Q: 支持 JetBrains 系列 IDE 吗?
A: 支持。在 JetBrains 插件市场搜索 "CodeArts Agent" 安装。但完整功能推荐使用独立 IDE。
Q: 鸿蒙开发支持如何?
A: 码道的核心优势之一。内置 ArkTS 专属模型,对鸿蒙 API 的理解和代码生成质量远超通用模型。华为开发者训练营设有鸿蒙开发专属课程。
Q: 能离线使用吗?
A: 目前需要网络连接。代码补全和 LSP 分析在本地执行,AI 推理在云端。
Q: 和 Claude Code 的关系?
A: 码道优势在 AgentTeam 多智能体协作、鸿蒙生态适配、SDD 规范驱动开发流程。Claude Code 优势在单 Agent 编码流畅度。两者 Skill 格式互通,可以配合使用。
九、学习路径建议
| 阶段 | 内容 | 预计时间 |
|---|---|---|
| Day 1 | 下载安装 IDE → 登录激活 → 创建项目 → 体验代码续写和问答 | 30 分钟 |
| Day 2 | 智能体模式:用探索模式快速做一个小功能 | 1 小时 |
| Day 3 | 规范驱动模式:体验 SDD 完整四阶段流程 | 1.5 小时 |
| Day 4 | Agent Space:切换 Space 模式,体验 AgentTeam 多角色协作 | 1 小时 |
| Day 5 | 创建/导入一个自定义 Skill,结合 Agent 完成综合实战 | 2 小时 |
华为云码道正在快速迭代中(当前截至 2026年7月),建议关注 华为云开发者论坛 获取最新动态和训练营活动。打开官网下载独立 IDE,免费体验版就能开始你的 AI 编码之旅。