在 Alpine Linux 上安装华为云 CodeArts CLI 完整指南

对于习惯在终端中高效工作的开发者来说，华为云码道（CodeArts）CLI 是一个极佳的 AI 编程助手。它支持终端交互界面（TUI）与命令行模式（CLI），让你无需打开 IDE，就能在终端里用自然语言完成代码生成、文件搜索与修改、Git 操作等任务。

官方文档中，CodeArts CLI 支持的主流 Linux 发行版包括 Huawei Cloud EulerOS、SUSE、Ubuntu、Debian、CentOS、RHEL 等。 但对于使用 Alpine Linux 的用户来说，官方并没有提供直接的安装包或适配说明。不过，通过官方提供的通用 Shell 安装脚本，我们依然可以在 Alpine 上顺利安装并使用 CodeArts CLI。本文将带你一步步完成安装、授权与使用。

一、前置准备

在开始安装之前，请确保你的 Alpine 系统已经安装了以下基础工具：

# 更新包索引并安装 curl 和 bash（Alpine 默认使用 sh，但安装脚本需要 bash）
apk update
apk add curl bash

如果你使用的是精简版的 Alpine Docker 镜像，可能还需要安装 sudo 或其他依赖，根据实际报错补充即可。

二、安装 CodeArts CLI

官方提供了适用于 Linux/macOS 的一键安装脚本，在 Alpine 终端中直接执行即可：

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

安装完成后，需要将 CodeArts CLI 的可执行文件路径添加到环境变量中：

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

为了永久生效，可以将上述命令写入你的 Shell 配置文件中（Alpine 默认使用 sh，配置文件为 ~/.profile 或 ~/.bashrc）：

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

安装成功后，终端会回显 CodeArts CLI 的版本号，说明安装完成。

三、获取 AK/SK 访问密钥

CodeArts CLI 使用 AK/SK（Access Key / Secret Key）进行身份认证。你需要先在华为云平台获取访问密钥：

1. 访问华为云"我的凭证"页面，新建一个访问密钥。
2. 创建成功后，立即下载并保存到本地（每个访问密钥仅支持下载一次，务必妥善保管）。
3. 打开下载的密钥文件，找到 AccessKeyId 和 SecretAccessKey 两个值。

另外，你还需要开通码道服务并获取免费体验版套餐，开通地址：

四、配置环境变量授权

获取到 AK/SK 后，在 Alpine 终端中配置环境变量：

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

同样，为了永久生效，将这两行写入配置文件：

echo 'export CODEARTS_CLI_AK="你的AccessKeyId"' >> ~/.profile
echo 'export CODEARTS_CLI_SK="你的SecretAccessKey"' >> ~/.profile
source ~/.profile

配置完成后，可以通过以下命令验证授权是否成功：

codearts models

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

五、常用命令速查

安装和授权完成后，就可以开始使用 CodeArts CLI 了。以下是一些常用命令：

# 进入 TUI 交互开发界面
codearts

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

# 非交互模式执行任务
codearts run "帮我写一个Python的图片压缩工具"

# 查看帮助
codearts help

# 查看 Token 用量
codearts stats

# 查看历史会话
codearts session list

# 查询可用模型列表
codearts models

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

# 升级到最新版本
codearts upgrade

# 卸载 CLI
codearts uninstall

六、常见问题

Q：安装脚本执行失败怎么办？

A：Alpine 默认使用 sh（ash），但官方安装脚本可能需要 bash。请确保已安装 bash，并使用 sh -c 或 bash -c 执行脚本。如果仍然失败，可以检查 curl 是否正常工作，以及网络是否能访问华为云 OBS 存储。

Q：提示权限不足（Permission denied）？

A：这通常是因为 ~/.codeartsdoer 目录的归属权限不正确。执行以下命令修复：

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

Q：Alpine 上运行有任何特殊限制吗？

A：CodeArts CLI 的安装脚本会将二进制文件下载到 ~/.codeartsdoer/installers 目录。只要 Alpine 系统的架构（x86_64 或 aarch64）有对应的预编译二进制，就可以正常运行。如果官方未提供 Alpine 专用的 musl libc 编译版本，可能需要通过兼容层（如 gcompat）来运行 glibc 编译的二进制文件。