OpenAI CLI: Cài đặt và gọi OpenAI API từ Terminal

OpenAI CLI là công cụ dòng lệnh chính thức của OpenAI cho REST API của OpenAI. Bạn cài đặt một binary openai duy nhất, thiết lập OPENAI_API_KEY, và gọi API từ terminal hoặc shell script: openai responses create, openai files upload, openai batches create, openai images generate. Đây không phải là Codex CLI. Codex là một coding agent; openai gửi một yêu cầu API cho mỗi lệnh.

Dùng thử Apidog ngay hôm nay

Hướng dẫn này bao gồm cài đặt, xác thực, những lệnh đầu tiên đáng để chạy, và cách nó so sánh với Codex CLI cùng lệnh openai cũ mà Python SDK đã đặt trên PATH của bạn. Mọi lệnh và kết quả bên dưới đều đến từ phiên bản 1.44.1, được cài đặt và chạy vào ngày 28 tháng 10 năm 2026.

OpenAI CLI là gì?

OpenAI CLI là một binary Go mã nguồn mở, được OpenAI phát hành tại github.com/openai/openai-cli theo giấy phép Apache 2.0. Các lệnh của nó phản chiếu các tài nguyên của API (responses, files, batches, images, audio, vector-stores, admin), vì vậy bất cứ thứ gì bạn sẽ gửi bằng curl hoặc một SDK đều trở thành một lệnh terminal duy nhất với các flag.

Nó không phải là hoàn toàn mới. Phiên bản 1.0.0 được phát hành vào ngày 5 tháng 5 năm 2026, và dự án đã cắt 99 bản phát hành kể từ đó; 1.44.1 ra mắt vào ngày 27 tháng 10 năm 2026. Vì vậy hãy coi nó như một công cụ trưởng thành mà bạn có thể đã bỏ lỡ, không phải một buổi ra mắt.

Đây là những gì bạn nhận được trong lần chạy đầu tiên:

Phần trợ giúp nhóm các lệnh theo công việc: tạo nội dung (responses, chat, images, audio, videos), dữ liệu và truy xuất (files, uploads, vector-stores, embeddings), mô hình và tác vụ, quản trị, và một tập hợp các công cụ cục bộ không bao giờ chạm vào mạng. Bản thân phần trợ giúp không cần API key và không cần kết nối, điều này khiến openai <command> --help trở thành cách nhanh nhất để học các flag.

Nó phù hợp với các nhà phát triển đang thử nghiệm một prompt mà không muốn viết script, những người vận hành muốn tải file và chạy batch trong một cron job, và các coding agent cần một giao diện được ghi lại thay vì curl tự viết tay.

Cách cài đặt OpenAI CLI

Bạn có ba cách cài đặt, tất cả đều được liệt kê trong README của dự án:

1. Binary dựng sẵn. Tải bản lưu trữ cho hệ điều hành và kiến trúc của bạn từ GitHub Releases (các bản dựng cho macOS, Linux và Windows đều được phát hành), giải nén và đặt openai vào PATH của bạn.

2. Homebrew.
   

   brew install openai/tools/openai

1. Go. Yêu cầu Go 1.26 trở lên.

   go install 'github.com/openai/openai-cli/cmd/openai@latest'
   export PATH="$PATH:$(go env GOPATH)/bin"

Các bản cài đặt tự quản lý từ release có thể tự cập nhật trong các lần chạy tương tác. Nếu bạn ghim phiên bản trong CI, hãy đặt OPENAI_CLI_NO_AUTO_UPDATE=1 để ngăn cài đặt tự động, hoặc OPENAI_CLI_NO_UPDATE_CHECK=1 để tắt hoàn toàn việc kiểm tra cập nhật. Các bản cài đặt Homebrew và Go vẫn giữ thông báo cập nhật nhưng để trình quản lý gói xử lý việc nâng cấp.

Cách xác thực của OpenAI CLI hoạt động

CLI đọc một API key tiêu chuẩn từ OPENAI_API_KEY (hoặc flag --api-key, mà bạn nên tránh vì nó sẽ nằm trong lịch sử shell). Nếu bạn chưa có, hướng dẫn của chúng tôi về lấy OpenAI API key sẽ hướng dẫn chi tiết.

Cách thiết lập nhanh nhất là hướng dẫn tích hợp sẵn:

openai help setup

Nó chỉ cho bạn trang API keys và cung cấp cho bạn dòng read -rs OPENAI_API_KEY cho Bash hoặc zsh, để key được nhập ẩn và không bao giờ bị hiển thị.

