华为云码道(CodeArts)从零到上手:2026 AI 编程智能体完全入门教程

华为云码道(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 安装

  1. 双击 codearts-agent-x64-xxx.exe
  2. 阅读并同意许可协议,点击「下一步」
  3. 选择安装路径,建议用英文路径(如 D:\CodeArts
  4. 勾选「创建桌面快捷方式」
  5. 点击「安装」,完成后启动

静默安装:命令行执行 codearts-agent-x64-xxx.exe /SILENT

2.4 macOS 安装

  1. 双击 .dmg 文件,将 CodeArts IDE 拖入「应用程序」
  2. 首次打开如果提示"无法验证开发者",进入 系统设置 → 隐私与安全性,点击「仍要打开」

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 首次启动与登录

  1. 启动 CodeArts IDE,进入欢迎页面,点击「开始使用」
  2. 看到「从 VS Code 导入」选项------可选择导入快捷键/主题,也可点「跳过」
  3. 点击右上角 「登录」,浏览器自动打开华为云登录页
  4. 输入华为云账号和密码完成登录
  5. 首次使用务必勾选「我已阅读并同意协议」,点击「立即开通」激活 AI 功能
  6. 返回 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 编码之旅。