Codex CLI

Tổng quan

Kiểu: Công cụ lập trìnhPrimary Path: OpenAI Responses (đường dẫn tùy chọn nâng cao)Độ tin cậy hỗ trợ: Được hỗ trợ với giới hạn theo mô hình/đường dẫn

OpenAI Codex là một công cụ dòng lệnh (CLI) mã nguồn mở hoạt động như một đại lý lập trình nhẹ, có khả năng đọc, sửa đổi và chạy mã trong terminal. Nó được xây dựng trên các mô hình GPT và được tối ưu hóa cho việc tạo mã. Đối với TokenLab, Codex CLI có thể sử dụng /v1/responses, nhưng bạn nên coi đó là một đường dẫn tương thích nâng cao. Một số tính năng chỉ dành cho Responses không được đảm bảo hoạt động trên mọi mô hình và đường dẫn. Nén từ xa của Codex CLI được hỗ trợ tại POST /v1/responses/compact. Codex gửi model của phiên hiện tại trong body.model cho /compact và tự động nén, vì vậy model bạn muốn dùng để nén phải có sẵn trên đường dẫn Responses. Không cấu hình /v1/compact.

Yêu cầu hệ thống

OS: macOS, Linux (hỗ trợ chính thức), Windows qua WSL
Node.js: Phiên bản 18+
npm: Phiên bản 10.x.x hoặc cao hơn

Cài đặt

npm install -g @openai/codex

Xác minh cài đặt:

codex --version

Cấu hình

Bước 1: Thiết lập API Key

Tạm thời (phiên hiện tại):

export OPENAI_API_KEY="sk-your-tokenlab-key"

Cấu hình vĩnh viễn: Thêm vào ~/.bashrc, ~/.zshrc, hoặc ~/.bash_profile:

export OPENAI_API_KEY="sk-your-tokenlab-key"

Sau đó nạp lại:

source ~/.zshrc  # or source ~/.bashrc

Bước 2: Cấu hình config.toml

Chỉnh sửa ~/.codex/config.toml:

model_provider = "tokenlab"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "xhigh"
model_context_window = 258000
model_auto_compact_token_limit = 232200
sandbox_mode = "danger-full-access"
approval_policy = "never"

personality = "friendly"
service_tier = "fast"

[model_providers.tokenlab]
env_key = "OPENAI_API_KEY"
name = "TokenLab"
base_url = "https://api.tokenlab.sh/v1"
wire_api = "responses"
supports_websockets = true
websocket_connect_timeout_ms = 15000

[features]
fast_mode = true

Chế độ WebSocket này là cầu nối Responses-over-WebSocket cho client Codex. Nó chỉ nhận sự kiện chính thức response.create; stream là ngầm định, còn background và response.cancel không khả dụng trên transport này. Đây không phải OpenAI Realtime API và không nhận session.update, conversation.item.*, input_audio_buffer.*, âm thanh nhị phân hoặc envelope Realtime lồng nhau response.create.response.

Nếu file config không tồn tại, chạy codex một lần để tạo file, sau đó chỉnh sửa file. Khởi động lại Codex hoàn toàn sau khi thay đổi config.toml để nạp lại các cài đặt nhà cung cấp mới.

Codex đang loại bỏ hỗ trợ chat/completions cho các nhà cung cấp tùy chỉnh. Giữ wire_api = "responses" cho TokenLab trừ khi bạn cố ý sử dụng một đường dẫn tương thích cũ hơn.

TokenLab chuyển tiếp các trường Responses chưa biết theo best-effort mà không âm thầm hạ cấp yêu cầu sang Chat Completions. Upstream được chọn quyết định trường hoặc tổ hợp có được hỗ trợ hay không.

Sử dụng cơ bản

Bắt đầu chế độ tương tác:

codex

Lệnh trực tiếp:

codex "Fix the bug in main.py line 42"

Chỉ định model:

codex -m gpt-5.6-sol "Build a REST API server"