Quên key và bạn sẽ nhận được một lỗi rõ ràng, có thể dùng trong script. Đây là kết quả thực tế khi không đặt key:

Nó thoát với trạng thái 1 và cho bạn biết chính xác key có thể đến từ đâu. Thêm --format-error json khi một script cần phần thân lỗi thô.

Các cài đặt xác thực khác:

Những lệnh OpenAI CLI đầu tiên nên chạy

Hình dạng lệnh tuân theo API: openai <resource> [subresource...] <command> [flags...]. Đây là những lệnh xứng đáng có chỗ trong hộp công cụ của bạn.

Thực hiện một lệnh gọi Responses API

openai responses create \
  --model gpt-5.5 \
  --input "Say this is a test"

Các prompt dài không cần escape. Các flag đầu vào JSON đọc từ file với @path:

openai responses create --model gpt-5.5 --input @prompt.txt

Nếu bạn pipe JSON hoặc YAML từ một nguồn bạn không tin cậy, hãy đặt OPENAI_UNTRUSTED_STDIN=1 để đầu vào đó không thể kích hoạt việc đọc file cục bộ.

Tải lên và tải về file

openai files upload report.txt --purpose user_data
openai files get file-example
openai files download file-example --output downloaded-report.txt

Chạy một batch

Đặt một yêu cầu mỗi dòng trong requests.jsonl, mỗi yêu cầu có một custom_id duy nhất, sau đó:

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

batches wait thăm dò cho đến khi batch hoàn thành và lưu các file kết quả, điều này loại bỏ vòng lặp thăm dò mà bạn sẽ phải viết. Hướng dẫn batch của dự án liệt kê các giới hạn hiện tại là 50.000 yêu cầu và 200 MB mỗi file đầu vào, với cửa sổ hoàn thành 24h. Giá batch khác với các lệnh gọi đồng bộ; xem phân tích giá OpenAI API của chúng tôi trước khi bạn xếp hàng một tác vụ lớn.

Đếm token cục bộ, không cần key

Lệnh tokenizer chạy hoàn toàn ngoại tuyến: không cần thông tin xác thực, không cần mạng, không lưu đầu vào.

Encoding mặc định là o200k_base, và openai tokenizer encodings liệt kê những encoding khác (cl100k_base, cùng hai encoding cũ). Phần trợ giúp nói thật về các giới hạn: đếm văn bản thuần loại trừ cấu trúc yêu cầu và đầu vào đa phương thức, vì vậy nó không phải là con số thanh toán. Để đếm phía máy chủ, hãy dùng openai responses input-tokens count.

Lấy đầu ra mà script có thể phân tích

Đầu ra mặc định là văn bản dễ đọc, ngay cả khi được pipe. Yêu cầu dữ liệu một cách rõ ràng:

openai models list --format jsonl | jq '.id'
openai files list --format json > files.json
openai files get file-example --transform filename --raw-output

--format chấp nhận auto, text, json, jsonl, yaml, explore (một trình xem JSON tương tác) và pretty. --transform trích xuất các trường với cú pháp GJSON, và jq xử lý bất cứ thứ gì phức tạp hơn. Luôn kiểm tra trạng thái thoát trước khi tin tưởng một file được chuyển hướng: một yêu cầu thất bại có thể để lại một file dở dang.

Khi một lệnh gọi hoạt động không đúng, --debug thêm thời gian HTTP cho mỗi lần thử; hãy xóa sạch log của nó trước khi chia sẻ. Nếu bạn đang gặp lỗi 429, hướng dẫn giới hạn tốc độ OpenAI của chúng tôi giải thích các tier.

OpenAI CLI so với Codex CLI so với lệnh openai cũ

Ba công cụ chia sẻ một nhà cung cấp và hai công cụ chia sẻ một cái tên. Đây là phiên bản ngắn gọn:

Chạy openai codex và OpenAI CLI sẽ tự in các lệnh cài đặt Codex, lưu ý rằng đó là một công cụ riêng biệt với đăng nhập riêng. Hướng dẫn Codex CLI của chúng tôi bao quát khía cạnh agent, và mã nguồn nằm tại github.com/openai/codex.

Coi chừng xung đột PATH

Gói Python openai cũng cài đặt một binary tên là openai. Nếu bạn từng chạy pip install openai, bạn có thể có hai:

