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

​
Tổng quan

Type: Coding ToolPrimary Path: OpenAI Responses (đường dẫn tùy chọn nâng cao)Support Confidence: Supported with model/path limits
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 LemonData, 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.

​
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-lemondata-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-lemondata-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 = "lemondata"
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.lemondata]
env_key = "OPENAI_API_KEY"
name = "lemondata"
base_url = "https://api.lemondata.cc/v1"
wire_api = "responses"
supports_websockets = true
websocket_connect_timeout_ms = 15000

[features]
responses_websockets = true
responses_websockets_v2 = true
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 LemonData 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, LemonData 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ị

ModelPhù 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

CommandDescription
/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.lemondata.cc/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 LemonData
  • Một số trường chỉ có sẵn trên /v1/responses khi LemonData 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ó