Bắt đầu nhanh với Codex
Cài đặt Codex trên Windows, macOS hoặc Linux, kết nối khóa API Modelflare và xác minh một yêu cầu Responses API.
Hướng dẫn này kết nối Codex với Modelflare và chạy yêu cầu đầu tiên. Sử dụng Tùy chọn A để thiết lập tự động. Sử dụng Tùy chọn B để cài đặt Codex trước, sau đó tự tạo từng tệp được yêu cầu.
1. Tạo khóa API
Đăng nhập vào bảng điều khiển Modelflare, mở Khóa API và tạo khóa có thể truy cập gpt-5.6-sol. Chọn bất kỳ nhóm không mặc định có sẵn nào liệt kê mô hình; không có nhóm yêu cầu duy nhất.
Giữ khóa API sẵn sàng. Bạn có thể sử dụng trình cài đặt hoặc định cấu hình các tệp tương tự theo cách thủ công.
2. Chọn phương pháp thiết lập
Tùy chọn A: chạy trình cài đặt
macOS hoặc Linux
Chạy lệnh này với tư cách người dùng bình thường của bạn:
curl -fsSL https://modelflare.dev/install/codex.sh | sh
Khi bạn đã đăng nhập với tư cách root trên VPS hoặc vùng chứa, hãy sử dụng:
curl -fsSL https://modelflare.dev/install/codex.sh | MODELFLARE_ALLOW_ROOT=1 sh
Không thêm sudo trên máy tính cá nhân thông thường. Tập lệnh cài đặt hoặc cập nhật Codex, sao lưu các tệp hiện có, yêu cầu khóa API Modelflare của bạn và ghi cấu hình nhà cung cấp trong ~/.codex.
Windows PowerShell
Mở PowerShell với tư cách người dùng Windows bình thường của bạn và chạy:
irm https://modelflare.dev/install/codex.ps1 | iex
Trình cài đặt yêu cầu ngôn ngữ và khóa API Modelflare của bạn, xác minh quyền truy cập vào gpt-5.6-sol và sao lưu các tệp hiện có trước khi thay đổi chúng. Khi quá trình hoàn tất, hãy tiếp tục Xác minh kết nối.
Option B: tự tạo từng tệp Codex
Sử dụng tùy chọn này khi bạn không muốn chạy tập lệnh thiết lập Modelflare. Thực hiện theo các bước theo thứ tự và sử dụng khối lệnh cho hệ điều hành của bạn trong mỗi bước.
Tùy chọn B tạo hai tệp trong thư mục .codex cấp người dùng của bạn: config.toml và modelflare_api_key.
Bước 1: cài đặt Codex CLI
Windows PowerShell
irm https://chatgpt.com/codex/install.ps1 | iex
codex --version
Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version
macOS
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version
Bước 2: tạo và nhập thư mục .codex
Windows PowerShell
New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Set-Location "$HOME\.codex"
Linux
mkdir -p ~/.codex
cd ~/.codex
macOS
mkdir -p ~/.codex
cd ~/.codex
Bước 3: tạo config.toml
Windows PowerShell
$config = @'
model_provider = "modelflare"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_supports_reasoning_summaries = true
[model_providers.modelflare]
name = "Modelflare"
base_url = "https://modelflare.dev/v1"
wire_api = "responses"
[model_providers.modelflare.auth]
command = "powershell.exe"
args = ["-NoProfile", "-NonInteractive", "-Command", "Get-Content -LiteralPath (Join-Path (Join-Path $HOME '.codex') 'modelflare_api_key') -Raw"]
'@
$utf8NoBom = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText(
(Join-Path (Get-Location) "config.toml"),
$config,
$utf8NoBom
)
Linux
cat > config.toml << 'EOF'
model_provider = "modelflare"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_supports_reasoning_summaries = true
[model_providers.modelflare]
name = "Modelflare"
base_url = "https://modelflare.dev/v1"
wire_api = "responses"
[model_providers.modelflare.auth]
command = "sh"
args = ["-lc", "cat ~/.codex/modelflare_api_key"]
EOF
chmod 600 config.toml
macOS
cat > config.toml << 'EOF'
model_provider = "modelflare"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_supports_reasoning_summaries = true
[model_providers.modelflare]
name = "Modelflare"
base_url = "https://modelflare.dev/v1"
wire_api = "responses"
[model_providers.modelflare.auth]
command = "sh"
args = ["-lc", "cat ~/.codex/modelflare_api_key"]
EOF
chmod 600 config.toml
Bước 4: tạo modelflare_api_key
Trước khi chạy lệnh cho hệ thống của bạn, hãy thay thế YOUR_MODELFLARE_API_KEY bằng khóa API hoàn chỉnh mà bạn đã tạo trong bảng điều khiển Modelflare. Tệp chỉ được chứa chính khóa—không giữ chỗ giữ chỗ hoặc thêm dấu ngoặc kép, dấu ngược hoặc dấu cách.
Windows PowerShell
$apiKey = @'
YOUR_MODELFLARE_API_KEY
'@
$apiKey = $apiKey.Trim()
$utf8NoBom = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText(
(Join-Path (Get-Location) "modelflare_api_key"),
$apiKey,
$utf8NoBom
)
$apiKey = $null
Linux
cat > modelflare_api_key << 'EOF'
YOUR_MODELFLARE_API_KEY
EOF
chmod 600 modelflare_api_key
macOS
cat > modelflare_api_key << 'EOF'
YOUR_MODELFLARE_API_KEY
EOF
chmod 600 modelflare_api_key
Bước 5: khởi động Codex
Windows PowerShell
Set-Location $HOME
New-Item -ItemType Directory -Force "my-codex-project" | Out-Null
Set-Location "my-codex-project"
codex --model gpt-5.6-sol
Linux
cd ~
mkdir -p my-codex-project
cd my-codex-project
codex --model gpt-5.6-sol
macOS
cd ~
mkdir -p my-codex-project
cd my-codex-project
codex --model gpt-5.6-sol
3. Xác minh kết nối
Nếu bạn đã sử dụng trình cài đặt, hãy đóng hoàn toàn mọi phiên Codex CLI, IDE hoặc phiên máy tính để bàn đã mở. Mở một thiết bị đầu cuối mới, nhập thư mục dự án và chạy:
codex --model gpt-5.6-sol
Sau đó hỏi Codex:
Trả lời bằng một câu xác nhận mô hình và nhà cung cấp đang hoạt động.
Phản hồi bình thường có nghĩa là quá trình thiết lập đã hoàn tất.
Các vấn đề thường gặp
| Triệu chứng | Phải làm gì |
|---|---|
| 401 | Sao chép lại khóa API và xác nhận rằng nó chưa bị xóa hoặc vô hiệu hóa. |
| model_not_found | Chỉnh sửa khóa API và chọn nhóm có thể truy cập gpt-5.6-sol. |
| Đăng nhập ChatGPT xuất hiện | Thoát hoàn toàn mọi phiên Codex và mở lại CLI. |
| Không tìm thấy codex | Mở một thiết bị đầu cuối mới. Trên Windows, hãy thử codex.cmd. |