安装与环境配置-人工智能平台 PAI(PAI)-阿里云帮助中心

PAI CLI 提供 Linux 和 macOS 的独立二进制文件，支持 amd64 和 arm64 架构。本文适用于 v1.1.0。

下载二进制文件

根据操作系统与 CPU 架构下载对应的 PAI CLI 二进制文件（v1.1.0）：

说明

从 v1.0.1 升级前，请先阅读 PAI CLI发布说明，了解不兼容变更等升级须知。

平台	架构	文件名
Linux	amd64 (x86_64)	`pai-linux-amd64`
Linux	arm64 (aarch64)	`pai-linux-arm64`
macOS	amd64 (Intel)	`pai-darwin-amd64`
macOS	arm64 (Apple Silicon)	`pai-darwin-arm64`

安装或升级

将下载文件改名为 pai，放入 PATH 中的目录。升级已有版本前，可先保留旧二进制和现有配置文件的备份。

# 1. 以 macOS Apple Silicon 为例，移动到并改名为 pai
mv pai-darwin-arm64 /usr/local/bin/pai

# 2. 添加可执行权限
chmod +x /usr/local/bin/pai

# 3. 验证安装
pai --version
# 输出： v1.1.0

说明

如果不想放到系统目录，也可以放到 ~/bin/ 或任意目录，然后将其加入 PATH 环境变量：export PATH=$PATH:~/bin（建议写入 ~/.bashrc 或 ~/.zshrc 持久化）。

常见异常处理：

执行被拦截：macOS 用户通过 Chrome浏览器下载时，系统会给文件写入 com.apple.quarantine 扩展属性，因此会被拦截（无法打开“pai”，因为Apple无法检查其是否包含恶意软件）。若确认文件来自可信的发布入口，但系统仍因下载隔离标记阻止运行，可移除该文件的隔离标记后再试：
```
xattr -d com.apple.quarantine "/usr/local/bin/pai"
```
或者使用 curl 下载：
```
# Apple Silicon（M 系列芯片）
curl -fL -o pai https://pai-dsw-ai-machine.oss-cn-beijing.aliyuncs.com/cli/pai-darwin-arm64

# Intel 芯片
curl -fL -o pai https://pai-dsw-ai-machine.oss-cn-beijing.aliyuncs.com/cli/pai-darwin-amd64
```
升级后 pai --version 仍显示旧版：用 command -v pai 检查实际执行的路径，确认 PATH 中没有更靠前的旧文件。

配置目录

默认配置文件为 ~/.pai/config.json。需要隔离多套环境，或同时使用 PAI Python SDK 时，可指定其他目录：

# 对后续命令生效
export PAI_CONFIG_DIR="$HOME/.pai-cli"

# 或只为单次命令指定目录
pai --config-dir "$HOME/.pai-cli" config show

目录优先级为：--config-dir > PAI_CONFIG_DIR > ~/.pai。目录内保存 CLI 配置、状态、日志及安装标识。指定新目录不会自动迁移旧目录的配置。

PAI Python SDK 也默认使用 ~/.pai/config.json，格式与 CLI 不同。共用时的覆盖风险和隔离方法见配置与认证。

配置自动补全（推荐）

安装后立即配置 Shell 自动补全，后续使用体验会大幅提升。以下示例为 Linux 环境，macOS 用户的补全脚本路径不同，详见 Shell 自动补全章节。

# Bash
pai completion bash > /etc/bash_completion.d/pai

# Zsh
pai completion zsh > "${fpath[1]}/_pai"

# Fish
pai completion fish > ~/.config/fish/completions/pai.fish