Feat : Gitbook

2026-09-22 13:38:31 +00:00 · 2026-05-11 11:50:24 +07:00
parent 7ad538bcf2
commit fd92af77a0
124 changed files with 34154 additions and 4 deletions
@@ -0,0 +1,136 @@
+# 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`):
+
+```bash
+# 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
+
+```bash
+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:
+
+```bash
+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
+
+```bash
+# 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
+
+```bash
+codex --model cx/gpt-5.2-codex "Create a REST API endpoint for user authentication"
+```
+
+### Giải thích Code
+
+```bash
+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`:
+
+```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:
+
+```bash
+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
+
+```bash
+export OPENAI_TIMEOUT=60  # seconds
+```
+
+### Debug Mode
+
+Bật debug mode để xem logs request/response chi tiết:
+
+```bash
+export CODEX_DEBUG=true
+codex --model cx/gpt-5.2-codex "Your prompt"
+```