decolua--9router/gitbook/content/vi/integration/codex.md

Tích hợp OpenAI Codex CLI

Tích hợp 9Router với OpenAI Codex CLI để định tuyến request API OpenAI qua hệ thống routing thông minh của 9Router.

Yêu cầu

• OpenAI Codex CLI đã cài đặt
• 9Router đang chạy cục bộ hoặc cloud endpoint đã cấu hình
• API key từ 9Router dashboard

Setup

1. Cấu hình biến môi trường

Đặt các biến môi trường sau trong file cấu hình shell (~/.bashrc, ~/.zshrc, hoặc ~/.bash_profile):

# Base URL for 9Router
export OPENAI_BASE_URL="http://localhost:20128/v1"

# API Key from 9Router dashboard
export OPENAI_API_KEY="your-9router-api-key"

2. Reload Shell Configuration

source ~/.zshrc  # or ~/.bashrc

3. Xác minh Cấu hình

Kiểm tra các biến môi trường đã set đúng:

echo $OPENAI_BASE_URL
echo $OPENAI_API_KEY

Model có sẵn

9Router cung cấp các model Codex sau:

Model ID	Mô tả
cx/gpt-5.2-codex	GPT-5.2 Codex - Phiên bản mới nhất
cx/gpt-5.1-codex-max	GPT-5.1 Codex Max - Extended context

Ví dụ Sử dụng

Sử dụng Cơ bản

# Use GPT-5.2 Codex
codex --model cx/gpt-5.2-codex "Write a function to sort an array"

# Use GPT-5.1 Codex Max
codex --model cx/gpt-5.1-codex-max "Explain this complex algorithm"

Tạo Code

codex --model cx/gpt-5.2-codex "Create a REST API endpoint for user authentication"

Giải thích Code

codex --model cx/gpt-5.1-codex-max "Explain what this code does: $(cat myfile.js)"

File Cấu hình

Bạn cũng có thể cấu hình Codex CLI qua file cấu hình. Tạo hoặc sửa ~/.codex/config.json:

{
  "baseUrl": "http://localhost:20128/v1",
  "apiKey": "your-9router-api-key",
  "defaultModel": "cx/gpt-5.2-codex"
}

Troubleshooting

Lỗi Xác thực

Nếu gặp lỗi xác thực:

1. Xác minh API key đúng trong 9Router dashboard
2. Kiểm tra biến môi trường OPENAI_API_KEY đã set
3. Đảm bảo API key chưa hết hạn

Lỗi Connection

Nếu gặp lỗi kết nối:

1. Xác minh 9Router đang chạy: curl http://localhost:20128/health
2. Kiểm tra biến môi trường đã set đúng
3. Đảm bảo không firewall nào chặn port 20128

Model không khả dụng

Nếu gặp lỗi "model not available":

1. Xác minh tên model khớp với cấu hình 9Router
2. Kiểm tra kết nối provider OpenAI đang hoạt động trong 9Router dashboard
3. Đảm bảo model có sẵn trong các provider đã kết nối

Cloud Endpoint

Để dùng 9Router cloud endpoint thay vì localhost:

export OPENAI_BASE_URL="https://9router.com"

Đảm bảo bạn đã cấu hình API key trong 9Router cloud dashboard.

Cấu hình Nâng cao

Custom Timeout

export OPENAI_TIMEOUT=60  # seconds

Debug Mode

Bật debug mode để xem logs request/response chi tiết:

export CODEX_DEBUG=true
codex --model cx/gpt-5.2-codex "Your prompt"