Sử dụng DeepSeek trong Codex CLI: Hướng dẫn thiết lập V4 Flash / Pro
Cấu hình DeepSeek V4 Flash và Pro trong Codex CLI thông qua endpoint Responses của APIMaster. Bao gồm thiết lập khóa API, chuyển đổi mô hình, kiểm tra công cụ và khắc phục sự cố.
Codex CLI có thể sử dụng DeepSeek không? Các thử nghiệm của chúng tôi với Codex CLI 0.153.4 đã sử dụng thành công deepseek-v4-flash và deepseek-v4-pro thông qua endpoint Responses của APIMaster. Cấu hình một nhà cung cấp tùy chỉnh với base URL https://apimaster.ai/v1 và wire_api = "responses". Chỉ riêng Chat Completions tương thích OpenAI là không đủ cho cấu hình này.
Lần kiểm tra cuối: 2026-09-07, Codex CLI 0.153.4, Linux. Cả hai mô hình đều trả về văn bản mong đợi, gọi một công cụ shell để đọc tệp thử nghiệm cục bộ và trả lời bằng nội dung của nó. Tất cả các lần chạy đều thoát với mã 0. Cảnh báo về siêu dữ liệu và sự kiện phát trực tuyến đã xảy ra; xem phần khắc phục sự cố. Các lệnh Windows / macOS được cung cấp để thiết lập, nhưng thử nghiệm này được chạy trên Linux. Các phiên dài, đầu vào hình ảnh và quy trình mã hóa phức tạp chưa được kiểm tra.
1. Chuẩn bị Codex và khóa API của bạn
Cài đặt Codex theo hướng dẫn môi trường và hướng dẫn thiết lập Codex, sau đó kiểm tra:
codex --version
Tạo một khóa API APIMaster có quyền truy cập vào mô hình DeepSeek đã chọn và đủ hạn mức. Đối với hướng dẫn này, hãy sử dụng cấu hình chuyên dụng bên dưới; bạn không cần thay thế auth.json hiện có hoặc đăng xuất khỏi tài khoản khác.
2. Đặt khóa trong terminal của bạn
macOS / Linux:
export APIMASTER_API_KEY='YOUR_APIMASTER_API_KEY'
Windows PowerShell:
$env:APIMASTER_API_KEY = 'YOUR_APIMASTER_API_KEY'
Biến chỉ tồn tại trong phiên terminal này. Cấu hình lưu trữ tên của biến, không phải bí mật.
3. Tạo cấu hình nhà cung cấp riêng biệt
Trong một thư mục bạn sử dụng cho hướng dẫn này, tạo deepseek.toml với nội dung này. Giữ nguyên cấu hình Codex hiện có của bạn.
model = "deepseek-v4-flash"
model_provider = "apimaster_deepseek"
[model_providers.apimaster_deepseek]
name = "APIMaster DeepSeek"
base_url = "https://apimaster.ai/v1"
env_key = "APIMASTER_API_KEY"
wire_api = "responses"
Để có bài kiểm tra đầu tiên có thể sao chép và cô lập, hãy truyền các cài đặt tương tự dưới dạng ghi đè dòng lệnh. --ignore-user-config ngăn một nhà cung cấp khác trong cấu hình thông thường của bạn chiếm ưu thế. --ephemeral tránh lưu phiên kiểm tra này.
codex exec --ignore-user-config --ephemeral --skip-git-repo-check --sandbox read-only --model deepseek-v4-flash -c 'model_provider="apimaster_deepseek"' -c 'model_providers.apimaster_deepseek.name="APIMaster DeepSeek"' -c 'model_providers.apimaster_deepseek.base_url="https://apimaster.ai/v1"' -c 'model_providers.apimaster_deepseek.env_key="APIMASTER_API_KEY"' -c 'model_providers.apimaster_deepseek.wire_api="responses"' "Reply with exactly: DEEPSEEK_TEST_OK"
Chạy lệnh từ terminal nơi bạn đã đặt khóa. Câu trả lời cuối cùng dự kiến: DEEPSEEK_TEST_OK. Trong các phiên bản Windows PowerShell cũ hơn, cách trích dẫn đối số gốc có thể khác; hãy sử dụng PowerShell 7 hoặc phương pháp hồ sơ bên dưới nếu các đối số TOML bị từ chối.
4. Lưu cấu hình dưới dạng hồ sơ tái sử dụng
Đối với phiên bản CLI đã kiểm tra, đặt deepseek.toml tại ~/.codex/deepseek.config.toml (Windows: %USERPROFILE%\.codex\deepseek.config.toml). Nếu CODEX_HOME được tùy chỉnh, hãy sử dụng thư mục đó thay thế. Hồ sơ được đặt tên này giữ các cài đặt DeepSeek tách biệt với config.toml thông thường của bạn.
macOS / Linux, từ thư mục chứa deepseek.toml:
mkdir -p ~/.codex
cp deepseek.toml ~/.codex/deepseek.config.toml
codex --profile deepseek --model deepseek-v4-flash
Windows PowerShell:
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
Copy-Item .\deepseek.toml "$env:USERPROFILE\.codex\deepseek.config.toml"
codex --profile deepseek --model deepseek-v4-flash
Sao lưu tệp hồ sơ trước nếu tên tệp đó đã tồn tại. Cú pháp hồ sơ phụ thuộc vào phiên bản: các lệnh này nhắm mục tiêu 0.153.4. Kiểm tra codex --help trên phiên bản đã cài đặt của bạn; các bản phát hành cũ hơn có thể sử dụng hồ sơ bên trong config.toml thay thế.
Để sử dụng Pro:
codex --profile deepseek --model deepseek-v4-pro
Một hồ sơ xếp lớp trên cấu hình thông thường của bạn, vì vậy các máy chủ MCP hiện có hoặc các cài đặt khác vẫn có thể được áp dụng. Lệnh cô lập trong bước 3 hữu ích khi chẩn đoán xung đột cấu hình.
5. Xác minh một lệnh gọi công cụ
Tạo một tệp cục bộ có tên probe.txt chứa:
TOOL_PROBE_739182
Từ cùng thư mục, chạy:
codex exec --profile deepseek --skip-git-repo-check --sandbox read-only --model deepseek-v4-flash "Use your file reading or shell tool to read probe.txt in the current directory. Reply with only the exact content. Do not guess."
Dự kiến: một lệnh đọc tệp thực thi thành công, sau đó là TOOL_PROBE_739182. Lặp lại với --model deepseek-v4-pro. Điều này kiểm tra một vòng lặp yêu cầu công cụ / kết quả công cụ, ngoài phản hồi văn bản đơn giản. Giữ các lời nhắc quyền bình thường được bật cho công việc dự án thực tế.
Khắc phục sự cố
| Triệu chứng | Giải thích hoặc bước tiếp theo |
|---|---|
Model metadata ... not found |
CLI đã kiểm tra không có siêu dữ liệu tích hợp cho các ID mô hình này và sử dụng siêu dữ liệu dự phòng. Các bài kiểm tra văn bản và công cụ của chúng tôi đã hoàn thành, nhưng giới hạn ngữ cảnh và các mặc định khác không nên được coi là khả năng mô hình đã xác minh. |
| Lỗi phân tích danh sách mô hình | Danh sách mô hình của cổng có thể khác với danh mục siêu dữ liệu của Codex. Chỉ định mô hình một cách rõ ràng và kiểm tra xem yêu cầu thực tế có hoàn thành không. |
OutputTextDelta without active item |
Đã thấy trong bài kiểm tra phát trực tuyến của chúng tôi. Phản hồi cuối cùng và vòng lặp công cụ vẫn hoàn thành. Nếu đầu ra bị thiếu hoặc bị gián đoạn, hãy giữ phiên bản CLI, dấu thời gian và lỗi để hỗ trợ. |
| 401 hoặc yêu cầu đi đến nhà cung cấp khác | Kiểm tra APIMASTER_API_KEY, lựa chọn nhà cung cấp và các cài đặt kế thừa. Thử lại lệnh cô lập trong bước 3. |
| 404 hoặc giao thức không được hỗ trợ | Base URL kết thúc bằng /v1, không phải /chat/completions; đặt wire_api = "responses". |
| Tùy chọn dòng lệnh không xác định | Kiểm tra phiên bản CLI đã cài đặt. Các tùy chọn được ghi lại đã được kiểm tra với 0.153.4. |
Các câu hỏi thường gặp
Điều này có nghĩa là mọi endpoint DeepSeek đều hoạt động trong Codex không?
Không. Các kết quả này áp dụng cho cấu hình cổng của APIMaster. Một nhà cung cấp phải hỗ trợ giao thức và hành vi công cụ mà Codex mong đợi; chấp nhận /chat/completions không thiết lập khả năng tương thích Responses.
Tôi có cần đăng ký ChatGPT cho thiết lập này không?
Nhà cung cấp tùy chỉnh này sử dụng khóa API APIMaster và hạn mức tài khoản của bạn. Nó không sử dụng hạn mức đăng ký ChatGPT. Kiểm tra chợ mô hình để biết tỷ lệ API hiện tại.
Tôi có thể tuyên bố khả năng tương thích Codex đầy đủ từ các bài kiểm tra này không?
Phạm vi đã xác minh là đầu ra văn bản ngắn và một vòng lặp công cụ đọc tệp cục bộ. Các cảnh báo ở trên vẫn có liên quan; hành vi ngữ cảnh dài, mọi công cụ và mọi bản phát hành CLI trong tương lai không được bao phủ.