Chuyển đến nội dung chính
Codex Desktop dùng cùng cấu hình cục bộ với Codex CLI. Trước tiên hãy cài Codex Desktop, rồi ghi config.toml và auth.json do bảng điều khiển tạo vào thư mục cấu hình Codex. Nếu bạn đã hoàn tất cấu hình Codex, hãy mở hoặc khởi động lại Codex Desktop. Bạn không cần tạo API Key mới.

​
Điều kiện trước

  • Bạn đã hoàn thành Tạo tài khoản.
  • Bạn đã hoàn thành Lấy API Key.
  • Codex Desktop đã được cài.
  • Hộp thoại Use key đã mở cho API Key bạn muốn dùng.
API Key trong auth.json được lưu cục bộ dạng văn bản rõ. Không đưa ~/.codex/auth.json, ảnh chụp hoặc đầu ra terminal vào repository hoặc cuộc trò chuyện.

​
Cài đặt

Tải và cài Codex Desktop từ tài liệu OpenAI Codex app. Sau khi cài, mở ứng dụng và hoàn tất thiết lập ban đầu theo hướng dẫn của Codex Desktop. Nếu Codex Desktop chưa có cho hệ điều hành của bạn, hãy dùng Codex CLI để truy cập bằng terminal.

​
Sao chép cấu hình từ bảng điều khiển

1

Mở API Keys

Mở bảng điều khiển và vào API Keys.
2

Chọn Codex CLI

Tìm key muốn dùng cho Codex Desktop, nhấn Use key, rồi chọn Codex CLI.
3

Chọn hệ điều hành

Chọn macOS / Linux hoặc Windows. Bảng điều khiển sẽ hiển thị đường dẫn tệp cấu hình tương ứng.
4

Ghi cấu hình cục bộ

Làm theo các bước cho hệ điều hành tương ứng trong trang Codex để ghi config.toml và auth.json.
5

Khởi động lại Codex Desktop

Lưu cấu hình, thoát hẳn Codex Desktop rồi mở lại.

​
Đường dẫn tệp cấu hình

Hệ điều hànhconfig.tomlauth.json
macOS / Linux~/.codex/config.toml~/.codex/auth.json
Windows%USERPROFILE%\.codex\config.toml%USERPROFILE%\.codex\auth.json
Nếu bạn dùng Codex trong WSL, hãy cấu hình thư mục ~/.codex/ của WSL, không phải thư mục người dùng Windows. Dùng các giá trị model, review_model, base_url và API Key được hiển thị trong bảng điều khiển. Xem trang Codex để biết ý nghĩa từng trường.

​
Kiểm tra

Mở Codex Desktop, chọn một dự án cục bộ, rồi gửi một tác vụ rủi ro thấp: 
Mô tả mục đích của dự án hiện tại trong một câu. Không sửa tệp.
Nếu Codex Desktop phản hồi mà không báo lỗi xác thực hoặc lỗi mô hình, cấu hình đã có hiệu lực.

​
Vấn đề thường gặp

Không. Codex Desktop đọc cùng cấu hình ~/.codex/. Hãy thoát hẳn Codex Desktop rồi mở lại.
Đặt cấu hình mới ở đầu config.toml. Lưu tệp, thoát hẳn Codex Desktop rồi mở lại.
Kiểm tra auth.json là JSON hợp lệ. Xác nhận API Key không thiếu ký tự, không có xuống dòng hoặc khoảng trắng thừa.
model và review_model phải khớp chính xác với tên mô hình trong bảng điều khiển. Không sao chép từ ảnh của người khác.