OpenAI 官方命令行工具来了!openai-cli 让开发者直接在终端调 API

最近， OpenAI 在 GitHub 上悄悄开源了一个项目，名叫 openai-cli。没有发布会，没有官方博客，甚至没有大张旗鼓的宣布——就是这样，一个 Apache 2.0 协议的命令行工具悄然上线了。

然后我在刷 X 的时候，看到程序员们开始疯狂转发。

说实话，我第一反应是：命令行工具这事儿，不是早就有 curl 了吗？但当我真的去翻了翻这个项目的文档，发现事情没那么简单。这是一个真正面向 Agent 工作流设计的命令行工具，它不只是"用 curl 调 API"那么简单。

今天我们就来好好聊聊这个工具。

一、 openai-cli 是什么？

简单来说，openai-cli 是 OpenAI 官方出品的命令行接口（ CLI ），让你可以在终端里直接调用 OpenAI 的各种 API ，不需要写任何 SDK 代码，一行命令搞定所有操作。

它开源在 GitHub 上（仓库地址 openai/openai-cli），采用 Apache 2.0 协议，这意味着任何人都可以自由使用、修改、甚至基于它做商业产品。

安装方式

goinstallgithub.com/openai/openai-cli@latest  brewinstallopenai-cli 

安装完成后，只需要设置一个环境变量，你的 API Key 就可以永久生效：

exportOPENAI_API_KEY="sk-xxxxxxxxxxxxxxxx"

然后你就可以开始用了，就这么简单。

二、它能做什么？

这是最让人兴奋的部分。openai-cli 不只是调用 chat 接口那么简单，它支持 OpenAI 全家桶的所有能力，而且还针对现代 Agent 工作流做了专门优化。

1. 图像生成（ DALL-E ）

openai-cliimagesgenerate--modeldall-e-3\--prompt"一只穿着宇航服的猫在月球上弹吉他"  openai-cliimagesgenerate\--modeldall-e-3\--prompt"Cyberpunk city at night, neon lights"\--size1024x1024\--n1

输出直接是图片 URL ，你不需要额外写代码去解析 JSON ，也不需要做任何 SDK 的初始化配置。一行命令，图片到手。

2. 语音转录（ Whisper ）

openai-cliaudiotranscription\--file./recording.mp3\--modelwhisper-1 

这个功能对于做播客、做会议记录、做字幕的开发者来说简直是神器。以前要跑通这个流程，你得写 Python 代码、装 OpenAI SDK 、处理音频格式，现在一个命令就搞定了。

3. Agents API 支持（划重点）

如果你关注 OpenAI 最近的动态，应该知道他们正在大力推 Agents API。这个 API 允许 AI 代理自主执行复杂任务，比如调用工具、搜索网页、读写文件。而 openai-cli 对这个 API 提供了原生支持：

openai-cliagentschat\--modelgpt-4o\--toolsweb-search,code-interpreter,file-read\--goal"帮我调研一下最新的大语言模型发展趋势"

这就是它真正有价值的地方——它是第一个官方出品的、面向 Agent 工作流的命令行工具。 OpenAI 在 Agents 领域一直在倡导"工具调用"的概念，而 openai-cli 把这个能力直接带到了终端。

4. Responses API

这是 OpenAI 最新上线的 API 类型，支持多模态输入、工具调用和结构化输出：

openai-cliresponsescreate\--modelgpt-4o\--input"用 Python 写一个快速排序算法"\--output-formatjson\--toolsweb-search 

5. 项目管理

openai-cli 还内置了项目管理功能，你可以：

openai-cliprojectscreatemy-project  openai-cliprojectslist  openai-cliprojectsgetmy-project 

这对于需要在多个项目间切换 API Key 的团队来说非常实用。

三、技术架构解析

核心设计理念

openai-cli 的设计核心是资源化命令结构。什么意思呢？传统 SDK 是这样的：你调用一个函数，传入参数，得到返回值。而 openai-cli 把所有 API 操作都组织成了"资源 + 动作"的形式，比如 images generate、audio transcription、agents chat。

这种设计有几个明显的好处：

协议与开源

Apache 2.0 许可证是一个相当宽松的开源协议，允许商业使用、修改、分发。这意味着：

与传统 SDK 对比

实际上，对于很多场景，openai-cli 的出现意味着你可能不再需要写任何代码就能完成 API 调用的原型开发。

四、应用场景

说了这么多，我们来看几个真实的使用场景。

场景一：快速原型开发

假设你正在做一个 AI 驱动的产品，需要快速验证"用 AI 生成产品配图"这个想法。用传统方式，你得：

用 openai-cli，你只需要：

openai-cliimagesgenerate\--modeldall-e-3\--prompt"a minimalist product photo of a coffee mug on a wooden desk"

5 秒钟出结果，你就可以判断这个方案是否可行。这对于独立开发者和小型团队来说，意义重大。

场景二：自动化脚本集成

很多运维场景需要调用 AI API ，比如：

用 openai-cli，你可以直接在 Shell 脚本里调用：

#!/bin/bashLOG_CONTENT=$(cat/var/log/app.log|tail-100)SUMMARY=$(openai-cliresponsescreate\--modelgpt-4o-mini\--input"Summarize this log in Chinese: $LOG_CONTENT")echo"$SUMMARY">>daily-report.txt 

