Skip to main content
Codex là agent lập trình của OpenAI, có ba dạng: Codex CLI trong terminal, extension Codex trong VS Code và app Codex. Cả ba đọc chung thư mục ~/.codex, nên cấu hình một lần là dùng được cả ba.

​
Cài bằng 1 lệnh

Thay sk-xxx bằng key của bạn, mở terminal, dán và Enter. Script kiểm tra key, liệt kê mọi model key được phép gọi để bạn chọn (Enter = model khuyến nghị: gpt-astra với gói Astra, gpt-5.6-sol với gói GPT, claude-opus-5 với gói Claude), cài Codex CLI và ghi cấu hình.
Script hỏi ngôn ngữ trước (1 = Tiếng Việt, 2 = English; bỏ hỏi bằng --lang vi hoặc --lang en). Không truyền --key thì script sẽ hỏi key. Muốn ép model: thêm --model gpt-astra hoặc --model gpt-5.6-sol.
Đọc mã nguồn script trước khi chạy nếu muốn: codex.sh, codex.ps1. Script chỉ chạy trên máy bạn và chỉ gửi key tới gpt.teamsoclo.site để kiểm tra.

​
Script làm gì

  1. Kiểm tra key với gateway và chọn model theo gói; key sai thì dừng, không đụng máy bạn.
  2. Sao lưu config.toml cũ nếu có, thành config.toml.bak.<thời gian>.
  3. Ghi ~/.codex/config.toml: model gpt-5.6-sol, gateway TeamSocLo, giao thức Responses API.
  4. Lưu key vào biến môi trường TEAMSOCLO_API_KEY (trong ~/.zshrc / ~/.bashrc, hoặc biến người dùng trên Windows). Key không nằm trong file cấu hình, nên bạn có thể chia sẻ config.toml mà không lộ key.
  5. Cài hoặc nâng cấp Codex CLI bằng npm install -g @openai/codex. Node.js chưa có thì script dừng và chỉ cách cài.
Chạy lại lệnh bất cứ lúc nào để đổi key hoặc đổi gói; cấu hình cũ luôn được sao lưu trước.
Không muốn dùng terminal thì dùng TeamSocLo Key Tool: app cho Windows và macOS, dán key một lần là cấu hình xong Codex, Claude Code và hơn 20 công cụ khác.

​
Sau khi cài

1

Mở terminal mới, chạy codex

Terminal cũ chưa nạp biến môi trường mới, phải mở tab mới. Hỏi Codex một câu để kiểm tra.
2

VS Code: cài extension, tắt hẳn rồi mở lại

VS Code → Extensions → tìm Codex (OpenAI’s coding agent) → Install. Sau đó thoát hẳn VS Code: macOS Cmd + Q, Windows đóng hết cửa sổ. Reload Window không đủ, extension chỉ đọc cấu hình lúc khởi động tiến trình.
3

App Codex

Mở lại app sau khi chạy lệnh. Trên macOS lệnh đã đặt biến cho app GUI bằng launchctl; trên Windows setx có hiệu lực với app mở sau đó.
Không cần bấm đăng nhập OpenAI. requires_openai_auth = false báo Codex dùng key của gateway qua biến môi trường.

​
Cấu hình tay

Nếu muốn tự sửa, ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml) cần đúng nội dung này:
và biến môi trường TEAMSOCLO_API_KEY chứa key của bạn.
Giữ nguyên wire_api = "responses". Codex nói chuyện bằng Responses API; đổi sang chat sẽ hỏng.
Mở nhanh thư mục cấu hình:

​
Đổi model

Gói GPT Astra dùng gpt-astra. Sửa dòng đầu config.toml rồi mở lại Codex:
Key GPT gọi gpt-astra sẽ báo không có kênh khả dụng, và ngược lại. Model đi theo gói bạn mua, xem Model và gói.

​
Gỡ cấu hình

Muốn giữ Codex nhưng quay về cấu hình trước đó: copy file config.toml.bak.<thời gian> đè lại config.toml.

​
Không chạy thì kiểm tra

  • Đã mở terminal mới hoặc thoát hẳn VS Code sau khi cài.
  • echo $TEAMSOCLO_API_KEY (Windows: echo %TEAMSOCLO_API_KEY% trong cmd) in ra key đủ ký tự.
  • base_url kết thúc bằng /v1, wire_api là responses.
  • Key còn hạn và còn hạn mức: kiểm tra tại đây.
  • Còn lỗi thì xem Lỗi thường gặp, có mục riêng cho Codex.