Các model được khuyến nghị

Mô hình	Phù hợp cho
`gpt-5.6-sol`	Lựa chọn mặc định tốt nhất cho việc lập trình và suy luận
`gpt-5-mini`	Phương án dự phòng nhanh hơn, rẻ hơn cho quy trình làm việc viết mã
`claude-sonnet-4-6`	Đánh giá mã, viết tài liệu
`deepseek-r1`	Thiết kế thuật toán, suy luận

Lệnh tương tác

Lệnh	Mô tả
`/help`	Hiển thị trợ giúp
`/exit` or `Ctrl+C`	Thoát
`/clear`	Xóa cuộc hội thoại
`/config`	Xem cấu hình
`/model <name>`	Chuyển model
`/tokens`	Xem lượng token đã sử dụng

Xác minh cấu hình

# Check environment variable
echo $OPENAI_API_KEY

# Test API connection
codex "Hello, Codex!"

# View configuration
cat ~/.codex/config.toml

Các trường hợp sử dụng phổ biến

Đánh giá mã:

git diff | codex "Review these code changes"

Tạo commit messages:

git diff --staged | codex "Generate a commit message for these changes"

Sửa lỗi:

codex "Fix the TypeScript errors in src/components/"

Giải thích mã:

cat main.py | codex "Explain what this code does"

Xử lý sự cố

Lỗi kết nối

Xác nhận base_url trong config.toml là chính xác https://api.tokenlab.sh/v1
Kiểm tra kết nối mạng
Đảm bảo không có can nhiễu proxy

Xác thực thất bại

Xác nhận env_key = "OPENAI_API_KEY" có trong ~/.codex/config.toml
Xác nhận biến môi trường OPENAI_API_KEY đã được đặt
Kiểm tra rằng khóa bắt đầu bằng sk-
Đảm bảo khóa đang hoạt động trong dashboard của TokenLab

Không tìm thấy model

Kiểm tra tên model khớp chính xác
Xác minh khả dụng của model tại tokenlab.sh/en/models

Trường native của Responses bị từ chối

Một số trường chỉ có sẵn trên /v1/responses khi TokenLab có thể đảm bảo hành vi đó cho mô hình và đường dẫn đã chọn
Nếu bạn thấy unsupported_request_field, loại bỏ trường đó hoặc chuyển sang một luồng công việc không phụ thuộc vào nó

/compact hoặc tự động nén thất bại

Codex CLI gọi POST /v1/responses/compact, không phải /v1/compact
Yêu cầu nén dùng model của phiên hiện tại, vì vậy model đó phải có sẵn trên đường dẫn Responses
Giữ wire_api = "responses" và base_url = "https://api.tokenlab.sh/v1"

Ma trận tương thích

Công cụ lập trình

SDK gốc

Framework và nền tảng

Ứng dụng chat

Tổng quan

Yêu cầu hệ thống

Cài đặt

Cấu hình

Bước 1: Thiết lập API Key

Bước 2: Cấu hình config.toml

Sử dụng cơ bản

Các model được khuyến nghị

Lệnh tương tác

Xác minh cấu hình

Các trường hợp sử dụng phổ biến

Xử lý sự cố

​Tổng quan

​Yêu cầu hệ thống

​Cài đặt

​Cấu hình

​Bước 1: Thiết lập API Key

​Bước 2: Cấu hình config.toml

​Sử dụng cơ bản

​Các model được khuyến nghị

​Lệnh tương tác

​Xác minh cấu hình

​Các trường hợp sử dụng phổ biến

​Xử lý sự cố

Tổng quan

Yêu cầu hệ thống

Cài đặt

Cấu hình

Bước 1: Thiết lập API Key

Bước 2: Cấu hình config.toml

Sử dụng cơ bản

Các model được khuyến nghị

Lệnh tương tác

Xác minh cấu hình

Các trường hợp sử dụng phổ biến

Xử lý sự cố