Your privacy choices

Allow optional cookies for referral attribution, visit analytics, and Google Ads purchase measurement.

Hướng dẫn triển khai Codex

Giải thích rõ việc cài công cụ CLI, kết nối API và cấu hình môi trường phát triển.

📋 Yêu cầu trước (bước đầu tiên) Vui lòng hoàn thành trước cài đặt môi trường Node.js, bảo đảm Node.js 18+ đã được cài đúng. Khi cấu hình nhớ mở tùy chọn nâng cao của ccs, sau khi thêm mô hình là có thể chat


🎯 Điều hướng nhanh

CodeX là trợ lý lập trình thông minh thế hệ mới dựa trên kiến trúc GPT-5, cung cấp cho nhà phát triển khả năng sinh và tối ưu mã vượt trội.

Lộ trình triển khai: cấu hình môi trường hệ thống ➜ cài công cụ CLI ➜ tích hợp API ➜ sẵn sàng môi trường phát triển

🚀 Dùng CC-Switch để cấu hình nhanh (khuyến nghị)

⚠️ Điều kiện tiên quyết

Trước khi dùng CC-Switch để cấu hình CodeX, hãy bảo đảm bạn đã cài công cụ CodeX toàn cục qua npm:

npm install -g @openai/codex@latest
下载压缩包 下载压缩包

Xác minh cài đặt: codex --version

Khuyến nghị dùng công cụ cấu hình nhanh CC-Switch để cấu hình bằng giao diện, đơn giản và nhanh gọn, không cần thao tác dòng lệnh.

Các bước cấu hình

  1. Khởi động CC-Switch và chuyển sang thẻ Codex

Hình ảnh hiển thị giao diện ứng dụng CC-Switch, phía trên có nhiều thẻ tùy chọn, trong đó thẻ “Codex” được mũi tên đỏ chỉ vào để làm nổi bật. Hình này tương ứng với phần “Dùng CC-Switch để cấu hình nhanh (khuyến nghị)”, dùng để minh họa rằng sau khi mở CC-Switch và chuyển sang thẻ Codex, người dùng cần bấm vào thẻ “Codex” ở phía trên để tiếp tục các thao tác cấu hình tiếp theo. Đây là bước quan trọng trong quy trình cấu hình bằng CC-Switch.Hình ảnh hiển thị giao diện ứng dụng CC-Switch, phía trên có nhiều thẻ t…

  1. Mở ứng dụng CC-Switch
  2. Nhấp vào thẻ “Codex” ở phía trên
  3. Nhấp nút màu cam “+” ở góc trên bên phải để thêm cấu hình mới
  4. Điền cấu hình provider cho CodeX
  5. Tên provider: tên tùy chỉnh (ví dụ “gpt-agent”)
  6. Base URL: nhập https://api.llm-token.cn/v1
  7. API Key: dán API key của bạn
  8. Model: chọn gpt-5.4 (tại thời điểm viết tài liệu, đây là mô hình mới nhất là 5.4)
  9. Cấu hình khác: điều chỉnh cường độ suy luận, quyền truy cập mạng và các tham số khác theo nhu cầu
  10. Nhấp nút “Lưu”

Hình ảnh hiển thị giao diện thêm cấu hình mới trong ứng dụng CC-Switch. Phía trên có hai thẻ “Nhà cung cấp Codex” và “Nhà cung cấp thống nhất”, hiện tại “Nhà cung cấp Codex” đang được chọn. Bên dưới có “Cấu hình tùy chỉnh” cùng nhiều lựa chọn provider cài sẵn như OpenAI Official, Shengsuan Cloud, v.v. Ở phần dưới cùng của giao diện có ô nhập “Tên nhà cung cấp” và “Ghi chú”, cùng các nút “Hủy” và “Thêm”. Hình này gắn chặt với ngữ cảnh phía trên, là màn hình xuất hiện sau thao tác “nhấp nút màu cam ‘+’ ở góc trên bên phải để thêm cấu hình mới”, giúp người dùng thực hiện cấu hình tùy chỉnh.Hình ảnh hiển thị giao diện thêm cấu hình mới trong ứng dụng CC-Switch.…

