Hướng dẫn cấu hình Codex App (máy tính) với Beeknoee
Codex App là gì?
Codex App là ứng dụng máy tính của OpenAI để chạy agent lập trình Codex, có bản cho Windows và macOS. Bạn có thể cho Codex App gọi model qua Beeknoee chỉ bằng một lệnh lấy từ Quick Setup — không cần tự sửa file cấu hình.
⚠️ Khác với Codex CLI: Codex App không chọn được profile, nên Beeknoee phải được đặt làm mặc định. Codex App và Codex CLI dùng chung một file cấu hình, vì vậy sau khi cài, Codex CLI trên cùng máy cũng mặc định dùng Beeknoee.
⚠️ Đừng tự sửa
config.tomlbằng tay. Codex App tự ghi rất nhiều thứ vào file này; dán thêm một dòng trùng là app báo "configuration could not be loaded" và không mở được. Lệnh Quick Setup sửa đúng chỗ và tự sao lưu bản gốc cho bạn.
Yêu cầu
- Đã cài Codex App và mở ít nhất một lần
- API Key từ Beeknoee Platform, dạng
sk-bee-...
📌 Bước 1: Lấy lệnh cài đặt
-
Vào trang API Keys → nếu chưa có key thì nhấn "Tạo API Key"
-
Chọn API Key bạn muốn dùng → nhấn ⚙️ Cấu hình API Key
-
Trong hộp thoại, mở tab "Quick Setup"
-
Chọn tab Codex → chọn Codex App (máy tính)
-
Chọn hệ điều hành — Windows hoặc macOS / Linux
-
Chọn 3 model: Small, Medium, Large. Ba model này sẽ hiện trong bảng chọn model của Codex App; Medium là model mặc định
💡 Chưa biết chọn gì? Lấy 3 model GPT ở 3 mức giá khác nhau là đủ. Giá từng model xem ở trang Các Mô Hình AI.
💡 Codex App dùng model Small để tự đặt tên cho mỗi cuộc trò chuyện mới (một lượt gọi nhỏ), nên hãy chọn model rẻ cho ô này.
-
Nhấn Copy bên cạnh khung lệnh
⚠️ API key chỉ hiển thị 24 giờ đầu. Nếu key đã bị ẩn, hộp thoại sẽ yêu cầu bạn dán lại key đầy đủ để tạo lệnh.
📌 Bước 2: Thoát hẳn Codex App
Codex App chỉ đọc cấu hình lúc khởi động, nên hãy thoát hẳn trước khi chạy lệnh:
- Windows: đóng cửa sổ, rồi kiểm tra biểu tượng ở khay hệ thống (góc phải thanh Taskbar) — nếu còn, bấm chuột phải → Thoát.
- macOS: bấm Cmd + Q khi đang mở app.
📌 Bước 3: Chạy lệnh
Mở PowerShell (Windows) hoặc Terminal (macOS), dán lệnh vừa copy rồi nhấn Enter.
Lệnh trên Windows có dạng:
irm "https://platform.beeknoee.com/api/v1/setup/codex-app?key=sk-bee-...&os=windows&small=...&medium=...&large=..." | iex
Lệnh trên macOS có dạng:
curl -sL "https://platform.beeknoee.com/api/v1/setup/codex-app?key=sk-bee-...&os=linux&small=...&medium=...&large=..." | sh
Chạy xong bạn sẽ thấy dòng Configuration Complete!
Lệnh tự động thực hiện:
- ✅ Sao lưu
config.tomlhiện tại (chụp một lần, chạy lại không bị đè) - ✅ Đặt Beeknoee làm mặc định: sửa dòng
modelsẵn có chứ không thêm dòng trùng - ✅ Thêm thông tin kết nối Beeknoee và danh sách 3 model bạn chọn
- ✅ Giữ nguyên mọi thứ khác của bạn: dự án tin cậy, plugin, MCP server…
- ✅ Nếu file đang hỏng vì bị dán trùng, lệnh tự sửa lại cho đúng
📌 Bước 4: Mở app và kiểm tra
- Mở lại Codex App
- Bấm vào bảng chọn model — bạn sẽ thấy 3 model Beeknoee vừa chọn
- Tạo cuộc trò chuyện mới, gửi thử:
Trả lời đúng một chữ: OK - Vào trang Usage trên Beeknoee — có lượt gọi mới là đã kết nối thành công
Đổi model hoặc đổi API key
Vào lại Quick Setup, chọn model (hoặc key) mới, copy lệnh và chạy lại như Bước 2–3. Lệnh chạy bao nhiêu lần cũng được, không tạo dòng trùng.
Kiểm tra và gỡ cài đặt
Trong hộp thoại Quick Setup, mục Công cụ khác có sẵn các lệnh sau (copy rồi chạy giống lệnh cài):
| Lệnh | Tác dụng |
|---|---|
| Xem trước | In ra những gì lệnh cài sẽ ghi, rồi dừng — không sửa gì |
| Kiểm tra máy (doctor) | Cho biết Codex App đang dùng model nào, đã trỏ về Beeknoee chưa, file có bị trùng dòng không. Chỉ đọc |
| Kiểm chứng cấu hình (verify) | Kiểm tra cấu hình đúng, API key còn hiệu lực, model tồn tại |
| Gỡ riêng cấu hình Beeknoee | Bỏ Beeknoee khỏi Codex App, trả lại model bạn dùng trước đó, giữ nguyên mọi thứ khác. Nên dùng cách này khi muốn quay lại OpenAI |
| Gỡ cài đặt (khôi phục toàn bộ) | Trả file cấu hình về đúng bản đã sao lưu trước khi cài — những thay đổi sau đó cũng bị hoàn về theo |
Sau khi gỡ, thoát hẳn Codex App rồi mở lại.
Xử lý lỗi thường gặp
| Hiện tượng | Cách xử lý |
|---|---|
App báo "configuration could not be loaded" (duplicate key, invalid unquoted key…) | File cấu hình bị sửa tay sai. Chạy lại lệnh cài ở Bước 3 — lệnh tự sửa lại. Nếu vẫn lỗi, chạy lệnh Gỡ cài đặt (khôi phục toàn bộ) rồi cài lại |
| Bảng chọn model không có model Beeknoee, hoặc trang Usage không có lượt mới | App chưa được thoát hẳn. Thoát hẳn (cả biểu tượng ở khay hệ thống) rồi mở lại. Chạy lệnh doctor để xem dòng Beeknoee: True |
401 Unauthorized / "Invalid API key" | Key đã bị xoá, tạm ngừng hoặc hết hạn. Kiểm tra ở trang API Keys, rồi chạy lại lệnh cài với key đang hoạt động |
Model not found | Model đã chọn không còn dùng được. Vào Quick Setup chọn lại model rồi chạy lại lệnh |
Lệnh báo ERROR: Chua chon model… | Chưa chọn đủ model trong Quick Setup. Chọn model rồi copy lại lệnh |
| Trả lời bị ngắt giữa chừng | Kiểm tra kết nối mạng rồi gửi lại. Lệnh cài đã đặt sẵn thời gian chờ dài cho model suy nghĩ lâu |
| Không còn thấy tab Chat, nút Files, nút micro… | Bình thường. Khi Beeknoee là mặc định, Codex App không chạy qua tài khoản ChatGPT nên các tính năng gắn với tài khoản (tab Chat, Files, nhập giọng nói, tác vụ trên đám mây) tạm ẩn. Phần làm việc và lập trình trên máy vẫn dùng Beeknoee bình thường. Chạy lệnh Gỡ riêng cấu hình Beeknoee là các tính năng đó trở lại |
HOÀN TẤT! 🎉
Cần hỗ trợ thêm? Sử dụng Support Chat (góc dưới phải trên platform) hoặc liên hệ qua email.
Xem thêm
- Codex CLI — dùng Codex trong terminal, có profile riêng
- Quick Setup — tự sinh lệnh cài đặt cho nhiều công cụ
- Claude Code — Anthropic AI coding CLI
- Cursor — AI-first code editor