Codex Desktop + APIMaster.ai

Codex Desktop là tác nhân mã hóa trên máy tính để bàn của OpenAI. Bạn có thể trỏ nó tới APIMaster.ai với cùng các tệp cấu hình cục bộ như Codex CLI: ~/.codex/config.toml và ~/.codex/auth.json.

Một thiết lập bao gồm cả Codex Desktop và Codex CLI. Sau khi hoàn thành hướng dẫn này, Desktop sẽ hiển thị Đã đăng nhập với khóa API và nhà cung cấp apimaster.

Điều kiện tiên quyết: Kiểm tra môi trường, Khóa API.

---

APIMaster.ai

Mục	Giá trị
URL gốc	https://apimaster.ai/v1
Khóa API	Bảng điều khiển
Mô hình	Chợ hoặc GET /v1/models

Codex sử dụng https://apimaster.ai/v1 (tương thích OpenAI). Tài liệu này không đảm bảo về giá cả hoặc mô hình.

---

Cấu hình Codex (Desktop + CLI)

Thư mục chính của Codex: ~/.codex/ (macOS) hoặc %USERPROFILE%\.codex\ (Windows). Thoát Codex Desktop trước khi chỉnh sửa tệp.

Windows

Win + R → %userprofile%\.codex — tạo thư mục nếu chưa có.

config.toml

disable_response_storage = true
model = "gpt-5.4"
model_provider = "apimaster"
model_reasoning_effort = "high"
model_verbosity = "high"

[features]
web_search_request = true

[model_providers.apimaster]
base_url = "https://apimaster.ai/v1"
name = "apimaster"
requires_openai_auth = true
wire_api = "responses"

auth.json

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

Thay YOUR_API_KEY bằng khóa APIMaster của bạn từ Bảng điều khiển.

macOS

Mở ~/.codex (Finder: Go → Go to Folder… → ~/.codex).

config.toml

model_provider = "apimaster"
model = "gpt-5.4"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
model_verbosity = "high"

[model_providers.apimaster]
name = "apimaster"
base_url = "https://apimaster.ai/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json — giống như Windows.

Ghi chú

• Đặt model thành gpt-5.5 v.v. theo Các mô hình được hỗ trợ.
• Nếu wire_api = "responses" không hoạt động trên phiên bản Codex của bạn, hãy thử wire_api = "chat" hoặc xóa dòng đó.

Sự cố	Cách khắc phục
401	Kiểm tra khóa trong auth.json
404	ID mô hình + quyền truy cập tài khoản
Hết thời gian	base_url phải chính xác là https://apimaster.ai/v1

---

Xác minh Codex Desktop

1. Mở lại Codex Desktop.
2. Xác nhận Đã đăng nhập với khóa API và nhà cung cấp apimaster trong giao diện.
3. Bắt đầu một cuộc trò chuyện — bạn sẽ nhận được phản hồi thông qua APIMaster.

Người dùng CLI cũng có thể chạy codex trong terminal để xác minh cùng cấu hình.

---

Nâng cao: chuyển đổi giữa đăng ký chính thức ↔ APIMaster

Chỉ sử dụng tính năng này nếu bạn đã sử dụng đăng ký ChatGPT chính thức trong Codex Desktop và muốn giữ lịch sử thanh bên dự án khi bạn gặp giới hạn sử dụng cuốn chiếu 5 giờ.

Việc chỉnh sửa thủ công config.toml trong tình huống đó thường làm ẩn các luồng dự án. codex-provider-switcher chuyển đổi chế độ nhà cung cấp và đồng bộ siêu dữ liệu cuộc trò chuyện cục bộ — không tải lên, không xóa nội dung trò chuyện.

Khi nào nên sử dụng

• Đăng ký chính thức hiển thị Bạn đã hết tin nhắn Codex hoặc Lượt sử dụng còn lại gần 0% với Đặt lại sau mỗi 5 giờ.
• Bạn muốn tiếp tục trong cùng các luồng dự án trên APIMaster, sau đó chuyển lại về chính thức khi giới hạn được đặt lại.

Công cụ này làm gì

Kho lưu trữ: github.com/RomaCredit/codex-provider-switcher

• Cập nhật cấu hình Codex cục bộ (config.toml, auth.json, SQLite, siêu dữ liệu phiên)
• Lưu hồ sơ APIMaster và chính thức
• Sao lưu trước khi thay đổi dưới ~/.codex/provider-switcher

Windows

1. Thoát Codex Desktop hoàn toàn.
2. Nháy đúp vào codex-provider-menu.bat.
3. Chọn 1 (APIMaster) hoặc 2 (chính thức). Nhập khóa API khi chuyển sang APIMaster lần đầu.
4. Mở lại Codex Desktop — mong đợi Đã đăng nhập với khóa API, nhà cung cấp apimaster, và các luồng dự án của bạn vẫn hiển thị.

Nếu lịch sử thanh bên không đúng: tùy chọn 6. Sửa danh sách lịch sử Desktop.

PowerShell:

.\switch-codex-provider.ps1 status
.\switch-codex-provider.ps1 apimaster
.\switch-codex-provider.ps1 official
.\switch-codex-provider.ps1 repair-history

macOS

chmod +x ./codex-provider-menu.command
./codex-provider-menu.command

Hoặc:

python3 codex_provider_switcher.py apimaster
python3 codex_provider_switcher.py official
python3 codex_provider_switcher.py repair-history

Bảo mật

• Khóa và bản sao lưu chỉ ở trên máy của bạn.
• Không dán các thư mục .codex vào các vấn đề công khai.
• Thoát Codex Desktop trước khi chuyển đổi.

Câu hỏi thường gặp (trình chuyển đổi)

Câu hỏi	Trả lời
Lịch sử được giữ lại?	Các tệp phiên vẫn còn; công cụ đồng bộ siêu dữ liệu để hiển thị thanh bên.
Chuyển lại về chính thức?	Có — menu 2 hoặc official.
Vị trí khóa?	Cục bộ ~/.codex/auth.json và hồ sơ công cụ.
Có xóa trò chuyện?	Không.

---

Liên quan

• Thiết lập Codex CLI · Tổng quan về tác nhân · Hướng dẫn tương thích OpenAI
• codex-provider-switcher trên GitHub