华为云码道（CodeArts）代码智能体对接使用完全指南

1. CodeArts代码智能体概述

华为云码道（CodeArts）代码智能体是华为云推出的一站式云端DevOps平台的核心智能引擎，它依托华为30年研发实践与千亿级代码库沉淀，集代码大模型、智能IDE、自主开发模式于一体。与传统AI编程工具不同，CodeArts代码智能体不仅仅是一个代码补全工具，而是一个能够理解项目需求、懂得编码之道、善用各种工具的实干派AI研发专家。

在模型层面，CodeArts代码智能体目前集成了GLM-5.0、DeepSeek-V3.2等业界领先模型，并持续进行增训，同时提供鸿蒙及昇腾专属模型。这意味着无论是开发鸿蒙原生应用还是昇腾AI应用，开发者都能获得针对性的代码生成支持。更重要的是，CodeArts支持自定义第三方模型接入，企业可以根据自身业务需求接入专属模型。

在功能覆盖上，CodeArts代码智能体提供了代码生成、研发知识问答、单元测试用例生成、专家技能Skills、代码库索引、规范驱动开发等全方位的AI编程能力。它支持项目级代码生成，能够基于整个代码仓库的上下文进行智能推理，而非仅仅依赖当前打开的文件。据华为云官方数据，同等任务下CodeArts可节省30%的Token消耗。

CodeArts代码智能体提供了四层扩展机制，开发者可以自定义智能体和子智能体，并通过MCP和Skills扩展智能体的能力边界。这种灵活的架构使得CodeArts能够适应从个人开发者到大型企业的多样化研发场景。

需要先登录华为云控制台，点击：华为云控制台，还没有账号，点击：注册并关联，已有账号点击：登录后关联

2. 环境准备与安装部署

2.1 账号注册与套餐选择

使用CodeArts代码智能体的第一步是注册华为云账号并完成实名认证。访问华为云官网，单击页面右上角的注册按钮，按照指引完成账号注册。注册成功后，建议完成实名认证，因为购买付费套餐需要实名认证。

CodeArts代码智能体提供了三种套餐规格：

• 体验版：免费，适合个人开发者体验核心功能
• 基础版：付费，支持创建云端智能体等高级功能
• 专业版：付费，支持企业级管理、自定义模型接入等完整能力

对于首次使用的开发者，建议先从体验版开始，熟悉产品功能后再根据需求升级。

2.2 IDE安装与登录

CodeArts代码智能体提供了多种使用方式，最核心的是专用IDE和插件两种形态。

专用IDE安装：访问CodeArts代码智能体官网，下载对应操作系统的安装包。对于Windows用户，双击安装程序根据界面提示完成安装即可。对于Linux（ARM64）架构用户，如果双击无法安装，可以通过命令行方式安装：

sudo dpkg -i codearts-agent-linux-***-***.deb

安装完成后，启动IDE，首次使用会进入欢迎页面。单击开始使用，选择从VS Code导入或跳过配置。随后单击登录按钮，系统会跳转至外部浏览器打开华为云登录页。输入华为账号和密码完成登录授权，页面提示登录成功后返回IDE即可开启智能编码之旅。

VS Code插件安装：对于已经习惯使用VS Code的开发者，可以直接在VS Code中安装CodeArts插件。在VS Code的扩展市场中搜索CodeArts，点击安装即可。安装后同样需要通过华为云账号登录。

PyCharm等其他IDE：CodeArts也支持通过插件方式集成到PyCharm等主流IDE中。

2.3 云端开发环境

除了本地IDE，CodeArts代码智能体还支持在华为开发者空间的云开发环境（容器）中使用。用户可以通过VS Code远程连接云开发环境，在容器中集成CodeArts Agent插件，搭建代码智能体。这种方式特别适合需要在标准化环境中进行团队协作的场景。

3. 核心功能使用详解

3.1 智能代码生成

CodeArts代码智能体最基础也是最强大的功能是智能代码生成。开发者可以通过自然语言描述需求，智能体自动生成对应的代码实现。

