简介
OpenAI CLI 是 OpenAI 在 GitHub（openai/openai-cli）发布的官方命令行工具，描述为「Official CLI for the OpenAI API」。它用 Go 编写、Apache 2.0 许可，把 OpenAI REST API 的接口按资源组织成命令，例如 openai responses create 发起对话请求、openai images generate 生成图片并自动保存到本地、openai files upload 上传文件，设置管理员密钥后还能调用组织用量等 admin 接口。所有命令都带完整的离线帮助，输出默认是易读文本，也可以切成 JSON、JSONL、YAML 方便脚本处理，并支持 GJSON 提取字段，适合在终端里快速测试 API、写自动化脚本或在 CI 中调用。工具会每周最多提示一次新版本，但不会自动更新。仓库 2026 年 5 月创建，目前 Star 近 900、发布频繁，2026 年 10 月 21–22 日连续发布了 v1.39.1 到 v1.40.2（新增自定义声音授权管理等）。使用需要 OpenAI API Key，调用费用按 OpenAI API 的正常价格计算。官方来源：https://github.com/openai/openai-cli 、https://github.com/openai/openai-cli/releases 、https://developers.openai.com/api/docs （2026-10-22 核对）。 定价：CLI 本身免费开源（Apache 2.0）；通过它调用 OpenAI API 产生的费用按 OpenAI API 官方价格计费，需要自备 API Key。
- 安装brew install openai/tools/openai，或 go install github.com/openai/openai-cli/cmd/openai@latest（需 Go 1.26+）
- 资源式命令openai <资源> [子资源] <命令> [参数]，如 openai responses create --input "Say this is a test" --model gpt-5.5
- 图像生成openai images generate --prompt "..." 默认用 gpt-image-2.5-sunburst，图片自动保存到 ~/Downloads/gpt-images/ 并打印路径；支持 images edit、images preview 和终端内联预览
- 文件openai files upload / get / download，上传时指定 purpose
- 管理接口设置 OPENAI_ADMIN_KEY 后可查组织用量等 admin 接口
- 输出与脚本默认可读文本，可切换 json / jsonl / yaml / raw 等格式，用 GJSON 语法 --transform 提取字段；错误信息默认给出可操作的摘要
- 帮助与补全直接运行 openai 按任务浏览命令组，帮助离线可用；支持 Bash / zsh / fish / PowerShell 补全和命令插入
- 安全相关自定义请求头、远程地址强制 HTTPS、双向 TLS（beta）、调试日志自动隐去请求头值
