openai-cli

终端一条命令，直接调通 OpenAI 模型

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署编程开发 🍴 复刻 94 🐛 待处理 15 👀 关注 8

GitHub ↗

GitHub 星标 ★ 1154

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，调用 API 需按 OpenAI 用量付费

项目预览

项目数据

分类编程开发

开发团队openai

GitHubhttps://github.com/openai/openai-cli

定价模式🏷️完全免费

价格说明开源免费，调用 API 需按 OpenAI 用量付费

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言Go

GitHub 星标★ 1154

上线时间2026-05-01 00:00:00

代码更新2026-11-07

仓库体积14.9 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-11-09

浏览次数0

项目介绍

openai-cli 是 OpenAI 官方提供的命令行工具，使用 Go 语言编写，让开发者在终端里直接调用 OpenAI API，无需自己写脚本或依赖第三方封装。它解决的是在自动化流程、服务器环境和日常开发中快速接入模型能力的问题：通过命令行即可发起对话补全、模型调用等请求，支持用环境变量配置 API 密钥，输出结果可直接被管道、脚本或其他工具消费。核心能力包括统一的命令入口、参数化请求构造、结构化输出以及便于集成到 CI/CD 或本地工作流的轻量形态。相比在代码里手写 HTTP 请求，它降低了调用门槛，也便于调试和批量处理。项目仍在成长阶段，适合需要脚本化调用模型能力的开发者、运维和自动化场景使用。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-11-09 · 当前星标 ★ 1154

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

macOS 且已安装 Homebrew（使用 zsh 或其它 shell）
Linux：Debian、Ubuntu 或 Fedora，使用 Bash 或 zsh
调用 API 时需要 OpenAI API 密钥
安装与调用 API 时需要网络连接（仅查看帮助则不需要）

安装与启动步骤

1macOS 安装

在终端把两行命令一起粘贴执行：第一行更新 Homebrew 并安装 openai，第二行启用自动更新。
```
brew update && brew install --cask openai/tools/openai && source "$(brew --prefix)/bin/openai-enable-updates.zsh"
```
2Linux 安装

从 Releases 下载 openai.sh，在下载目录打开 Bash 或 zsh，按脚本页面给出的两行内容执行安装。
3查看总帮助

确认命令已可用，并浏览资源（resource）与子命令结构；帮助不需要 API 密钥和网络。
```
openai --help
```
4查看具体命令帮助

命令按 API 资源组织，用 --help 查看某个动作的用法、必填输入和相关参数。
```
openai images generate --help
```
5配置 API 密钥

调用 API 前需通过环境变量提供密钥，具体变量名与写法以官方 CLI 参考文档为准。

6批量请求示例

上传 JSONL 请求文件、创建批次并等待结果下载到 ./results，文件与批次 ID 换成返回值。

openai files upload requests.jsonl --purpose batch
openai batches create --input-file-id file-example --endpoint /v1/responses --completion-window 24h
openai batches wait batch_example --output-dir ./results