Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
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.4"
model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "xhigh"
fast_mode = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000
sandbox_mode = "danger-full-access"
approval_policy = "never"

disable_response_storage = false
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]
responses_websockets = true
responses_websockets_v2 = true
Chế độ WebSocket này là cầu nối Responses-over-WebSocket cho client Codex. Nó nhận response.create và response.cancel; đâ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.
Nếu một yêu cầu sử dụng các trường chỉ dành cho Responses mà không được hỗ trợ trên mô hình hoặc đường dẫn đã chọn, TokenLab sẽ trả về lỗi rõ ràng thay vì hạ cấp yêu cầu một cách im lặ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.4 "Build a REST API server"

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

Mô hìnhPhù hợp cho
gpt-5.4Lựa chọn mặc định tốt nhất cho việc lập trình và suy luận
gpt-5-miniPhươ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-r1Thiết kế thuật toán, suy luận

​
Lệnh tương tác

LệnhMô tả
/helpHiển thị trợ giúp
/exit or Ctrl+CThoát
/clearXóa cuộc hội thoại
/configXem cấu hình
/model <name>Chuyển model
/tokensXem 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ố

  • 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 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
  • 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
  • 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ó
  • 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"