在IDE中，代码生成主要通过两种方式触发：

• 快捷键触发：在代码编辑器中，将光标移动至需要生成代码的位置，按下快捷键Alt+C（以Java为例），智能体会根据当前代码上下文自动生成代码
• 对话窗口触发：在研发对话窗口中输入自然语言描述，智能体会生成对应的代码

以下是一个使用CodeArts代码智能体生成Python函数的示例。假设开发者在对话窗口中输入：

帮我写一个Python函数，读取指定目录下的所有CSV文件，合并成一个DataFrame并返回

智能体会自动生成如下代码：

import pandas as pd
import os
from pathlib import Path

def merge_csv_files(directory_path: str) -> pd.DataFrame:
    """
    读取指定目录下的所有CSV文件并合并为一个DataFrame
    
    Args:
        directory_path: 目录路径
        
    Returns:
        合并后的DataFrame
    """
    all_data = []
    for file_path in Path(directory_path).glob('*.csv'):
        df = pd.read_csv(file_path)
        all_data.append(df)
    
    if all_data:
        return pd.concat(all_data, ignore_index=True)
    else:
        return pd.DataFrame()

这只是一个简单示例，实际使用中智能体可以生成更复杂的多文件项目级代码。

3.2 研发知识问答

CodeArts代码智能体不仅会写代码，还具备深厚的研发知识。开发者可以在对话窗口中提出技术问题，智能体会基于华为云的知识库和代码库给出专业解答。支持的问题类型包括：

• 框架和库的使用方法
• 设计模式和最佳实践
• 错误排查和调试建议
• 性能优化方案

与通用问答机器人不同，CodeArts可以基于当前项目的代码库索引进行上下文感知的准确检索，提供与当前项目紧密相关的解答。

3.3 单元测试用例生成

编写单元测试是保证代码质量的重要手段，但也往往是开发者最耗时的工作之一。CodeArts代码智能体可以根据已有代码自动生成单元测试用例。开发者只需选中需要生成测试的代码，右键选择CodeArts盘古助手相关菜单，或使用快捷键Ctrl+Shift+Q将代码添加至对话窗口，然后输入生成测试用例的指令即可。

3.4 代码解释、注释与翻译

CodeArts还提供了代码解释、代码注释、代码翻译、代码调试、代码检查等辅助功能。对于接手 legacy 代码或需要跨语言开发的场景，这些功能可以大幅提升效率。

4. SKILL自定义开发

4.1 SKILL的概念与架构

SKILL是CodeArts代码智能体最独特的扩展机制之一。SKILL是一种为大型语言模型获取新能力的模块化封装标准，基于渐进式披露架构设计。它将特定任务的指令、脚本与资源结构化存储为独立单元，允许模型在对话上下文中通过元数据智能识别用户意图。这种架构在保证模型轻量化响应的同时，显著扩展了其处理复杂、多步骤任务的能力。

4.2 SKILL的创建与配置

SKILL可以在两个层级进行配置：

• 项目级：仅针对当前项目生效，存储在项目根目录的./.codeartsdoer/skills路径下
• 个人级：针对当前用户下的所有项目生效，存储在本地%USERPROFILE%/.codeartsdoer/skills/路径下

创建SKILL的标准流程如下：

1. 下载skill-creator工具包（可从GitHub获取）
2. 解压后将skill-creator文件夹复制到.codeartsdoer/skills目录下
3. 在CodeArts IDE中验证SKILL是否添加成功

一个典型的SKILL目录结构如下：

.codeartsdoer/skills/
├── function_creator/
│   ├── SKILL.md          # SKILL说明文档
│   └── create_function.py # 功能实现脚本
├── trigger_creator/
│   ├── SKILL.md
│   └── create_trigger.py
└── web_generator/
    ├── SKILL.md
    └── generate_web.py

SKILL.md文件定义了SKILL的元数据、触发条件和执行逻辑，而配套的脚本文件则实现了具体的功能。

4.3 SKILL的应用场景

