Thiết lập Codex

Hướng dẫn này giúp Codex được kết nối 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ần thiết.

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.

Chuẩn bị sẵn chìa khóa. 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

Bạn chưa thấy thoải mái với thiết bị đầu cuối? Bắt đầu với hướng dẫn chạy lần đầu tương tác. Nó chỉ là một buổi diễn tập trực quan và không thay đổi máy tính của bạn.

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:

bash

curl -fsSL https://modelflare.dev/install/codex.sh | sh

Khi bạn đã đăng nhập với tên root trên VPS hoặc container, hãy sử dụng:

bash

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:

PowerShell

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.

Tùy chọn B: tự tạo từng file 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à auth.json.

Bước 1: cài đặt Codex CLI

Windows PowerShell

PowerShell

irm https://chatgpt.com/codex/install.ps1 | iex
codex --version

Linux

bash

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version

macOS

bash

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

PowerShell

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Set-Location "$HOME\.codex"

Linux

bash

mkdir -p ~/.codex
cd ~/.codex

macOS

bash

mkdir -p ~/.codex
cd ~/.codex

Bước 3: tạo config.toml

Windows PowerShell

PowerShell

$config = @'
cli_auth_credentials_store = "file"
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"
requires_openai_auth = true
'@
$utf8NoBom = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText(
  (Join-Path (Get-Location) "config.toml"),
  $config,
  $utf8NoBom
)

Linux

bash

cat > config.toml << 'EOF'
cli_auth_credentials_store = "file"
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"
requires_openai_auth = true
EOF
chmod 600 config.toml

macOS

bash

cat > config.toml << 'EOF'
cli_auth_credentials_store = "file"
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"
requires_openai_auth = true
EOF
chmod 600 config.toml

Bước 4: tạo auth.json

Thay thế YOUR_MODELFLARE_API_KEY trong đối tượng JSON bằng khóa API hoàn chỉnh mà bạn đã tạo trong bảng điều khiển Modelflare. Tệp này phải duy trì JSON hợp lệ và sử dụng trường OPENAI_API_KEY; không thêm khối lệnh nhà cung cấp auth. Các bản phát hành Codex hiện tại yêu cầu requires_openai_auth = true cho đường dẫn khóa API này.

Windows PowerShell

PowerShell

$authJson = @'
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_MODELFLARE_API_KEY"
}
'@
$utf8NoBom = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText(
  (Join-Path (Get-Location) "auth.json"),
  $authJson,
  $utf8NoBom
)

Linux

bash

cat > auth.json << 'EOF'
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_MODELFLARE_API_KEY"
}
EOF
chmod 600 auth.json

macOS

bash

cat > auth.json << 'EOF'
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_MODELFLARE_API_KEY"
}
EOF
chmod 600 auth.json

Bước 5: khởi động Codex

Windows PowerShell

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

bash

cd ~
mkdir -p my-codex-project
cd my-codex-project
codex --model gpt-5.6-sol

macOS

bash

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 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:

bash

codex --model gpt-5.6-sol

Sau khi thiết lập xong, bạn cũng có thể tải xuống Ứng dụng Codex.

Sau đó hỏi Codex:

Text

Reply with one sentence confirming the active model and provider.

Phản hồi bình thường 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.
Xuất hiện thông tin đăng nhập ChatGPT	Thoát hoàn toàn mọi phiên Codex và mở lại CLI.
codex	Mở một thiết bị đầu cuối mới. Trên Windows, hãy thử codex.cmd.