Source: https://aiprimetech.io/vi/learn/use-claude-api-with-codex/

[Trang chủ](/vi/) / [Tìm hiểu](/vi/learn/) / Codex CLI với nhà cung cấp tùy chỉnh: config.toml, các mô hình GPT và Claude, tiện ích mở rộng IDE và cách khắc phục 

# Codex CLI với nhà cung cấp tùy chỉnh: config.toml, mô hình GPT và Claude, tiện ích mở rộng IDE và cách khắc phục lỗi 

Codex đọc một tệp, ~/.codex/config.toml, được dùng chung bởi CLI, codex exec và tiện ích mở rộng IDE. Một nhà cung cấp tùy chỉnh trong tệp đó trỏ Codex đến cổng API này, nơi cùng một cấu hình có thể chạy cả mô hình GPT và Claude. Các phiên bản Codex hiện tại chỉ giao tiếp qua Responses API (wire_api = "responses"), nên các hướng dẫn cũ sử dụng wire_api = "chat" không còn hoạt động. 

## Cài đặt Codex 

cửa sổ dòng lệnhSao chép

```
# macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# or with a package manager
npm install -g @openai/codex
brew install --cask codex

codex --version
```

Windows PowerShellSao chép

```
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
```

Tiện ích mở rộng Codex cho VS Code, Cursor và Windsurf được cài đặt từ kho tiện ích mở rộng của trình soạn thảo và sử dụng cùng ~/.codex/config.toml với CLI, vì vậy mọi nội dung bên dưới đều áp dụng cho cả hai. 

## Dùng khóa thuộc đúng nhóm 

Khóa cổng API thuộc về một nhóm, và nhóm đó quyết định các mô hình mà khóa có thể gọi. Với mô hình GPT, hãy tạo khóa trong nhóm **Codex** trên bảng điều khiển. Với mô hình Claude, mọi khóa Claude tính phí theo mức sử dụng đều dùng được. Khóa thuộc nhóm Không giới hạn cần có gói đang hoạt động; nếu không, mọi yêu cầu đều thất bại với No active subscription found for this group. 

~/.bashrc hoặc ~/.zshrcSao chép

```
export AIPRIME_CODEX_KEY=key_from_the_codex_group    # GPT models
export AIPRIME_CLAUDE_KEY=key_from_a_claude_group    # Claude models
```

WindowsSao chép

```
setx AIPRIME_CODEX_KEY "key_from_the_codex_group"
setx AIPRIME_CLAUDE_KEY "key_from_a_claude_group"
# open a new terminal afterwards
```

## config.toml cho các mô hình GPT 

~/.codex/config.tomlSao chép

```
model_provider = "aiprime"
model = "gpt-6-astra"
model_reasoning_effort = "high"

[model_providers.aiprime]
name = "AI Prime Tech"
base_url = "https://aiprimetech.io/v1"
env_key = "AIPRIME_CODEX_KEY"
wire_api = "responses"
supports_websockets = false
```

  | Thiết lập  | Lý do  

 | [model_providers.aiprime] | Bất kỳ mã định danh nào ngoại trừ mã dành riêng openai, ollama và lmstudio 

 | base_url = "https://aiprimetech.io/v1" | Codex thêm /responses vào cuối địa chỉ đó 

 | env_key | **Tên** của biến môi trường chứa khóa, không phải bản thân khóa 

 | wire_api = "responses" | Giá trị duy nhất mà Codex hiện tại chấp nhận 

 | supports_websockets = false | Giữ Codex sử dụng truyền dữ liệu dạng luồng HTTP thông thường, hoạt động qua mọi proxy hoặc VPN  

Đừng thêm requires_openai_auth = true hoặc experimental_bearer_token vào nhà cung cấp này. Với requires_openai_auth = true Codex bỏ qua env_key và thay vào đó gửi thông tin đăng nhập ChatGPT hoặc OpenAI của bạn, khiến cổng API từ chối. 

## Chạy Codex với các mô hình Claude 

Cổng API chấp nhận các yêu cầu Responses API cho mô hình Claude và chuyển đổi chúng, vì vậy Codex cũng có thể điều khiển Claude. Thêm nhà cung cấp thứ hai sử dụng khóa Claude của bạn, rồi thêm một hồ sơ cấu hình để chuyển sang nhà cung cấp đó. 

~/.codex/config.toml (thêm bên dưới nhà cung cấp đầu tiên)Sao chép

