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

华为云码道 CodeArts CLI 提供了终端交互界面和命令行模式，适合在 Linux 服务器、远程开发环境或纯终端工作流里使用。Arch Linux 虽然不在官方明确列出的支持发行版中，但可以通过官方 Linux 安装脚本完成安装。

安装前准备

建议在安装前确认系统已安装以下依赖：

sudo pacman -S curl bash

如果你后续需要通过浏览器完成登录授权，还需要安装一个可用浏览器，例如：

sudo pacman -S chromium

另外，建议先确认当前用户拥有 ~/.codeartsdoer 目录的写入权限，避免后续因权限问题导致配置写入失败。

一键安装 CodeArts CLI

在终端中执行官方 Linux 安装脚本：

sh -c "$(curl -L https://cnnorth4-cloudide-marketplace.obs.cn-north-4.myhuaweicloud.com/codearts/cli_tui/install_script/install.sh)"

安装完成后，将安装目录加入 PATH：

export PATH=~/.codeartsdoer/installers:$PATH

为了让每次打开终端都生效，可以把上面这行写入 Shell 配置文件：

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

如果你使用的是 zsh，则写入 ~/.zshrc：

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

验证安装

执行以下命令检查是否安装成功：

codearts --version

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

授权方式一：AK/SK 环境变量

CodeArts CLI 支持通过华为云 AK/SK 完成授权。获取 AK/SK 的入口为：

https://codearts.huaweicloud.cn/portal/settings/cli-auth

获取后，可以临时设置环境变量：

export CODEARTS_CLI_AK="你的AK"
export CODEARTS_CLI_SK="你的SK"

也可以写入 Shell 配置文件：

echo 'export CODEARTS_CLI_AK="你的AK"' >> ~/.bashrc
echo 'export CODEARTS_CLI_SK="你的SK"' >> ~/.bashrc
source ~/.bashrc

验证授权是否生效：

codearts models

需要注意的是，AK/SK 属于敏感凭证，不建议直接提交到 Git 仓库或公开配置文件中。更稳妥的做法是将其放在独立的环境变量文件中，并确保文件权限仅限当前用户读取。

授权方式二：浏览器登录

部分版本也支持通过浏览器完成登录授权。首次运行 codearts 时，如果提示进行浏览器授权，可以按终端给出的链接在浏览器中完成登录。

在 Arch Linux 上，如果系统没有安装桌面浏览器，这一步可能会失败。此时可以安装 Chromium、Firefox 等浏览器，或者改用 AK/SK 方式完成授权。

常用命令

安装并授权完成后，可以开始使用：

codearts

进入终端交互开发界面。

codearts /path/to/project

指定项目目录进入交互界面。

codearts run "需求描述"

以非交互模式执行任务。

codearts models

查看可用模型列表。

codearts stats

查看 Token 用量。

codearts upgrade

升级到最新版本。

codearts uninstall

卸载 CLI。

Arch Linux 上的注意事项

1. 发行版兼容性
   官方文档列出的 Linux 支持包括 Ubuntu、Debian、RHEL、CentOS、SUSE 等，Arch Linux 并未被明确列出。因此安装脚本虽然可以运行，但后续版本更新或依赖变化时可能需要自行排查。

2. glibc 版本
   如果后续使用 CodeArts IDE 或其他相关组件，Linux ARM64 版本通常要求 glibc ≥ 2.31。Arch Linux 一般自带较新的 glibc，通常不会成为问题。

3. 权限问题
   如果运行 CLI 时出现权限拒绝错误，可以检查 ~/.codeartsdoer 目录归属：

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

4. 端口占用
   如果后续涉及远程开发或隧道连接，默认本地端口可能会被占用。遇到这种情况可以更换端口，并同步修改对应配置。

5. 更新方式
   建议优先使用：

   codearts upgrade
   

   而不是反复执行安装脚本，避免产生多个残留文件。

小结

在 Arch Linux 上安装 CodeArts CLI 的核心步骤很简单：先通过官方脚本安装，再配置 PATH，最后完成 AK/SK 或浏览器授权即可使用。由于 Arch Linux 并非官方明确支持的发行版，日常使用时建议关注版本更新和权限配置，遇到问题优先检查环境变量、浏览器依赖以及 ~/.codeartsdoer 目录权限。