Hướng dẫn cài đặt offline Codex CLI

Hướng dẫn cài đặt offline Codex CLI trên Windows và macOS, gồm cấu trúc gói, script setup, lỗi thường gặp và cách chuẩn bị API key tiết kiệm hơn.

Hướng dẫn cài đặt offline Codex CLI

Hướng dẫn này dành cho người mới muốn cài Codex CLI mà không phụ thuộc vào mạng ngoài ổn định, rồi dùng ngay sau khi setup xong.

Tài liệu này phù hợp với ai

Người muốn thử Vibe Coding mà chưa có mạng ổn định

Người lần đầu dùng Codex CLI và muốn một đường cài đặt gọn

Nhóm cần một gói offline có thể phát cho đồng nghiệp hoặc bạn bè

Chuẩn bị trước khi cài

Máy đích nên có sẵn Node.js và npm. Hãy kiểm tra trước trong terminal.

node -v
npm -v

Cấu trúc gói

Bộ offline được chia theo nền tảng: windows-x64, macos-arm64 và macos-x64. Mỗi thư mục chứa gói chính, gói runtime theo nền tảng, script cài và script setup.

Xác định nền tảng trước

Windows

Phần lớn máy Windows thông thường dùng windows-x64.

macOS

Dùng macos-arm64 cho Apple Silicon và macos-x64 cho Intel Mac. Trên macOS có thể kiểm tra bằng uname -m.

uname -m

Các bước cài đặt trên Windows x64

Bước 1: vào thư mục cài offline

cd "your-path\codex-npm-offline\windows-x64\npm-offline"

Bước 2: chạy script cài đặt

.\install-codex-windows-x64.cmd

Bước 3: cài thủ công nếu cần

npm install -g .\codex-npm-0.121.0-alpha.6.tgz @openai/codex-win32-x64@file:.\codex-npm-win32-x64-0.121.0-alpha.6.tgz

Bước 4: kiểm tra cài đặt thành công

codex --version

Chạy script setup

.\run-codex-setup.cmd

Sau khi cài, script setup sẽ hỏi Base URL và API key.

Script sẽ ghi cấu hình vào file chính của Codex và thường tạo bản sao lưu trước khi ghi đè.

~/.codex/config.toml
~/.codex/auth.json

Cài đặt macOS Apple Silicon

cd "/your-path/codex-npm-offline/macos-arm64/npm-offline"
bash ./install-codex-macos-arm64.sh

Nếu thích cài tay, bạn có thể dùng npm để cài gói chính và gói nền tảng.

npm install -g ./codex-npm-0.121.0-alpha.6.tgz @openai/codex-darwin-arm64@file:./codex-npm-darwin-arm64-0.121.0-alpha.6.tgz

Cài đặt macOS Intel

cd "/your-path/codex-npm-offline/macos-x64/npm-offline"
bash ./install-codex-macos-x64.sh

npm install -g ./codex-npm-0.121.0-alpha.6.tgz @openai/codex-darwin-x64@file:./codex-npm-darwin-x64-0.121.0-alpha.6.tgz

Lỗi thường gặp

Không tìm thấy lệnh codex sau khi cài

Đóng terminal hiện tại, mở terminal mới rồi chạy lại codex --version.

Windows chặn script

Hãy dùng entry setup vì nó gọi PowerShell với ExecutionPolicy Bypass.

macOS báo script không có quyền chạy

Hãy chạy script shell qua bash thay vì double-click.

Cách lấy API key ổn định và rẻ hơn

Nếu vẫn cần key nhà cung cấp, hãy đăng ký, xem nhóm model và giá, tạo API token rồi sao chép Base URL và API key vào luồng setup.

Đường dùng ngắn nhất

Cài đúng gói theo nền tảng

Chạy script setup và nhập Base URL cùng API key

Khởi động Codex bằng codex hoặc dùng codex --yolo để vào chế độ chạy trực tiếp hơn

codex
codex --yolo