```
[model_providers.aiprime_claude]
name = "AI Prime Tech (Claude)"
base_url = "https://aiprimetech.io/v1"
env_key = "AIPRIME_CLAUDE_KEY"
wire_api = "responses"
supports_websockets = false
```

~/.codex/claude.config.tomlSao chép

```
model_provider = "aiprime_claude"
model = "claude-sonnet-5"
model_reasoning_effort = "high"
```

cửa sổ dòng lệnhSao chép

```
codex --profile claude
codex exec --profile claude "review the last commit for bugs"
```

Kể từ Codex 0.134.0, mỗi hồ sơ cấu hình có tệp riêng, ~/.codex/<name>.config.toml, với các khóa ở cấp cao nhất; [profiles.<name>] các bảng bên trong config.toml không còn được đọc. Hồ sơ cấu hình và nhà cung cấp chỉ có thể được đặt trong cấu hình người dùng của bạn: tệp của dự án .codex/config.toml bỏ qua model_provider và model_providers. 

## Mô hình và mức độ suy luận 

  | ID mô hình  | Nhà cung cấp  | Dùng cho  

 | gpt-6-astra | Khóa nhóm Codex | Mô hình GPT mạnh nhất trên cổng API; dành cho các tác vụ tác nhân kéo dài 

 | gpt-6-sol | Khóa nhóm Codex | GPT nhanh hơn và rẻ hơn cho công việc lập trình thường ngày 

 | gpt-5.6-terra | Khóa nhóm Codex | Tác vụ nhẹ và chỉnh sửa nhanh 

 | claude-sonnet-5 | Khóa Claude | Claude mặc định cho công việc lập trình 

 | claude-opus-5-5 | Khóa Claude | Suy luận khó hơn và tái cấu trúc quy mô lớn 

 | claude-fable-5-1 | Khóa Claude | Có năng lực cao nhất và đắt nhất  

model_reasoning_effort chấp nhận low, medium, high, xhigh hoặc max, tùy theo mô hình. Đừng đặt none: các mô hình này từ chối giá trị đó với 'none' is not supported. review_model đặt một mô hình khác cho /review nếu bạn muốn. Bảng điều khiển hiển thị mọi mô hình mà nhóm của khóa có thể gọi. 

## Tiện ích mở rộng IDE và codex exec 

Tiện ích mở rộng IDE đọc cùng config.toml, nhưng env_key được xác định từ môi trường riêng của trình soạn thảo. Trình soạn thảo khởi động từ Dock hoặc menu Start không nhận được các biến được xuất trong .bashrc, và khi đó Codex thất bại với Invalid API key trong khi CLI vẫn hoạt động. Đặt biến cho toàn hệ thống (trên Windows, setx thực hiện việc này), hoặc khởi động trình soạn thảo từ terminal, ví dụ code .. 

codex exec chạy một tác vụ mà không có giao diện tương tác, phù hợp với tập lệnh và CI. Lệnh này sử dụng cùng cấu hình và hồ sơ cấu hình: 

cửa sổ dòng lệnhSao chép

```
codex exec "write unit tests for utils.py"
codex exec --profile claude "summarise the changes on this branch"
codex login status        # which authentication method is active
```

## Thử lại và thời gian chờ 

Mỗi nhà cung cấp có cài đặt thử lại và truyền dữ liệu dạng luồng riêng. Giá trị mặc định là 4 lần thử lại yêu cầu, 5 lần kết nối lại luồng và thời gian chờ khi không có hoạt động là 5 phút cho mỗi luồng. Các lượt suy luận dài có thể không phát dữ liệu trong một khoảng thời gian, vì vậy tăng thời gian chờ này sẽ hữu ích khi dùng mức độ suy luận cao. 

~/.codex/config.tomlSao chép

```
[model_providers.aiprime]
# ...settings from above...
request_max_retries = 6
stream_max_retries = 8
stream_idle_timeout_ms = 600000
```

## Khắc phục sự cố: các lỗi người dùng Codex gặp phải 