这种集成方式比写 Python 脚本简洁得多，而且可以直接融入现有的运维体系。

场景三：教育与学习

对于想学习 AI API 但不想写代码的学生或新手，openai-cli 提供了一个零门槛的入口。你可以在终端里：

openai-cliresponsescreate\--modelgpt-4o\--input"解释量子计算的基本原理，用小学生能听懂的方式"  openai-cliresponsescreate--modelgpt-4o--input"什么是机器学习" openai-cliresponsescreate--modelgpt-4o-mini--input"什么是机器学习"

场景四： CI/CD 集成

在持续集成环境里，openai-cli 可以让你的流水线直接调用 AI 能力：

ai-test:script:-openai-cli responses create --model gpt-4o --input "Review this code:$CODE"-openai-cli images generate --model dall-e-3 --prompt "Test coverage visualization"

五、使用示例：从入门到实战

基础配置

首先，你需要在环境里配置 API Key ：

exportOPENAI_API_KEY="sk-xxxxxxxxxxxxxxxx"  openai-cliconfigsetapi-key"sk-xxxxxxxxxxxxxxxx"  openai-cli--api-key"sk-xxx"imagesgenerate... 

常用命令速查

图像生成

openai-cliimagesgenerate\--modeldall-e-3\--prompt"A serene mountain landscape at sunrise, photorealistic"\--size1024x1024\--qualityhd  openai-cliimagesedit\--modeldall-e-2\--imageinput.png\--maskmask.png\--prompt"Add autumn foliage to the trees"  openai-cliimagesvariation\--modeldall-e-2\--imageinput.png 

语音处理

openai-cliaudiotranscription\--filerecording.mp3\--modelwhisper-1\--languagezh  openai-cliaudiospeech\--modeltts-1\--input"你好，欢迎使用 OpenAI CLI"\--voicealloy\--outputspeech.mp3 

模型对话

openai-clichatcreate\--modelgpt-4o\--message"你好，介绍一下你自己"  openai-clichatcreate\--modelgpt-4o\--system"你是一个专业的产品经理，擅长分析用户需求"\--message"帮我分析一下这个功能的价值"  openai-clichatcreate\--modelgpt-4o\--message"写一篇 3000 字的文章"\--stream 

Agents 工作流

openai-cliagentschat\--modelgpt-4o\--toolsweb-search,code-interpreter\--goal"帮我找一下最近一周有哪些重要的 AI 新闻"  openai-cliagentshistory--session-id<session-id>  openai-cliagentsexport--session-id<session-id>--formatjson 

六、对开发者的意义

openai-cli 的出现，实际上反映了 OpenAI 最近的战略重心变化。

过去， OpenAI 的生态主要是围绕 SDK 建立的——Python SDK 、 Node.js SDK 、 Go SDK 。这些 SDK 的设计哲学是"给应用开发者用"，目标是让他们在自己的应用里集成 AI 能力。

但现在，AI Agent 的时代正在到来。 Agent 不再是"在你的应用里调用 AI"，而是"让 AI 能够自主行动、调用工具、完成任务"。这就需要一种新的交互方式——不是写代码调用 API ，而是给 AI 下指令，让它自主执行。

openai-cli 就是这种新范式的体现。它把 AI 能力直接带到了命令行，让任何能够使用终端的人——不只是程序员——都能与 AI 交互。这降低了门槛，也打开了新的可能性。

七、局限性与展望

说了这么多优点，我们也来客观看看它的局限性。

目前还年轻

openai-cli 作为一个新开源项目，还处于快速迭代期。功能可能不如 SDK 完善，部分 API 可能还没覆盖。另外，由于项目较新，社区资源和文档还在完善中，遇到问题可能需要自己看源码。

不适合复杂应用

对于复杂的企业级应用， SDK 仍然是更好的选择。命令行工具的优势在于简单快捷，但当你需要：

这些时候，一个成熟的 SDK 会更可靠。

展望

不过，考虑到 OpenAI 对它的重视程度，以及开源社区的活跃度，我预计 openai-cli 会快速发展。未来可能的方向包括：

总结

openai-cli 的出现，标志着 OpenAI 在从"API 提供商"向"平台提供商"转型的道路上又迈出了一步。它让 AI 能力的获取变得更加简单、直接，也让我们看到了命令行工具在 AI 时代的新的可能性。

不管你是程序员还是普通用户，只要你需要调用 OpenAI 的 API ，都值得关注一下这个工具。毕竟，有时候，最简单的方式就是最好的方式。

现在，去终端里试试吧。

brewinstallopenai-cli  goinstallgithub.com/openai/openai-cli@latest  exportOPENAI_API_KEY="sk-your-key"  openai-cliimagesgenerate\--modeldall-e-3\--prompt"the future of AI, cyberpunk aesthetic"

你有哪些使用场景？欢迎在评论区分享。

标签： OpenAI / 命令行工具 / 开发者工具 / AI API / Agent

摘要： OpenAI 官方开源命令行工具 openai-cli ， Apache 2.0 协议，支持图像生成、语音转录、 Agents API 等所有主要功能，一行命令直接调用 API ，无需 SDK 编码，让开发者零门槛使用 OpenAI 全家桶能力。