Codex CLI là coding agent chạy trong terminal: bạn giao việc bằng câu lệnh và có thể cấu hình API key thay cho đăng nhập tài khoản OpenAI. Nếu đang làm trong một repository, bạn có thể dùng nó để xử lý tác vụ lập trình ngay tại nơi mình chạy lệnh. Điểm cần phân biệt từ đầu là cài được công cụ chưa đồng nghĩa với gọi được model. Bài này đi từ `npm install -g @openai/codex` đến cách đối chiếu cấu hình API, chọn model đang được hỗ trợ và khoanh vùng lỗi khi chạy thử. Bạn sẽ biết cần kiểm tra gì trong `~/.codex/config.toml`, thay vì đoán tên model hoặc chép một lệnh cài cũ. Với lệnh cài tự động ở trang Kết nối app, hãy lấy bản đang hiển thị lúc bạn thao tác; hướng dẫn có thể thay đổi theo phiên bản.

Tóm tắt nhanh

• Cài Codex CLI bằng gói npm `@openai/codex`; macOS còn có phương thức Homebrew.
• Muốn dùng API key, kiểm tra cấu hình trong `~/.codex/config.toml` và danh sách model hiện được hỗ trợ.
• Khi chạy không được, kiểm tra trước API key, tên model và thông báo lỗi trong terminal.

Bạn đang đứng trong thư mục dự án, thấy một bài kiểm thử thất bại và muốn giao việc ngay trong terminal. Codex CLI nhận yêu cầu bằng ngôn ngữ tự nhiên để hỗ trợ tác vụ lập trình trong phiên làm việc đó. Điểm cần phân biệt: chương trình chạy trên máy bạn, nhưng việc gọi model vẫn cần kết nối đến dịch vụ từ xa. Cài được CLI không đồng nghĩa với việc đã có quyền sử dụng model.

Cùng là Codex, khác nơi bạn làm việc Với Codex CLI, terminal là chỗ bạn nhập yêu cầu và theo dõi thao tác trên dự án cục bộ. Codex Web là giao diện trên trình duyệt; extension IDE đưa tương tác vào trình biên tập; ứng dụng desktop có cửa sổ riêng. Nếu bạn đang mở một repository trong terminal và muốn làm việc tại đó, CLI là lựa chọn đúng ngữ cảnh. Nếu bạn cần xem mã ngay bên cạnh khung chat trong IDE, extension hợp thói quen hơn. Đây là khác biệt về điểm thao tác, không phải căn cứ để khẳng định một giao diện viết mã tốt hơn giao diện còn lại.

Đăng nhập tài khoản hay dùng API key?

Codex CLI có hai hướng xác thực: đăng nhập bằng tài khoản ChatGPT, hoặc dùng API key kèm cấu hình. Hai hướng này không nên xem là cùng một phiên đăng nhập: key cần

được cấp từ dịch vụ API mà bạn định gọi, còn cấu hình phải chỉ đúng dịch vụ và model tương ứng. File `~/.codex/config.toml` là một vị trí cấu hình được tài liệu Codex CLI đề cập; chỉ có file này trên máy không chứng minh request đã đi qua nhà cung cấp bạn chọn. Khi chuyển từ đăng nhập ChatGPT sang API key

của một nhà cung cấp khác, hãy kiểm tra hướng dẫn kết nối ứng dụng và tài liệu hiện hành của bên đó trước khi điền thông số. Chúng tôi chưa xác minh cấu hình Codex CLI cho các model được gợi ý là GPT-6/5.6, nên không coi những tên này là lựa chọn mặc định.

Một yêu cầu như “tìm chỗ tính phí vận chuyển, sửa điều kiện miễn phí và chạy test liên quan” có thể bắt đầu ngay trong terminal tại thư mục dự án. Bạn vẫn cần đọc phần mã thay đổi trước khi chấp nhận: yêu cầu càng rộng, phạm vi sửa càng khó kiểm soát.

Những việc nên giao cho Codex CLI Đọc và lần theo mã nguồn: yêu cầu công cụ tìm hàm tính phí giao hàng, chỉ ra nơi gọi hàm và tóm tắt luồng xử lý. Việc này hữu ích khi bạn vừa nhận một repository lạ và chưa biết nên mở file nào trước. Sửa hoặc tạo mã: mô tả đầu vào, đầu ra và file cần tác động, chẳng hạn “thêm kiểm tra mã bưu chính vào hàm hiện có, không đổi chữ ký hàm”. Nếu cần một script mới, hãy nêu đường dẫn dự kiến và ví dụ dữ liệu để bạn dễ kiểm tra phần

được tạo ra. Chạy lệnh kiểm tra: yêu cầu chạy bộ test liên quan

