Hướng dẫn cài đặt nhà cung cấp

Trước tiên, cần phân biệt hai phương thức đăng nhập

Trang này chỉ đề cập đến các cấu hình trong ứng dụng trên máy tính liên quan đến Key, model và Provider. Việc cài đặt dòng lệnh, các lệnh terminal và hướng dẫn sử dụng CLI đầy đủ hơn được trình bày trên trang Công cụ CLI.

Đường dẫn ví dụ:C: \Users\YourUsername\. codex

Cách cấu hình Key

Thư mục cấu hình cục bộ của Codex có tên là . codex. Đối với ứng dụng Windows, hãy dùng %USERPROFILE%\. codex Đối với macOS / Linux, thường dùng ~/. codex Nếu bạn chỉ đăng nhập bằng ChatGPT, tạm thời không cần ghi Key thủ công; nếu bạn sử dụng provider hoặc Key của bên thứ ba, bạn nên đưa Key vào biến môi trường hệ thống, sau đó để config.toml đọc biến này.

$env:MZ_PROXY_API_KEY = "YOUR_KEY"

MZ_PROXY_API_KEY="YOUR_KEY" codex "Please reply only: Configuration successful"

Không ghi Key thật vào trang web, ảnh chụp màn hình, lịch sử chat hoặc kho lưu trữ dự án. Hãy sử dụng biến môi trường bất cứ khi nào có thể thay vì ghi trực tiếp Key vào config.toml Để lưu lâu dài trên Windows, bạn có thể thêm biến người dùng trong "Environment Variables" (Biến môi trường) của hệ thống; phương pháp lưu lâu dài trên macOS / Linux phụ thuộc vào terminal bạn thực tế sử dụng.

Cách cấu hình mô hình

Mô hình mặc định được ghi ở đầu tệp config.toml Tài liệu chính thức hiện khuyến nghị bắt đầu từ gpt-5.5 Nếu bạn đang sử dụng provider, hãy điền chuỗi ký tự dùng cho lệnh gọi API trong danh sách mô hình ở trang quản trị của provider. Chuỗi này có thể được gọi là "Model ID", "Model Name" hoặc tên mô hình trên giao diện quản trị. Hãy sao chép chính xác nguyên văn. Không tự ý thay đổi chữ hoa/chữ thường, dấu gạch ngang hay dấu chấm.

model = "gpt-5.5"

model = "MODEL_ID_FROM_PROVIDER_DASHBOARD" model_provider = "mz_proxy"

Cách cấu hình Provider trung chuyển

Cốt lõi của việc cấu hình provider bao gồm ba yếu tố:Tên mô hình, Base URL, Biến môi trường chứa Key Nếu provider của bạn cung cấp giao diện tương thích với OpenAI, hãy ưu tiên chọn chế độ hỗ trợ Responses API; các provider chỉ hỗ trợ Chat Completions cũ sẽ có khả năng tương thích kém hơn trong tương lai.

model = "MODEL_ID_FROM_PROVIDER_DASHBOARD" model_provider = "mz_proxy" [model_providers.mz_proxy] name = "Example AI Provider" base_url = "https://YOUR_PROVIDER_API_URL" env_key = "MZ_PROXY_API_KEY" wire_api = "responses"

model = "gpt-5.5" model_provider = "openai" openai_base_url = "https://YOUR_OPENAI_PROXY_API_URL"

Trước tiên, hãy kiểm tra các mục này trong cài đặt ứng dụng

Sau khi mở phần cài đặt của ứng dụng Codex, thanh bên trái sẽ được nhóm thành 'Personal, Integration, Coding, Archived'. Người mới bắt đầu nên bắt đầu từ mục General để xác nhận chế độ làm việc (work mode), phạm vi quyền hạn (permission scope), vị trí mở mặc định, terminal và ngôn ngữ; việc cấu hình model, Key và Provider vẫn quay lại phần xử lý config.toml trước đó.

Xác minh và xử lý sự cố

Sau khi thay đổi Key, model hoặc Provider, hãy khởi động lại ứng dụng và tạo một luồng trò chuyện thử nghiệm mới. Tạm thời đừng để ứng dụng sửa đổi tệp; chỉ yêu cầu ứng dụng xác nhận xem dự án hiện tại và mô hình có hoạt động bình thường hay không.

First state which files you can see. Do not modify files or run commands. Reply only with whether the current project is readable and the model ID or model name you are using.

Quyền hạn và bảo mật

Ứng dụng Codex có thể đọc các tệp dự án, đồng thời cũng có thể chỉnh sửa tệp, thực hiện kiểm tra hoặc mở các trang để xem dựa trên sự xác nhận của bạn. Điều quan trọng nhất đối với người mới bắt đầu là phải xem rõ ứng dụng muốn làm gì trước khi cho phép tiếp tục.