2026华为AI码道 CodeArts 使用分享:Windows端 + 服务器CLI 实战总结

华为AI码道 CodeArts 使用分享:Windows端 + 服务器CLI 实战总结

文章目录

一、前言

目前让AI自主分析修改代码,已经有很多工具和模型了,国外的模型基本用不了,

工具的话,国内主要用TREA、Kiro 等,里面可以选择不同的国内算法模型。

最近华为也推出了码道CodeArts,有需要的可以用看看,推广期间还是有比较多免费积分和每天送的积分的。

华为云码道 CodeArts 代码智能体是华为推出的 AI 编程助手,

类似于 Cursor、Claude Code、TREA Code这类工具,

可以通过对话的方式让 AI 自动完成需求分析、代码编写、调试修复、代码评审等研发工作。

新手常见的几个误区:

  1. 以为码道只是一个 IDE 插件,实际上它有桌面端(Space)、独立 IDE、VS Code/JetBrains 插件、CLI 命令行、网页端等多种形态,覆盖不同的使用场景;

  2. 以为必须付费才能用,实际上注册华为账号后授权时会自动开通免费的个人体验版套餐,日常体验完全够用,不够再升级基础版/专业版/企业版;

  3. 以为 AI 编程工具只能在本地图形界面用,实际上码道 CLI 可以装在 Linux 服务器上,通过 SSH 远程终端就能让 AI 直接改服务器上的代码,这一点对后端和运维同学非常实用。

这里把码道 CodeArts 在 Windows 端的使用方法,以及在服务器上用 CLI 开发的流程做个简单总结,方便大家快速上手。

二、安装使用过程

1、产品形态一览

码道 CodeArts 目前主要有这么几种形态,按需选择即可:

形态 适用场景 说明
码道 Space 桌面端 泛研发/办公一站式 AI 工作台 独立桌面应用,内置 AI 专家、技能、浏览器、代码编辑器,支持任务看板和定时任务
码道 IDE 独立 AI 编程 IDE 内置智能体对话、代码生成、Diff 视图等
VS Code 插件 已有 VS Code 的开发者 插件市场搜索 CodeArts Agent 安装
JetBrains 插件 IDEA 等 JetBrains 系 IDE 用户 支持 22.3 及以上版本
码道 CLI 服务器/远程终端/脚本化场景 命令行 TUI 交互,支持非交互 run 模式
网页端 不想装任何客户端 浏览器直接用

准备工作统一是:

  1. 注册华为账号(有华为云账号可直接用);

  2. 进入码道官网下载对应客户端:https://codearts.huaweicloud.com/download.html

  3. 首次登录授权后会自动开通个人体验版套餐;需要更多用量可购买基础版/专业版,企业多人使用可买企业版多席位。

其实一般就是在Windows端打开目录修改代码;或者在代码服务器CLI模式直接修改代码。

2、Windows 桌面端使用

(1)安装登录
  1. 进入官网下载页,下载 Windows 版安装包(x64,建议 Windows 10 2019+ 或 Windows 11);

  2. 双击安装程序,根据界面提示完成安装;

  3. 启动后单击"华为账号登录",会跳转到外部浏览器的华为云登录页;

  4. 输入账号密码登录,在授权页面单击"确认授权";

  5. 提示登录成功后返回客户端,即可开始使用。

(2)基本使用

登录后进入"新建任务"页面,直接用自然语言描述需求即可,例如:

text 复制代码
生成一个轻量化音乐播放器,简约干净、主打深色系沉浸式设计

码道会自主完成整个工作流:拆解任务 → 生成/修改代码 → 执行验证,最后给出可预览的产物。桌面端内置了代码编辑器和浏览器预览,生成的网页类应用可以直接看效果。

智能体有两种开发模式:

  • 氛围编程(Vibe-Coding):边聊边做,即时验证,适合从模糊想法快速做出原型;

  • 规范开发(Spec-Driven):先生成 spec.md 需求规格 → design.md 技术设计 → tasks.md 任务清单,再逐项执行编码,适合对一致性要求高的正式项目。

3、VS Code / JetBrains 插件使用

如果不想换 IDE,直接装插件即可。

VS Code 安装步骤:

  1. 打开 VS Code,点击左侧"扩展";

  2. 搜索 CodeArts Agent,找到后点击安装;

  3. 重启 VS Code,登录华为云账号完成授权。

