Xin chào mọi người, tôi là Cang He.
Sau khi CodexGuide ra mắt vào hôm kia, backend đã bị quá tải.
Câu hỏi thường gặp nhất là: Làm thế nào để sử dụng Codex ở Trung Quốc? Có thể dùng mà không cần đăng ký Plus không?
Nói thật, tôi hiểu nỗi khổ này.
Đăng ký Plus có rào cản riêng, và bạn còn phải tìm cách thanh toán; thật mệt mỏi.
Vì vậy, tôi đã dành hai ngày để thử nghiệm mọi giải pháp tìm thấy trên mạng, vấp phải nhiều lỗi, và cuối cùng tổng kết được ba phương pháp truy cập đáng tin cậy nhất.
Tôi chia sẻ tất cả với các bạn hôm nay—chỉ cần làm theo các bước.
Hướng dẫn cũng có sẵn trên CodexGuide để bạn tham khảo bất cứ lúc nào.
Thấy tôi làm việc vất vả thế này, hãy cho một ngôi sao nhé, hahaha.
Đầu tiên, một điều kiện tiên quyết: cách ổn định nhất để sử dụng Codex vẫn là đăng nhập bằng tài khoản GPT chính thức.
Kết nối với API của bên thứ ba là một thao tác nâng cao; bạn cần biết config.toml, API Key và Base URL là gì.
Nếu bạn không biết, không sao—chỉ cần làm theo các bước dưới đây.
Cách Chọn Giữa Ba Phương Án
Đây là bảng để bạn tìm ra lựa chọn phù hợp:
Phương án | Phù hợp với | Ưu điểm | Lưu ý |
|---|---|---|---|
Cấu hình Thủ công | Những ai muốn hiểu nguyên lý cơ bản | Minh bạch, kiểm soát được, dễ dàng xử lý sự cố | Phải tự duy trì |
Codex++ | Người dùng ứng dụng Desktop muốn quản lý bằng GUI | Có giao diện quản lý, cấu hình một chạm | Công cụ bên thứ ba, có thể cần cập nhật sau khi Codex cập nhật |
CCX + CC Switch | Những ai có nhiều nhà cung cấp cần chuyển đổi giao thức | Định tuyến cổng + chuyển đổi nhà cung cấp một chạm | Nhiều thành phần, yêu cầu hiểu về cổng và chuỗi proxy |
Thành thật mà nói, nếu bạn là người mới bắt đầu, chỉ cần xem Phương án 2; đó là cách không phải lo lắng nhất.
Nếu bạn mới bắt đầu học Codex, tôi khuyên bạn nên xem hướng dẫn cơ bản về Codex trước khi mày mò với API bên thứ ba.
Phương án 1: Cấu hình Thủ công
Phương pháp này có một nhược điểm: bạn không thể sử dụng chức năng plugin của ứng dụng Codex.
Nếu bạn muốn sử dụng plugin, hãy chuyển thẳng sang Phương án 2.
Cốt lõi của cấu hình thủ công là sửa đổi một tệp:
Trước khi sửa đổi, hãy sao lưu nó—hãy tạo thói quen tốt:
Hai Cách Đăng nhập
Cách | Hiểu như thế nào | Tình huống phù hợp |
|---|---|---|
Đăng nhập GPT | Giữ trạng thái đăng nhập chính thức, chỉ thay đổi địa chỉ chuyển tiếp yêu cầu | Muốn giữ khả năng của tài khoản chính thức trong khi sử dụng trung chuyển |
Đăng nhập API Key | Sử dụng Key trong biến môi trường, yêu cầu trực tiếp bên thứ ba | Sử dụng OpenAI API Key hoặc dịch vụ tương thích tự xây dựng |
Một lời khuyên: đừng thay đổi quá nhiều thứ cùng một lúc. Chỉ thêm một nhà cung cấp trước, và khi nó hoạt động, sau đó mới mày mò với nhiều cấu hình.
Ví dụ về Trạng thái Đăng nhập GPT
Điều này có nghĩa là Codex của bạn trước tiên phải được đăng nhập vào tài khoản GPT.
Bước 1: Sửa đổi tệp cấu hình:
Mở ~/.codex/config.toml và thêm cấu hình sau.
Lưu ý: điền các trường và giá trị theo dịch vụ thực tế của bạn:
Một vài lỗi thường gặp:
model_providerphải giống hệtxxxtrong[model_providers.xxx]; không được sai một chữ cái nào.base_urlchỉ nên đến/v1; không bao gồm toàn bộ đoạn/v1/responses.wire_api = "responses"có nghĩa là yêu cầu theo định dạng Responses API; đừng thay đổi nó.requires_openai_auth = falsecó nghĩa là không sử dụng trạng thái đăng nhập chính thức.
Bước 2: Đặt biến môi trường
Mở terminal và nhập:
Bước 3: Khởi động ứng dụng Codex từ terminal
Có một điểm cần lưu ý ở đây: người dùng Mac phải khởi động từ terminal; nhấp vào biểu tượng trực tiếp có thể không đọc được model.
Đóng hoàn toàn ứng dụng Codex trước khi khởi động, sau đó nhập vào terminal:
Bước 4: Xác minh hiệu quả
Mở ứng dụng Codex, bạn sẽ thấy model đã được chuyển đổi thành công:
Trời ơi, nó đang cất cánh.
Ví dụ về Đăng nhập API Key
Nếu bạn đang sử dụng phương pháp API Key, hãy nhớ một nguyên tắc: đặt secret key vào biến môi trường, đừng hardcode nó trong tệp cấu hình.
Cấu hình config.toml tương ứng:
Một điều cần lưu ý: nếu upstream của bạn chỉ hỗ trợ Chat Completions và không hỗ trợ Responses API, chỉ thay đổi cấu hình sẽ không hoạt động; bạn cần sử dụng một cổng như CCX để chuyển đổi giao thức, điều này sẽ được thảo luận trong Phương án 3.
Sửa đổi tệp xác thực
Mở ~/.codex/auth.json và thay đổi OPENAI_API_KEY thành Key của nhà cung cấp model của bạn:
Cách Xác minh Cấu hình Thành công
Đừng vội sau khi cấu hình; hãy xác minh trước:
- Thoát hoàn toàn Codex và mở lại.
- Yêu cầu nó thực hiện một tác vụ chỉ đọc, chẳng hạn như tóm tắt cấu trúc thư mục hiện tại.
- Nếu nó báo lỗi, trước tiên hãy kiểm tra tên
model_provider,base_urlvà các biến môi trường. - Nếu xảy ra lỗi xác thực, trước tiên hãy chuyển về cấu hình sao lưu; đừng hoảng sợ.
Phương án 2: Codex++
Nếu bạn thấy cấu hình thủ công quá rắc rối, hãy xem Codex++.
Đó là một công cụ quản lý đồ họa giúp bạn xử lý cấu hình chuyển tiếp chỉ bằng một cú nhấp chuột, mà không cần phải viết tệp toml thủ công.
Hơn nữa, nó hỗ trợ các chức năng plugin, điều mà Phương án 1 không thể làm được.
Phù hợp với những người này:
- Những người chủ yếu sử dụng ứng dụng Desktop Codex.
- Những người không muốn viết tệp cấu hình thủ công.
- Những người muốn chuyển về chế độ chính thức bất cứ lúc nào.
Các Bước Cài đặt
- Mở Codex++ Releases và tải gói cài đặt.
Bạn sẽ thấy hai gói cài đặt: "Codex++ Management Tool" và "Codex++ app"; hãy cài đặt cả hai.
- Mở "Codex++ Management Tool" sau khi cài đặt.
Nếu cửa sổ bật lên lỗi này lần đầu tiên bạn mở, đừng hoảng sợ:
Vào "System Settings" - "Privacy & Security", và nhấp "Open Anyway":
Sau khi mở, vào giao diện quản lý:
Cài đặt ứng dụng Codex++ theo cùng một cách; sẽ đúng nếu phát hiện của công cụ quản lý đều xanh:
Xác nhận rằng trạng thái đăng nhập GPT đã được phát hiện.
- Thêm cấu hình chuyển tiếp.
Chọn "Provider Configuration" - Add Provider, và điền Base URL và Key của bạn.
Lưu ý: chọn "Pure API" cho phương thức truy cập:
Danh sách model có thể được tự động lấy từ upstream; nếu bạn đang cấu hình một trạm chuyển tiếp, sẽ có nhiều model để chọn ở đây:
Về cơ bản, công cụ này giúp bạn viết cấu hình một cách thuận tiện hơn, giúp bạn không phải chỉnh sửa tệp thủ công:
Kiểm tra kết nối sau khi lưu; nếu không có vấn đề gì, hãy sử dụng trực tiếp:
- Khởi động Codex từ điểm vào của Codex++.
Lưu ý: khởi động từ Codex++, không phải Codex gốc:
Sau khi khởi động lại, bạn sẽ thấy Codex đã sử dụng nhà cung cấp model tùy chỉnh và số lượng model có thể chọn đã tăng lên đột ngột:
Plugin cũng có thể được sử dụng trực tiếp; đây là trải nghiệm đầy đủ:
Bạn phải thừa nhận, phương án này là mượt mà nhất tôi từng sử dụng cho đến nay; rất được khuyến khích.
Nếu tôi muốn quay lại thì sao?
- Xóa chế độ API trong công cụ quản lý và chuyển về cấu hình chính thức.
- Nếu Codex++ ngừng hoạt động sau khi Codex cập nhật, chỉ cần đợi nó được điều chỉnh; nó sẽ không ảnh hưởng đến việc sử dụng phiên bản gốc.
Phương án 3: CCX + CC Switch
Phương án này phù hợp với người dùng cao cấp, tách biệt "cổng" và "công cụ chuyển đổi":
- CCX: Cổng proxy API, chịu trách nhiệm chuyển đổi giao thức và định tuyến. Hỗ trợ nhiều điểm vào khác nhau như Claude, OpenAI, Codex, Gemini, v.v.
- CC Switch: Công cụ quản lý desktop, chuyển đổi cấu hình nhà cung cấp khác nhau chỉ bằng một cú nhấp chuột.
Khi nào nên sử dụng phương án này? Khi bạn có nhiều API model nội địa, nhiều dịch vụ chuyển tiếp, nhiều Key, hoặc khi upstream chỉ hỗ trợ Chat Completions và cần chuyển đổi sang Responses API.
Bước 1: Triển khai CCX
Sử dụng Docker với một lệnh duy nhất:
Sau khi khởi động, bạn có thể thấy nó bằng cách mở trình duyệt.
Bước 2: Thêm Kênh Upstream
Thêm các kênh của bạn trong giao diện quản lý CCX:
- Chọn loại dịch vụ upstream.
- Điền API Key và Base URL.
- Cấu hình ánh xạ model và quy tắc định tuyến.
- Sử dụng chức năng kiểm tra tích hợp để xác nhận kết nối.
Có một điểm chính ở đây: Codex cần một điểm vào Responses API. Nếu upstream chỉ có Chat Completions, CCX sẽ giúp bạn thực hiện chuyển đổi giao thức, đó là lý do cốt lõi để sử dụng nó.
Bước 3: Cài đặt CC Switch
Cài đặt dòng lệnh:
Khởi tạo:
Trong quá trình khởi tạo, hãy điền địa chỉ CCX làm điểm vào chuyển tiếp.
Bước 4: Chuyển đổi Cấu hình và Khởi động
Một dòng lệnh để chuyển đổi nhà cung cấp:
Sau đó khởi động lại Codex để nó có hiệu lực.
Sau khi chuyển đổi, bạn nên mở ~/.codex/config.toml để xác minh:
model_providercó phải là cái bạn vừa chọn không?base_urlcó trỏ đến CCX không?- Bạn có vô tình viết Key vào một kho lưu trữ công khai không (điều này rất quan trọng)?
Tổng kết các Lỗi Thường gặp
Cuối cùng, đây là bảng xử lý sự cố; hãy kiểm tra nó trước nếu bạn gặp vấn đề:
Hiện tượng | Kiểm tra điều gì trước |
|---|---|
Không có hiệu quả sau khi chuyển đổi | Codex đã được khởi động lại hoàn toàn chưa, tên |
Lỗi xác thực | API Key có hợp lệ không, các biến môi trường có được kế thừa bởi shell hiện tại không |
Lỗi đường dẫn giao diện |
|
Model nội địa không phản hồi | Upstream có hỗ trợ Responses API không; nếu không, bạn phải sử dụng CCX để chuyển đổi |
Thiếu cấu hình plugin | Công cụ chuyển đổi có ghi đè cấu hình không; bạn đã sao lưu trước chưa? |
Nói thật, tôi đã chạy thành công cả ba phương án, nhưng tôi sử dụng Phương án 2, Codex++, nhiều nhất cho hàng ngày; nó không phải lo lắng.
Nếu bạn là loại người dùng cao cấp có vài Key và vài nhà cung cấp, Phương án 3 phù hợp hơn với bạn.
Được rồi, đó là tất cả những gì chia sẻ hôm nay.
Nếu hướng dẫn này giúp được bạn, hãy cho một like để tôi biết, và tôi sẽ tiếp tục cập nhật thêm nhiều mẹo sử dụng Codex thực tế trong tương lai.
Nếu bạn có câu hỏi, hãy hỏi trực tiếp trong phần bình luận; tôi sẽ trả lời tất cả những gì tôi thấy.
