Lỗi thường gặp

codex: command not found sau khi cài

npm đã cài xong nhưng terminal hiện tại chưa nạp lại PATH. Mở terminal mới rồi thử lại.

Nếu vẫn không được, kiểm tra thư mục bin global của npm có trong PATH chưa:

npm config get prefix
# thư mục trên + /bin phải nằm trong $PATH

Lỗi EACCES: permission denied khi npm install

Node cài bằng quyền hệ thống (thường gặp trên Linux). Hai cách sửa:

Cách 1 — đổi prefix npm (nhanh):

npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"   # thêm dòng này vào ~/.bashrc hoặc ~/.zshrc

Cách 2 — dùng nvm (khuyến nghị lâu dài):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
nvm install --lts

Sau đó chạy lại lệnh cài đặt.

Key sai hoặc hết hạn (lỗi 401 / unauthorized)

• Kiểm tra key trong ~/.codex/auth.json đúng và đủ ký tự (key dạng sk-...)
• Đổi key mới: chạy lại lệnh cài đặt với key mới — config cũ tự được sao lưu

Windows: file config bị lỗi encoding

Nếu bạn sửa file thủ công bằng PowerShell và dùng Set-Content -Encoding UTF8, PowerShell 5.1 sẽ chèn BOM vào đầu file làm Codex không đọc được TOML/JSON. Cách sửa: dùng script cài đặt (ghi file chuẩn không BOM), hoặc lưu file bằng VS Code với encoding UTF-8 (không phải UTF-8 with BOM).

Khôi phục config cũ

Mỗi lần chạy script, config cũ được sao lưu cạnh file mới:

ls ~/.codex/*.bak.*
# khôi phục: copy đè lại, ví dụ
cp ~/.codex/config.toml.bak.20260811120000 ~/.codex/config.toml

Vẫn chưa hết lỗi?

Liên hệ hỗ trợ kèm ảnh chụp lỗi — xem kênh liên hệ ở trang Bắt đầu.