Các lỗi bên dưới là những lỗi mà ứng dụng khách Codex thực sự tạo ra trên cổng API này, được sắp xếp từ phổ biến nhất. 

  | Những gì bạn thấy  | Nguyên nhân  | Cách khắc phục  

 | 403 No active subscription found for this group | Khóa thuộc nhóm Không giới hạn nhưng không có gói đang hoạt động | Dùng khóa thuộc nhóm tính phí theo mức sử dụng (Codex cho GPT), hoặc mua một gói 

 | 401 Invalid API key | Biến trống trong tiến trình chạy Codex (thường là IDE), hoặc requires_openai_auth = true khiến Codex gửi thông tin đăng nhập khác | echo $AIPRIME_CODEX_KEY; xóa requires_openai_auth; khởi động lại trình soạn thảo 

 | 404 Model "..." is not supported by any configured account in this group | Mô hình không thuộc nhóm của khóa, ví dụ mô hình Claude dùng với khóa GPT | Chuyển nhà cung cấp hoặc hồ sơ cấu hình để khóa phù hợp với mô hình 

 | 426 WebSocket upgrade required | Phương thức truyền tải WebSocket đã bật nhưng kết nối chưa được nâng cấp | supports_websockets = false, và xóa responses_websockets_v2 khỏi [features] 

 | 403 Your API key has expired | Khóa được tạo với ngày hết hạn | Tạo khóa mới trên bảng điều khiển 

 | 'none' is not supported | Mức độ suy luận được đặt thành none | Sử dụng low hoặc cao hơn 

 | 404 page not found | base_url chứa /v1 hai lần | Dùng chính xác https://aiprimetech.io/v1 

 | Lỗi cấu hình liên quan đến wire_api sau khi nâng cấp | A wire_api = "chat" dòng từ một hướng dẫn cũ | Đặt wire_api = "responses" 

 | Your balance is used up | Số dư đã hết | [Nạp tiền](/vi/topup/) 

 | Concurrency limit exceeded for user | Nhiều tác nhân hoặc cửa sổ Codex chạy cùng lúc | Giảm số lượng chạy song song hoặc yêu cầu bộ phận hỗ trợ tăng giới hạn chạy đồng thời  

Bạn đang so sánh Codex với Claude Code trước khi quyết định chọn một công cụ? Xem [Claude Code so với Codex](/vi/claude-code/vs-codex/). 

## Câu hỏi thường gặp 

 Tệp cấu hình Codex nằm ở đâu?

~/.codex/config.toml (hoặc $CODEX_HOME/config.toml). CLI, codex exec và tiện ích mở rộng IDE đều đọc tệp này. Tệp .codex/config.toml của dự án không thể thiết lập nhà cung cấp. Codex CLI có thể dùng các mô hình Claude không?

Có, thông qua một cổng kết nối chấp nhận các yêu cầu Responses API cho mô hình Claude. Thêm một nhà cung cấp có khóa Claude và đặt model thành một ID như claude-sonnet-5. wire_api = "chat" còn hoạt động trong Codex không?

Không. Tài liệu tham khảo về cấu hình Codex liệt kê responses là giá trị duy nhất được hỗ trợ, và đây cũng là giá trị mặc định khi không được chỉ định. Tại sao tiện ích mở rộng Codex cho VS Code báo khóa API không hợp lệ trong khi CLI vẫn hoạt động?

env_key được đọc từ môi trường của trình soạn thảo. Đặt biến ở cấp toàn hệ thống hoặc khởi động trình soạn thảo từ một terminal đã xuất biến đó. 'Không tìm thấy gói đăng ký đang hoạt động cho nhóm này' có nghĩa là gì trong Codex?

Khóa thuộc một nhóm đăng ký (Unlimited) không có gói đang hoạt động. Hãy dùng khóa từ nhóm trả phí theo mức sử dụng hoặc mua một gói.  

Bắt đầu sử dụng Claude chỉ trong vài phút

Lấy khóa API — không cần tài khoản Anthropic hay đăng ký danh sách chờ.[Lấy khóa API của bạn](/register) 

AI Prime Tech là một cổng API độc lập. AI Prime Tech không liên kết với, không được Anthropic chứng thực và không phải là đại lý bán lại của Anthropic. Claude và các tên mô hình liên quan là nhãn hiệu của chủ sở hữu tương ứng.  

Hướng dẫn API Codex và GPT: [Khóa API và quyền truy cập Codex](/vi/codex-api/) · [API tương thích với OpenAI](/vi/openai-api/) · [Thiết lập Codex CLI](/vi/docs/guides/codex-cli/) · [So sánh mô hình GPT-6](/vi/blog/gpt-6-models-for-codex/)    

## Các hướng dẫn khác về Claude API