Đây là giao diện chỉnh sửa cấu hình provider trong CC-Switch. Phía trên giao diện có ký hiệu của công cụ tương ứng, đồng thời có nhiều trường cấu hình: tên provider đã được điền là “Guishu Cloud Computing”, ô liên kết website có nội dung hiển thị một phần là “https:///”, trường API Key đã được dán với khóa bị che, địa chỉ yêu cầu API được điền là “https://api.llm-token.cn/v1”. Phần nhắc màu vàng ở cuối giao diện ghi rằng cần điền địa chỉ endpoint máy chủ tương thích định dạng OpenAI Response, và góc dưới bên phải có nút “Lưu” màu xanh. Tất cả đều phù hợp với thao tác điền cấu hình provider trong hướng dẫn triển khai Codex.Đây là giao diện chỉnh sửa cấu hình provider trong CC-Switch. Phía trên…

💡 Mẹo

  • CC-Switch sẽ tự động tạo các tệp ~/.codex/config.tomlauth.json
  • Có thể thêm nhiều cấu hình provider và chuyển đổi bất cứ lúc nào
  • Sau khi đổi cấu hình, chỉ cần đóng rồi mở lại CodeX là có hiệu lực
  1. Bật cấu hình và sử dụng
  2. Tìm cấu hình vừa tạo trong danh sách cấu hình
  3. Nhấp nút “Đang sử dụng” ở bên phải cấu hình
  4. Cấu hình sẽ được đánh dấu là trạng thái “Đang sử dụng” (nhãn màu xanh lá)
  5. Khởi động lại CodeX, cấu hình mới sẽ có hiệu lực
  6. Chuyển đổi nhanh qua khay hệ thống

CC-Switch hỗ trợ chuyển đổi nhanh cấu hình CodeX qua khay hệ thống:

  • Nhấp chuột phải vào biểu tượng CC-Switch trong khay hệ thống
  • Chọn danh mục Codex trong menu
  • Chọn trực tiếp cấu hình cần chuyển sang
  • Cấu hình có hiệu lực ngay, không cần mở giao diện chính

⚠️ Lưu ý

  • Sau khi đổi cấu hình cần khởi động lại CodeX mới có hiệu lực
  • Có thể kiểm tra tốc độ endpoint API trong CC-Switch

⌨️ Cấu hình thủ công bằng dòng lệnh

Nếu bạn không dùng CC-Switch, có thể cấu hình CodeX thủ công theo các bước dưới đây.

🖥️ Nền tảng Windows

Bước 1: triển khai công cụ dòng lệnh CodeX

Mở Command Prompt hoặc PowerShell bằng quyền quản trị viên, rồi chạy:

npm install -g @openai/codex@latestcodex --version

Viết tệp cấu hình: config.toml

model_provider = "gpt-agent"model = "gpt-5.4"model_reasoning_effort = "xhigh"disable_response_storage = trueapproval_policy = "on-request"sandbox_mode = "danger-full-access"model_supports_reasoning_summaries = true[model_providers.gpt-agent]name = "ikun"base_url = "https://api.llm-token.cn/v1"wire_api = "responses"requires_openai_auth = true

Viết tệp xác thực: auth.json

{  "OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"}

Bước 3: khởi tạo workspace

mkdir my-codex-projectcd my-codex-projectcodex

🍏 Nền tảng macOS

Triển khai công cụ CodeX

npm install -g @openai/codex@latestcodex --version

Tích hợp dịch vụ API

Tạo thư mục cấu hình:

mkdir -p ~/.codexcd ~/.codex

Viết cấu hình config.toml:

