在 AlmaLinux 上安装华为云 CodeArts CLI

CodeArts CLI（码道 CLI）是华为云提供的终端版 AI 编程助手，支持 TUI 交互与命令行模式，适合服务器、容器、CI/CD 等无桌面环境使用。

截至 2026 年 9 月，华为官方文档列出的 Linux 支持列表为：Huawei Cloud EulerOS 2.0、SUSE Linux Enterprise Server 12 SP5、Ubuntu 18.04/20.04/22.04/24.04 LTS、Debian 10/11/12、CentOS 8、RHEL 8/9。AlmaLinux 作为 RHEL 的下游兼容发行版，与 RHEL 8/9 二进制兼容，因此可以按 RHEL 的方式安装。

一、环境准备

确保你的 AlmaLinux 满足以下基本条件：

# 查看系统版本
cat /etc/os-release

# 确保 curl 已安装
sudo dnf install -y curl

二、安装 CodeArts CLI

官方提供的 Linux 一键安装脚本如下：

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

执行后，安装脚本会自动下载并安装 CLI 工具。安装完成后，将 PATH 追加到 shell 配置文件中，避免每次打开终端都要手动设置：

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

验证安装是否成功：

codearts --version

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

三、授权登录（AK/SK 方式）

CLI 需要通过华为云账号的访问密钥（AK/SK）进行授权。

1. 获取 AK/SK

1. 登录 华为云控制台
2. 进入「我的凭证」→「访问密钥」
3. 点击「新增访问密钥」，创建后立即下载密钥文件（仅支持下载一次，务必妥善保管）

2. 配置环境变量

打开下载的密钥文件，找到 AccessKeyId 和 SecretAccessKey，然后配置到环境变量中：

export CODEARTS_CLI_AK="你的AccessKeyId"
export CODEARTS_CLI_SK="你的SecretAccessKey"

# 写入 ~/.bashrc 使其永久生效
echo 'export CODEARTS_CLI_AK="你的AccessKeyId"' >> ~/.bashrc
echo 'export CODEARTS_CLI_SK="你的SecretAccessKey"' >> ~/.bashrc
source ~/.bashrc

3. 验证授权

codearts models

如果能正常列出可用模型，说明授权成功。

四、常用命令速查

# 进入 TUI 交互开发界面
codearts

# 指定项目目录进入 TUI
codearts /path/to/project

# 非交互模式执行任务
codearts run "帮我写一个Python脚本，读取CSV文件并统计每列的空值数量"

# 查看可用模型列表
codearts models

# 指定模型进入 TUI
codearts -m huaweicloud-maas/GLM-5.2

# 查看 Token 用量
codearts stats

# 查看历史会话
codearts session list

# 查看帮助
codearts help

# 升级到最新版本
codearts upgrade

# 卸载 CLI
codearts uninstall

五、常见问题

• 安装脚本执行失败：检查网络是否能访问华为云 OBS，或尝试手动下载安装包。
• codearts 命令找不到：确认 PATH 是否正确配置，执行 echo $PATH 检查是否包含 ~/.codeartsdoer/installers。
• 端口冲突：如果后续使用远程隧道连接功能，默认本地端口为 1234，若被占用需在创建隧道时指定其他空闲端口。

六、注意事项

• AK/SK 是敏感凭证，请勿泄露或提交到代码仓库。
• 个人用户首次登录会自动开通免费体验版套餐，每月有一定 Token 额度。
• 官方支持列表未明确列出 AlmaLinux，如遇兼容性问题，建议参考 RHEL 8/9 的故障排查方式，或在华为云社区反馈。