安装出现 404

404 表示安装脚本、setup 包或指定版本在发布地址中不存在。请检查发布根地址、版本号和平台架构是否正确。

安装出现 checksum mismatch

这通常是发布侧的 setup 包和 checksums.txt 不匹配。不要跳过校验继续使用，请保留报错信息并联系客户支持、发布负责人或 天翼云CLI 研发处理。

cannot execute binary file: Exec format error

这通常表示下载的 setup 包与当前操作系统或 CPU 架构不匹配。请重新执行一键部署，或确认平台后重新下载匹配的 setup 包。

windows系统安装

禁止运行脚本

文档中的命令使用了 -ExecutionPolicy Bypass，只对这一次 powershell 子进程生效，不会永久修改系统策略。

如果仍希望在当前 PowerShell 窗口里直接运行 .\install-cli.ps1，可以只为当前窗口临时放开限制：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

提示无法识别 ctyun-cli

通常是 PATH 还没有在当前 PowerShell 窗口生效。先用完整路径验证，再临时加入 PATH：

& "$HOME\.ctyun-cli\bin\ctyun-cli.exe" version
$env:Path = "$HOME\.ctyun-cli\bin;$env:Path"

在windows powershell中 使用天翼云CLI出现乱码

可以设置当前会话为utf8编码：

$OutputEncoding = [System.Text.UTF8Encoding]::new()
[Console]::InputEncoding = [System.Text.UTF8Encoding]::new()
[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new()
chcp 65001

如果结合智能体使用的话，可以尝试与智能体说：

帮我修复powershell打印乱码问题

checksum mismatch

这通常是发布侧的 setup 包和 checksums.txt 不匹配。不要跳过校验继续使用，请保留报错信息并联系客户支持、发布负责人或 CLI 研发处理。

下载后提示架构不匹配

请按第 1 节重新确认架构，然后下载 windows-amd64 或 windows-arm64 对应的 setup 包。

Linux系统安装

ctyun-cli: command not found

通常是 PATH 还没有在当前终端生效。先用完整路径验证，再临时加入 PATH：

"$HOME/.ctyun-cli/bin/ctyun-cli" version
export PATH="$HOME/.ctyun-cli/bin:$PATH"

提示 cannot execute binary file: Exec format error

该错误通常表示 setup 包与当前 CPU 架构不匹配。请重新执行一键部署，或确认架构后重新下载匹配的 setup 包。

checksum mismatch

这通常是发布侧的 setup 包和 checksums.txt 不匹配。不要跳过校验继续使用，请保留报错信息并联系客户支持、发布负责人或 CLI 研发处理。

macOS系统安装

ctyun-cli: command not found

通常是 PATH 还没有在当前终端生效。先用完整路径验证，再临时加入 PATH：

"$HOME/.ctyun-cli/bin/ctyun-cli" version
export PATH="$HOME/.ctyun-cli/bin:$PATH"

提示 cannot execute binary file: Exec format error

该错误通常表示 setup 包与当前 CPU 架构不匹配。请重新执行一键部署，或确认架构后重新下载匹配的 setup 包。

checksum mismatch

这通常是发布侧的 setup 包和 checksums.txt 不匹配。不要跳过校验继续使用，请保留报错信息并联系客户支持、发布负责人或 CLI 研发处理。

macOS 阻止运行

请先确认文件确实来自可信发布地址，然后在“系统设置 -> 隐私与安全性”中允许该程序运行。