Cài đặt Codex CLI

Tìm hiểu cách cấu hình Codex CLI để dùng API của Aiberm. Hướng dẫn này gồm cài đặt và cấu hình cho Windows, macOS và Linux.

Codex CLI là gì?

Codex CLI là giao diện dòng lệnh của OpenAI, được thiết kế cho các tác vụ terminal liên quan đến mã. Nó chú trọng đầu ra sẵn sàng cho kỹ thuật với các thay đổi mã rõ ràng, có thể hành động hơn so với công cụ chat thông thường. Khi cấu hình để dùng Aiberm, bạn có thể truy cập nhiều mô hình AI qua một endpoint tiết kiệm chi phí.

Điều kiện tiên quyết

Trước khi bắt đầu, hãy đảm bảo bạn có:

Một tài khoản Aiberm (Đăng ký tại đây)
Một API key Aiberm (Lấy khóa của bạn)
Node.js v20 trở lên kèm npm

Cài đặt

Cài Codex CLI toàn cục bằng npm:

npm install -g @openai/codex

Kiểm tra cài đặt:

codex --version

Lệnh này sẽ hiển thị số phiên bản.

Cấu hình

Codex CLI dùng tệp config.toml để cấu hình. Vị trí thư mục cấu hình khác nhau theo hệ điều hành:

Windows: %userprofile%\.codex
macOS/Linux: ~/.codex

Phương pháp 1: Cấu hình thủ công

Đi tới thư mục cấu hình rồi tạo hoặc chỉnh config.toml:

macOS/Linux:

mkdir -p ~/.codex
nano ~/.codex/config.toml

Windows:

mkdir $env:USERPROFILE\.codex -Force
notepad $env:USERPROFILE\.codex\config.toml

Thêm cấu hình sau:

model = "gpt-5.6-sol"
model_provider = "aiberm"
model_reasoning_effort = "xhigh"

[model_providers.aiberm]
name = "Aiberm API"
base_url = "https://aiberm.com/v1"
experimental_bearer_token = "sk-your-aiberm-api-key"
wire_api = "responses"
supports_websockets = false

Quan trọng: Thay sk-your-aiberm-api-key bằng API key Aiberm thật của bạn. Key được lưu dưới dạng văn bản thuần trong config.toml. Không commit tệp này vào Git và không chia sẻ tệp với người khác.

Phương pháp 2: Cấu hình bằng một lệnh

macOS/Linux:

mkdir -p ~/.codex && cat > ~/.codex/config.toml << 'EOF'
model = "gpt-5.6-sol"
model_provider = "aiberm"
model_reasoning_effort = "xhigh"

[model_providers.aiberm]
name = "Aiberm API"
base_url = "https://aiberm.com/v1"
experimental_bearer_token = "sk-your-aiberm-api-key"
wire_api = "responses"
supports_websockets = false
EOF

Windows PowerShell:

$configPath = "$env:USERPROFILE\.codex"
New-Item -ItemType Directory -Force -Path $configPath | Out-Null
@"
model = "gpt-5.6-sol"
model_provider = "aiberm"
model_reasoning_effort = "xhigh"

[model_providers.aiberm]
name = "Aiberm API"
base_url = "https://aiberm.com/v1"
experimental_bearer_token = "sk-your-aiberm-api-key"
wire_api = "responses"
supports_websockets = false
"@ | Out-File -FilePath "$configPath\config.toml" -Encoding utf8

Quan trọng: Thay sk-your-aiberm-api-key trong cấu hình bằng API key Aiberm thật của bạn. Key được lưu dưới dạng văn bản thuần trong config.toml. Không commit tệp này vào Git và không chia sẻ tệp với người khác.

Kiểm tra cấu hình

Kiểm tra cài đặt Node.js:

node -v
npm -v

Xác nhận cài đặt Codex CLI:

codex --version

Kiểm tra kết nối API:

codex "Hi"

Nếu cấu hình đúng, Codex CLI sẽ phản hồi bằng API của Aiberm.

Xử lý sự cố

Lỗi 401 Unauthorized

Xác nhận API key đúng: Console → API Keys
Đảm bảo experimental_bearer_token chứa API key Aiberm thật và placeholder không bị lưu nguyên trạng

Lỗi 403 Forbidden

Kiểm tra API key còn hiệu lực
Xác nhận số dư tài khoản tại https://aiberm.com/console
Đảm bảo API key có quyền truy cập mô hình được yêu cầu

Lỗi mạng

Kiểm tra kết nối internet
Kiểm tra xem bạn có truy cập được https://aiberm.com trên trình duyệt không
Đảm bảo tường lửa cho phép kết nối HTTPS đi ra
Xác nhận base_url trong config.toml đúng: https://aiberm.com/v1

Cấu hình không có hiệu lực

Khởi động lại terminal sau khi chỉnh config.toml
Kiểm tra cú pháp TOML (không có khoảng trắng thừa, dấu ngoặc đúng)
Kiểm tra vị trí tệp cấu hình đúng với hệ điều hành của bạn
Đảm bảo tệp được lưu là config.toml (không phải config.toml.txt)

Không tìm thấy lệnh Codex

macOS/Linux:

# Check if npm global bin is in PATH
npm config get prefix

# If needed, add to PATH in ~/.zshrc or ~/.bashrc:
export PATH="$(npm config get prefix)/bin:$PATH"

Windows:

Xác nhận đường dẫn npm global nằm trong PATH hệ thống
Khởi động lại terminal sau khi cài npm