华为云码道（CodeArts）使用指南

华为云码道（CodeArts）是华为云推出的 AI 原生智能编码工具。其核心架构基于 AI IDE+代码智能体+项目级代码库理解，旨在帮助企业实现全流程研发提效与企业级规范安全管理。

一、主要功能

• 项目级代码生成：支持跨文件生成多语言代码，能够适配复杂项目架构并实现多文件同步变更。
• 代码续写与补全：具备上下文感知能力，提供智能续写、函数级/行级补全，显著提升编码流畅度。
• 研发知识问答：基于项目上下文提供需求、编码、测试、发布等端到端问答，支持接入私域知识库。
• 单元测试生成：支持 JUnit/Pytest 等主流框架，可自动生成方法或类级别的测试用例并进行智能修复。
• 代码注释与重构：能够自动生成注释、优化代码结构、清理冗余代码，有效提升代码可读性与可维护性。
• 双模开发模式：
• 探索模式：快速验证开发思路。
• 规范模式：集成编码规范与安全检查，保障代码质量。
• 代码库索引（Codebase）：支持深度理解千万行级代码库，实现精准检索与更快更准的代码生成。
• 多模型支持：内置 GLM-4.7/5/5.1、DeepSeek-V3.2 等模型，包含适配鸿蒙的 GLM-4.7-ArkTS-SPARK 模型。
• 内置华为专家技能（Skills）：提供开箱即用的华为研发最佳实践，覆盖架构、编码、测试、部署等环节。

二、适用人群

1. 个人开发者/学生：享受免费使用权益，适合快速学习、原型开发及日常编码提效。
2. 小团队/初创公司：适合低成本引入 AI 研发能力，帮助对齐编码规范，提升团队协作效率。
3. 企业研发团队：适配企业级流程与规范，支持鸿蒙生态，保障代码安全与合规。
4. 鸿蒙开发者：深度适配 ArkTS 语言，优化鸿蒙开发场景，提升特定领域开发效率。
5. 从 Copilot/Cursor 迁移的用户：核心能力对齐，拥有更好的中文理解能力，无需翻墙即可使用。

三、免费与付费情况

1. 当前版本状态（截至 2026.5.24）

• 个人版公测：完全免费，无功能与时长限制。
• 团队支持：支持最多 50 人团队协作（26.4.1 版起）。

2. 商用计划（2026.5.30 起）

• 体验版：原公测版自动转入，永久免费，保留核心能力。
• 基础版/专业版：需付费订阅，提供高级功能、企业级 SLA 及技术支持（具体价格待公布）。

3. 版权与数据隐私

• 代码版权：AI 生成的代码版权归用户所有。
• 数据安全：不存储用户代码数据，仅用于当次交互，并实施严格权限控制。

四、如何使用

方式 1：独立 IDE（推荐新手）

1. 访问官网下载安装包：https://codearts.huaweicloud.com/。
2. 安装并启动客户端，可选择从 VS Code 导入配置。
3. 使用华为账号登录并开通个人版服务，打开项目文件夹。
4. 在界面打开 AI 侧栏，切换至智能体模式，输入需求（如“生成 Web 日历”），AI 将自主规划并执行。

方式 2：VS Code 插件

1. 在 VS Code 扩展市场搜索“CodeArts Agent"并进行安装。
2. 在侧边栏打开插件，使用华为账号登录并开通服务。
3. 打开项目文件，在 AI 侧栏发起对话，支持代码生成、补全、测试等功能。

方式 3：JetBrains 系列（IDEA/PyCharm 等）

1. 在插件市场搜索“CodeArts Agent”安装并重启 IDE。
2. 在侧边栏打开插件，完成登录与开通流程。
3. 即可使用智能体对话、单元测试生成等核心功能。

五、避坑点与最佳实践

1. 网络与登录问题

• 请求超时/代理错误：请检查 hosts 与 IDE 代理配置；公司内网环境需配置代理；如遇问题可尝试重置网络（netsh winsock reset）后重试。
• 登录失败：确认账号权限，企业 IAM 用户需管理员授权；请务必更新到最新版客户端。

2. 项目与上下文管理

• 大型项目索引慢：首次使用建议先完成全项目 Codebase 索引；大量变更后可重新索引；微服务项目建议按单服务索引，避免全仓库扫描。
• 上下文混乱：使用 @文件名/类名 明确参考范围；复杂任务拆分为 spec.md→design.md→tasks.md 分步执行；同一会话集中处理相关任务，减少新会话开销。

3. 模型与技能选择

• 模型匹配：鸿蒙开发场景优选 GLM-4.7-ArkTS-SPARK；通用场景选 DeepSeek-V3.2；复杂推理任务优先 GLM-5.1。
• 技能使用：自定义 Skill 命名遵循“动词 + 名词”；描述需清晰精准，避免模糊触发；建议将团队规范沉淀为 Skill，无需每次重复说明。

4. 安全与权限

• 文件修改限制：仅允许修改当前项目目录内非点文件（.env/.gitignore 等受保护文件除外）；严格遵循最小权限原则。
• 代码质量风险：生成代码必须人工 Review；规范模式下开启安全检查；涉及敏感逻辑（如支付/鉴权）避免直接生成。

5. 成本与效率优化

• Token 浪费：避免粘贴大段代码；精准指定函数或方法；分步实现复杂需求；利用 Codebase 索引减少冗余输入。
• 过度依赖 AI：需求阶段先明确范围与验收标准；AI 生成后需主动优化与调试；核心逻辑建议保留人工编写与审查。