在 Gentoo Linux 上安装 CodeArts CLI

华为云码道 CodeArts CLI 提供了一个终端交互界面和命令行模式，可以在不打开 IDE 的情况下完成代码生成、文件操作、Git 协作、单元测试生成等任务。它适合习惯终端工作流的开发者，也方便接入脚本化流程。

官方文档列出的 Linux 支持包括 Ubuntu、Debian、CentOS、RHEL、SUSE 和 Huawei Cloud EulerOS 等，暂未明确列出 Gentoo。 因此，在 Gentoo 上安装时，建议优先确认官方安装脚本和依赖是否适配你的系统。

前置准备

安装前需要准备好几样东西：

• 一个可用的终端，例如 bash、zsh、fish
• curl
• git，因为 CLI 可能涉及仓库操作或后续升级
• 一个可用浏览器，用于华为云账号授权
• 华为云账号，并开通码道 CodeArts 服务
• AK/SK 访问密钥，用于 CLI 授权

Gentoo 用户通常可以直接通过 Portage 安装基础依赖：

sudo emerge --ask net-misc/curl dev-vcs/git

如果你使用 zsh 或 fish，后面配置环境变量时需要写入对应的 shell 配置文件，例如 ~/.zshrc 或 ~/.config/fish/config.fish。

安装 CodeArts CLI

官方为 Linux 提供了一键安装脚本。 在终端中执行：

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

安装完成后，把 CLI 可执行文件加入 PATH：

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

为了让每次打开终端都能直接使用 codearts，可以写入 shell 配置：

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

如果你使用的是 zsh：

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

安装成功后，执行：

codearts --version

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

授权登录

CodeArts CLI 需要使用华为云账号授权。常见方式有两种：浏览器授权，或通过 AK/SK 配置环境变量。

方式一：浏览器授权

在终端执行：

codearts

首次使用时，CLI 通常会引导你通过浏览器完成登录授权。授权成功后即可进入 TUI 交互界面。

方式二：AK/SK 授权

如果你更习惯通过环境变量管理凭证，可以先在华为云控制台获取 AK/SK，然后配置环境变量：

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

写入配置文件：

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

注意，AK/SK 属于敏感凭证，不要提交到 Git 仓库。如果项目需要共享配置，可以考虑使用 .env 文件配合本地忽略规则，或者使用更安全的环境变量管理方式。

开始使用

安装并授权后，可以直接在终端中使用 CodeArts CLI。

进入交互界面：

codearts

进入指定项目目录：

codearts /path/to/project

用自然语言执行任务：

codearts run "帮我生成一个 Python 脚本，统计当前目录下的文件数量"

查看帮助：

codearts help

查看模型列表：

codearts models

查看版本：

codearts --version

升级与卸载

升级 CLI 可以使用内置命令：

codearts upgrade

如果需要卸载：

codearts uninstall

如果安装脚本将文件写入 ~/.codeartsdoer，也可以手动检查该目录并清理残留文件。

Gentoo 用户需要注意的问题

Gentoo 并不是 CodeArts CLI 官方明确列出的支持发行版，因此可能会遇到以下情况：

• 安装脚本依赖的运行时库与系统版本不完全匹配
• 二进制文件依赖的 glibc 版本与当前 profile 不一致
• 某些功能需要浏览器完成授权，而服务器环境缺少图形浏览器
• 后续升级可能需要重新执行官方安装脚本

如果遇到兼容性问题，可以考虑在容器或 chroot 中运行一个官方支持的发行版，例如 Ubuntu 或 Debian，再在其中安装 CodeArts CLI。

小结

CodeArts CLI 的 Linux 安装流程本身比较直接：下载官方脚本、加入 PATH、完成授权即可使用。对 Gentoo 用户来说，主要差异在于需要自行确认依赖兼容性和 shell 环境配置。如果你平时主要在终端里完成开发工作，CLI 模式会比打开完整 IDE 更轻量。