Trên máy Mac này, bản Python báo openai 2.30.0 và cung cấp các lệnh con api, tools, migrate và grit; bản Go báo openai version 1.44.1. Bất kỳ thư mục nào đứng trước trên PATH của bạn sẽ thắng. Chạy which -a openai và openai --version sau khi bạn cài đặt. Nếu đầu ra ghi openai version 1.44.1 (hoặc mới hơn), bạn có đúng bản. Nếu nó in một số phiên bản trần như openai 2.30.0, hãy sắp xếp lại PATH của bạn hoặc gọi binary mới bằng đường dẫn đầy đủ của nó.

Apidog CLI phù hợp ở đâu bên cạnh OpenAI CLI

OpenAI CLI thực hiện các lệnh gọi đến OpenAI. Nó không biết gì về API của riêng bạn: các endpoint mà ứng dụng của bạn cung cấp trên nền OpenAI, các môi trường bạn triển khai, hoặc các assertion chứng minh rằng một bản phát hành không làm hỏng bất cứ thứ gì. Đó là một công việc khác, và đó là lúc Apidog CLI xuất hiện. Bạn không chọn cái này thay cho cái kia; hầu hết các nhóm phát hành một tính năng AI đều muốn cả hai.

Tốt hơn nữa, hãy để coding agent của bạn chạy cả hai. Thiết lập Apidog CLI một lần:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick your agent when prompted

Sau đó đưa cho agent của bạn một [REDACTED PROMPT]
Use the openai CLI to confirm my key works with one responses create call on gpt-5.5.
Then import ./openapi.yaml into Apidog project , create a test case for
POST /v1/summarize that asserts a 200 and a non-empty "summary" field, run it
against the staging environment and summarize any failures.

Agent kiểm tra key với `openai`, sau đó làm việc qua Apidog CLI. Nó đọc schema trước khi viết bất kỳ payload nào, xác thực file, và chỉ sau đó mới tạo và chạy test case:

bash
apidog import --project --format openapi --file ./openapi.yaml
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project --file case.json
apidog run --test-case --project -e -r cli,json

Hai chi tiết từ `apidog test-case create --help` giúp tiết kiệm một vòng lặp: test case cần một `categoryId` hợp lệ (liệt kê chúng với `apidog test-case category --project <id>`), và payload nên đến từ `cli-schema`, không bao giờ từ trí nhớ. Cùng dòng `apidog run` với `-r junit` có thể đưa vào CI, như [hướng dẫn Apidog CLI CI/CD](https://apidog.com/vi/blog/apidog-cli-ci-cd-pipeline?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation) của chúng tôi chỉ ra. Nếu Codex là agent của bạn, hãy bắt đầu với [Apidog CLI trong Codex](https://apidog.com/vi/blog/apidog-cli-in-codex?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation).

Gói Miễn phí của Apidog bao gồm tối đa 4 người dùng, vì vậy một nhóm nhỏ có thể thử điều này mà không cần quyết định mua.

## FAQ

**OpenAI CLI có miễn phí không?** Công cụ này miễn phí và mã nguồn mở theo Apache 2.0. Các lệnh gọi API mà nó thực hiện được tính phí vào tài khoản OpenAI của bạn theo giá API thông thường. Các lệnh cục bộ như `openai tokenizer` và mọi trang `--help` đều không tốn gì và không cần key.

**OpenAI CLI có giống Codex CLI không?** Không. `openai` gửi các yêu cầu API trực tiếp, một yêu cầu mỗi lệnh. `codex` là một coding agent đọc và chỉnh sửa dự án của bạn và chạy các lệnh. Chúng được cài đặt riêng và xác thực riêng.

**Làm cách nào để cài đặt OpenAI CLI trên Mac?** Chạy `brew install openai/tools/openai`, hoặc tải file zip `macos_arm64` (Apple Silicon) hoặc `macos_amd64` (Intel) từ GitHub Releases và đặt binary vào PATH của bạn. Sau đó chạy `openai --version` để xác nhận bạn không đang chạm vào lệnh `openai` Python cũ hơn.

**OpenAI CLI có hoạt động trong shell script và CI không?** Có, đó là mục tiêu thiết kế chính của nó. Dùng `--format json` hoặc `jsonl` để có đầu ra có thể phân tích, kiểm tra trạng thái thoát, giữ key trong `OPENAI_API_KEY` từ trình quản lý secret của bạn, và đặt `OPENAI_CLI_NO_AUTO_UPDATE=1` để giữ phiên bản được ghim.

**OpenAI CLI được phát hành khi nào?** Phiên bản 1.0.0 được phát hành trên GitHub vào ngày 5 tháng 5 năm 2026. Tính đến ngày 28 tháng 10 năm 2026, bản phát hành mới nhất là 1.44.1, từ ngày 27 tháng 10.