gddy 是 GoDaddy 官方命令行工具，用于域名搜索与注册、DNS 管理、主机、邮箱、GoDaddy 产品购买，以及 GoDaddy 开发者平台（为 GoDaddy Commerce 产品构建应用）。
安装：macOS/Linux/Git Bash/MSYS2/Cygwin 执行 curl -fsSL https://github.com/godaddy/cli/releases/latest/download/install.sh | bash；PowerShell 执行 irm https://github.com/godaddy/cli/releases/latest/download/install.ps1 | iex。安装后用 gddy --version 验证。
命令自文档：用 --help 查看任一命令，gddy search <keywords> 查找命令，gddy tree 列出全部命令，gddy guide 查看概念与多步工作流文档。
认证：无令牌、令牌过期或需额外权限时自动进行三步 OAuth，会打开浏览器；登录时授予几乎全部权限范围，敏感操作（购买、修改域名服务器、删除应用、数据库访问）首次触发时另开同意页，可用 gddy auth scope --non-default 查看。非交互场景可用个人访问令牌（PAT）：gddy pat create 打开开发者门户生成，再用 gddy pat add 安全存储或设置 GDDY_PAT 环境变量。
用户同意：代表用户执行以下操作前必须暂停并取得明确同意——同意条款与条件（需提供链接并确认已阅读）、任何购买、任何不可逆操作（如删除资源）。
域名购买：运行 gddy guide domain-purchase 查看多步购买流程。
DNS 管理：有效记录类型为 A AAAA ALIAS CAA CNAME MX NS SOA SRV TXT，其中 NS 与 SOA 由 GoDaddy 管理且只读。示例：gddy dns list example.com --type A；gddy dns add example.com --type A --name www --data 192.0.2.1 --ttl 3600；gddy dns set example.com --type TXT --name @ --data "v=spf1 -all"；gddy dns delete example.com --type A --name www。add 追加记录，set 替换该类型+名称的全部记录，delete 删除全部匹配记录；MX/SRV 需 --priority，SRV 还需 --port、--weight、--protocol、--service，CAA 需 --tag。set 与 delete 具破坏性，建议先加 --dry-run 并向用户展示改动。
支付方式：gddy payment-method add 打开账户支付方式页面，CLI 不处理卡数据；缺少有效支付方式或余额不足时购买会失败，需查看错误 code 字段区分原因。主机方面，创建、更新或删除应用密钥后使用 hosting app restart 命令。
全局标志：--debug 输出详细请求响应，--dry-run 预览改动，--human 显示交互 TTY 格式，非 TTY 默认 --json，--toon 节省 token，--env 覆盖默认生产环境或 gddy env set <env> 永久设置。参考材料 reference/api.md 与 reference/errors-and-limits.md 仅在任务需要时阅读。