Endpoint: https://api.shopaikey.com
Codex CLI là công cụ dòng lệnh (CLI) chính thức của OpenAI, giúp bạn lập trình cặp (pair programming), refactor code, và debug ngay trong terminal.
0. Cài đặt tự động (Khuyên dùng)
macOS / Linux
curl -fsSL https://cdn.shopaikey.com/codex/setup.sh | bash
Windows (PowerShell)
irm https://cdn.shopaikey.com/codex/setup.ps1 | iex
Script tự động cài Codex CLI (nếu chưa có), backup settings cũ, và cấu hình API key.
1. Cài đặt Codex
:::tip Khuyến nghị sử dụng script cài đặt tự động ở phần 0 để cấu hình nhanh chóng! :::
Bạn có thể chọn một trong ba cách cài đặt Codex:
Codex CLI (Command Line Interface)
Nếu bạn sử dụng phiên bản dòng lệnh, chạy lệnh sau để cài đặt:
npm i -g @openai/codex@latest
Package Codex CLI: https://www.npmjs.com/package/@openai/codex
VSCode Extension
Nếu bạn sử dụng VSCode, có thể cài đặt extension chính thức:
https://marketplace.visualstudio.com/items?itemName=openai.chatgpt
Hoặc tìm kiếm codex trực tiếp trong VSCode Extension Marketplace.
Codex App (Desktop)
Nếu bạn muốn sử dụng ứng dụng desktop, tải về tại:
https://developers.openai.com/codex/quickstart?setup=app
2. Tìm thư mục cấu hình Codex
Đầu tiên, mở Terminal (hoặc Command Prompt trên Windows).
Sau đó chạy lệnh tương ứng với hệ điều hành của bạn để mở thư mục cấu hình:
Windows
Trong CMD:
start "" "%USERPROFILE%\.codex"
macOS / Linux
open "$HOME/.codex"
Thư mục .codex sẽ được mở ra, đây là nơi chứa các file cấu hình của Codex.
3. Tạo file cấu hình
Trong thư mục .codex, tạo hai file sau:
File config.toml
Tạo file config.toml với nội dung:
model_provider = "shopaikey"
model = "gpt-5.2"
model_reasoning_effort = "xhigh"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
model_verbosity = "high"
[model_providers.shopaikey]
name = "shopaikey"
base_url = "https://api.shopaikey.com/v1"
wire_api = "responses"
requires_openai_auth = true
File auth.json
Tạo file auth.json với nội dung:
{
"OPENAI_API_KEY": ""
}
4. Điền API Key
Trong file auth.json, điền API Key của bạn vào trường OPENAI_API_KEY:
{
"OPENAI_API_KEY": "sk-your-api-key-here"
}
API Key có thể lấy từ dashboard của ShopAIKey.
Sau đó lưu file.
5. Khởi động và kiểm tra
Mở Terminal và chạy lệnh:
codex
Nếu cấu hình thành công, bạn sẽ vào chế độ chat và có thể bắt đầu sử dụng Codex.
Lưu ý quan trọng
:::warning Lưu ý khi sử dụng CLI
- Không nên chuyển model trong phiên chat: Sau khi khởi động CLI, tránh chuyển đổi model trong cùng một phiên làm việc.
- Nếu đã chuyển model: Cần khởi động lại Codex bằng lệnh sau để tiếp tục sử dụng model mong muốn:
codex -m gpt-5.3-codex -c model_reasoning_effort="xhigh"
:::
:::warning Cấu hình có hiệu lực khi nào?
- Mỗi khi sửa file
config.tomlhoặcauth.json, bạn phải khởi động lại Codex để cấu hình có hiệu lực. - Cách khởi động lại: Nhấn
Ctrl + Cđể thoát Codex hiện tại, sau đó chạy lại lệnhcodex. - Áp dụng cho: VSCode Extension và Codex App cũng sử dụng cùng hệ thống cấu hình này. :::
6. Hướng dẫn Sử dụng
Sau khi cấu hình xong, bạn có thể bắt đầu sử dụng Codex CLI.
Khởi động chế độ tương tác (Interactive Mode)
Tại thư mục dự án của bạn, gõ:
codex
Lúc này bạn sẽ vào giao diện chat. Bạn có thể hỏi:
"Giải thích cấu trúc dự án này cho tôi"
"Tạo một file test cho hàm login trong src/auth.js"
Chạy lệnh trực tiếp (Single Shot)
Gửi một yêu cầu nhanh mà không cần vào chế độ chat:
codex "Refactor file utils.js để code gọn hơn"
Chọn model
Codex CLI hỗ trợ nhiều model khác nhau. Bạn có thể chỉ định model khi khởi động:
codex --model gpt-5 "Giải thích hàm calculateTotal"
Xem danh sách model đầy đủ tại Bảng giá Model.
Cấu hình nâng cao (Tùy chọn)
Sử dụng biến môi trường
Ngoài file cấu hình, bạn cũng có thể sử dụng biến môi trường để cấu hình Codex:
Linux / macOS
export OPENAI_BASE_URL="https://api.shopaikey.com/v1"
export OPENAI_API_KEY="sk-your-api-key-here"
Windows (PowerShell)
$env:OPENAI_BASE_URL = "https://api.shopaikey.com/v1"
$env:OPENAI_API_KEY = "sk-your-api-key-here"
Windows (CMD)
set OPENAI_BASE_URL=https://api.shopaikey.com/v1
set OPENAI_API_KEY=sk-your-api-key-here
Sử dụng file .env
Bạn cũng có thể tạo file .env trong thư mục ~/.codex/:
OPENAI_BASE_URL=https://api.shopaikey.com/v1
OPENAI_API_KEY=sk-your-api-key-here
Khắc phục sự cố
Codex không kết nối được
- Kiểm tra lại
base_urltrongconfig.tomlcó đúng làhttps://api.shopaikey.com/v1không - Kiểm tra API Key trong
auth.jsoncó hợp lệ không - Thử khởi động lại Codex sau khi sửa cấu hình
Lỗi "command not found"
- Đảm bảo đã cài đặt Codex CLI:
npm i -g @openai/codex@latest - Chạy
source ~/.zshrc(macOS/Linux) để load lại biến môi trường
Model không hoạt động đúng
- Kiểm tra tên model trong
config.tomlcó khớp với model bạn muốn sử dụng không - Khởi động lại Codex với tham số model cụ thể:
codex -m gpt-5.2 -c model_reasoning_effort="xhigh"