在 Deepin Linux 上安装华为云码道 CodeArts CLI

华为云码道 CodeArts CLI 是终端形态的 AI 编码工具，安装后可以在 Linux 终端里完成代码生成、代码解释、Git 操作、单元测试生成等任务。它不需要打开 IDE，适合在 Deepin 终端、远程服务器或容器里快速使用。

本文记录在 Deepin Linux 上安装 CodeArts CLI 的流程。

环境说明

• 操作系统：Deepin Linux
• 安装方式：官方一键安装脚本
• 适用场景：本地 Deepin 终端、远程 Linux 服务器
• 前置条件：
  • 已安装 curl
  • 网络可以访问华为云 OBS 地址
  • 拥有华为云账号，并已开通码道 CodeArts 服务

如果终端提示缺少 curl，可以先安装：

sudo apt update
sudo apt install -y curl

安装 CodeArts CLI

在 Deepin 终端中执行：

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

安装完成后，建议把路径写入 ~/.bashrc 或 ~/.zshrc，避免每次重新打开终端都要手动设置：

echo 'export PATH=~/.codeartsdoer/installers:$PATH' >> ~/.bashrc
source ~/.bashrc

如果你使用的是 zsh，则改为：

echo 'export PATH=~/.codeartsdoer/installers:$PATH' >> ~/.zshrc
source ~/.zshrc

验证安装是否成功：

codearts --version

如果能正常输出版本号，说明安装完成。

配置 AK/SK 授权

CodeArts CLI 支持浏览器登录授权和 AK/SK 环境变量授权。在 Deepin 终端里，如果只是本地使用，浏览器授权比较方便；如果要在脚本、远程终端或自动化场景中使用，推荐使用 AK/SK 环境变量。

先在华为云控制台获取 Access Key 和 Secret Access Key，然后执行：

echo 'export CODEARTS_CLI_AK="你的Access Key Id"' >> ~/.bashrc
echo 'export CODEARTS_CLI_SK="你的Secret Access Key"' >> ~/.bashrc
source ~/.bashrc

配置完成后验证授权：

codearts models

如果返回模型列表，说明授权成功。

注意：AK/SK 属于敏感凭证，不要提交到 Git 仓库，也不要直接写在项目配置文件里。

使用 CodeArts CLI

进入项目目录后，可以直接启动 TUI 交互模式：

cd ~/my-project
codearts

也可以指定模型进入：

codearts -m huaweicloud-maas/GLM-5.2

如果只是执行单条任务，可以使用 run 模式：

codearts run "解释当前目录下的 main.go"

常用命令：

codearts models
codearts
codearts run "生成一个 Go Web 服务脚手架"
codearts help
codearts stats
codearts session list
codearts upgrade
codearts uninstall

其中：

• codearts models：查看可用模型
• codearts stats：查看 Token 用量
• codearts session list：查看历史会话
• codearts upgrade：升级 CLI
• codearts uninstall：卸载 CLI

Deepin 环境注意事项

Deepin 基于 Debian 系，包管理使用 apt。日常安装依赖时可以用：

sudo apt update
sudo apt install -y curl git

如果后续要在本地项目里配合 CLI 做代码生成、构建或 Git 操作，建议确认 git、对应语言运行时、构建工具是否已经安装。

如果遇到权限问题，例如提示无法写入 ~/.codeartsdoer，可以检查目录归属：

sudo chown -R $(whoami):$(whoami) ~/.codeartsdoer

常见问题

小结

在 Deepin Linux 上安装 CodeArts CLI 的核心步骤仍然是：执行官方安装脚本、配置 PATH、设置 AK/SK 授权。相比 IDE 插件，CLI 更适合终端工作流，也方便后续封装成脚本使用。

如果后续需要结合 CI/CD 或自动化脚本，可以把 codearts run 写进 Shell 脚本，但要注意保护好 AK/SK，避免泄露到日志或版本控制系统中。