SKILL机制使得CodeArts代码智能体可以适应各种专业化的开发场景。例如，开发者可以创建用于数据库迁移的SKILL、用于API文档生成的SKILL、用于代码规范检查的SKILL等。华为云官方已经内置了需求管理、系统设计、软件开发、编译构建、测试验证、发布部署、开源与漏洞管理等高频场景的SKILL。

5. CodeArts MCP Server接入

5.1 MCP Server概述

CodeArts MCP Server是一个面向华为云CodeArts中国站的统一MCP Server，它将CodeArts的多个产品能力封装成标准化MCP工具，让支持MCP的AI客户端可以直接调用CodeArts能力。它解决了AI助手在参与研发流程时只能停留在看代码、写建议层面，而无法真正操作项目管理、流水线执行、构建日志查询等环节的问题。

当前CodeArts MCP Server覆盖了CodeArts的8个产品模块，共暴露419个MCP工具：

5.2 两种接入模式

CodeArts MCP Server支持两种接入模式：

本地stdio模式：适合个人开发者在本机使用。配置AK/SK后，AI客户端可以通过本地进程调用CodeArts能力。这种模式简单直接，适合个人开发测试场景。

团队共享http+session模式：适合将MCP Server部署成团队公共入口。需要特别强调的是，共享的是服务入口而非凭证，每个用户仍然使用自己的AK/SK，服务端通过session做隔离。团队共享模式还支持Cookie会话恢复、Bearer token恢复、AK/SK加密持久化、写操作per-session限流、高频读工具缓存与in-flight dedupe等高级特性。

5.3 快速启动MCP Server

使用Docker Compose可以快速启动MCP Server：

cp .env.example .env
docker compose up -d --build

核心环境变量配置示例：

MCP_TRANSPORT=http
MCP_HTTP_PORT=3000
MCP_SERVER_NAME=codearts-mcp
MCP_SERVER_VERSION=0.1.0
MCP_AUTH_MASTER_KEY=replace-with-a-long-random-secret
MCP_AUTH_DATA_PATH=.codearts-mcp/auth-store.json

在AI客户端添加MCP服务：

{
  "mcpServers": {
    "codearts-shared": {
      "type": "http",
      "url": "http://your-server-ip/mcp"
    }
  }
}

首次连接后调用鉴权接口：

{
  "access_key": "your-ak",
  "secret_key": "your-sk",
  "region": "cn-north-4"
}

连接成功后，可以使用以下读工具验证链路：

• req_list_projects：列出项目列表
• repo_list_repositories：列出代码仓库

6. 与华为云服务集成

6.1 与FunctionGraph集成构建自动化工作流

CodeArts代码智能体可以与华为云函数工作流FunctionGraph深度集成，构建多任务定时调度与管理工作流。这种集成方案解决了传统Cron任务单点故障、缺乏统一管理、运维成本高、弹性不足等痛点。

集成方案的核心思路是：通过CodeArts代码智能体生成SKILL，SKILL调用FunctionGraph的API创建函数和配置触发器，实现定时任务的云端托管、统一管理和弹性执行。具体实现步骤包括：

1. 在CodeArts中创建用于函数创建的SKILL
2. 创建用于触发器配置的SKILL
3. 创建用于Web界面生成的SKILL
4. 创建用于工作流部署的SKILL
5. 将生成的SKILL部署到项目中
6. 使用SKILL开发多任务定时调度与管理工作流

6.2 与Versatile Agent集成

CodeArts代码智能体还可以与华为云Versatile Agent平台集成，构建AI原生应用。Versatile Agent是一个AI原生应用引擎，提供了数据准备、模型选择调优、知识工程、模型编排、应用部署、应用集成等能力。

集成流程如下：

1. VS Code远程连接云开发环境
2. VS Code集成CodeArts Agent插件，搭建CodeArts代码智能体
3. 构建Versatile Agent应用，获取API调用URL和IAM用户信息
4. 与CodeArts代码智能体对话，输入URL及IAM用户信息
5. 反复测试运行并将问题提交给CodeArts进行优化

