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

​
Tổng quan

OpenAI Codex là một công cụ dòng lệnh (CLI) mã nguồn mở đóng vai trò như một tác nhân lập trình (coding agent) 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ã.

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

  • Hệ điều hành: macOS, Linux (hỗ trợ chính thức), Windows thông 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

sudo npm install -g @openai/codex@latest
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 đó tải lại: 
source ~/.zshrc  # hoặc source ~/.bashrc

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

Chỉnh sửa ~/.codex/config.toml: 
model = "gpt-4o"
model_provider = "lemondata"

[model_providers.lemondata]
name = "LemonData"
base_url = "https://api.lemondata.cc/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"
Nếu tệp cấu hình không tồn tại, hãy chạy codex một lần để tạo tệp, sau đó chỉnh sửa tệp.

​
Cách 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 mô hình: 
codex -m gpt-4o "Build a REST API server"

​
Các mô hình hiện có

Mô hìnhTốt nhất cho
gpt-4oCác tác vụ lập trình phức tạp, kiến trúc
gpt-4o-miniSửa lỗi nhanh, các tác vụ đơn giản
claude-sonnet-4-5Đánh giá mã nguồn, tài liệu hóa
deepseek-r1Thiết kế thuật toán, suy luận

​
Các lệnh tương tác

LệnhMô tả
/helpHiển thị trợ giúp
/exit hoặc Ctrl+CThoát
/clearXóa cuộc hội thoại
/configXem cấu hình
/model <name>Chuyển đổi mô hình
/tokensXem mức sử dụng token

​
Xác minh cấu hình

# Kiểm tra biến môi trường
echo $OPENAI_API_KEY

# Kiểm tra kết nối API
codex "Hello, Codex!"

# Xem cấu hình
cat ~/.codex/config.toml

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

Đánh giá mã nguồn: 
git diff | codex "Review these code changes"
Tạo thông điệp commit: 
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ã nguồn: 
cat main.py | codex "Explain what this code does"

​
Khắc phục sự cố

  • Xác minh base_url trong config.toml chính xác là https://api.lemondata.cc/v1
  • Kiểm tra kết nối mạng
  • Đảm bảo không có sự can thiệp của proxy
  • Xác minh biến môi trường OPENAI_API_KEY đã được thiết lập
  • Kiểm tra xem key có bắt đầu bằng sk- hay không
  • Đảm bảo key đang hoạt động trong bảng điều khiển LemonData
  • Kiểm tra tên mô hình khớp chính xác
  • Xác minh tính khả dụng của mô hình tại lemondata.cc/en/models