在 Linux Mint 上安装华为云 CodeArts CLI 完整教程

对于习惯在终端下工作的开发者来说，CLI 工具往往比图形界面更加高效。华为云 CodeArts CLI（码道 CLI）正是这样一款将 AI 编码能力直接注入命令行的工具——无需离开终端，用自然语言就能驱动 AI 完成代码编写、分析、优化等任务。

本文将详细介绍如何在 Linux Mint 上安装、配置和使用 CodeArts CLI。

前置准备

在开始之前，请确保：

• 你的 Linux Mint 系统可以正常访问互联网
• 已安装 curl 命令（Mint 默认自带）
• 已注册华为云账号并开通 CodeArts 代码智能体服务（体验版免费）

系统兼容性说明：根据官方文档，CodeArts CLI 明确支持的 Linux 发行版包括 Huawei Cloud EulerOS、SUSE、Ubuntu LTS、Debian、CentOS 和 RHEL。 Linux Mint 基于 Ubuntu LTS，底层兼容，因此可以正常使用。

安装 CodeArts 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

验证安装是否成功：

codearts --version

如果终端回显了版本号，说明安装成功。

永久配置环境变量

上面的 export 命令只在当前终端会话中生效。为了让配置永久生效，需要将其写入 Shell 配置文件。

如果你使用的是 Bash（Mint 默认）：

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

如果你使用的是 Zsh：

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

运维小贴士：日常在服务器上部署工具时，建议统一将第三方工具的 PATH 配置放在 ~/.bashrc 或 ~/.profile 中，方便后续维护和迁移。

授权登录

CodeArts CLI 支持两种授权方式：

方式一：浏览器登录授权（简单，适合快速体验）

在终端直接执行：

codearts

未登录状态下会自动跳转浏览器，完成华为云登录授权即可。此方式仅当前窗口生效。

方式二：AK/SK 环境变量授权（推荐，永久生效）

1. 登录华为云控制台，进入「我的凭证」→「访问密钥」页面，新建一个访问密钥
2. 创建成功后立即下载 credentials.csv 文件（弹窗关闭后无法再次查看）
3. 打开文件，找到 Access Key Id 和 Secret Access Key
4. 将密钥写入 Shell 配置文件：

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

验证授权是否成功：

codearts models

如果回显了模型列表（包含 model_id 和 model_name），说明授权生效。

安全提醒：AK/SK 是你的云资源访问凭证，请勿泄露给他人。建议定期轮换密钥，避免在公共代码仓库中硬编码密钥。

基本使用

进入 TUI 交互模式

进入你的项目目录，执行：

cd /path/to/your/project
codearts

即可进入终端交互界面（TUI），用自然语言描述需求，AI 会自动完成编码任务。例如：

请用 HTML 编写一个贪吃蛇游戏

首次执行文件操作时会询问权限，按需授权即可。

命令行模式（适合脚本集成）

如果不需要交互，可以直接用一条命令完成任务：

codearts run "你都会啥"

切换模型

通过 -m 参数可以指定使用哪个模型：

# 先查询可用模型
codearts models

# 使用指定模型
codearts -m huaweicloud-maas/GLM-5.2

常用命令速查

常见问题

Q1：提示 command not found: codearts

确认 PATH 是否正确配置：

echo $PATH | grep codeartsdoer

如果没有输出，重新执行 source ~/.bashrc 或检查配置文件是否写入成功。

Q2：提示 Permission denied

这通常是 ~/.codeartsdoer 目录的归属权限不正确所致，执行以下命令修复：

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

运维小贴士：在 Linux 服务器上排查权限问题时，ls -la 配合 chown/chmod 是最基础的手段。如果是多用户环境，建议为每个用户单独配置环境变量，避免权限交叉。

Q3：内网/代理环境无法安装

如果公司内网需要配置代理，先设置好 http_proxy 和 https_proxy 环境变量，再执行安装命令。

总结

CodeArts CLI 的最大价值在于将 AI 编码能力无缝融入终端工作流——无论是本地开发还是 SSH 远程连接服务器，都可以直接在命令行中调用 AI 完成编码任务，无需在本地和服务器之间来回同步代码。

对于日常在终端下工作的开发者来说，这无疑是一个能显著提升效率的工具。如果你也习惯在终端中完成大部分开发工作，不妨试试 CodeArts CLI。