JetBrains(IDEA 为例)安装步骤:

  1. 打开设置(Windows:File > Settings);

  2. 进入 插件 > Marketplace,搜索 CodeArts Agent 安装;

  3. 重启 IDEA,登录华为云账号。

插件装好后,在聊天窗口切换到"智能体"模式,就可以让它跨文件改代码、跑命令、生成单元测试了。常用的斜杠命令(在输入框输入 / 唤出):

命令 说明
/init 一键为项目生成研发规范配置文件 Agent.md
/explain 解释代码的功能、逻辑、使用场景
/optimize 分析性能瓶颈并给出优化建议
/comment 自动生成代码注释
/tests 按 JUnit/pytest/unittest 等框架生成单元测试
/review 代码评审,自动识别问题并修复
/sdd-new 生成需求规格文档 spec.md
/sdd-design 基于 spec.md 生成技术设计 design.md
/sdd-tasks 生成编码任务清单 tasks.md
/sdd-apply tasks.md 逐项执行编码
/bugfix 根据问题单描述自动修复代码

4、Windows 下 CLI 安装与授权

CLI 适合喜欢终端操作、或者要写脚本集成的同学。Windows 下只能通过 PowerShell 安装。

(1)安装

在项目目录右键选择"在终端中打开"(自动打开 PowerShell),执行:

powershell 复制代码
irm https://cnnorth4-cloudide-marketplace.obs.cn-north-4.myhuaweicloud.com/codearts/cli_tui/install_script/install.ps1 | iex

安装完成后回显版本号即表示成功,可用 codearts --version 验证。

(2)授权

CLI 基于 AK/SK 鉴权,支持两种方式。

方式一:浏览器登录授权(简单,仅当前窗口生效)。在终端执行 codearts,未登录状态会自动跳转浏览器完成华为云登录授权。

方式二:AK/SK 环境变量授权(可永久生效)。

先到华为云控制台"访问密钥"页面新建 AK/SK,下载 credentials.csv 保存好(弹窗关闭后无法再次查看)。

进程级临时授权(PowerShell):

powershell 复制代码
$env:CODEARTS_CLI_AK="你的Access Key Id"
$env:CODEARTS_CLI_SK="你的Secret Access Key"

永久授权:打开"系统属性 > 高级 > 环境变量",在用户变量中新建 CODEARTS_CLI_AKCODEARTS_CLI_SK 两个变量,重启终端后生效。

验证:执行 codearts models,能回显模型列表说明授权成功。

5、服务器(Linux)CLI 使用

这是我认为最有价值的场景:SSH 连上服务器,让 AI 直接在服务器上改代码、跑构建、修问题,不用把代码来回同步到本地。

(1)安装

公司内网环境先配置代理,然后在终端执行:

bash 复制代码
sh -c "$(curl -L https://cnnorth4-cloudide-marketplace.obs.cn-north-4.myhuaweicloud.com/codearts/cli_tui/install_script/install.sh)" && export PATH=~/.codeartsdoer/installers:$PATH

安装成功会回显版本号。建议把 PATH 写入 ~/.bashrc

bash 复制代码
echo 'export PATH=~/.codeartsdoer/installers:$PATH' >> ~/.bashrc
source ~/.bashrc

(2)授权

推荐用 AK/SK 环境变量方式,写进 shell 配置文件永久生效:

bash 复制代码
echo 'export CODEARTS_CLI_AK="你的Access Key Id"' >> ~/.bashrc
echo 'export CODEARTS_CLI_SK="你的Secret Access Key"' >> ~/.bashrc
source ~/.bashrc

验证授权:

bash 复制代码
codearts models

如果回显 model_id model_name 的模型列表,说明授权生效。

(3)模型查询与指定

CLI 内置了多款模型,通过 codearts models 可以查询,通过 -m 参数可以指定使用哪个模型:

bash 复制代码
# 查询内嵌模型列表
codearts models

# 一次性使用指定模型进入 TUI 交互环境
codearts -m huaweicloud-maas/GLM-5.2

# 使用指定模型问单一问题(非交互模式)
codearts run -m huaweicloud-maas/GLM-5.2 "你都会啥"

codearts models 回显的 model_id 就是 -m 后面要填的值,换模型只需要换这个参数,Windows PowerShell 和 Linux 终端下用法一致。

(4)交互模式(TUI)

进入项目目录,执行 codearts 即可进入 TUI 开发环境:

bash 复制代码
cd /home/user/my-project
codearts

然后直接下发需求,例如官方快速入门的例子:

text 复制代码
请用HTML编写一个贪吃蛇游戏

首次执行文件操作时会询问权限,选择 Allow always(永久授权)后 AI 就能自动读写文件、执行命令,任务完成后告诉你产物位置。

(5)非交互模式(脚本集成)

codearts run 可以直接传提示词、执行完输出结果,适合写进 shell 脚本或 CI 流程:

bash 复制代码
# 让 AI 分析当前目录代码
codearts run "分析当前项目的目录结构,输出模块说明"

# 结合管道使用
codearts run "阅读这个报错日志并定位原因" < error.log

(6)常用命令

在 CMD、PowerShell 或 Linux 终端执行 codearts [command]

命令 描述
codearts 进入 TUI 交互开发环境
codearts project 启动指定项目的 TUI 开发环境
codearts -m <model_id> 一次性使用指定模型进入 TUI 开发环境
codearts run message 非交互模式,直接执行提示词
codearts run -m <model_id> message 使用指定模型执行非交互任务
codearts help 查看命令帮助
codearts models 列出内嵌可用模型
codearts agent create/list 创建/列出智能体
codearts mcp 管理 MCP 服务器
codearts stats 查看 Token 使用量和成本统计
codearts session list/delete 管理/删除会话
codearts export sessionID 以 JSON 导出会话数据
codearts codebase 创建云端代码索引
codearts serve 启动无界面服务器(需先配置密码环境变量)
codearts upgrade / uninstall 升级 / 卸载
codearts --version 查看版本号

华为码道在服务器中可选的AI模型是比较少的,如下图所示:

上面已经是Andorid系统服务器代码环境,可以直接进入编辑窗口让它分析代码问题。

CLI模式目前只有GLM 和 华为的盘古模型。后面估计会兼容多一点模型。

6、常见问题与踩坑

先说一个重要的注意点:码道的 AI 是在沙箱(Sandbox)模式下执行命令的,并不是直接跑在你的本机/服务器环境里,所以有些操作它做不到:

  1. Windows 端:沙箱环境不能获取实时信息,比如系统当前时间、本机实时状态、剪贴板内容等,AI 给出的这类信息可能不准,最好自己把实时数据贴给它;

  2. Linux CLI 模式:沙箱内无法执行 git 查询类操作(git log、git diff、git status 等),AI 拿不到代码的具体修改记录,让它"看看最近改了什么"、"分析下这次提交"这类需求会失败;

  3. 沙箱内环境和你的真实终端不完全一致,涉及本机环境变量、本地服务、实时数据的操作都可能受限,遇到"AI 说做了但实际没生效"的情况,先想想是不是沙箱限制。

常见问题排查表:

现象 原因 处理
执行 codearts 提示未授权/跳转登录 未配置 AK/SK,或环境变量未生效 按第 4/5 节配置环境变量,重开终端验证 codearts models
echo %CODEARTS_CLI_AK% 显示变量名本身 CMD 中 set 命令没执行成功,或变量名打错 重新 set,注意不要有多余空格
Linux 安装后提示 command not found PATH 未包含安装目录 export PATH=~/.codeartsdoer/installers:$PATH 并写入 ~/.bashrc
内网环境安装/登录失败 公司网络代理拦截 按官方文档"配置代理"章节设置代理后再安装
浏览器授权页面没弹出来 被弹窗拦截 关闭弹窗拦截,或手动复制终端里的登录链接到浏览器打开
提示套餐/用量问题 免费体验版用量有限 首次授权自动开通体验版;不够用在订阅管理升级套餐
IDE 插件安装后看不到聊天窗口 AI 侧栏被收起 顶部菜单栏右上角点"展开AI侧栏"图标
AI 拿不到实时信息/时间不对 沙箱模式无法获取实时数据 把实时信息直接贴在提示词里给 AI
Linux CLI 下 git log/diff 查不到代码修改 沙箱限制 git 查询类命令 手动执行 git 命令后把输出贴给 AI,或直接描述改动内容

三、其他

