Lệnh dành cho nhà phát triển
Tài liệu tham khảo về lệnh và lệnh gạch chéo cho ứng dụng ChatGPT trên máy tính, Codex CLI và tiện ích mở rộng Codex IDE.
Lệnh trên ChatGPT web
ChatGPT web có menu lệnh riêng trong trình soạn thảo. Nhập / để xem các thao tác
khả dụng trong cuộc trò chuyện hiện tại. Menu này không cung cấp tập lệnh của ứng dụng ChatGPT
trên máy tính hay CLI; các lệnh gạch chéo, lệnh con CLI và cờ Codex trong
tài liệu tham khảo này không áp dụng cho ChatGPT web.
Lệnh trong ứng dụng ChatGPT trên máy tính
Trang Lệnh tổng quát trình bày cách điều hướng ứng dụng, phím tắt trò chuyện, tùy chỉnh bàn phím và liên kết sâu cho cuộc trò chuyện, phần cài đặt, kỹ năng, tác vụ theo lịch, plugin và thú cưng.
Trang Lệnh gạch chéo trình bày các lệnh
khả dụng trong trình soạn thảo của ứng dụng, bao gồm /feedback, /goal, /init,
/mcp, /plan, /review và /status.
Tài liệu tham khảo lệnh Codex CLI
Cách đọc tài liệu tham khảo này
Trang này liệt kê mọi lệnh và cờ Codex CLI đã được ghi lại trong tài liệu. Hãy dùng các bảng tương tác để tìm kiếm theo khóa hoặc mô tả. Mỗi phần cho biết tùy chọn đang ổn định hay thử nghiệm và lưu ý các tổ hợp có rủi ro.
Cờ toàn cục
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--add-dir |
path |
Cấp quyền ghi cho các thư mục bổ sung bên cạnh không gian làm việc chính. Lặp lại với nhiều đường dẫn. |
--ask-for-approval, -a |
untrusted | on-request | never |
Kiểm soát thời điểm Codex tạm dừng để chờ người dùng phê duyệt trước khi chạy lệnh. |
--cd, -C |
path |
Đặt thư mục làm việc cho tác nhân trước khi tác nhân bắt đầu xử lý yêu cầu của bạn. |
--config, -c |
key=value |
Ghi đè các giá trị cấu hình. Giá trị được phân tích dưới dạng TOML nếu có thể; nếu không, chuỗi nguyên văn sẽ được sử dụng. |
--dangerously-bypass-approvals-and-sandbox, --yolo |
boolean |
Chạy mọi lệnh mà không cần phê duyệt hoặc sandbox. Chỉ sử dụng bên trong một môi trường bên ngoài đã được gia cố bảo mật. |
--dangerously-bypass-hook-trust |
boolean |
Chạy các hook đã bật mà không yêu cầu mức tin cậy hook được lưu cho lần gọi này. Chỉ dành cho quy trình tự động hóa đã kiểm tra nguồn hook. |
--disable |
feature |
Buộc tắt một cờ tính năng (chuyển thành -c features.<name>=false). Có thể lặp lại. |
--enable |
feature |
Buộc bật một cờ tính năng (chuyển thành -c features.<name>=true). Có thể lặp lại. |
--image, -i |
path[,path...] |
Đính kèm một hoặc nhiều tệp hình ảnh vào lời nhắc ban đầu. Phân tách nhiều đường dẫn bằng dấu phẩy hoặc lặp lại cờ. |
--local-provider |
lmstudio | ollama |
Chọn nhà cung cấp cục bộ dùng với --oss, ghi đè oss_provider cho lần chạy này. |
--model, -m |
string |
Ghi đè mô hình được đặt trong cấu hình (ví dụ: gpt-5.6-terra). |
--no-alt-screen |
boolean |
Tắt chế độ màn hình thay thế cho TUI (ghi đè tui.alternate_screen cho lần chạy này). |
--oss |
boolean |
Sử dụng nhà cung cấp mô hình nguồn mở cục bộ. Codex sử dụng --local-provider, oss_provider bạn đã cấu hình hoặc yêu cầu bạn chọn giữa LM Studio và Ollama. |
--profile, -p |
string |
Chồng $CODEX_HOME/profile-name.config.toml lên trên cấu hình người dùng cơ sở. |
--remote |
ws://host:port | wss://host:port | unix:// | unix://PATH |
Kết nối với điểm cuối app-server từ xa qua WebSocket hoặc socket Unix. Được hỗ trợ cho codex, codex resume, codex fork, codex archive, codex delete và codex unarchive; các lệnh con khác từ chối chế độ từ xa. |
--remote-auth-token-env |
ENV_VAR |
Đọc bearer token từ biến môi trường này và gửi token khi kết nối bằng --remote. Yêu cầu --remote; token chỉ được gửi qua URL wss:// hoặc URL ws:// chỉ dành cho máy cục bộ. |
--sandbox, -s |
read-only | workspace-write | danger-full-access |
Chọn chính sách sandbox cho các lệnh shell do mô hình tạo. |
--search |
boolean |
Bật tìm kiếm web trực tiếp (đặt web_search = "live" thay cho "cached" mặc định). |
--strict-config |
boolean |
Báo lỗi khi config.toml chứa các trường mà phiên bản Codex này không nhận dạng. Được hỗ trợ bởi các lệnh thời gian chạy như codex, exec, review, resume, fork, app-server, mcp-server và exec-server. |
PROMPT |
string |
Hướng dẫn dạng văn bản không bắt buộc để bắt đầu phiên. Bỏ qua để khởi chạy TUI mà không điền sẵn thông báo. |
Các tùy chọn này áp dụng cho lệnh codex cơ sở. Hầu hết được truyền tiếp tới các lệnh;
hãy xem ghi chú ở trên hoặc phần trợ giúp của lệnh liên quan để biết ngoại lệ. Đối với các
cờ được truyền tiếp, hãy làm theo phần trợ giúp của lệnh liên quan. Ví dụ: codex exec --oss ...
áp dụng --oss cho exec.
Tổng quan về lệnh
| Khóa | Mức độ hoàn thiện | Chi tiết |
|---|---|---|
codex |
Ổn định | Khởi chạy giao diện người dùng trong terminal. Chấp nhận các cờ toàn cục ở trên cùng lời nhắc hoặc tệp hình ảnh đính kèm không bắt buộc. |
codex app |
Ổn định | Khởi chạy ứng dụng ChatGPT trên máy tính trong macOS hoặc Windows. Trên macOS, Codex có thể mở đường dẫn không gian làm việc; trên Windows, Codex in ra đường dẫn cần mở. |
codex app-server |
Thử nghiệm | Khởi chạy app server Codex để phát triển hoặc gỡ lỗi cục bộ qua stdio, WebSocket hoặc socket Unix. |
codex apply |
Ổn định | Áp dụng bản diff mới nhất do một cuộc trò chuyện Codex trên đám mây tạo ra vào cây làm việc cục bộ. Bí danh: codex a. |
codex archive |
Ổn định | Lưu trữ một phiên tương tác đã lưu theo ID hoặc tên phiên. |
codex cloud |
Thử nghiệm | Duyệt hoặc thực thi các cuộc trò chuyện Codex trên đám mây từ terminal mà không mở TUI. Bí danh: codex cloud-tasks. |
codex completion |
Ổn định | Tạo tập lệnh hoàn thành shell cho Bash, Zsh, Fish hoặc PowerShell. |
codex debug app-server send-message-v2 |
Thử nghiệm | Gỡ lỗi app-server bằng cách gửi một thông báo V2 duy nhất qua ứng dụng kiểm thử tích hợp. |
codex debug models |
Thử nghiệm | In danh mục mô hình thô mà Codex nhìn thấy, kèm tùy chọn chỉ kiểm tra danh mục đi kèm. |
codex debug prompt-input |
Thử nghiệm | Kết xuất danh sách đầu vào lời nhắc mà mô hình nhìn thấy dưới dạng JSON, có thể kèm lời nhắc và hình ảnh. |
codex delete |
Ổn định | Xóa vĩnh viễn một phiên tương tác đã lưu theo ID hoặc tên phiên. |
codex doctor |
Ổn định | Tạo báo cáo chẩn đoán về các vấn đề liên quan đến bản cài đặt cục bộ, cấu hình, xác thực, thời gian chạy, Git, terminal, app-server và danh mục luồng. |
codex exec |
Ổn định | Chạy Codex ở chế độ không tương tác. Bí danh: codex e. Truyền trực tiếp kết quả tới stdout hoặc JSONL và có thể tiếp tục các phiên trước đó. |
codex execpolicy |
Thử nghiệm | Đánh giá các tệp quy tắc execpolicy và xem một lệnh sẽ được cho phép, yêu cầu xác nhận hay chặn. |
codex features |
Ổn định | Liệt kê các cờ tính năng và bật hoặc tắt chúng lâu dài trong config.toml. |
codex fork |
Ổn định | Phân nhánh một phiên tương tác trước đó thành cuộc trò chuyện mới, đồng thời giữ nguyên bản ghi gốc. |
codex login |
Ổn định | Xác thực Codex bằng ChatGPT OAuth, xác thực thiết bị, API key hoặc access token được truyền qua stdin. |
codex logout |
Ổn định | Xóa thông tin xác thực đã lưu. |
codex mcp |
Ổn định | Quản lý các máy chủ Model Context Protocol (liệt kê, thêm, xóa, xác thực). |
codex mcp-server |
Ổn định | Chạy chính Codex dưới dạng máy chủ MCP qua stdio. Hữu ích khi một tác nhân khác sử dụng Codex. |
codex plugin |
Ổn định | Cài đặt, liệt kê và xóa plugin khỏi các nguồn marketplace đã cấu hình. |
codex plugin marketplace |
Ổn định | Thêm, liệt kê, nâng cấp hoặc xóa các marketplace plugin từ Git hoặc nguồn cục bộ. |
codex remote-control |
Thử nghiệm | Chạy hoặc quản lý tính năng điều khiển từ xa cho app-server cục bộ, hoặc tạo mã ghép nối tồn tại trong thời gian ngắn. |
codex resume |
Ổn định | Tiếp tục một phiên tương tác trước đó theo ID hoặc tiếp tục cuộc trò chuyện gần nhất. |
codex review |
Ổn định | Chạy quy trình đánh giá không tương tác đối với các thay đổi chưa commit, bản diff với nhánh cơ sở, một commit hoặc hướng dẫn đánh giá tùy chỉnh. |
codex sandbox |
Ổn định | Chạy các lệnh tùy ý bên trong sandbox macOS, Linux hoặc Windows do Codex cung cấp. |
codex unarchive |
Ổn định | Khôi phục một phiên tương tác đã lưu trữ theo ID hoặc tên phiên. |
codex update |
Ổn định | Kiểm tra và áp dụng bản cập nhật Codex CLI khi bản phát hành đã cài đặt hỗ trợ tự cập nhật. |
Chi tiết lệnh
codex (tương tác)
Chạy codex mà không có lệnh con sẽ khởi chạy giao diện người dùng tương tác trong terminal (TUI). Tác nhân chấp nhận các cờ toàn cục ở trên cùng tệp hình ảnh đính kèm. Tìm kiếm web mặc định ở chế độ dùng bộ nhớ đệm; dùng --search để chuyển sang duyệt trực tiếp. Để làm việc cục bộ thuận tiện, hãy dùng --sandbox workspace-write --ask-for-approval on-request.
Dùng --remote ws://host:port hoặc --remote wss://host:port để kết nối TUI với app server được khởi động bằng codex app-server --listen ws://IP:PORT. Với socket Unix cục bộ, dùng --remote unix:// cho socket mặc định hoặc --remote unix://PATH cho đường dẫn cụ thể. Thêm --remote-auth-token-env <ENV_VAR> khi máy chủ yêu cầu bearer token để xác thực WebSocket.
codex app-server
Khởi chạy app server Codex cục bộ. Chức năng này chủ yếu dành cho phát triển và gỡ lỗi, đồng thời có thể thay đổi mà không báo trước.
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--analytics-default-enabled |
boolean |
Mặc định bật tính năng phân tích cho các ứng dụng app-server chính chủ, trừ khi người dùng chọn không tham gia trong cấu hình. |
--listen |
stdio:// | ws://IP:PORT | unix:// | unix://PATH | off |
URL của trình lắng nghe phương thức truyền tải. Dùng stdio:// cho JSONL, ws://IP:PORT cho điểm cuối TCP WebSocket, unix:// cho socket Unix mặc định, unix://PATH cho socket Unix tùy chỉnh hoặc off để tắt phương thức truyền tải cục bộ. |
--stdio |
boolean |
Sử dụng phương thức truyền tải stdio. Tương đương với --listen stdio:// và loại trừ lẫn nhau với --listen. |
--ws-audience |
string |
Claim aud dự kiến cho bearer token đã ký. Yêu cầu --ws-auth signed-bearer-token. |
--ws-auth |
capability-token | signed-bearer-token |
Chế độ xác thực cho ứng dụng WebSocket của app-server. Nếu bỏ qua, xác thực WebSocket sẽ bị tắt; các trình lắng nghe không cục bộ sẽ hiển thị cảnh báo khi khởi động. |
--ws-issuer |
string |
Claim iss dự kiến cho bearer token đã ký. Yêu cầu --ws-auth signed-bearer-token. |
--ws-max-clock-skew-seconds |
number |
Dung sai độ lệch đồng hồ khi xác thực các claim exp và nbf của bearer token đã ký. Yêu cầu --ws-auth signed-bearer-token. |
--ws-shared-secret-file |
absolute path |
Tệp chứa khóa bí mật dùng chung HMAC để xác thực JWT bearer token đã ký. Bắt buộc khi dùng --ws-auth signed-bearer-token. |
--ws-token-file |
absolute path |
Tệp chứa capability token dùng chung. Dùng với --ws-auth capability-token, trừ khi bạn cung cấp --ws-token-sha256 thay thế. |
--ws-token-sha256 |
hexadecimal SHA-256 digest |
Giá trị băm SHA-256 dự kiến để xác thực capability token. Dùng thay cho --ws-token-file khi token của ứng dụng đến từ một nguồn khác. |
codex app-server --listen stdio:// giữ nguyên hành vi JSONL qua stdio mặc định và codex app-server --stdio là bí danh của phương thức truyền tải đó. --listen ws://IP:PORT bật phương thức truyền tải WebSocket cho các ứng dụng app-server. Máy chủ chấp nhận các URL lắng nghe ws://; hãy dùng kết thúc TLS hoặc proxy bảo mật khi ứng dụng kết nối bằng wss://. Dùng --listen unix:// để chấp nhận bắt tay WebSocket trên socket Unix mặc định của Codex hoặc --listen unix:///absolute/path.sock để chọn đường dẫn socket. Nếu bạn tạo schema cho các binding phía ứng dụng, hãy thêm --experimental để bao gồm các trường và phương thức bị giới hạn.
Thêm --code-mode-host wss://code-mode.example.com/host để kết nối app-server với
máy chủ Code Mode từ xa thay vì khởi động máy chủ cục bộ. Kết nối đi ra này
độc lập với --listen và được mọi luồng trong tiến trình
app-server dùng chung. Chỉ dùng ws:// cho máy chủ localhost hoặc máy chủ được chuyển tiếp qua SSH.
codex remote-control
Chạy codex remote-control để khởi động tính năng điều khiển từ xa ở chế độ chạy trực tiếp. Dùng
codex remote-control start để khởi động daemon app-server cục bộ với tính năng điều khiển từ xa
được bật và codex remote-control stop để dừng daemon. Các ứng dụng điều khiển từ xa
được quản lý và quy trình làm việc từ xa qua SSH sử dụng các lệnh này; chúng không
thay thế cho codex app-server --listen khi bạn xây dựng ứng dụng giao thức
cục bộ.
Sau khi daemon chạy, dùng codex remote-control pair để tạo và
in mã ghép nối thủ công tồn tại trong thời gian ngắn. Thêm --json vào bất kỳ lệnh điều khiển từ xa
nào để nhận đầu ra mà máy có thể đọc. Với pair, phản hồi JSON bao gồm
pairingCode, manualPairingCode, environmentId và expiresAt.
codex app
Khởi chạy ứng dụng ChatGPT trên máy tính từ terminal trong macOS hoặc Windows. Trên macOS, Codex có thể mở một đường dẫn không gian làm việc cụ thể; trên Windows, Codex in ra đường dẫn cần mở.
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--download-url |
url |
Giá trị ghi đè nâng cao cho URL trình cài đặt ứng dụng ChatGPT trên máy tính được dùng trong quá trình cài đặt. |
PATH |
path |
Đường dẫn không gian làm việc cho ứng dụng ChatGPT trên máy tính. Trên macOS, Codex mở đường dẫn này; trên Windows, Codex in ra đường dẫn. |
codex app mở ứng dụng ChatGPT trên máy tính đã cài đặt hoặc khởi động trình cài đặt khi
chưa có ứng dụng. Trên macOS, Codex mở đường dẫn không gian làm việc được cung cấp; trên
Windows, Codex in ra đường dẫn cần mở sau khi cài đặt.
codex debug app-server send-message-v2
Gửi một thông báo qua luồng thread/turn V2 của app-server bằng ứng dụng kiểm thử app-server tích hợp.
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
USER_MESSAGE |
string |
Nội dung thông báo được gửi tới app-server qua luồng ứng dụng kiểm thử V2 tích hợp. |
Luồng gỡ lỗi này khởi tạo bằng experimentalApi: true, bắt đầu một luồng, gửi một lượt và truyền trực tiếp thông báo của máy chủ. Hãy dùng luồng này để tái hiện và kiểm tra hành vi giao thức app-server cục bộ.
codex debug models
In danh mục mô hình thô mà Codex nhìn thấy dưới dạng JSON.
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--bundled |
boolean |
Bỏ qua thao tác làm mới và chỉ in danh mục mô hình đi kèm với tệp nhị phân Codex hiện tại. |
Dùng --bundled khi bạn chỉ muốn kiểm tra danh mục đi kèm với tệp nhị phân hiện tại mà không làm mới từ điểm cuối mô hình từ xa.
codex debug prompt-input
Kết xuất chính xác danh sách đầu vào lời nhắc mà mô hình nhìn thấy dưới dạng JSON. Hãy dùng lệnh này khi gỡ lỗi quá trình khám phá hướng dẫn, ngữ cảnh phiên hoặc cách xây dựng lời nhắc.
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--image, -i |
path[,path...] |
Đính kèm một hoặc nhiều hình ảnh vào lời nhắc của người dùng. Phân tách nhiều đường dẫn bằng dấu phẩy hoặc lặp lại cờ. |
PROMPT |
string |
Lời nhắc người dùng không bắt buộc được thêm sau ngữ cảnh phiên. |
codex apply
Áp dụng bản diff gần nhất từ một cuộc trò chuyện Codex trên đám mây vào kho lưu trữ cục bộ. Bạn phải xác thực và có quyền truy cập cuộc trò chuyện.
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
TASK_ID |
string |
Mã định danh của cuộc trò chuyện Codex trên đám mây có bản diff cần áp dụng. |
Codex in ra các tệp đã vá và thoát với mã khác 0 nếu git apply thất bại (ví dụ: do xung đột).
codex review
Chạy đánh giá mã ở chế độ không tương tác. Chọn chính xác một đối tượng đánh giá hoặc truyền hướng dẫn đánh giá tùy chỉnh dưới dạng lời nhắc.
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--base |
branch |
Đánh giá các thay đổi so với nhánh cơ sở đã chỉ định. |
--commit |
SHA |
Đánh giá các thay đổi do commit đã chỉ định tạo ra. |
--strict-config |
boolean |
Báo lỗi khi config.toml chứa các trường mà phiên bản Codex này không nhận dạng. |
--title |
string |
Đặt tiêu đề commit hiển thị trong bản tóm tắt đánh giá. Yêu cầu --commit. |
--uncommitted |
boolean |
Đánh giá các thay đổi đã stage, chưa stage và chưa được theo dõi. |
PROMPT |
string | - (read stdin) |
Hướng dẫn đánh giá tùy chỉnh. Dùng - để đọc hướng dẫn từ stdin. |
--uncommitted, --base, --commit và PROMPT tùy chỉnh xung đột với
nhau. Chỉ dùng --title cùng với --commit.
codex archive và codex unarchive
Lưu trữ hoặc khôi phục một phiên tương tác đã lưu theo ID hoặc tên phiên. Hãy dùng các lệnh này khi bạn muốn dọn dẹp trình chọn phiên mà không xóa bản ghi. ID phiên được ưu tiên hơn tên phiên.
codex archive <SESSION>
codex unarchive <SESSION>| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--remote |
ws://host:port | wss://host:port | unix:// | unix://PATH |
Kết nối với điểm cuối app-server từ xa trước khi thay đổi trạng thái lưu trữ. |
--remote-auth-token-env |
ENV_VAR |
Đọc bearer token từ biến môi trường này khi --remote yêu cầu xác thực. |
SESSION |
session ID | session name |
Phiên đã lưu cần lưu trữ hoặc khôi phục. ID phiên được ưu tiên hơn tên phiên. |
codex delete
Xóa vĩnh viễn một phiên tương tác đã lưu theo ID hoặc tên phiên. Chỉ dùng lệnh này khi bạn muốn xóa bản ghi thay vì ẩn bản ghi khỏi danh sách phiên đang hoạt động.
codex delete <SESSION>
codex delete <SESSION_UUID> --force| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--force |
boolean |
Xóa mà không yêu cầu xác nhận. Đối số phiên phải là UUID; tên vẫn yêu cầu xác nhận tương tác. |
--remote |
ws://host:port | wss://host:port | unix:// | unix://PATH |
Kết nối với điểm cuối app-server từ xa trước khi xóa phiên. |
--remote-auth-token-env |
ENV_VAR |
Đọc bearer token từ biến môi trường này khi --remote yêu cầu xác thực. |
SESSION |
session ID | session name |
Phiên đã lưu cần xóa. ID phiên được ưu tiên hơn tên phiên. |
Chỉ dùng --force với UUID phiên. Phiên có tên vẫn yêu cầu
xác nhận để Codex không xóa một tên trùng lặp hoặc không rõ ràng mà không hỏi.
codex cloud
Tương tác với các cuộc trò chuyện Codex trên đám mây từ terminal. Lệnh mặc định mở trình chọn tương tác; codex cloud exec gửi trực tiếp một tác vụ và codex cloud list trả về các cuộc trò chuyện gần đây để dùng trong tập lệnh hoặc kiểm tra nhanh.
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--attempts |
1-4 |
Số lần trợ lý thử thực hiện (chọn kết quả tốt nhất trong N lần) mà Codex trên đám mây sẽ chạy. |
--env |
ENV_ID |
Mã định danh môi trường Codex trên đám mây đích (bắt buộc). Dùng codex cloud để liệt kê các tùy chọn. |
QUERY |
string |
Lời nhắc tác vụ. Nếu bỏ qua, Codex sẽ yêu cầu cung cấp chi tiết theo cách tương tác. |
Quá trình xác thực sử dụng cùng thông tin xác thực với CLI chính. Codex thoát với mã khác 0 nếu không gửi được tác vụ.
codex cloud list
Liệt kê các cuộc trò chuyện trên đám mây gần đây với tính năng lọc và phân trang không bắt buộc.
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--cursor |
string |
Con trỏ phân trang do yêu cầu trước đó trả về. |
--env |
ENV_ID |
Lọc tác vụ theo mã định danh môi trường. |
--json |
boolean |
Xuất JSON mà máy có thể đọc thay cho văn bản thuần túy. |
--limit |
1-20 |
Số lượng tác vụ tối đa cần trả về. |
Đầu ra văn bản thuần túy in URL tác vụ, sau đó là chi tiết trạng thái. Dùng --json cho quy trình tự động hóa. Payload JSON chứa một mảng tasks cùng giá trị cursor không bắt buộc. Mỗi tác vụ bao gồm id, url, title, status, updated_at, environment_id, environment_label, summary, is_review và attempt_total.
codex completion
Tạo tập lệnh hoàn thành shell và chuyển hướng đầu ra đến vị trí phù hợp, ví dụ: codex completion zsh > "${fpath[1]}/_codex".
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
SHELL |
bash | zsh | fish | power-shell | elvish |
Shell cần tạo nội dung hoàn thành. Đầu ra được in ra stdout. |
codex doctor
Tạo báo cáo chẩn đoán cục bộ trước khi gửi vấn đề hỗ trợ hoặc trong khi điều tra bản cài đặt Codex bị lỗi. Báo cáo kiểm tra tình trạng của bản cài đặt, cấu hình, xác thực, thời gian chạy, Git, terminal, app-server và danh mục luồng.
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--all |
boolean |
Mở rộng các danh sách dài trong báo cáo chi tiết mà người dùng có thể đọc. |
--ascii |
boolean |
Sử dụng nhãn trạng thái và dấu phân cách ASCII trong đầu ra mà người dùng có thể đọc. |
--json |
boolean |
Xuất báo cáo hỗ trợ đã được che thông tin nhạy cảm và máy có thể đọc. |
--no-color |
boolean |
Tắt màu ANSI trong đầu ra mà người dùng có thể đọc. |
--summary |
boolean |
Chỉ hiển thị các hàng kiểm tra được nhóm và bản tóm tắt số lượng cuối cùng. |
codex features
Quản lý các cờ tính năng được lưu trong $CODEX_HOME/config.toml. Các lệnh enable và
disable lưu thay đổi lâu dài để chúng áp dụng cho các phiên sau. Lệnh con
features không chấp nhận --profile.
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
Disable subcommand |
codex features disable <feature> |
Tắt lâu dài một cờ tính năng trong $CODEX_HOME/config.toml. |
Enable subcommand |
codex features enable <feature> |
Bật lâu dài một cờ tính năng trong $CODEX_HOME/config.toml. |
List subcommand |
codex features list |
Hiển thị các cờ tính năng đã biết, giai đoạn hoàn thiện và trạng thái thực tế của chúng. |
codex exec
Dùng codex exec (hoặc dạng rút gọn codex e) cho các lần chạy bằng tập lệnh hoặc theo kiểu CI cần hoàn tất mà không có sự tương tác của người dùng.
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--cd, -C |
path |
Đặt thư mục gốc của không gian làm việc trước khi thực thi tác vụ. |
--color |
always | never | auto |
Kiểm soát màu ANSI trong stdout. |
--dangerously-bypass-approvals-and-sandbox, --yolo |
boolean |
Bỏ qua lời nhắc phê duyệt và sandbox. Nguy hiểm—chỉ sử dụng bên trong trình chạy được cô lập. |
--dangerously-bypass-hook-trust |
boolean |
Chạy các hook đã bật mà không yêu cầu mức tin cậy hook được lưu cho lần gọi này. Chỉ dành cho quy trình tự động hóa đã kiểm tra nguồn hook. |
--ephemeral |
boolean |
Chạy mà không lưu các tệp rollout của phiên vào ổ đĩa. |
--full-auto |
boolean |
Cờ tương thích đã ngừng khuyến nghị. Hãy ưu tiên --sandbox workspace-write; Codex in cảnh báo khi cờ này được sử dụng. |
--ignore-rules |
boolean |
Không tải các tệp execpolicy .rules của người dùng hoặc dự án cho lần chạy này. |
--ignore-user-config |
boolean |
Không tải $CODEX_HOME/config.toml. Quá trình xác thực vẫn sử dụng CODEX_HOME. |
--image, -i |
path[,path...] |
Đính kèm hình ảnh vào thông báo đầu tiên. Có thể lặp lại; hỗ trợ danh sách được phân tách bằng dấu phẩy. |
--json, --experimental-json |
boolean |
In các sự kiện JSON được phân tách bằng dòng mới thay cho văn bản đã định dạng. |
--local-provider |
lmstudio | ollama |
Chọn nhà cung cấp cục bộ dùng với --oss, ghi đè oss_provider cho lần chạy này. |
--model, -m |
string |
Ghi đè mô hình đã cấu hình cho lần chạy này. |
--oss |
boolean |
Sử dụng nhà cung cấp nguồn mở cục bộ. Codex sử dụng --local-provider hoặc oss_provider bạn đã cấu hình và thoát với lỗi nếu cả hai đều chưa được đặt. |
--output-last-message, -o |
path |
Ghi thông báo cuối cùng của trợ lý vào một tệp. Hữu ích cho tập lệnh xử lý tiếp theo. |
--output-schema |
path |
Tệp JSON Schema mô tả cấu trúc phản hồi cuối cùng dự kiến. Codex xác thực đầu ra công cụ theo schema này. |
--profile, -p |
string |
Chồng $CODEX_HOME/profile-name.config.toml lên trên cấu hình người dùng cơ sở. |
--sandbox, -s |
read-only | workspace-write | danger-full-access |
Chính sách sandbox cho các lệnh do mô hình tạo. Mặc định lấy từ cấu hình. |
--skip-git-repo-check |
boolean |
Cho phép chạy bên ngoài kho lưu trữ Git (hữu ích cho các thư mục dùng một lần). |
-c, --config |
key=value |
Giá trị ghi đè cấu hình nội tuyến cho lần chạy không tương tác (có thể lặp lại). |
PROMPT |
string | - (read stdin) |
Hướng dẫn ban đầu cho tác vụ. Dùng - để truyền lời nhắc từ stdin. |
Resume subcommand |
codex exec resume [SESSION_ID] |
Tiếp tục phiên exec theo ID hoặc thêm --last để tiếp tục phiên gần nhất từ thư mục làm việc hiện tại. Thêm --all để xét các phiên từ mọi thư mục. Chấp nhận lời nhắc tiếp theo không bắt buộc. |
Codex mặc định ghi đầu ra đã định dạng. Thêm --json để nhận các sự kiện JSON được phân tách bằng dòng mới (mỗi thay đổi trạng thái một sự kiện). Lệnh con resume không bắt buộc cho phép bạn tiếp tục các tác vụ không tương tác. Dùng --last để chọn phiên gần nhất từ thư mục làm việc hiện tại hoặc thêm --all để tìm trong tất cả các phiên:
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--all |
boolean |
Bao gồm các phiên nằm ngoài thư mục làm việc hiện tại khi chọn phiên gần nhất. |
--image, -i |
path[,path...] |
Đính kèm một hoặc nhiều hình ảnh vào lời nhắc tiếp theo. Phân tách nhiều đường dẫn bằng dấu phẩy hoặc lặp lại cờ. |
--last |
boolean |
Tiếp tục cuộc trò chuyện gần nhất từ thư mục làm việc hiện tại. |
PROMPT |
string | - (read stdin) |
Hướng dẫn tiếp theo không bắt buộc được gửi ngay sau khi tiếp tục. |
SESSION_ID |
uuid | session name |
Tiếp tục phiên đã chỉ định. Bỏ qua và dùng --last để tiếp tục phiên gần nhất. |
codex execpolicy
Kiểm tra các tệp quy tắc execpolicy trước khi lưu. codex execpolicy check chấp nhận một hoặc nhiều cờ --rules (ví dụ: các tệp trong ~/.codex/rules) và xuất JSON cho biết quyết định nghiêm ngặt nhất cùng mọi quy tắc khớp. Thêm --pretty để định dạng đầu ra. Lệnh execpolicy hiện đang ở giai đoạn xem trước.
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--pretty |
boolean |
In kết quả JSON theo định dạng dễ đọc. |
--rules, -r |
path (repeatable) |
Đường dẫn đến tệp quy tắc execpolicy cần đánh giá. Cung cấp nhiều cờ để kết hợp quy tắc từ nhiều tệp. |
COMMAND... |
var-args |
Lệnh cần được kiểm tra theo các chính sách đã chỉ định. |
codex login
Xác thực CLI bằng tài khoản ChatGPT, API key hoặc access token. Khi không có cờ, Codex mở trình duyệt cho luồng ChatGPT OAuth.
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--device-auth |
boolean |
Sử dụng luồng mã thiết bị OAuth thay vì khởi chạy cửa sổ trình duyệt. |
--with-access-token |
boolean |
Đọc access token từ stdin (ví dụ: printenv CODEX_ACCESS_TOKEN | codex login --with-access-token). |
--with-api-key |
boolean |
Đọc API key từ stdin (ví dụ: printenv OPENAI_API_KEY | codex login --with-api-key). |
status subcommand |
codex login status |
In chế độ xác thực đang hoạt động và thoát với mã 0 khi đã đăng nhập. |
codex login status thoát với 0 khi có thông tin xác thực, điều này hữu ích trong các tập lệnh tự động hóa.
codex logout
Xóa thông tin xác thực đã lưu cho cả API key và xác thực ChatGPT. Lệnh này không có cờ.
codex mcp
Quản lý các mục máy chủ Model Context Protocol được lưu trong ~/.codex/config.toml.
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
add <name> |
-- <command...> | --url <value> |
Đăng ký máy chủ bằng lệnh khởi chạy stdio hoặc URL HTTP có thể truyền trực tiếp. Hỗ trợ --env KEY=VALUE cho phương thức truyền tải stdio. |
get <name> |
--json |
Hiển thị cấu hình của một máy chủ cụ thể. --json in mục cấu hình thô. |
list |
--json |
Liệt kê các máy chủ MCP đã cấu hình. Thêm --json để nhận đầu ra mà máy có thể đọc. |
login <name> |
--scopes scope1,scope2 |
Bắt đầu đăng nhập OAuth cho máy chủ HTTP có thể truyền trực tiếp (chỉ áp dụng cho máy chủ hỗ trợ OAuth). |
logout <name> |
Xóa thông tin xác thực OAuth đã lưu cho máy chủ HTTP có thể truyền trực tiếp. | |
remove <name> |
Xóa định nghĩa máy chủ MCP đã lưu. |
Lệnh con add hỗ trợ cả phương thức truyền tải stdio và HTTP có thể truyền trực tiếp:
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--bearer-token-env-var |
ENV_VAR |
Biến môi trường có giá trị được gửi dưới dạng bearer token khi kết nối với máy chủ HTTP có thể truyền trực tiếp. |
--env KEY=VALUE |
repeatable |
Các phép gán biến môi trường được áp dụng khi khởi chạy máy chủ stdio. |
--oauth-client-id |
CLIENT_ID |
Mã định danh ứng dụng OAuth cho máy chủ MCP HTTP có thể truyền trực tiếp. Yêu cầu --url. |
--oauth-resource |
RESOURCE |
Tham số tài nguyên OAuth cần đưa vào khi đăng nhập cho máy chủ MCP HTTP có thể truyền trực tiếp. Yêu cầu --url. |
--url |
https://… |
Đăng ký máy chủ HTTP có thể truyền trực tiếp thay cho stdio. Loại trừ lẫn nhau với COMMAND.... |
COMMAND... |
stdio transport |
Tệp thực thi cùng các đối số để khởi chạy máy chủ MCP. Cung cấp sau --. |
Các thao tác OAuth (login, logout) chỉ hoạt động với máy chủ HTTP có thể truyền trực tiếp (và chỉ khi máy chủ hỗ trợ OAuth).
codex plugin
Cài đặt, liệt kê và xóa plugin khỏi các marketplace đã cấu hình.
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
add <plugin[@marketplace]> |
[--marketplace, -m NAME] [--json] |
Cài đặt plugin từ một marketplace đã cấu hình. Dùng --marketplace hoặc -m khi đối số plugin không có @marketplace. |
list |
[--marketplace, -m NAME] [--available --json] [--json] |
Liệt kê các plugin đã cài đặt. Khi dùng --json, đầu ra có các mảng installed và available; --available bao gồm các plugin marketplace chưa cài đặt và yêu cầu --json. |
marketplace |
Quản lý các nguồn marketplace đã cấu hình. Xem codex plugin marketplace bên dưới. |
|
remove <plugin[@marketplace]> |
[--marketplace, -m NAME] [--json] |
Xóa một plugin đã cài đặt khỏi cấu hình và bộ nhớ đệm cục bộ. Dùng --json để nhận đầu ra phù hợp với quy trình tự động hóa. |
codex plugin add --json in pluginId, name, marketplaceName,
version, installedPath và authPolicy. codex plugin list --json in các mảng
installed và available. Các mục bao gồm pluginId, name,
marketplaceName, version, installed, enabled, source, installPolicy,
authPolicy và, khi có, marketplaceSource cùng kiểu và giá trị
nguồn marketplace đã cấu hình. codex plugin remove --json in
pluginId, name và marketplaceName.
codex plugin marketplace
Quản lý các nguồn marketplace plugin mà Codex có thể duyệt và cài đặt.
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
add <source> |
[--ref REF] [--sparse PATH] [--json] |
Cài đặt marketplace plugin từ dạng viết tắt GitHub, URL Git, URL SSH hoặc thư mục gốc marketplace cục bộ. --sparse chỉ được hỗ trợ cho nguồn Git và có thể lặp lại. |
list |
[--json] |
Hiển thị các marketplace plugin mà Codex hiện đang xét và đường dẫn gốc của từng marketplace. |
remove <marketplace-name> |
[--json] |
Xóa một marketplace plugin đã cấu hình. |
upgrade [marketplace-name] |
[--json] |
Làm mới một marketplace Git đã cấu hình hoặc tất cả marketplace Git đã cấu hình khi không cung cấp tên. |
codex plugin marketplace add chấp nhận dạng viết tắt GitHub như owner/repo hoặc
owner/repo@ref, URL Git HTTP hoặc HTTPS, URL Git SSH và các thư mục
gốc marketplace cục bộ. Dùng --ref để ghim một tham chiếu Git và lặp lại --sparse PATH để
sử dụng sparse checkout cho các kho lưu trữ marketplace dựa trên Git.
codex plugin marketplace list in tên và thư mục gốc của các marketplace trong phạm vi,
bao gồm các marketplace mặc định được phát hiện ngầm và ảnh chụp nhanh marketplace
đã cấu hình.
Thêm --json vào các lệnh thêm, liệt kê, nâng cấp hoặc xóa marketplace để
nhận đầu ra phù hợp với quy trình tự động hóa. JSON khi thêm marketplace bao gồm marketplaceName,
installedRoot và alreadyAdded; JSON khi liệt kê bao gồm một mảng marketplaces
với name, root và marketplaceSource không bắt buộc; JSON khi nâng cấp bao gồm
selectedMarketplaces, upgradedRoots và errors; JSON khi xóa bao gồm
marketplaceName và installedRoot.
codex mcp-server
Chạy Codex dưới dạng máy chủ MCP qua stdio để các công cụ khác có thể kết nối. Lệnh này kế thừa các giá trị ghi đè cấu hình toàn cục và thoát khi ứng dụng phía dưới đóng kết nối.
codex resume
Tiếp tục một phiên tương tác theo ID hoặc tiếp tục cuộc trò chuyện gần nhất. codex resume giới hạn --last trong thư mục làm việc hiện tại, trừ khi bạn truyền --all. Lệnh chấp nhận cùng các cờ toàn cục như codex, bao gồm giá trị ghi đè mô hình và sandbox.
Nếu thư mục làm việc hiện tại khác với thư mục đã lưu của phiên,
Codex sẽ hỏi cần sử dụng thư mục nào. Đặt
tui.resume_cwd thành "current" hoặc
"session" để dùng lại lựa chọn đó mà không cần hỏi. Giá trị ghi đè --cd (-C)
cụ thể được ưu tiên hơn tui.resume_cwd.
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--all |
boolean |
Bao gồm các phiên nằm ngoài thư mục làm việc hiện tại khi chọn phiên gần nhất. |
--include-non-interactive |
boolean |
Bao gồm các phiên không tương tác trong trình chọn và khi chọn bằng --last. |
--last |
boolean |
Bỏ qua trình chọn và tiếp tục cuộc trò chuyện gần nhất từ thư mục làm việc hiện tại. |
SESSION_ID |
uuid | session name |
Tiếp tục phiên đã chỉ định. Bỏ qua và dùng --last để tiếp tục phiên gần nhất. |
codex fork
Phân nhánh một phiên tương tác trước đó thành cuộc trò chuyện mới. Theo mặc định, codex fork mở trình chọn phiên; thêm --last để phân nhánh phiên gần nhất của bạn.
Khi thư mục hiện tại và thư mục đã lưu của phiên khác nhau, codex fork sử dụng
cùng lời nhắc chọn thư mục làm việc và cài đặt tui.resume_cwd như codex resume.
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--all |
boolean |
Hiển thị các phiên nằm ngoài thư mục làm việc hiện tại trong trình chọn. |
--last |
boolean |
Bỏ qua trình chọn và tự động phân nhánh cuộc trò chuyện gần nhất. |
SESSION_ID |
uuid |
Phân nhánh phiên đã chỉ định. Bỏ qua và dùng --last để phân nhánh phiên gần nhất. |
codex sandbox
Sử dụng trình trợ giúp sandbox để chạy một lệnh theo cùng các chính sách mà Codex sử dụng nội bộ.
Seatbelt trên macOS
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--allow-unix-socket |
path |
Cho phép lệnh trong sandbox liên kết hoặc kết nối với các socket Unix bắt nguồn từ đường dẫn này. Lặp lại để cho phép nhiều đường dẫn. |
--cd, -C |
DIR |
Thư mục làm việc được dùng để phân giải hồ sơ và thực thi lệnh. Yêu cầu --permission-profile. |
--config, -c |
key=value |
Truyền các giá trị ghi đè cấu hình vào lần chạy trong sandbox (có thể lặp lại). |
--include-managed-config |
boolean |
Bao gồm các yêu cầu được quản lý khi phân giải hồ sơ quyền cụ thể. Yêu cầu --permission-profile. |
--log-denials |
boolean |
Ghi lại các lần sandbox macOS từ chối bằng log stream trong khi lệnh chạy và in chúng sau khi thoát. |
--permission-profile, -P |
NAME |
Áp dụng hồ sơ quyền có tên từ ngăn xếp cấu hình đang hoạt động. |
--profile, -p |
NAME |
Chồng $CODEX_HOME/NAME.config.toml lên trên cấu hình người dùng cơ sở. |
COMMAND... |
var-args |
Lệnh shell cần thực thi trong macOS Seatbelt. Mọi nội dung sau -- đều được chuyển tiếp. |
Landlock trên Linux
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--cd, -C |
DIR |
Thư mục làm việc được dùng để phân giải hồ sơ và thực thi lệnh. Yêu cầu --permission-profile. |
--config, -c |
key=value |
Các giá trị ghi đè cấu hình được áp dụng trước khi khởi chạy sandbox (có thể lặp lại). |
--include-managed-config |
boolean |
Bao gồm các yêu cầu được quản lý khi phân giải hồ sơ quyền cụ thể. Yêu cầu --permission-profile. |
--permission-profile, -P |
NAME |
Áp dụng hồ sơ quyền có tên từ ngăn xếp cấu hình đang hoạt động. |
--profile, -p |
NAME |
Chồng $CODEX_HOME/NAME.config.toml lên trên cấu hình người dùng cơ sở. |
COMMAND... |
var-args |
Lệnh cần thực thi trong Landlock + seccomp. Cung cấp tệp thực thi sau --. |
Windows
| Khóa | Kiểu / Giá trị | Chi tiết |
|---|---|---|
--cd, -C |
DIR |
Thư mục làm việc được dùng để phân giải hồ sơ và thực thi lệnh. Yêu cầu --permission-profile. |
--config, -c |
key=value |
Các giá trị ghi đè cấu hình được áp dụng trước khi khởi chạy sandbox (có thể lặp lại). |
--include-managed-config |
boolean |
Bao gồm các yêu cầu được quản lý khi phân giải hồ sơ quyền cụ thể. Yêu cầu --permission-profile. |
--permission-profile, -P |
NAME |
Áp dụng hồ sơ quyền có tên từ ngăn xếp cấu hình đang hoạt động. |
--profile, -p |
NAME |
Chồng $CODEX_HOME/NAME.config.toml lên trên cấu hình người dùng cơ sở. |
COMMAND... |
var-args |
Lệnh cần thực thi trong sandbox Windows gốc. Cung cấp tệp thực thi sau --. |
codex update
Kiểm tra và áp dụng bản cập nhật Codex CLI khi bản phát hành đã cài đặt hỗ trợ tự cập nhật. Bản dựng gỡ lỗi sẽ in thông báo yêu cầu bạn cài đặt bản dựng phát hành thay thế.
Tổ hợp cờ và mẹo an toàn
- Dùng
--sandbox workspace-writecho công việc cục bộ không cần giám sát và có thể giới hạn trong không gian làm việc; tránh--dangerously-bypass-approvals-and-sandboxtrừ khi bạn đang ở trong một máy ảo sandbox chuyên dụng. - Khi cần cấp cho Codex quyền ghi vào nhiều thư mục hơn, hãy ưu tiên
--add-dirthay vì buộc dùng--sandbox danger-full-access. - Kết hợp
--jsonvới--output-last-messagetrong CI để ghi lại tiến trình mà máy có thể đọc và bản tóm tắt cuối cùng bằng ngôn ngữ tự nhiên.
Phím tắt tương tác
- Nhập
@để tìm kiếm một tệp trong không gian làm việc và thêm đường dẫn của tệp vào lời nhắc. - Nhấn Up hoặc Down để khôi phục lịch sử bản nháp.
- Nhấn Ctrl+R để tìm kiếm lịch sử lời nhắc, sau đó nhấn Enter để sử dụng kết quả khớp hoặc Esc để hủy.
- Nhấn Ctrl+O hoặc chạy
/copyđể sao chép đầu ra Codex hoàn tất gần nhất. - Thêm
!vào đầu một dòng để chạy lệnh shell cục bộ theo cài đặt phê duyệt và sandbox hiện tại. - Nhấn Tab trong khi Codex đang làm việc để đưa lời nhắc tiếp theo, lệnh gạch chéo hoặc lệnh shell vào hàng đợi cho lượt sau.
- Nhấn Enter trong khi Codex đang làm việc để đưa hướng dẫn mới vào lượt hiện tại.
- Nhấn Esc hai lần khi trình soạn thảo trống để chỉnh sửa thông báo trước đó của người dùng và phân nhánh cuộc trò chuyện từ điểm đó.
- Nhấn Ctrl+C hoặc chạy
/exitđể đóng phiên.
Tài nguyên liên quan
- Tổng quan về Codex CLI: cài đặt, nâng cấp và mẹo nhanh.
- Kiến thức cơ bản về cấu hình: lưu lâu dài các giá trị mặc định như mô hình và nhà cung cấp.
- Cấu hình nâng cao: hồ sơ, nhà cung cấp, tinh chỉnh sandbox và tích hợp.
- AGENTS.md: tổng quan khái niệm về các khả năng và phương pháp hay nhất của tác nhân Codex.
Lệnh gạch chéo cho phép bạn điều khiển Codex nhanh chóng, ưu tiên bàn phím. Nhập / trong
trình soạn thảo để mở cửa sổ bật lên về lệnh gạch chéo, chọn một lệnh và Codex sẽ thực hiện
các thao tác như chuyển đổi mô hình, điều chỉnh quyền hoặc tóm tắt cuộc trò chuyện dài
mà không cần rời terminal.
Hướng dẫn này chỉ cho bạn cách:
- Tìm lệnh gạch chéo tích hợp phù hợp cho một tác vụ
- Điều khiển một phiên đang hoạt động bằng các lệnh như
/model,/fast,/personality,/permissions,/approve,/raw,/agentvà/status
Lệnh gạch chéo Codex CLI
Lệnh gạch chéo tích hợp
Codex cung cấp các lệnh sau. Mở cửa sổ bật lên về lệnh gạch chéo và bắt đầu nhập tên lệnh để lọc danh sách.
Khi một cuộc trò chuyện đang chạy, bạn có thể nhập lệnh gạch chéo rồi nhấn Tab để
đưa lệnh vào hàng đợi cho lượt sau. Codex phân tích các lệnh gạch chéo trong hàng đợi khi chúng chạy, vì vậy
menu lệnh và lỗi sẽ xuất hiện sau khi lượt hiện tại kết thúc. Tính năng hoàn thành lệnh gạch chéo
vẫn hoạt động trước khi bạn đưa lệnh vào hàng đợi.
| Lệnh | Mục đích | Khi nào nên dùng |
|---|---|---|
/permissions |
Thiết lập những gì Codex có thể làm mà không cần hỏi trước. | Nới lỏng hoặc siết chặt yêu cầu phê duyệt giữa phiên, chẳng hạn như chuyển đổi giữa Auto và Read Only. |
/ide |
Bao gồm các tệp đang mở, vùng chọn hiện tại và ngữ cảnh IDE khác. | Đưa ngữ cảnh trình soạn thảo vào lời nhắc tiếp theo mà không cần giải thích lại những gì đang mở trong IDE. |
/keymap |
Ánh xạ lại các phím tắt TUI. | Kiểm tra và lưu các liên kết phím tắt tùy chỉnh trong config.toml. |
/vim |
Bật hoặc tắt chế độ Vim cho trình soạn thảo. | Chuyển đổi giữa hành vi normal/insert của Vim và chế độ chỉnh sửa mặc định của trình soạn thảo. |
/setup-default-sandbox |
Thiết lập sandbox tác nhân nâng cao (chỉ dành cho Windows). | Thay thế sandbox Windows bị hạn chế sau khi Codex đề xuất thiết lập nâng cao. |
/sandbox-add-read-dir |
Cấp cho sandbox quyền đọc một thư mục bổ sung (chỉ dành cho Windows). | Gỡ chặn các lệnh cần đọc đường dẫn thư mục tuyệt đối nằm ngoài các thư mục gốc hiện có thể đọc. |
/agent, /subagents |
Chuyển luồng tác nhân đang hoạt động. | Kiểm tra hoặc tiếp tục công việc trong luồng tác nhân phụ đã được tạo. |
/apps |
Duyệt các ứng dụng (trình kết nối) và chèn chúng vào lời nhắc. | Đính kèm ứng dụng dưới dạng $app-slug trước khi yêu cầu Codex sử dụng ứng dụng đó. |
/plugins |
Duyệt các plugin đã cài đặt và có thể khám phá. | Kiểm tra công cụ của plugin, cài đặt plugin được đề xuất hoặc quản lý trạng thái khả dụng của plugin. |
/hooks |
Xem và quản lý các hook vòng đời. | Kiểm tra các hook đã cấu hình, tin cậy hook mới hoặc đã thay đổi, hay vô hiệu hóa hook không được quản lý trước khi chúng chạy. |
/clear |
Xóa nội dung terminal và bắt đầu cuộc trò chuyện mới. | Đặt lại đồng thời giao diện hiển thị và ngữ cảnh trò chuyện khi bạn muốn bắt đầu lại. |
/rename |
Đổi tên cuộc trò chuyện hiện tại. | Đặt tên dễ nhận biết cho phiên đã lưu mà không cần rời khỏi TUI. |
/archive |
Lưu trữ phiên hiện tại và thoát Codex. | Xóa phiên hiện tại khỏi danh sách phiên đang hoạt động mà không xóa bản ghi hội thoại. |
/delete |
Xóa vĩnh viễn phiên hiện tại và thoát Codex. | Xóa bản ghi hội thoại và các phiên con khi chỉ lưu trữ là chưa đủ. |
/compact |
Tóm tắt cuộc trò chuyện đang hiển thị để giải phóng token. | Dùng sau các phiên chạy dài để Codex giữ lại những điểm chính mà không làm tràn cửa sổ ngữ cảnh. |
/copy |
Sao chép đầu ra Codex hoàn tất gần nhất. | Lấy phản hồi hoặc nội dung kế hoạch hoàn tất gần nhất mà không cần chọn thủ công. Bạn cũng có thể nhấn Ctrl+O. |
/diff |
Hiển thị Git diff, bao gồm cả những tệp Git chưa theo dõi. | Xem lại các chỉnh sửa của Codex trước khi commit hoặc chạy kiểm thử. |
/exit |
Thoát CLI (tương tự /quit). |
Cách viết thay thế; cả hai lệnh đều thoát khỏi phiên. |
/experimental |
Bật hoặc tắt các tính năng thử nghiệm. | Bật các tùy chọn như Network proxy hoặc Prevent sleep while running. |
/approve |
Phê duyệt một lần thử lại cho quyết định từ chối gần đây của quy trình đánh giá tự động. | Thử lại lệnh hoặc hành động mà trình đánh giá tự động đã từ chối. |
/memories |
Cấu hình việc sử dụng và tạo bộ nhớ. | Bật hoặc tắt việc đưa bộ nhớ vào ngữ cảnh hay tạo bộ nhớ mà không rời khỏi TUI. |
/skills |
Duyệt và sử dụng các skill. | Cải thiện hành vi theo từng tác vụ bằng cách chọn một skill cục bộ phù hợp. |
/import |
Nhập thiết lập, dự án và cuộc trò chuyện gần đây từ Claude Code. | Di chuyển các thành phần được hỗ trợ của tác nhân bên ngoài vào cấu hình Codex và các tệp cục bộ. |
/feedback |
Gửi nhật ký cho đội ngũ bảo trì Codex. | Báo cáo sự cố hoặc chia sẻ dữ liệu chẩn đoán với bộ phận hỗ trợ. |
/init |
Tạo khung AGENTS.md trong thư mục hiện tại. |
Ghi lại các hướng dẫn lâu dài cho kho lưu trữ hoặc thư mục con mà bạn đang làm việc. |
/logout |
Đăng xuất khỏi Codex. | Xóa thông tin xác thực cục bộ khi sử dụng máy dùng chung. |
/mcp |
Liệt kê các công cụ Model Context Protocol (MCP) đã cấu hình. | Kiểm tra những công cụ bên ngoài mà Codex có thể gọi trong phiên; thêm verbose để xem chi tiết máy chủ. |
/mention |
Đính kèm tệp vào cuộc trò chuyện. | Chỉ cho Codex các tệp hoặc thư mục cụ thể mà bạn muốn Codex kiểm tra tiếp theo. |
/model |
Chọn mô hình đang hoạt động (và mức độ suy luận, khi có). | Chuyển đổi giữa các mô hình như gpt-5.6-luna và gpt-5.6-terra trước khi chạy tác vụ. |
/fast |
Bật hoặc tắt cấp dịch vụ Fast khi danh mục mô hình cung cấp cấp này. | Bật hoặc tắt cấp Fast của mô hình hiện tại và lưu lựa chọn. |
/plan |
Chuyển sang chế độ lập kế hoạch và tùy chọn gửi lời nhắc. | Yêu cầu Codex đề xuất kế hoạch thực thi trước khi bắt đầu triển khai. |
/goal |
Đặt, chỉnh sửa, tạm dừng, tiếp tục, xem hoặc xóa mục tiêu tác vụ. | Cung cấp cho Codex một mục tiêu lâu dài để theo dõi trong khi tác vụ lớn hơn đang chạy. |
/personality |
Chọn phong cách giao tiếp cho phản hồi. | Giúp Codex súc tích hơn, giải thích kỹ hơn hoặc cộng tác hơn mà không thay đổi hướng dẫn của bạn. |
/ps |
Hiển thị các terminal chạy nền và đầu ra gần đây của chúng. | Kiểm tra các lệnh chạy lâu mà không rời khỏi bản ghi hội thoại chính. |
/stop |
Dừng tất cả terminal chạy nền. | Hủy công việc terminal chạy nền do phiên hiện tại khởi chạy. |
/fork |
Phân nhánh cuộc trò chuyện hiện tại thành một cuộc trò chuyện mới. | Tạo nhánh từ phiên đang hoạt động để khám phá cách tiếp cận mới mà không làm mất bản ghi hiện tại. |
/app |
Tiếp tục phiên hiện tại trong ứng dụng ChatGPT dành cho máy tính. | Chuyển từ TUI sang ứng dụng máy tính trên macOS hoặc Windows. |
/side, /btw |
Bắt đầu cuộc trò chuyện phụ tạm thời. | Đặt câu hỏi tiếp theo có trọng tâm mà không làm gián đoạn bản ghi của cuộc trò chuyện chính. |
/raw |
Bật hoặc tắt chế độ cuộn ngược thô. | Giảm định dạng khi chọn và sao chép trong terminal lúc xem đầu ra dài. |
/resume |
Tiếp tục một cuộc trò chuyện đã lưu từ danh sách phiên. | Tiếp tục công việc từ phiên CLI trước đó mà không phải bắt đầu lại. |
/new |
Bắt đầu cuộc trò chuyện mới trong cùng phiên CLI. | Đặt lại ngữ cảnh trò chuyện mà không rời CLI khi bạn muốn có lời nhắc mới trong cùng repo. |
/quit |
Thoát CLI. | Rời khỏi phiên ngay lập tức. |
/review |
Yêu cầu Codex đánh giá cây làm việc. | Chạy sau khi Codex hoàn tất công việc hoặc khi bạn muốn có thêm một lượt kiểm tra các thay đổi cục bộ. |
/status |
Hiển thị cấu hình phiên và mức sử dụng token. | Xác nhận mô hình đang hoạt động, chính sách phê duyệt, các thư mục gốc có thể ghi và dung lượng ngữ cảnh còn lại. |
/usage |
Xem mức sử dụng token của tài khoản hoặc dùng một lần đặt lại giới hạn tốc độ. | Kiểm tra hoạt động token ChatGPT hằng ngày, hằng tuần hoặc tích lũy ngay trong TUI. |
/debug-config |
In thông tin chẩn đoán về lớp cấu hình và các yêu cầu. | Gỡ lỗi thứ tự ưu tiên và các yêu cầu chính sách, bao gồm giới hạn mạng thử nghiệm. |
/statusline |
Cấu hình tương tác các trường trên dòng trạng thái TUI. | Chọn và sắp xếp lại các mục ở chân trang (model/context/limits/git/tokens/session), rồi lưu trong config.toml. |
/title |
Cấu hình tương tác các trường tiêu đề cửa sổ hoặc thẻ terminal. | Chọn và sắp xếp lại các mục tiêu đề như dự án, trạng thái, luồng, nhánh, mô hình và tiến độ tác vụ. |
/theme |
Chọn giao diện tô sáng cú pháp. | Xem trước và lưu một giao diện tô sáng cú pháp cho terminal. |
/pets, /pet |
Chọn hoặc ẩn thú cưng trong terminal. | Cá nhân hóa TUI bằng thú cưng môi trường có sẵn hoặc tùy chỉnh. |
/quit và /exit đều thoát CLI. Chỉ sử dụng chúng sau khi bạn đã lưu hoặc
commit mọi công việc quan trọng.
Dùng /permissions để điều chỉnh những gì Codex có thể làm mà không cần hỏi trước. Chỉ dùng
/approve khi bạn cần thử lại một hành động gần đây bị quy trình đánh giá tự động
từ chối.
Điều khiển phiên bằng lệnh gạch chéo
Các quy trình sau giúp phiên của bạn đi đúng hướng mà không cần khởi động lại Codex.
Đặt mô hình đang hoạt động bằng /model
- Khởi động Codex và mở trình soạn thảo.
- Nhập
/modelrồi nhấn Enter. - Chọn một mô hình như
gpt-5.6-lunahoặcgpt-5.6-terratừ cửa sổ bật lên.
Kết quả mong đợi: Codex xác nhận mô hình mới trong bản ghi hội thoại. Chạy /status để xác minh thay đổi.
Bật hoặc tắt chế độ Fast bằng /fast
- Nhập
/fastđể bật cấp dịch vụ Fast của mô hình hiện tại. - Nhập lại
/fastđể tắt.
Kết quả mong đợi: Codex chuyển đổi cấp dịch vụ và lưu lựa chọn. Trong chân trang TUI,
bạn cũng có thể hiển thị mục trạng thái chế độ Fast bằng /statusline.
Các lệnh cấp Fast được điều khiển bởi danh mục. Nếu mô hình hiện tại không công bố
cấp Fast, Codex sẽ không hiển thị /fast.
Đặt phong cách giao tiếp bằng /personality
Dùng /personality để thay đổi cách Codex giao tiếp mà không cần viết lại lời nhắc.
- Trong một cuộc trò chuyện đang hoạt động, nhập
/personalityrồi nhấn Enter. - Chọn một phong cách từ cửa sổ bật lên.
Kết quả mong đợi: Codex xác nhận phong cách mới trong bản ghi hội thoại và sử dụng phong cách đó cho các phản hồi tiếp theo trong cuộc trò chuyện.
Codex hỗ trợ các tính cách friendly, pragmatic và none. Dùng none
để tắt hướng dẫn về tính cách.
Nếu mô hình đang hoạt động không hỗ trợ hướng dẫn dành riêng cho tính cách, Codex sẽ ẩn lệnh này.
Chuyển sang chế độ lập kế hoạch bằng /plan
- Nhập
/planrồi nhấn Enter để chuyển cuộc trò chuyện đang hoạt động sang chế độ lập kế hoạch . - Tùy chọn: cung cấp nội dung lời nhắc ngay trên cùng dòng (ví dụ:
/plan Propose a migration plan for this service). - Bạn có thể dán nội dung hoặc đính kèm hình ảnh khi sử dụng đối số
/plannội dòng.
Kết quả mong đợi: Codex chuyển sang chế độ lập kế hoạch và dùng lời nhắc nội dòng tùy chọn làm yêu cầu lập kế hoạch đầu tiên.
Khi Codex đang làm việc, /plan tạm thời không khả dụng.
Đặt hoặc xem mục tiêu tác vụ bằng /goal
- Nhập
/goal <objective>để đặt mục tiêu, ví dụ/goal Finish the migration and keep tests green. - Nhập
/goalđể xem mục tiêu hiện tại. - Dùng
/goal editđể sửa mục tiêu. Dùng/goal pause,/goal resumehoặc/goal clearđể tạm dừng, tiếp tục hoặc xóa mục tiêu.
Kết quả mong đợi: Codex duy trì mục tiêu gắn với cuộc trò chuyện đang hoạt động trong khi công việc tiếp diễn.
Nội dung mục tiêu không được để trống và có độ dài tối đa 4.000 ký tự. Với hướng dẫn dài hơn, hãy đưa chi tiết vào một tệp và trỏ mục tiêu đến tệp đó.
Bật hoặc tắt các tính năng thử nghiệm bằng /experimental
- Nhập
/experimentalrồi nhấn Enter. - Bật hoặc tắt các tính năng bạn muốn (ví dụ: Network proxy hoặc Prevent sleep while running), sau đó khởi động lại Codex nếu lời nhắc yêu cầu.
Kết quả mong đợi: Codex lưu lựa chọn tính năng vào cấu hình và áp dụng chúng khi khởi động lại.
Phê duyệt một quyết định từ chối của quy trình đánh giá tự động bằng /approve
Dùng /approve khi trình đánh giá tự động đã từ chối một hành động gần đây và bạn muốn
Codex thử lại hành động đó một lần.
- Nhập
/approve. - Xác nhận thử lại khi Codex hiển thị hành động bị từ chối tương ứng.
Kết quả mong đợi: Codex thử lại hành động bị từ chối một lần theo chính sách của phiên hiện tại .
Cấu hình bộ nhớ bằng /memories
- Nhập
/memories. - Chọn Codex nên sử dụng bộ nhớ hiện có, tạo bộ nhớ mới hay duy trì trạng thái tắt bộ nhớ.
Kết quả mong đợi: Codex cập nhật các thiết lập bộ nhớ tương ứng cho các phiên sau.
Sử dụng skill bằng /skills
- Nhập
/skills. - Chọn skill mà bạn muốn Codex áp dụng.
Kết quả mong đợi: Codex chèn ngữ cảnh của skill đã chọn để yêu cầu tiếp theo tuân theo hướng dẫn của skill đó.
Nhập thiết lập Claude Code bằng /import
- Nhập
/import. - Chọn Claude Code.
- Chọn thiết lập, tệp dự án hoặc cuộc trò chuyện gần đây mà bạn muốn di chuyển.
Kết quả mong đợi: Codex mở trình chọn nhập tác nhân bên ngoài và nhập các thành phần được hỗ trợ đã chọn vào cấu hình Codex và các tệp cục bộ. Quá trình khám phá phiên bao gồm tối đa 50 cuộc trò chuyện trong 30 ngày gần nhất.
Chạy /import từ một phiên TUI cục bộ. Lệnh này không khả dụng khi tác vụ đang chạy,
trong phiên từ xa và khi được kết nối với daemon app-server cục bộ.
Để biết quy trình trong ứng dụng máy tính và các loại thành phần được hỗ trợ, hãy xem Nhập từ một tác nhân khác.
Xóa terminal và bắt đầu cuộc trò chuyện mới bằng /clear
- Nhập
/clearrồi nhấn Enter.
Kết quả mong đợi: Codex xóa terminal, đặt lại bản ghi hội thoại hiển thị và bắt đầu một cuộc trò chuyện mới trong cùng phiên CLI.
Để đặt tên cho cuộc trò chuyện mới ngay khi tạo, hãy chạy /clear release prep.
Không giống Ctrl+L, /clear bắt đầu một cuộc trò chuyện mới.
Ctrl+L chỉ xóa phần hiển thị terminal và giữ nguyên cuộc trò chuyện hiện tại . Codex vô hiệu hóa cả hai hành động khi tác vụ đang diễn ra.
Lưu trữ phiên hiện tại bằng /archive
- Nhập
/archiverồi nhấn Enter. - Xác nhận rằng bạn muốn lưu trữ phiên hiện tại và thoát Codex.
Kết quả mong đợi: Codex lưu trữ phiên hiện tại và đóng TUI tương tác.
Codex vẫn lưu bản ghi hội thoại của phiên ở máy cục bộ; sau này hãy khôi phục bằng
codex unarchive <SESSION>.
/archive không khả dụng khi tác vụ đang chạy.
Xóa phiên hiện tại bằng /delete
- Nhập
/deleterồi nhấn Enter. - Xác nhận rằng bạn muốn xóa phiên hiện tại và thoát Codex.
Kết quả mong đợi: Codex xóa bản ghi hội thoại của phiên hiện tại và đóng TUI tương tác. Việc xóa là vĩnh viễn và cũng xóa các phiên con đã được tạo .
/delete không khả dụng khi cuộc trò chuyện đang chạy hoặc trong cuộc trò chuyện phụ.
Cập nhật quyền bằng /permissions
- Nhập
/permissionsrồi nhấn Enter. - Chọn cấu hình phê duyệt sẵn phù hợp với mức độ bạn thấy thoải mái, ví dụ
Autođể chạy tự động hoặcRead Onlyđể xem xét chỉnh sửa. Khi các hồ sơ quyền có tên đang hoạt động, trình chọn cũng hiển thị các hồ sơ tùy chỉnh đã cấu hình cùng phần mô tả.
Kết quả mong đợi: Codex thông báo chính sách đã cập nhật. Các hành động sau này tuân theo chế độ phê duyệt mới cho đến khi bạn thay đổi lại.
Bao gồm ngữ cảnh IDE bằng /ide
- Nhập
/ide. - Thêm văn bản nội dòng tùy chọn nếu bạn muốn giải thích Codex nên làm gì với vùng chọn IDE hiện tại hoặc các tệp đang mở.
Kết quả mong đợi: Codex bao gồm ngữ cảnh IDE có sẵn trong lời nhắc tiếp theo.
Bật hoặc tắt chế độ Vim bằng /vim
- Nhập
/vim. - Tiếp tục chỉnh sửa trong trình soạn thảo.
Kết quả mong đợi: Codex bật hoặc tắt chế độ Vim của trình soạn thảo cho phiên hiện tại. Để đặt chế độ Vim
làm mặc định cho các phiên mới, hãy đặt tui.vim_mode_default = true trong
config.toml.
Thiết lập sandbox Windows nâng cao bằng /setup-default-sandbox
Lệnh này chỉ xuất hiện trên Windows khi Codex đang sử dụng sandbox restricted-token bị hạn chế.
- Nhập
/setup-default-sandbox. - Làm theo quy trình thiết lập dành cho quản trị viên.
Kết quả mong đợi: Codex cấu hình sandbox Windows nâng cao và chọn cấu hình phê duyệt tự động tương ứng.
Sao chép phản hồi mới nhất bằng /copy
- Nhập
/copyrồi nhấn Enter.
Kết quả mong đợi: Codex sao chép đầu ra Codex hoàn tất gần nhất vào bảng nhớ tạm.
Nếu một lượt vẫn đang chạy, /copy sẽ dùng đầu ra hoàn tất gần nhất thay vì
phản hồi đang được tạo. Lệnh này không khả dụng trước đầu ra Codex hoàn tất đầu tiên
và ngay sau khi hoàn tác.
Bạn cũng có thể nhấn Ctrl+O từ TUI chính để sao chép phản hồi hoàn tất gần nhất mà không cần mở menu lệnh gạch chéo.
Bật hoặc tắt cuộn ngược thô bằng /raw
- Nhập
/raw,/raw onhoặc/raw off.
Kết quả mong đợi: Codex bật hoặc tắt chế độ cuộn ngược thô, giúp việc chọn và
sao chép trong terminal trực tiếp hơn. Bạn cũng có thể dùng tổ hợp Alt+R
mặc định hoặc lưu mặc định bằng tui.raw_output_mode = true.
Cấp quyền đọc sandbox bằng /sandbox-add-read-dir
Lệnh này chỉ khả dụng khi chạy CLI trực tiếp trên Windows.
- Nhập
/sandbox-add-read-dir C:\absolute\directory\pathrồi nhấn Enter. - Xác nhận đường dẫn là một thư mục tuyệt đối hiện có.
Kết quả mong đợi: Codex làm mới chính sách sandbox Windows và cấp quyền đọc thư mục đó cho các lệnh chạy trong sandbox sau này.
Kiểm tra phiên bằng /status
- Trong bất kỳ cuộc trò chuyện nào, nhập
/status. - Xem lại đầu ra về mô hình đang hoạt động, chính sách phê duyệt, các thư mục gốc có thể ghi và mức sử dụng token hiện tại. Khi TUI kết nối từ xa, đầu ra cũng hiển thị địa chỉ từ xa và phiên bản máy chủ.
Kết quả mong đợi: Codex in bản tóm tắt xác nhận rằng nó đang hoạt động ở đúng nơi bạn mong đợi.
Xem mức sử dụng tài khoản bằng /usage
- Nhập
/usageđể mở menu mức sử dụng. - Chọn hiển thị hoạt động token hoặc sử dụng một lần đặt lại đã nhận được nếu có.
- Để mở trực tiếp hoạt động token, nhập
/usage daily,/usage weeklyhoặc/usage cumulative.
Kết quả mong đợi: Codex mở các hành động về mức sử dụng hoặc hiển thị hoạt động token của tài khoản cho chế độ xem đã chọn. Nếu phiên không có xác thực tài khoản dịch vụ Codex, Codex hiển thị yêu cầu đăng nhập.
Kiểm tra các lớp cấu hình bằng /debug-config
- Nhập
/debug-config. - Xem lại đầu ra về thứ tự lớp cấu hình (mức ưu tiên thấp nhất trước), trạng thái bật/tắt và nguồn chính sách.
Kết quả mong đợi: Codex in thông tin chẩn đoán lớp cùng chi tiết chính sách như
allowed_approval_policies, allowed_sandbox_modes, mcp_servers, rules,
enforce_residency và experimental_network khi được cấu hình.
Dùng đầu ra này để gỡ lỗi lý do một thiết lập có hiệu lực khác với config.toml.
Cấu hình các mục chân trang bằng /statusline
- Nhập
/statusline. - Dùng trình chọn để bật hoặc tắt và sắp xếp lại các mục, sau đó xác nhận.
Kết quả mong đợi: Dòng trạng thái ở chân trang cập nhật ngay lập tức và được lưu vào
tui.status_line trong config.toml.
Các mục dòng trạng thái khả dụng bao gồm mô hình, mô hình+mức suy luận, thống kê ngữ cảnh, giới hạn tốc độ, nhánh git, bộ đếm token, id phiên, thư mục hiện tại/thư mục gốc dự án và phiên bản Codex.
Cấu hình các mục tiêu đề terminal bằng /title
- Nhập
/title. - Dùng trình chọn để bật hoặc tắt và sắp xếp lại các mục, sau đó xác nhận.
Kết quả mong đợi: Tiêu đề cửa sổ hoặc thẻ terminal cập nhật ngay lập tức và được lưu vào
tui.terminal_title trong config.toml.
Các mục tiêu đề khả dụng bao gồm tên ứng dụng, dự án, biểu tượng chờ, trạng thái, luồng, nhánh git , mô hình và tiến độ tác vụ.
Chọn giao diện cú pháp bằng /theme
- Nhập
/theme. - Xem trước một giao diện từ trình chọn, sau đó xác nhận.
Kết quả mong đợi: Codex cập nhật tô sáng cú pháp và lưu lựa chọn vào
tui.theme trong config.toml.
Chọn thú cưng terminal bằng /pets
- Nhập
/pets(hoặc/pet) để mở trình chọn thú cưng. - Chọn thú cưng có sẵn hoặc tùy chỉnh, hay tắt thú cưng.
Kết quả mong đợi: Codex hiển thị thú cưng môi trường đã chọn trong các terminal được hỗ trợ và
lưu lựa chọn. Bạn cũng có thể nhập /pets off để ẩn thú cưng.
Ánh xạ lại phím tắt TUI bằng /keymap
Dùng /keymap để kiểm tra, cập nhật và lưu các liên kết phím tắt cho TUI.
- Nhập
/keymap. - Chọn ngữ cảnh phím tắt và hành động bạn muốn thay đổi.
- Nhập liên kết phím mới hoặc xóa liên kết hiện có.
Kết quả mong đợi: Codex cập nhật sơ đồ phím đang hoạt động và ghi liên kết tùy chỉnh vào tui.keymap trong config.toml.
Các liên kết phím sử dụng tên như ctrl-a, shift-enter và page-down. Liên kết theo ngữ cảnh ghi đè tui.keymap.global; danh sách liên kết trống sẽ gỡ liên kết hành động.
Kiểm tra các terminal chạy nền bằng /ps
- Nhập
/ps. - Xem lại danh sách terminal chạy nền và trạng thái của chúng.
Kết quả mong đợi: Codex hiển thị lệnh của từng terminal chạy nền cùng tối đa ba dòng đầu ra gần đây không trống, giúp bạn đánh giá nhanh tiến độ.
Terminal chạy nền xuất hiện khi unified_exec đang được sử dụng; nếu không, danh sách có thể trống.
Dừng các terminal chạy nền bằng /stop
- Nhập
/stop. - Xác nhận nếu Codex hỏi trước khi dừng các terminal được liệt kê.
Kết quả mong đợi: Codex dừng tất cả terminal chạy nền của phiên hiện tại. /clean
vẫn khả dụng như một bí danh của /stop.
Giữ bản ghi hội thoại gọn nhẹ bằng /compact
- Sau một cuộc trao đổi dài, nhập
/compact. - Xác nhận khi Codex đề nghị tóm tắt cuộc trò chuyện cho đến thời điểm hiện tại.
Kết quả mong đợi: Codex thay thế các lượt trước bằng bản tóm tắt ngắn gọn, giải phóng ngữ cảnh mà vẫn giữ các chi tiết quan trọng.
Xem lại thay đổi bằng /diff
- Nhập
/diffđể kiểm tra Git diff. - Cuộn qua đầu ra trong CLI để xem lại các chỉnh sửa và tệp đã thêm.
Kết quả mong đợi: Codex hiển thị các thay đổi đã stage, thay đổi chưa stage và các tệp Git chưa theo dõi, để bạn quyết định nên giữ lại những gì.
Đánh dấu tệp bằng /mention
- Nhập
/mentiontheo sau là một đường dẫn, ví dụ/mention src/lib/api.ts. - Chọn kết quả phù hợp từ cửa sổ bật lên.
Kết quả mong đợi: Codex thêm tệp vào cuộc trò chuyện, bảo đảm các lượt tiếp theo tham chiếu trực tiếp đến tệp đó.
Bắt đầu cuộc trò chuyện mới bằng /new
- Nhập
/newrồi nhấn Enter.
Kết quả mong đợi: Codex bắt đầu một cuộc trò chuyện mới trong cùng phiên CLI, để bạn có thể chuyển đổi cuộc trò chuyện mà không rời terminal.
Để đặt tên cho cuộc trò chuyện mới ngay khi tạo, hãy chạy /new bug bash.
Không giống /clear, /new không xóa phần hiển thị terminal hiện tại trước.
Đổi tên cuộc trò chuyện hiện tại bằng /rename
- Nhập
/rename <name>hoặc nhập/renameđể mở lời nhắc đặt tên. - Nhập một tên ngắn giúp bạn tìm lại cuộc trò chuyện sau này.
Kết quả mong đợi: Codex cập nhật tên cuộc trò chuyện đã lưu mà không thay đổi bản ghi hội thoại.
Tiếp tục cuộc trò chuyện đã lưu bằng /resume
- Nhập
/resumerồi nhấn Enter. - Chọn phiên bạn muốn từ trình chọn phiên đã lưu.
Kết quả mong đợi: Codex tải lại bản ghi của cuộc trò chuyện đã chọn để bạn có thể tiếp tục nơi đã dừng, đồng thời giữ nguyên lịch sử ban đầu.
Phân nhánh cuộc trò chuyện hiện tại bằng /fork
- Nhập
/forkrồi nhấn Enter.
Kết quả mong đợi: Codex sao chép cuộc trò chuyện hiện tại thành một cuộc trò chuyện mới có ID mới, giữ nguyên bản ghi gốc để bạn có thể khám phá một cách tiếp cận khác song song.
Nếu cần phân nhánh một phiên đã lưu thay vì phiên hiện tại, hãy chạy
codex fork trong terminal để mở trình chọn phiên.
Tiếp tục trong ứng dụng máy tính bằng /app
Trên macOS và Windows, nhập /app để mở phiên hiện tại trong ứng dụng ChatGPT
dành cho máy tính. Nếu ứng dụng chưa được cài đặt hoặc chưa chạy, Codex sẽ hiển thị lỗi yêu cầu
bạn cài đặt hoặc khởi chạy ứng dụng.
Kết quả mong đợi: Ứng dụng máy tính mở cùng cuộc trò chuyện đã lưu để bạn có thể tiếp tục tại đó.
Bắt đầu cuộc trò chuyện phụ bằng /side
Dùng /side để bắt đầu một nhánh tạm thời từ cuộc trò chuyện hiện tại mà không rời khỏi cuộc trò chuyện chính.
- Nhập
/sideđể mở cuộc trò chuyện phụ. - Tùy chọn thêm văn bản nội dòng, ví dụ
/side Check whether this plan has an obvious risk. - Quay lại cuộc trò chuyện mẹ sau khi hoàn tất phần trao đổi tập trung.
Kết quả mong đợi: Codex mở một cuộc trò chuyện phụ có bản ghi tách biệt với cuộc trò chuyện mẹ. Khi bạn ở chế độ phụ, TUI tiếp tục hiển thị trạng thái của cuộc trò chuyện mẹ để bạn biết cuộc trò chuyện chính có còn đang chạy hay không.
/side không khả dụng bên trong một cuộc trò chuyện phụ khác và trong chế độ đánh giá.
Tạo AGENTS.md bằng /init
- Chạy
/inittrong thư mục mà bạn muốn Codex tìm hướng dẫn lâu dài. - Xem lại
AGENTS.mdđã tạo, sau đó chỉnh sửa để phù hợp với quy ước của kho lưu trữ.
Kết quả mong đợi: Codex tạo khung AGENTS.md để bạn tinh chỉnh và commit cho
các phiên sau.
Yêu cầu đánh giá cây làm việc bằng /review
- Nhập
/review. - Tiếp tục bằng
/diffnếu bạn muốn kiểm tra chính xác các thay đổi trong tệp.
Kết quả mong đợi: Codex tóm tắt các vấn đề tìm thấy trong cây làm việc, tập trung vào
thay đổi hành vi và các kiểm thử còn thiếu. Codex dùng mô hình của phiên hiện tại trừ khi
bạn đặt review_model trong config.toml.
Liệt kê công cụ MCP bằng /mcp
- Nhập
/mcp. - Xem lại danh sách để xác nhận những máy chủ và công cụ MCP nào khả dụng.
Kết quả mong đợi: Bạn thấy các công cụ Model Context Protocol (MCP) đã cấu hình mà Codex có thể gọi trong phiên này.
Dùng /mcp verbose để bao gồm thông tin chẩn đoán máy chủ chi tiết. Nếu bạn truyền bất kỳ giá trị nào khác ngoài verbose, Codex sẽ hiển thị cách dùng lệnh.
Duyệt ứng dụng bằng /apps
- Nhập
/apps. - Chọn một ứng dụng từ danh sách.
Kết quả mong đợi: Codex chèn phần đề cập ứng dụng vào trình soạn thảo dưới dạng $app-slug, để
bạn có thể lập tức yêu cầu Codex sử dụng ứng dụng đó.
Duyệt plugin bằng /plugins
- Nhập
/plugins. - Chọn một thẻ marketplace, sau đó chọn plugin để kiểm tra các khả năng hoặc hành động khả dụng.
Kết quả mong đợi: Codex mở trình duyệt plugin để bạn xem các plugin đã cài đặt, plugin có thể khám phá mà cấu hình của bạn cho phép và trạng thái plugin đã cài đặt. Nhấn Space trên một plugin đã cài đặt để bật hoặc tắt trạng thái hoạt động.
Xem và quản lý các hook vòng đời bằng /hooks
- Nhập
/hooks. - Chọn một sự kiện hook để kiểm tra các trình xử lý tương ứng.
- Tin cậy, vô hiệu hóa hoặc bật lại các hook không được quản lý khi cần.
Kết quả mong đợi: Codex mở trình duyệt hook để bạn xem lại các hook vòng đời đã cấu hình. Hook được quản lý sẽ hiển thị là được quản lý và không thể bị vô hiệu hóa từ trình duyệt hook của người dùng.
Chuyển đổi luồng tác nhân bằng /agent
- Nhập
/agenthoặc/subagentsrồi nhấn Enter. - Chọn luồng bạn muốn từ trình chọn.
Kết quả mong đợi: Codex chuyển luồng đang hoạt động để bạn có thể kiểm tra hoặc tiếp tục công việc của tác nhân đó.
Gửi phản hồi bằng /feedback
- Nhập
/feedbackrồi nhấn Enter. - Làm theo lời nhắc để bao gồm nhật ký hoặc dữ liệu chẩn đoán.
Kết quả mong đợi: Codex thu thập dữ liệu chẩn đoán được yêu cầu và gửi cho đội ngũ bảo trì.
Đăng xuất bằng /logout
- Nhập
/logoutrồi nhấn Enter.
Kết quả mong đợi: Codex xóa thông tin xác thực cục bộ cho phiên người dùng hiện tại.
Thoát CLI bằng /quit hoặc /exit
- Nhập
/quit(hoặc/exit) rồi nhấn Enter.
Kết quả mong đợi: Codex thoát ngay lập tức. Hãy lưu hoặc commit mọi công việc quan trọng trước.
Lệnh của tiện ích mở rộng IDE
Dùng các lệnh này để điều khiển Codex từ Command Palette của VS Code. Bạn cũng có thể gán chúng cho phím tắt.
Gán liên kết phím
Để gán hoặc thay đổi liên kết phím cho một lệnh Codex:
- Mở Command Palette (Cmd+Shift+P trên macOS hoặc Ctrl+Shift+P trên Windows/Linux).
- Chạy Preferences: Open Keyboard Shortcuts.
- Tìm kiếm
Codexhoặc ID lệnh (ví dụ:chatgpt.newChat). - Chọn biểu tượng bút chì, sau đó nhập phím tắt bạn muốn.
Lệnh của tiện ích mở rộng
| Lệnh | Liên kết phím mặc định | Mô tả |
|---|---|---|
chatgpt.addToThread |
- | Thêm vùng văn bản đã chọn làm ngữ cảnh cho cuộc trò chuyện hiện tại |
chatgpt.addFileToThread |
- | Thêm toàn bộ tệp làm ngữ cảnh cho cuộc trò chuyện hiện tại |
chatgpt.newChat |
macOS: Cmd+N Windows/Linux: Ctrl+N |
Tạo cuộc trò chuyện mới |
chatgpt.newCodexPanel |
- | Tạo bảng Codex mới |
chatgpt.openCommandMenu |
- | Mở menu lệnh Codex |
chatgpt.openSidebar |
- | Mở bảng thanh bên Codex |
Lệnh gạch chéo của tiện ích mở rộng IDE
Lệnh gạch chéo cho phép bạn điều khiển Codex mà không rời trình soạn thảo. Dùng chúng để kiểm tra trạng thái, chuyển đổi giữa chế độ cục bộ và đám mây hoặc gửi phản hồi.
Sử dụng lệnh gạch chéo
- Trong trình soạn thảo Codex, nhập
/. - Chọn một lệnh từ danh sách hoặc tiếp tục nhập để lọc (ví dụ:
/status). - Nhấn Enter.
Các lệnh gạch chéo khả dụng
| Lệnh gạch chéo | Mô tả |
|---|---|
/approve |
Phê duyệt một lần thử lại cho quyết định từ chối gần đây của quy trình đánh giá tự động, khi quy trình này đang hoạt động. |
/cloud |
Chạy cuộc trò chuyện trên đám mây khi tính năng thực thi trên đám mây khả dụng. |
/cloud-environment |
Chọn môi trường đám mây cho cuộc trò chuyện. |
/compact |
Thu gọn ngữ cảnh của cuộc trò chuyện hiện tại. |
/fast |
Bật hoặc tắt cấp dịch vụ Fast do danh mục cung cấp, khi khả dụng. |
/feedback |
Mở hộp thoại phản hồi để gửi phản hồi và tùy chọn đính kèm nhật ký. |
/fork |
Sao chép cuộc trò chuyện cục bộ thành một cuộc trò chuyện cục bộ mới. |
/goal |
Đặt mục tiêu lâu dài để Codex hướng tới. |
/ide-context |
Bật hoặc tắt ngữ cảnh IDE tự động. |
/init |
Tạo khung AGENTS.md cho dự án hiện tại. |
/local |
Chạy cuộc trò chuyện trong không gian làm việc cục bộ. |
/mcp |
Mở trạng thái MCP để xem các máy chủ đã kết nối. |
/memories |
Cấu hình việc cuộc trò chuyện có thể sử dụng hoặc tạo bộ nhớ hay không, khi Memories khả dụng. |
/model |
Chọn mô hình cho cuộc trò chuyện hiện tại. |
/personality |
Chọn cách Codex phản hồi, khi mô hình hiện tại hỗ trợ tính cách. |
/plan |
Bật hoặc tắt chế độ lập kế hoạch cho quá trình lập kế hoạch nhiều bước. |
/project |
Chọn dự án cho các cuộc trò chuyện mới. |
/reasoning |
Chọn mức độ suy luận cho cuộc trò chuyện hiện tại. |
/review |
Bắt đầu chế độ đánh giá mã để xem xét các thay đổi chưa commit hoặc so sánh với nhánh cơ sở. |
/side |
Bắt đầu cuộc trò chuyện phụ tạm thời mà không làm gián đoạn cuộc trò chuyện chính. |
/status |
Hiển thị ID cuộc trò chuyện, mức sử dụng ngữ cảnh và giới hạn tốc độ. |
/worktree |
Chạy cuộc trò chuyện trong một Git worktree mới. |