sau khi sửa, rồi xem lệnh nào thất bại và phần mã nào đã thay đổi. Đừng coi việc lệnh chạy xong là bằng chứng bản sửa đúng; bạn vẫn phải đối chiếu kết quả với yêu cầu ban đầu.

Trước khi gửi prompt đầu tiên Bạn cần terminal có quyền đọc repository và quyền ghi vào những file dự định sửa. Kiểm tra `node –version` và `npm –version` trước khi chọn cách cài qua npm; trên macOS, Homebrew cũng là một phương thức cài

được tài liệu Codex CLI nêu. Nếu dùng npm, lệnh cài gói là `npm install -g @openai/codex`; sau đó chạy `codex –version` để xem lệnh đã có trong terminal chưa. Kết nối mạng cũng cần hoạt động khi công cụ gọi model. Trước prompt thử đầu tiên, hãy chuẩn bị API key nếu bạn chọn cách xác thực bằng key, và kiểm tra tên model trong danh sách do dịch vụ bạn định dùng công bố; đừng tự điền GPT-6 hay GPT-5.6 khi chưa thấy chúng ở đó. Một prompt nhỏ như “chỉ ra file chứa hàm tính phí vận chuyển, chưa sửa mã” giúp bạn kiểm tra đường gọi model trước khi cho phép thay đổi repository.

Bắt đầu từ trang Kết nối app của RevidAPI và sao chép đúng lệnh đang hiển thị tại thời điểm bạn cấu hình. Không tự thay `base URL`, tên biến môi trường hoặc model theo một bài viết cũ; các giá trị này phụ thuộc tài liệu hiện hành và phiên bản Codex CLI bạn đang dùng.

Quy trình cấu hình

Một request thất bại trong Codex CLI thường thuộc một trong bốn lớp: thông tin xác thực, cấu hình endpoint, model hoặc môi trường chạy terminal. Kiểm tra theo lớp giúp bạn không sửa `config.toml` khi lỗi thực tế nằm ở API key chưa có trong phiên shell hiện tại.

Kiểm tra từ terminal đến nhà cung cấp Trước hết, mở một terminal mới rồi kiểm tra biến key bằng `printenv` hoặc lệnh tương ứng với tên biến trong hướng dẫn cài đặt. Không in toàn bộ giá trị key vào log; chỉ xác nhận biến có tồn tại. Tiếp theo, đọc `~/.codex/config.toml` và đối chiếu `base_url`, tên model cùng định dạng endpoint với phiên bản Codex CLI đang cài. Một URL thừa `/v1` cũng có thể khiến request thành đường dẫn sai.

Developer tự động hóa việc lặp lại Một developer freelance nhận thư mục gồm 200 file `.md` từ khách hàng Việt Nam, cần đổi tiêu đề, chuẩn hóa dấu câu và tạo thêm trường `slug`. Bạn có thể giao Codex CLI kiểm tra cấu trúc repository, viết script Node.js rồi chạy thử trên 3 file mẫu trước khi xử lý toàn bộ. Prompt nên nêu rõ quy tắc như giữ nguyên code fence, không dịch chuỗi trong dấu backtick và dùng UTF-8; đây là các chi tiết thường gây lỗi khi nội dung có tiếng Việt. Kịch bản minh họa này không phải case study có dữ liệu khách hàng xác thực. Cách làm phù hợp khi developer cần rà soát diff bằng `git diff`, chạy một lệnh kiểm thử như `npm test`, rồi mới đưa script vào cron hoặc pipeline nội bộ. Codex CLI đảm nhiệm phần thao tác trong terminal; API cung cấp model để phân tích yêu cầu và đề xuất mã, còn quyền đọc, ghi thư mục vẫn phải

được bạn kiểm tra trước.

Marketer nối nội dung với workflow Một marketer tại Hà Nội quản lý lịch đăng cho 3 kênh: Facebook, TikTok và blog. Họ có thể dùng Codex CLI để tạo bộ quy tắc biến brief tiếng Việt thành các trường cố định như `title`, `caption`, `hashtags` và `review_status`, sau đó chuyển dữ liệu sang workflow n8n

của RevidAPI để chạy các bước xử lý đã được thiết lập. Codex CLI phù hợp với việc sửa template, kiểm tra JSON và phát hiện trường bị thiếu; n8n phù hợp với việc nối các bước theo lịch hoặc theo sự kiện. Kịch bản trên cũng chỉ là minh họa, chưa đại diện cho kết quả của một khách hàng cụ thể. Với nội dung bán hàng, marketer nên đặt bước duyệt thủ công trước khi xuất bản, nhất là khi prompt có giá niêm yết bằng đồng Việt Nam, tên phường xã hoặc chính sách đổi trả. Nếu không muốn quản lý từng lệnh terminal, creator có thể chọn AI Studio Workflow cho phần thao tác trực quan; lựa chọn này không thay thế việc kiểm tra nội dung và quyền truy cập dữ liệu.