1、小结

  1. 码道 CodeArts 是华为云的 AI 编程智能体,形态覆盖桌面端(Space)、独立 IDE、VS Code/JetBrains 插件、CLI 和网页端,按场景选择即可;

  2. 注册华为账号即可免费用,首次授权自动开通个人体验版套餐,不够再升级;

  3. Windows 端流程:官网下载安装包 → 双击安装 → 华为账号浏览器授权 → 自然语言下发任务;插件用户在扩展市场搜 CodeArts Agent 安装即可;

  4. CLI 是服务器场景的利器:Linux 上一条 curl 脚本安装,AK/SK 写环境变量永久授权,codearts 进 TUI 交互,codearts run 做脚本化非交互执行;

  5. 智能体支持氛围编程(Vibe-Coding)和规范开发(Spec-Driven)两种模式,斜杠命令 /init/review/sdd-*/tests 等可以覆盖需求 → 设计 → 编码 → 测试 → 评审全流程;

  6. 密钥安全要注意:AK/SK 创建后立即下载保存,弹窗关闭无法再查看;公共机器上建议只做进程级临时授权,用完即失效;

  7. 码道 AI 在沙箱模式下执行命令:Windows 端拿不到实时信息,Linux CLI 下 git 查询受限、获取不到代码具体修改,涉及实时数据/git 记录的任务,建议把信息直接贴给 AI。

简单的说华为的AI工具和模型,并不是很成熟,能简单用一下。

2、每天送积分活动

登录在线版码道代码智能体:

https://devcloud.cn-north-4.huaweicloud.com/chat/home

除了注册会送几千积分,每天可以领1000积分,正常是用不完的。啥时候活动结束就不知道了。

网页版本和window版本可以选的AI算法模型多一点,但是也不是很多,如下图所示:

比代码服务器CLI窗口都几个。

3、常用命令速查

bash 复制代码
# ===== 安装 =====
# Windows PowerShell 安装 CLI
irm https://cnnorth4-cloudide-marketplace.obs.cn-north-4.myhuaweicloud.com/codearts/cli_tui/install_script/install.ps1 | iex

# Linux/macOS 安装 CLI
sh -c "$(curl -L https://cnnorth4-cloudide-marketplace.obs.cn-north-4.myhuaweicloud.com/codearts/cli_tui/install_script/install.sh)" && export PATH=~/.codeartsdoer/installers:$PATH

# ===== 授权(AK/SK)=====
# Linux 永久授权
export CODEARTS_CLI_AK="你的AK"
export CODEARTS_CLI_SK="你的SK"
echo 'export CODEARTS_CLI_AK="你的AK"' >> ~/.bashrc
echo 'export CODEARTS_CLI_SK="你的SK"' >> ~/.bashrc
source ~/.bashrc

# Windows PowerShell 临时授权
$env:CODEARTS_CLI_AK="你的AK"
$env:CODEARTS_CLI_SK="你的SK"

# 验证授权
codearts models

# ===== 日常使用 =====
codearts                  # 进入 TUI 交互开发
codearts /path/to/project # 指定项目进入 TUI
codearts run "需求描述"    # 非交互执行任务
codearts help             # 查看帮助
codearts stats            # 查看Token用量
codearts session list     # 查看历史会话
codearts --version        # 查看版本

# ===== 模型查询与指定 =====
codearts models                              # 查询内嵌模型列表
codearts -m huaweicloud-maas/GLM-5.2         # 一次性使用指定模型进入 TUI
codearts run -m huaweicloud-maas/GLM-5.2 "你都会啥"  # 指定模型问单一问题

# ===== 升级/卸载 =====
codearts upgrade          # 升级到最新版本
codearts uninstall        # 卸载 CLI

以上就是华为 AI 码道 CodeArts 的使用分享,整体体验下来和主流 AI 编程工具的思路一致,但服务器 CLI 场景对后端同学比较友好,感兴趣的可以到官网下载体验。有问题欢迎评论区交流。

相关推荐
贝猫说python1 小时前
阿里云部署qwen 大模型从0-1,第3步:阿里云服务器上部署大模型
python
少陽君1 小时前
服务器服务检查报告
python
x秀x1 小时前
sam3新手使用教程
开发语言·python
Java后端的Ai之路1 小时前
大模型LLM评估完全指南
开发语言·人工智能·python·llm·评估
外收内放1 小时前
Python学习记录25(基础知识终结篇)
python·学习
别动我齐刘海1 小时前
ROS2 Jazzy + C++ 实战路线——基础学习1
c++·vscode·python·ubuntu·机器学习·自动驾驶·github
Brilliantwxx1 小时前
【STM32】 从HAL库源码深度解析I2C(源码解析+面试题)
开发语言·stm32·单片机·嵌入式硬件·架构
life码农1 小时前
python框架Flask多语言配置示例
python·flask
yxlalm1 小时前
对话记忆持久化-Redis热与MySQL冷
android·redis·mysql