cat > config.toml << 'EOF'model_provider = "gpt-agent"model = "gpt-5.4"model_reasoning_effort = "xhigh"disable_response_storage = trueapproval_policy = "on-request"sandbox_mode = "danger-full-access"model_supports_reasoning_summaries = true[model_providers.gpt-agent]name = "ikun"base_url = "https://api.llm-token.cn/v1"wire_api = "responses"requires_openai_auth = trueEOF

Viết cấu hình xác thực auth.json:

cat > auth.json << 'EOF'{  "OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"}EOF

Khởi tạo workspace

mkdir my-codex-projectcd my-codex-projectcodex

🐧 Nền tảng Linux

Triển khai công cụ CodeX

sudo npm install -g @openai/codex@latestcodex --version

1 2

Tích hợp dịch vụ API

Tạo thư mục cấu hình:

mkdir -p ~/.codexcd ~/.codex

Viết cấu hình config.toml:

cat > config.toml << 'EOF'model_provider = "gpt-agent"model = "gpt-5.4"model_reasoning_effort = "xhigh"disable_response_storage = trueapproval_policy = "on-request"sandbox_mode = "danger-full-access"model_supports_reasoning_summaries = true[model_providers.gpt-agent]name = "ikun"base_url = "https://api.llm-token.cn/v1"wire_api = "responses"requires_openai_auth = trueEOF

Viết cấu hình xác thực auth.json:

cat > auth.json << 'EOF'{  "OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"}EOF

Khởi tạo workspace

mkdir my-codex-projectcd my-codex-projectcodex

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

  • Windows: %USERPROFILE%\.codex\
  • macOS/Linux: ~/.codex/

Không chat được sau khi cấu hình?

Hãy thử cách này, nếu vẫn không được thì liên hệ hỗ trợ khách hàng

Hình ảnh hiển thị giao diện CC Switch, phía trên có tiêu đề “CC Switch” cùng nhiều biểu tượng. Dòng “Guishu Cloud Computing” trong giao diện có nền xanh lá, bên trái có biểu tượng ba chấm, bên phải có nhãn “Truy vấn thất bại”. Mũi tên đỏ trong hình chỉ vào biểu tượng bánh răng ở bên trái. Biểu tượng này tương ứng với phần “Không chat được sau khi cấu hình? Hãy thử cách này, nếu vẫn không được thì liên hệ hỗ trợ khách hàng”, có thể dùng để chỉ dẫn người dùng nhấp vào đây để thao tác cấu hình liên quan.Hình ảnh hiển thị giao diện CC Switch, phía trên có tiêu đề “CC Switch”…

Đây là ảnh chụp màn hình giao diện cài đặt của CC Switch. Các mũi tên đỏ lần lượt chỉ vào thẻ “Proxy” ở phía trên và nhãn trạng thái “Đang chạy” trong khu vực “Proxy cục bộ”. Mô-đun “Proxy cục bộ” trên giao diện dùng để điều khiển bật tắt dịch vụ proxy, xem trạng thái và thông tin cổng, còn trạng thái “Đang chạy” cho biết dịch vụ proxy của chương trình hiện đang hoạt động bình thường.Đây là ảnh chụp màn hình giao diện cài đặt của CC Switch. Các mũi tên đỏ…

Hình ảnh hiển thị cấu hình liên quan đến proxy trong trang cài đặt của hướng dẫn triển khai Codex. Phía trên có các thẻ “Chung”, “Proxy”, “Nhật ký”, trong đó “Proxy” đang được chọn. Khi bật công tắc tổng proxy và bật phản hồi vòng lặp proxy, bên dưới sẽ có hai lựa chọn Codex và Gemini, trong đó tùy chọn Codex được mũi tên đỏ chỉ vào. Giao diện cũng hiển thị các mục cấu hình như địa chỉ máy chủ proxy, cổng proxy, loại proxy, khả năng proxy, bật ghi log ứng dụng, cùng công tắc ghi log. Hình này liên quan đến cách xử lý khi đã cấu hình mà không thể chat, dùng để minh họa tình hình cấu hình proxy.Hình ảnh hiển thị cấu hình liên quan đến proxy trong trang cài đặt của h…