DeepSeek V4 Flash và Pro trong Codex: Cấu hình và chọn model
Cấu hình DeepSeek trong Codex với APIMaster. Tìm config.toml trên Windows, macOS và Linux, đặt API key, bắt đầu chat tương tác và chọn model.
Cấu hình API key APIMaster và config.toml của Codex, sau đó chạy codex để trò chuyện với DeepSeek. Sử dụng deepseek-v4-flash, deepseek-v4-pro. Codex kết nối qua Responses API tại https://apimaster.ai/v1.
Trước khi bắt đầu
Hoàn tất kiểm tra môi trường, cài đặt Codex theo hướng dẫn chung, và lấy một API key APIMaster có quyền truy cập các model này cùng số dư đủ dùng.
codex --version
1. Mở thư mục cấu hình
Windows
Nhấn Win + R, nhập đường dẫn sau rồi nhấn Enter:
%USERPROFILE%\.codex
Tạo thư mục nếu nó chưa tồn tại. Mở hoặc tạo config.toml bằng một trình soạn thảo văn bản. Đảm bảo tên tệp không phải là config.toml.txt.
macOS / Linux
Trên macOS, trong Finder nhấn Command + Shift + G và nhập:
~/.codex
Trên Linux, mở cùng thư mục đó bằng trình quản lý tệp hoặc trình soạn thảo của bạn. Nếu cần, hãy tạo nó từ terminal:
mkdir -p ~/.codex
Mở hoặc tạo config.toml trong thư mục này. Nếu bạn dùng thư mục trạng thái Codex tùy chỉnh, hãy sử dụng thư mục đó thay thế.
2. Cấu hình config.toml
Cả hai nền tảng đều dùng nội dung giống nhau:
model = "deepseek-v4-flash"
model_provider = "apimaster"
model_reasoning_summary = "none"
model_supports_reasoning_summaries = false
[model_providers.apimaster]
name = "APIMaster"
base_url = "https://apimaster.ai/v1"
env_key = "APIMASTER_API_KEY"
wire_api = "responses"
Nếu tệp đã tồn tại, hãy sao lưu và trộn các thiết lập này. Thay thế các khóa cấp cao nhất hiện có thay vì trùng lặp chúng, và đặt chúng trước tiêu đề [table] đầu tiên. Trộn phần provider nếu nó đã tồn tại. Điều này thay đổi provider và model mặc định cho các phiên Codex mới.
Base URL bao gồm /v1. Giữ nguyên wire_api = "responses"; một endpoint Chat Completions đơn thuần là không đủ cho quy trình này. Các thiết lập summary tắt các bản tóm tắt suy luận tùy chọn, chứ không tắt quá trình tư duy nội bộ của model.
Để giữ nguyên provider mặc định hiện có của bạn, hãy đặt cấu hình này vào ~/.codex/deepseek.config.toml thay thế (Windows: %USERPROFILE%\.codex\deepseek.config.toml). Sau đó thêm --profile deepseek vào các lệnh khởi động bên dưới. Các tệp profile có tên yêu cầu Codex 0.134.0 trở lên và sẽ kế thừa các thiết lập cơ sở khác.
3. Đặt API key của bạn
Thay YOUR_APIMASTER_API_KEY bằng key lấy từ APIMaster. Cấu hình TOML lưu tên của biến môi trường, chứ không lưu chính key đó.
Windows PowerShell
Chạy trong terminal nơi bạn sẽ khởi chạy Codex:
$env:APIMASTER_API_KEY = 'YOUR_APIMASTER_API_KEY'
Để đồng thời lưu nó cho các terminal sau này:
[Environment]::SetEnvironmentVariable('APIMASTER_API_KEY', 'YOUR_APIMASTER_API_KEY', 'User')
Mở một terminal mới sau khi lưu biến cố định, hoặc tiếp tục dùng terminal hiện tại nơi bạn đã chạy lệnh đầu tiên.
macOS / Linux
export APIMASTER_API_KEY='YOUR_APIMASTER_API_KEY'
Lệnh này áp dụng cho terminal hiện tại. Để dùng lại nó trong các terminal mới, hãy thêm cùng dòng export vào tệp khởi động của shell, ví dụ ~/.zshrc cho Zsh hoặc ~/.bashrc cho Bash tương tác, sau đó mở một terminal mới. Giữ các tệp chứa key thật ở chế độ riêng tư và bên ngoài các kho lưu trữ dùng chung.
4. Khởi động Codex và trò chuyện
Mở một terminal trong thư mục dự án của bạn và chạy:
codex
Sau các prompt lần chạy đầu hoặc xác nhận tin tưởng dự án thông thường, hãy kiểm tra rằng model đang hoạt động là deepseek-v4-flash. Trong cuộc trò chuyện Codex, nhập:
Reply with exactly OK.
Một câu trả lời bình thường xác nhận kết nối cơ bản đã hoạt động. Sau đó bạn có thể yêu cầu nó giải thích code, đọc một tệp hoặc thực hiện thay đổi. Hãy xem xét các prompt cấp quyền tệp và lệnh thông thường.
5. Chọn model khác
Với các model ID tùy chỉnh này, hãy chọn model một cách tường minh khi khởi động Codex. Chạy mỗi lần một lệnh trong terminal của bạn:
codex --model deepseek-v4-flash
codex --model deepseek-v4-pro
Mỗi lệnh mở một cuộc trò chuyện tương tác. Để chuyển từ một phiên đang mở, nhập /exit, sau đó chạy lệnh cho model mong muốn. Để tiếp tục một cuộc trò chuyện đã lưu hiện có bằng model khác, hãy dùng codex resume SESSION_ID --model MODEL_ID thay vì bắt đầu một cuộc trò chuyện mới.
Trong Codex, /model mở danh mục model của nó và /status hiển thị model đang hoạt động. Menu không tự động liệt kê mọi model trong thị trường model của APIMaster. Nếu model DeepSeek của bạn không có mặt, hãy dùng --model như trên. Đừng giả định cú pháp /model MODEL_ID của Claude Code hoạt động trong Codex; đó không phải là đường dẫn chọn model tùy chỉnh đã được xác minh ở đây.
Với profile có tên tùy chọn, ví dụ:
codex --profile deepseek --model deepseek-v4-flash
Để thay đổi mặc định cho các lần khởi động sau, hãy chỉnh sửa giá trị model cấp cao nhất trong tệp cấu hình bạn đang dùng.
Khắc phục sự cố
| Triệu chứng | Cần kiểm tra |
|---|---|
| Thiếu API key / 401 | Đặt APIMASTER_API_KEY trong terminal khởi chạy Codex; kiểm tra tính hợp lệ và số dư của key. |
| Vẫn đang dùng provider khác | Kiểm tra model_provider, profile đã chọn, các ghi đè của dự án và cờ khởi động. Khởi động lại sau khi chỉnh sửa cấu hình. |
| Lỗi phân tích TOML | Tránh khóa hoặc bảng trùng lặp; các thiết lập cấp cao nhất phải đứng trước các tiêu đề bảng. |
| 404 / giao thức không được hỗ trợ | Dùng https://apimaster.ai/v1 và wire_api = "responses". |
| Model không có trong /model | Dùng model ID đầy đủ với codex --model. Danh mục tích hợp sẵn không phải là danh sách model của gateway. |
| Cảnh báo metadata model hoặc danh sách model | Các ID này có thể thiếu metadata của Codex. Kiểm tra câu trả lời cuối cùng; giới hạn ngữ cảnh dự phòng không phải là năng lực đã xác minh của model. |
| Cảnh báo luồng suy luận/kết quả | Kiểm tra câu trả lời cuối cùng và kết quả công cụ. Báo cáo đầu ra bị gián đoạn kèm theo model, phiên bản CLI, thời gian UTC và request ID nếu có. |
Xác thực và kiểm tra công cụ tùy chọn
Các bài kiểm tra tích hợp được ghi nhận: 2026-09-07 UTC, Codex CLI 0.153.4, Linux. Tất cả các model được liệt kê ở đây đều trả về văn bản mong đợi và sử dụng một công cụ để đọc tệp cục bộ. Các tác vụ lập trình phức tạp nằm ngoài phạm vi kiểm tra đó. Hướng dẫn cấu hình Windows và macOS đã được cung cấp, nhưng các hệ điều hành đó không nằm trong số các lần chạy được ghi nhận. Các kiểm tra này không xác lập khả năng tương thích đầy đủ của tính năng, hành vi của phiên dài hay giới hạn ngữ cảnh tối đa.
Để kiểm tra các công cụ tệp, tạo probe.txt trong một dự án tạm thời với nội dung:
FILE_PROBE_739182
Khởi động Codex tại đó với model bạn đã chọn, sau đó nhập:
Read probe.txt using a tool and reply with its exact contents. Do not guess.
Xác nhận rằng một công cụ đọc tệp được chạy và câu trả lời khớp với tệp. Dùng bước này sau khi cuộc trò chuyện cơ bản đã hoạt động.
Câu hỏi thường gặp
Cái này có dùng gói đăng ký ChatGPT của tôi không?
Các yêu cầu dùng key và số dư APIMaster của bạn. Codex là ứng dụng khách; DeepSeek là model được chọn. Cấu hình này không biến DeepSeek thành một model của OpenAI.
Tại sao Claude Code dùng một URL khác?
Codex dùng https://apimaster.ai/v1 cho Responses. Claude Code dùng thư mục gốc của trang https://apimaster.ai và tự nối thêm /v1/messages.