Codex CLI chạy trong terminal, còn RevidAPI cung cấp lớp API để gửi yêu cầu đến model. Vì vậy, bạn cần đưa API key và địa chỉ endpoint vào phiên terminal trước khi giao tác vụ coding cho Codex CLI.

Nạp API key mà không để lộ trong mã nguồn Tạo biến môi trường trong shell hiện tại, chẳng hạn `export REVIDAPI_API_KEY=’YOUR_API_KEY’`, rồi truyền biến đó qua header `Authorization: Bearer`. Không dán key vào `~/.codex/config.toml`, repository Git, script commit chung hoặc lệnh có thể bị lưu trong history. Lấy key tại `https://revidapi.com/dashboard`; nếu tài liệu

của phiên Codex yêu cầu header `x-api-key`, dùng đúng tên header đó thay cho `Authorization`. Base URL của endpoint được công bố là `https://revidapi.com`. Trước khi chạy prompt lớn, gọi `GET /v1/chat/models` để xem model đang có quyền truy cập. `claude-sonnet-5` là model xuất hiện trong endpoint mẫu hiện hành; các tên như GPT-6 hoặc 5.6 chỉ nên nhập khi danh sách model trên dashboard trả về đúng tên đó.

export REVIDAPI_API_KEY='YOUR_API_KEY'
export REVIDAPI_BASE_URL='https://revidapi.com' curl "$REVIDAPI_BASE_URL/v1/chat/models" \ -H "Authorization: Bearer $REVIDAPI_API_KEY" curl "$REVIDAPI_BASE_URL/v1/chat/completions" \ -H "Authorization: Bearer $REVIDAPI_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"Kiểm tra kết nối"}]}'

Kiểm tra quota và phân biệt workflow `GET /v1/chat/models` chỉ kiểm tra danh sách model, không phải endpoint quota. Trước một lô tác vụ, bạn xem credit, usage hoặc cảnh báo giới hạn trong `https://revidapi.com/dashboard`; hãng chưa công bố endpoint quota trong danh sách dùng cho phần này. Nếu request trả lỗi model, key hoặc giới hạn, giữ nguyên mã lỗi để phân biệt lỗi cấu hình Codex CLI với lỗi từ API. Các đường dẫn `/v1/chat/completions`, `/v1/images/generations` và `/v1/video/generate` là API HTTP; chúng không phải workflow n8n hay AI Studio Workflow. Codex CLI có thể gọi API hội thoại để xử lý coding, nhưng việc tạo ảnh hoặc video cần đúng endpoint và model tương ứng, không tự biến thành một workflow kéo-thả. Trước khi chạy hàng loạt, thử một request có nội dung ngắn và kiểm tra log để chắc rằng key không bị in ra terminal.

Codex CLI là gì?

Codex CLI là coding agent chạy trong terminal, nhận yêu cầu để hỗ trợ tác vụ lập trình qua model từ xa. Tài liệu SERP ghi nhận công cụ có thể cài bằng gói npm `@openai/codex`; file cấu hình thường

được đặt tại `~/.codex/config.toml`.

Có thể dùng API key thay đăng nhập OpenAI không?

Có, nếu phiên bản Codex CLI và nhà cung cấp API hỗ trợ cấu hình API key tương ứng. Bạn cần đối chiếu tên biến môi trường, `base_url`, model và định dạng cấu hình trong tài liệu hiện hành; API key riêng không tự bảo đảm mọi phiên bản CLI

sẽ nhận endpoint thay thế.

Lấy API key RevidAPI ở đâu?

Bạn đăng nhập dashboard RevidAPI để tạo hoặc sao chép API key. Trước khi chạy Codex CLI, kiểm tra key đã

được nạp vào đúng phiên terminal và không xuất hiện trong `~/.codex/config.toml`, repository hoặc log chia sẻ công khai.

Vì sao Codex CLI báo lỗi model hoặc endpoint?

Kiểm tra lần lượt `base_url`, đường dẫn endpoint, model và quyền truy cập

của key. Nếu tên model lấy từ trang Kết nối app khác với giá trị trong cấu hình, request có thể thất bại dù lệnh cài `@openai/codex` vẫn chạy bình thường.

Nên kiểm tra gì khi bị rate limit hoặc quota?

Mở dashboard RevidAPI để xem usage, quota, giới hạn tốc độ và trạng thái tài khoản. Với lỗi xảy ra sau nhiều request liên tiếp, hãy thử lại bằng một prompt ngắn và ghi lại mã lỗi, model cùng thời điểm request trước khi đổi cấu hình.

Khám phá workflow miễn phí tại AI Tạo ảnh & Video và lấy API key tại API Marketplace RevidAPI.