在 Deepin Linux 上安装 CodeArts CLI

CodeArts CLI 是华为云码道 CodeArts 的终端版 AI 编码工具。安装后，你可以直接在 Deepin Linux 终端里进行代码生成、代码解释、Git 操作、单元测试生成等任务，不需要打开 IDE。

Deepin Linux 基于 Debian 系，日常使用 apt 管理软件包，因此安装 CodeArts CLI 的整体流程与 Debian / Ubuntu 类系统比较接近。

环境说明

本文环境：

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

如果你还没有开通服务，需要先到华为云码道 CodeArts 官网开通对应套餐。

1. 安装前置依赖

Deepin Linux 通常自带 curl，但如果你使用的是最小化安装，建议先确认一下。

更新软件源并安装 curl：

sudo apt update
sudo apt install -y curl

如果后续还需要做代码管理或项目构建，可以一并安装常用工具：

sudo apt install -y git

2. 执行官方安装脚本

在 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

这条命令会完成两件事：

1. 下载并执行 CodeArts CLI 官方安装脚本
2. 把安装目录加入当前终端的 PATH

安装完成后，CLI 文件一般会放到：

~/.codeartsdoer/installers

3. 把 PATH 写入 Shell 配置文件

为了避免每次重新打开终端都手动执行 export PATH，建议把路径写入配置文件。

如果你使用的是默认 bash：

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

如果你使用的是 zsh：

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

可以通过下面命令确认当前 Shell：

echo $SHELL

如果输出类似：

/bin/bash

就写入 ~/.bashrc；如果是：

/bin/zsh

就写入 ~/.zshrc。

4. 验证安装是否成功

执行：

codearts --version

如果能正常输出版本号，说明 CodeArts CLI 已经安装成功。

如果提示：

codearts: command not found

通常是 PATH 没有生效，可以执行：

source ~/.bashrc

或者：

source ~/.zshrc

然后再试一次。

5. 配置 AK/SK 授权

CodeArts CLI 支持两种授权方式：

• 浏览器登录授权
• AK/SK 环境变量授权

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

先在华为云控制台获取：

• Access Key Id
• Secret Access Key

然后执行：

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

如果你使用的是 zsh，把 ~/.bashrc 改成 ~/.zshrc。

配置完成后，验证授权：

codearts models

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

注意：AK/SK 属于敏感凭证，不要提交到 Git 仓库，也不要写进项目配置文件或公开日志中。

6. 基本使用方法

进入你的项目目录：

cd ~/my-project

启动 CodeArts CLI 交互模式：

codearts

也可以指定模型：

codearts -m huaweicloud-maas/GLM-5.2

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

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

常用命令：

codearts models

查看可用模型。

codearts

进入交互模式。

codearts run "生成一个 Python Flask 接口示例"

执行单条自然语言任务。

codearts stats

查看 Token 用量。

codearts session list

查看历史会话。

codearts upgrade

手动升级 CLI。

codearts uninstall

卸载 CLI。

7. Deepin Linux 环境注意事项

Deepin Linux 是面向桌面使用的 Linux 发行版，安装 CodeArts CLI 时建议注意以下几点：

1. 建议使用普通用户安装
   不建议直接使用 root 安装，否则可能导致 ~/.codeartsdoer 目录权限异常。

2. 检查目录权限
   如果提示无法写入安装目录，可以修复权限：

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

3. 确认网络环境
   安装脚本需要从华为云 OBS 下载文件，如果公司网络、校园网或代理环境有限制，可能会下载失败。

4. 不要泄露 AK/SK
   不要把密钥写进项目代码、脚本或公开日志中。

8. 常见问题

小结

在 Deepin Linux 上安装 CodeArts CLI 的核心流程很简单：

1. 安装 curl
2. 执行官方安装脚本
3. 配置 PATH
4. 配置 AK/SK 授权
5. 使用 codearts 或 codearts run 开始使用

相比 IDE 插件，CodeArts CLI 更适合终端工作流，也适合放到脚本、远程终端或自动化任务中使用。如果你经常在 Deepin 终端里做开发、调试或代码分析，可以把 codearts run 封装进 Shell 脚本，但一定要注意保护好 AK/SK，避免泄露到 Git 仓库或日志文件中。