[Cách lấy khóa Claude API](/vi/learn/how-to-get-a-claude-api-key/)[Giải thích giá API Claude](/vi/learn/claude-api-pricing-explained/)[Cách tiết kiệm nhất để sử dụng Claude API](/vi/learn/cheapest-way-to-use-claude-api/)[Cursor không giới hạn với Claude API](/learn/use-claude-api-with-cursor/)[Truy cập Claude Code không giới hạn](/vi/learn/use-claude-api-with-claude-code/)[Cổng Claude API so với truy cập trực tiếp Anthropic](/vi/learn/claude-api-vs-anthropic-direct/)[Sử dụng Claude qua API tương thích với OpenAI](/vi/learn/openai-compatible-claude-api/)[Giải thích các mô hình Claude: so sánh Claude Opus, Sonnet, Haiku và Fable — tất cả mô hình API Claude, tên mô hình Anthropic và giá (2026)](/vi/learn/claude-api-models-compared/)[Thanh toán Claude API bằng tiền mã hóa](/vi/learn/claude-api-with-crypto-payment/)[Truy cập Claude API không cần vào danh sách chờ](/vi/learn/claude-api-without-waitlist/)[Cách giảm lượng token sử dụng với Claude](/vi/learn/how-to-reduce-claude-token-usage/)[Cline không giới hạn với Claude API](/vi/learn/use-claude-api-with-cline/)[Roo Code không giới hạn với Claude API](/vi/learn/use-claude-api-with-roo-code/)[Claude không giới hạn trong các IDE JetBrains](/vi/learn/use-claude-api-with-jetbrains/)[Sử dụng Aider không giới hạn với Claude API](/vi/learn/use-claude-api-with-aider/)[Claude không giới hạn trong VS Code](/vi/learn/use-claude-api-with-vscode/)[Cấu hình OpenCode cho Claude: thiết lập opencode.json, mô hình và các lỗi thường gặp](/vi/learn/use-claude-api-with-opencode/)[Chạy tác nhân Hermes không giới hạn trên Claude](/vi/learn/run-hermes-agent-with-claude-api/)[Chạy OpenClaw không giới hạn trên Claude](/vi/learn/run-openclaw-with-claude-api/)[API tương thích với Anthropic có nghĩa là gì](/vi/learn/anthropic-compatible-api/)[Khóa API Claude Code — ANTHROPIC_API_KEY: cách lấy, thiết lập và khi nào nên dùng claude setup-token thay thế](/vi/learn/claude-code-api-key-setup/)[Chi phí API Claude Code — Giá và cách cắt giảm](/vi/learn/claude-code-api-costs/)[Giải thích các lỗi API Claude: lỗi máy chủ 500, quá tải 529, giới hạn tốc độ 429, yêu cầu không hợp lệ 400 — và cách khắc phục từng lỗi](/vi/learn/claude-api-errors-troubleshooting/)[Cách mua tín dụng Claude API — và vì sao tín dụng Claude tốt hơn mọi lời chào mời "mua tài khoản Claude"](/vi/learn/buy-claude-api-credits/)[API Claude miễn phí: có khóa API Claude miễn phí không, và điều gì thực sự miễn phí trong 2026?](/vi/learn/claude-api-free-trial/)[Claude API so với gói thuê bao Claude Pro/Max — Nên chọn loại nào](/vi/learn/claude-api-vs-subscription/)[Kết nối Claude với n8n](/vi/learn/use-claude-api-with-n8n/)[Định tuyến LiteLLM tới Claude](/vi/learn/use-claude-api-with-litellm/)[Sử dụng Claude trong Kilo Code](/vi/learn/use-claude-api-with-kilo-code/)[Tích hợp Claude vào GitHub Copilot](/vi/learn/use-claude-api-with-github-copilot/)[Kết nối Zed với Claude qua cổng API](/vi/learn/use-claude-api-with-zed/)[Kết nối Cherry Studio với Claude](/vi/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic trong LangChain: nhập, base_url, truyền dữ liệu dạng luồng, công cụ và lỗi](/vi/learn/use-claude-api-with-langchain/)[SDK Python của Anthropic: cài đặt, thiết lập base_url, truyền dữ liệu dạng luồng và xử lý lỗi](/vi/learn/anthropic-python-sdk/)[Claude với Vercel AI SDK: baseURL của createAnthropic, truyền dữ liệu dạng luồng và cách khắc phục lỗi](/vi/learn/use-claude-api-with-vercel-ai-sdk/)[Chạy Factory Droid với Claude](/vi/learn/use-claude-api-with-factory-droid/)[Giải thích API của Claude Code](/vi/learn/claude-code-api/)[Tích hợp API Claude vào ứng dụng của bạn](/vi/learn/claude-api-integration/)[Cách sử dụng Claude không giới hạn — và vì sao không có "Claude Code bẻ khóa"](/vi/learn/get-unlimited-claude-usage/)