7. 命令行工具与API调用

7.1 CodeArts CLI

CodeArts提供了命令行工具（码道CLI），支持通过命令行管理智能体。主要命令包括：

• create：创建新智能体
• list：列出所有可用智能体
• describe <name>：查看指定智能体的配置详情，包括权限、工具、模型参数、提示词等

CLI工具还支持切换模型，包括内置模型和自定义模型。

7.2 REST API调用

CodeArts提供了REST风格API，支持通过HTTPS请求调用。API覆盖了CodeArts IDE客户端激活码管理、流水线执行与查询、代码检查等操作。

调用API需要先获取认证凭证，然后按照API文档构造请求。详细的API调用方法请参考华为云官方API文档。

8. 智能体管理

8.1 智能体类型与作用范围

CodeArts代码智能体支持创建多种类型的智能体，不同智能体有不同的作用范围和存储位置：

云端智能体需要基础版或专业版套餐支持。当用户登录CodeArts时，系统会在本地IDE缓存用户在云端可见的智能体，并每24小时自动刷新一次。

8.2 创建云端智能体

在CodeArts控制台的智能体中心可以创建云端智能体。创建时需要配置以下参数：

• 智能体名称：长度2~20字符，由中文、英文字母、数字、下划线和中划线组成
• 智能体类型：主智能体（独立运行）或子智能体（可被主智能体调用）
• 描述：说明智能体的功能，不超过5000字符
• 可用范围：个人、企业或团队
• 提示词：设定智能体的角色、语气、工作流程和规则规范
• 内置工具：智能体自带的开箱即用工具

9. 最佳实践与注意事项

9.1 开发效率提升建议

• 善用对话式开发：用自然语言描述需求，让智能体生成代码框架，然后在此基础上进行精细化调整
• 利用代码库索引：CodeArts的代码库索引功能可以让智能体深度理解整个代码仓库，提供更精准的上下文感知建议
• 规范驱动开发：CodeArts支持规范驱动开发模式，可以确保生成的代码符合企业规范
• 迭代式调优：通过反复对话和调试，不断优化智能体生成的结果

9.2 安全与合规

• CodeArts使用过程中的代码文件均存储在本地，数据采用加密传输
• 后续将提供审计日志看板、多语言恶意代码检测、开源片段代码版权提示等功能
• 企业用户应合理配置智能体的可用范围和权限，防止数据泄露

10. 常见问题解答

问1：CodeArts代码智能体支持哪些编程语言？

答：CodeArts代码智能体支持Java、C、C++、Python、JavaScript等主流编程语言，此外还支持鸿蒙系统官方推荐的原生应用开发语言ArkTS。

问2：体验版和付费版有什么区别？

答：体验版免费，可体验核心的代码生成和智能问答功能。基础版和专业版支持创建云端智能体、自定义模型接入、企业级管理控制台等高级功能。具体差异请参考华为云官网的套餐对比。

问3：如何将CodeArts集成到VS Code中？

答：在VS Code的扩展市场中搜索CodeArts，点击安装即可。安装后通过华为云账号登录，即可在VS Code中使用CodeArts的全部智能编码功能。

问4：SKILL和智能体有什么区别？

答：SKILL是功能模块化的封装标准，用于为智能体添加特定能力，可理解为智能体的插件或技能包。智能体则是独立的AI实体，可以包含多个SKILL，具备完整的角色设定和行为逻辑。

问5：CodeArts MCP Server适合什么场景？

答：CodeArts MCP Server适合需要将AI助手深度集成到研发流程中的场景，如自动查询项目状态、触发流水线、查看构建日志、管理代码仓库等。它让AI不仅停留在建议层面，还能真正操作系统。

问6：使用CodeArts会产生额外费用吗？

答：CodeArts体验版免费。如果使用付费套餐或与其他华为云服务（如FunctionGraph）集成，可能会产生相应费用。建议在使用前仔细阅读各服务的计费说明。