Tiếng Việt

Lệnh dành cho nhà phát triển

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 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 bộ lệnh của ứng dụng ChatGPT trên máy tính hoặc CLI; các lệnh gạch chéo, lệnh con CLI và cờ của 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 dành 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/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 ở trạng thái ổn định hay thử nghiệm và nêu bật 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 thêm quyền ghi cho các thư mục bên cạnh không gian làm việc chính. Lặp lại để chỉ định 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ờ con người 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.
--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 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 môi trường cô lập. Chỉ dùng trong 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 (được 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 (được 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 Dùng nhà cung cấp mô hình nguồn mở cục bộ. Codex dùng --local-provider, oss_provider đã cấu hình hoặc yêu cầu bạn chọn giữa LM Studio và Ollama.
--profile, -p string Xếp lớp $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. Hỗ trợ cho codex, codex resume, codex fork, codex archive, codex deletecodex 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 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 cục bộ.
--sandbox, -s read-only | workspace-write | danger-full-access Chọn chính sách môi trường cô lập 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 các lệnh thời gian chạy như codex, exec, review, resume, fork, app-server, mcp-serverexec-server hỗ trợ.
PROMPT string Chỉ dẫn 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 điệp.

Các tùy chọn này áp dụng cho lệnh codex cơ sở. Hầu hết được truyền sang các lệnh; xem ghi chú ở trên hoặc phần trợ giúp của lệnh liên quan để biết ngoại lệ. Với các cờ được truyền, 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 Stable 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 Stable 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 đường dẫn cần mở.
codex app-server Experimental Khởi chạy Codex app server để phát triển hoặc gỡ lỗi cục bộ qua stdio, WebSocket hoặc socket Unix.
codex apply Stable Áp dụng diff mới nhất do cuộc trò chuyện Codex trên đám mây tạo vào cây làm việc cục bộ. Bí danh: codex a.
codex archive Stable Lưu trữ một phiên tương tác đã lưu theo ID hoặc tên phiên.
codex cloud Experimental 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 Stable Tạo tập lệnh tự động hoàn thành shell cho Bash, Zsh, Fish hoặc PowerShell.
codex debug app-server send-message-v2 Experimental Gỡ lỗi app-server bằng cách gửi một thông điệp V2 qua trình khách kiểm thử tích hợp.
codex debug models Experimental 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 Experimental 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 Stable 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 Stable Tạo báo cáo chẩn đoán về sự cố 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 Stable Chạy Codex không tương tác. Bí danh: codex e. Truyền trực tiếp kết quả đến stdout hoặc JSONL và có thể tiếp tục các phiên trước.
codex execpolicy Experimental Đá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 Stable Liệt kê cờ tính năng và bật hoặc tắt lâu dài trong config.toml.
codex fork Stable 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 Stable Xác thực Codex bằng ChatGPT OAuth, xác thực thiết bị, API key hoặc access token được chuyển qua stdin.
codex logout Stable Xóa thông tin xác thực đã lưu.
codex mcp Stable Quản lý máy chủ Model Context Protocol (liệt kê, thêm, xóa, xác thực).
codex mcp-server Deprecated Giao diện đã ngừng dùng để chạy Codex dưới dạng máy chủ MCP qua stdio. Hãy dùng Codex app server. Để gọi Codex từ Claude Code, hãy dùng plugin Codex cho Claude Code.
codex plugin Stable Cài đặt, liệt kê và xóa plugin từ các nguồn marketplace đã cấu hình.
codex plugin marketplace Stable Thêm, liệt kê, nâng cấp hoặc xóa marketplace plugin từ Git hay nguồn cục bộ.
codex remote-control Experimental Chạy hoặc quản lý đ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 Stable Tiếp tục 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 Stable Chạy quy trình đánh giá không tương tác đối với thay đổi chưa commit, diff của nhánh cơ sở, một commit hoặc chỉ dẫn đánh giá tùy chỉnh.
codex sandbox Stable Chạy các lệnh tùy ý bên trong môi trường cô lập macOS, Linux hoặc Windows do Codex cung cấp.
codex unarchive Stable 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 Stable 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 terminal tương tác (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 dùng chế độ bộ nhớ đệm; hãy 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 Codex app server cục bộ. Tính 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 phân tích cho các trình khách 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 trình lắng nghe giao 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 giao thức truyền tải cục bộ.
--stdio boolean Dùng giao thức truyền tải stdio. Tương đương --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 trình khách WebSocket của app-server. Nếu bỏ qua, xác thực WebSocket sẽ bị tắt; trình lắng nghe không phải cục bộ sẽ 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 Sai lệch đồng hồ cho phép khi xác thực các claim expnbf 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 với --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.
--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 --ws-token-file khi token của trình khách đến từ nguồn khác.

codex app-server --listen stdio:// giữ nguyên hành vi JSONL qua stdio mặc định, còn codex app-server --stdio là bí danh cho giao thức truyền tải đó. --listen ws://IP:PORT bật giao thức truyền tải WebSocket cho trình khách app-server. Máy chủ chấp nhận URL lắng nghe ws://; hãy dùng điểm kết cuối TLS hoặc proxy bảo mật khi trình khách 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 tạo schema cho phần liên kết trình khách, hãy thêm --experimental để bao gồm các trường và phương thức bị kiểm soát.

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 này tách biệt 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 được chuyển tiếp qua SSH.

codex remote-control

Chạy codex remote-control để khởi động điều khiển từ xa ở tiền cảnh. Dùng codex remote-control start để khởi động daemon app-server cục bộ có bật điều khiển từ xa và codex remote-control stop để dừng daemon. Trình khách điều khiển từ xa được quản lý và quy trình từ xa qua SSH dùng các lệnh này; chúng không thay thế codex app-server --listen khi bạn xây dựng trình khách giao thức cục bộ.

Sau khi daemon đang 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 mọi lệnh điều khiển từ xa để nhận đầu ra máy có thể đọc. Với pair, phản hồi JSON bao gồm pairingCode, manualPairingCode, environmentIdexpiresAt.

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 đườ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 đườ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 đường dẫn cần mở sau khi cài đặt.

codex debug app-server send-message-v2

Gửi một thông điệp qua luồng thread/turn V2 của app-server bằng trình khách 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 điệp được gửi đến app-server qua luồng trình khách 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 từ máy chủ. Hãy dùng để 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 làm mới và chỉ in danh mục mô hình đi kèm 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 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 danh sách đầu vào lời nhắc chính xác mà mô hình nhìn thấy dưới dạng JSON. Dùng tính năng này khi gỡ lỗi quá trình khám phá chỉ 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 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 nối sau ngữ cảnh phiên.

codex apply

Áp dụng 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ó diff cần áp dụng.

Codex in 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ã không tương tác. Chọn chính xác một mục tiêu đánh giá hoặc truyền chỉ 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á thay đổi so với nhánh cơ sở được chỉ định.
--commit SHA Đánh giá các thay đổi do commit được chỉ định đưa vào.
--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) Chỉ dẫn đánh giá tùy chỉnh. Dùng - để đọc chỉ dẫn từ stdin.

--uncommitted, --base, --commitPROMPT tùy chỉnh xung đột với nhau. Chỉ dùng --title cùng --commit.

codex archivecodex 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. Dùng các lệnh này khi bạn muốn dọn dẹp bộ 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 hỏi. Đối số phiên phải là UUID; tên vẫn cần 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 cần 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ở bộ 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 để viết 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ử (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ê tùy chọn.
QUERY string Lời nhắc tác vụ. Nếu bỏ qua, Codex sẽ hỏi chi tiết theo cách tương tác.

Quy trình xác thực 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, có thể lọc và phân trang.

Khóa Kiểu / Giá trị Chi tiết
--cursor string Con trỏ phân trang được trả về từ yêu cầu trước.
--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ố 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 tự động hóa. Payload JSON chứa 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_reviewattempt_total.

codex completion

Tạo tập lệnh tự động hoàn thành shell và chuyển hướng đầu ra đến vị trí thích 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 tự động 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 khi điều tra một bản cài đặt Codex bị lỗi. Báo cáo kiểm tra tình trạng 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à con người có thể đọc.
--ascii boolean Dùng nhãn trạng thái và dấu phân cách ASCII trong đầu ra mà con người có thể đọc.
--json boolean Xuất báo cáo hỗ trợ đã được che dữ liệu nhạy cảm mà máy có thể đọc.
--no-color boolean Tắt màu ANSI trong đầu ra mà con người 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ờ tính năng được lưu trong $CODEX_HOME/config.toml. Các lệnh enabledisable lưu thay đổi để á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 có hiệu lực 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ó tương tác của con người.

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 yêu cầu phê duyệt và môi trường cô lập. Nguy hiểm—chỉ dùng trong trình chạy 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 tệp rollout của phiên vào ổ đĩa.
--full-auto boolean Cờ tương thích đã ngừng dùng. Ưu tiên --sandbox workspace-write; Codex in cảnh báo khi dùng cờ này.
--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. Quy trình xác thực vẫn dùng CODEX_HOME.
--image, -i path[,path...] Đính kèm hình ảnh vào thông điệp đầu tiên. Có thể lặp lại; hỗ trợ danh sách phân tách bằng dấu phẩy.
--json, --experimental-json boolean In các sự kiện JSON 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 Dùng nhà cung cấp nguồn mở cục bộ. Codex dùng --local-provider hoặc oss_provider đã 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 điệp cuối cùng của trợ lý vào một tệp. Hữu ích cho việc viết tập lệnh ở bước sau.
--output-schema path Tệp JSON Schema mô tả hình dạng phản hồi cuối cùng dự kiến. Codex xác thực đầu ra công cụ theo tệp này.
--profile, -p string Xếp lớp $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 môi trường cô lập cho các lệnh do mô hình tạo. Mặc định theo 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 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) Chỉ dẫn ban đầu cho tác vụ. Dùng - để chuyển lời nhắc từ stdin.
Resume subcommand codex exec resume [SESSION_ID] Tiếp tục một 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 nối không bắt buộc.

Codex ghi đầu ra đã định dạng theo mặc định. Thêm --json để nhận các sự kiện JSON phân tách bằng dòng mới (một sự kiện cho mỗi thay đổi trạng thái). 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 trong thư mục làm việc hiện tại hoặc thêm --all để tìm trong mọi phiên:

Khóa Kiểu / Giá trị Chi tiết
--all boolean Bao gồm các phiên bên 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 nối. 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) Chỉ dẫn tiếp nối 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 được 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 ở bản xem trước.

Khóa Kiểu / Giá trị Chi tiết
--pretty boolean In đẹp kết quả JSON.
--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 kiểm tra theo các chính sách được 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 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 giao thức truyền tải stdio.
get <name> --json Hiển thị cấu hình 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á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ỉ dành 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ả giao 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 trình khách 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 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 từ 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ừ marketplace đã cấu hình. Dùng --marketplace hoặc -m khi đối số plugin bỏ qua @marketplace.
list [--marketplace, -m NAME] [--available --json] [--json] Liệt kê các plugin đã cài đặt. Với --json, đầu ra có các mảng installedavailable; --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 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 tự động hóa.

codex plugin add --json in pluginId, name, marketplaceName, version, installedPathauthPolicy. codex plugin list --json in các mảng installedavailable. 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, namemarketplaceName.

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 xem 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à thư mục gốc marketplace cục bộ. Dùng --ref để ghim một Git ref và lặp lại --sparse PATH để dùng sparse checkout cho kho lưu trữ marketplace dựa trên Git.

codex plugin marketplace list in tên và thư mục gốc marketplace trong phạm vi, bao gồm marketplace mặc định được phát hiện ngầm và các ảnh chụp nhanh marketplace đã cấu hình.

Thêm --json vào 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 tự động hóa. JSON khi thêm marketplace bao gồm marketplaceName, installedRootalreadyAdded; JSON khi liệt kê bao gồm mảng marketplaces với name, rootmarketplaceSource không bắt buộc; JSON khi nâng cấp bao gồm selectedMarketplaces, upgradedRootserrors; JSON khi xóa bao gồm marketplaceNameinstalledRoot.

codex mcp-server

Đối với các tích hợp hiện có, lệnh này 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 kế thừa các giá trị ghi đè cấu hình toàn cục và thoát khi trình khách phía sau đóng kết nối.

codex resume

Tiếp tục 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ác cờ toàn cục giống codex, bao gồm giá trị ghi đè mô hình và môi trường cô lập.

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 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 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 bên 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 bộ chọn và lựa chọn --last.
--last boolean Bỏ qua bộ 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 được 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ở bộ chọn phiên; thêm --last để phân nhánh phiên gần nhất.

Khi thư mục của phiên hiện tại và phiên đã lưu khác nhau, codex fork dùng cùng lời nhắc thư mục làm việc và tùy chọn tui.resume_cwd như codex resume.

Khóa Kiểu / Giá trị Chi tiết
--all boolean Hiển thị các phiên bên ngoài thư mục làm việc hiện tại trong bộ chọn.
--last boolean Bỏ qua bộ 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 được chỉ định. Bỏ qua và dùng --last để phân nhánh phiên gần nhất.

codex sandbox

Dùng trình hỗ trợ môi trường cô lập để chạy lệnh theo cùng chính sách mà Codex sử dụng nội bộ.

macOS seatbelt
Khóa Kiểu / Giá trị Chi tiết
--allow-unix-socket path Cho phép lệnh trong môi trường cô lập 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 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 môi trường cô lập (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 môi trường cô lập 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 Xếp lớp $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.
Linux Landlock
Khóa Kiểu / Giá trị Chi tiết
--cd, -C DIR Thư mục làm việ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 môi trường cô lập (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 Xếp lớp $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 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 môi trường cô lập (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 Xếp lớp $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 môi trường cô lập gốc của Windows. 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.

Tổ hợp cờ và mẹo an toàn

  • Dùng --sandbox workspace-write cho công việc cục bộ không cần giám sát và có thể nằm trong không gian làm việc; tránh --dangerously-bypass-approvals-and-sandbox trừ khi bạn đang ở trong một máy ảo cô lập 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-dir thay vì buộc dùng --sandbox danger-full-access.
  • Kết hợp --json với --output-last-message trong 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 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 trong lịch sử lời nhắc, sau đó nhấn Enter để 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 tiền tố ! vào một dòng để chạy lệnh shell cục bộ theo cài đặt phê duyệt và môi trường cô lập hiện tại.
  • Nhấn Tab khi Codex đang làm việc để xếp lời nhắc tiếp nối, lệnh gạch chéo hoặc lệnh shell vào hàng đợi cho lượt sau.
  • Nhấn Enter khi Codex đang làm việc để chèn chỉ 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 điệp 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

Lệnh gạch chéo giú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 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 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 trình bày cách:

  • Tìm đúng lệnh gạch chéo tích hợp cho một tác vụ
  • Điều hướng một phiên đang hoạt động bằng các lệnh như /model, /fast, /personality, /permissions, /approve, /raw, /agent/status

Lệnh gạch chéo của Codex CLI

Lệnh gạch chéo tích hợp

Codex đi kèm các lệnh sau. Mở cửa sổ bật lên 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 để xếp 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 xuất hiện sau khi lượt hiện tại kết thúc. Tính năng tự động hoàn thành lệnh gạch chéo vẫn hoạt động trước khi bạn xếp 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 Đưa các tệp đang mở, vùng chọn hiện tại và ngữ cảnh IDE khác vào. Đư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 phím tắt TUI. Kiểm tra và lưu lâu dài 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 môi trường cô lập nâng cao cho tác nhân (chỉ dành cho Windows). Thay thế môi trường cô lập Windows bị hạn chế sau khi Codex đề xuất thiết lập nâng cao.
/sandbox-add-read-dir Cấp cho môi trường cô lập quyền đọc một thư mục bổ sung (chỉ dành cho Windows). Cho phép các lệnh cần đọc đường dẫn thư mục tuyệt đối nằm ngoài những 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ý khả năng sử dụng 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 tắt 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 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 trò chuyện.
/delete Xóa vĩnh viễn phiên hiện tại và thoát Codex. Xóa bản ghi và các phiên con khi việc 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 làm việc 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ả các 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 (giống như /quit). Cách viết thay thế; cả hai lệnh đều thoát phiên.
/experimental Bật hoặc tắt các tính năng thử nghiệm. Bật những 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 hành động vừa bị đánh giá tự động từ chối. 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 chèn hay tạo bộ nhớ mà không cần rời TUI.
/skills Duyệt và sử dụng các kỹ năng. Cải thiện hành vi theo từng tác vụ bằng cách chọn một kỹ năng cục bộ phù hợp.
/import Nhập thiết lập, dự án và cuộc trò chuyện từ Claude Code hoặc Cursor. 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à tệp cục bộ.
/feedback Gửi nhật ký cho đội ngũ duy 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 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ỉ định cho Codex các tệp hoặc thư mục cụ thể mà bạn muốn kiểm tra tiếp theo.
/model Chọn mô hình đang hoạt động (và mức độ suy luận, nếu có). Chuyển đổi giữa các mô hình như gpt-5.6-lunagpt-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 chạy tác vụ lớn hơn.
/personality Chọn phong cách giao tiếp cho phản hồi. Làm cho Codex súc tích hơn, giải thích chi tiết 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 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 cần rời bản ghi chính.
/stop Dừng tất cả terminal nền. Hủy công việc terminal 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 cuộc trò chuyện mới. Phân nhánh phiên đang hoạt động để khám phá cách tiếp cận mới mà không 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 dành cho 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 nối 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 lại đầu ra dài.
/resume Tiếp tục 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 dùng lời nhắc mới trong cùng repo.
/quit Thoát CLI. Rời phiên ngay lập tức.
/review Yêu cầu Codex xem xét cây làm việc của bạn. Chạy sau khi Codex hoàn thành công việc hoặc khi bạn muốn có thêm một lượt đánh giá 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 lớp cấu hình và yêu cầu. Gỡ lỗi thứ tự ưu tiên và yêu cầu chính sách, bao gồm các ràng buộc 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 vào config.toml.
/title Cấu hình tương tác các trường tiêu đề cửa sổ hoặc tab terminal. Chọn và sắp xếp lại các mục tiêu đề như project, status, thread, branch, model và task progress.
/theme Chọn giao diện tô sáng cú pháp. Xem trước và lưu lâu dài giao diện tô sáng cú pháp cho terminal.
/pets, /pet Chọn hoặc ẩn thú cưng terminal. Cá nhân hóa TUI bằng thú cưng nền tích hợp sẵn hoặc tùy chỉnh.

/quit/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 mà quá trình đánh giá tự động đã từ chối.

Kiểm soát 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

  1. Khởi động Codex và mở trình soạn thảo.
  2. Nhập /model rồi nhấn Enter.
  3. Chọn một mô hình như gpt-5.6-luna hoặc gpt-5.6-terra trong 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 trò chuyện. Chạy /status để xác minh thay đổi.

Bật hoặc tắt chế độ Fast bằng /fast

  1. Nhập /fast để bật cấp dịch vụ Fast của mô hình hiện tại.
  2. 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.

  1. Trong cuộc trò chuyện đang hoạt động, nhập /personality rồi nhấn Enter.
  2. Chọn một phong cách trong 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 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, pragmaticnone. 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 theo tính cách, Codex sẽ ẩn lệnh này.

Chuyển sang chế độ lập kế hoạch bằng /plan

  1. Nhập /plan rồi nhấn Enter để chuyển cuộc trò chuyện đang hoạt động sang chế độ lập kế hoạch.
  2. Tùy chọn: cung cấp nội dung lời nhắc trên cùng dòng (ví dụ: /plan Propose a migration plan for this service).
  3. Bạn có thể dán nội dung hoặc đính kèm hình ảnh khi dùng đối số /plan trên cùng dòng.

Kết quả mong đợi: Codex chuyển sang chế độ lập kế hoạch và dùng lời nhắc tùy chọn trên cùng dòng 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

  1. Nhập /goal <objective> để đặt mục tiêu, ví dụ /goal Finish the migration and keep tests green.
  2. Nhập /goal để xem mục tiêu hiện tại.
  3. Dùng /goal edit để sửa mục tiêu. Dùng /goal pause, /goal resume hoặ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 giữ 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 tục.

Nội dung mục tiêu không được để trống và 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

  1. Nhập /experimental rồi nhấn Enter.
  2. 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 hành động bị đánh giá tự động từ chối 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.

  1. Nhập /approve.
  2. Xác nhận lầ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

  1. Nhập /memories.
  2. Chọn Codex nên sử dụng bộ nhớ hiện có, tạo bộ nhớ mới hay tiếp tục tắt chức năng bộ nhớ.

Kết quả mong đợi: Codex cập nhật các thiết lập bộ nhớ liên quan cho những phiên sau.

Sử dụng kỹ năng bằng /skills

  1. Nhập /skills.
  2. Chọn kỹ năng bạn muốn Codex áp dụng.

Kết quả mong đợi: Codex chèn ngữ cảnh của kỹ năng đã chọn để yêu cầu tiếp theo tuân theo hướng dẫn của kỹ năng đó.

Nhập thiết lập Claude Code hoặc Cursor bằng /import

  1. Nhập /import.
  2. Chọn Claude Code hoặc Cursor.
  3. 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ở bộ chọn nhập từ 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à 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 kết nối với daemon app-server cục bộ.

Để biết quy trình trong ứng dụng dành cho 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 nội dung terminal và bắt đầu cuộc trò chuyện mới bằng /clear

  1. Nhập /clear rồi nhấn Enter.

Kết quả mong đợi: Codex xóa nội dung terminal, đặt lại bản ghi đang 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 cuộc trò chuyện mới.

Ctrl+L chỉ xóa nội dung hiển thị trên terminal và vẫn giữ cuộc trò chuyện hiện tại. Codex vô hiệu hóa cả hai thao tác khi tác vụ đang chạy.

Lưu trữ phiên hiện tại bằng /archive

  1. Nhập /archive rồi nhấn Enter.
  2. 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 giữ bản ghi phiên trong bộ nhớ cục bộ; sau này bạn có thể 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

  1. Nhập /delete rồi nhấn Enter.
  2. 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 phiên hiện tại và đóng TUI tương tác. Thao tác xóa là vĩnh viễn và cũng xóa các phiên con đã tạo.

/delete không khả dụng khi cuộc trò chuyện đang chạy hoặc khi ở trong cuộc trò chuyện phụ.

Cập nhật quyền bằng /permissions

  1. Nhập /permissions rồi nhấn Enter.
  2. Chọn thiết lập phê duyệt sẵn phù hợp với mức độ thoải mái của bạn, ví dụ Auto để chạy tự động hoặc Read Only để xem lại chỉnh sửa. Khi các hồ sơ quyền có tên đang hoạt động, bộ chọn cũng hiển thị các hồ sơ tùy chỉnh đã cấu hình cùng mô tả của chúng.

Kết quả mong đợi: Codex thông báo chính sách đã cập nhật. Các hành động sau đó tuân theo chế độ phê duyệt mới cho đến khi bạn thay đổi lại.

Đưa ngữ cảnh IDE vào bằng /ide

  1. Nhập /ide.
  2. Thêm văn bản tùy chọn trên cùng dòng 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 đưa ngữ cảnh IDE hiện có vào lời nhắc tiếp theo.

Bật hoặc tắt chế độ Vim bằng /vim

  1. Nhập /vim.
  2. 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 thiết lập tui.vim_mode_default = true trong config.toml.

Thiết lập môi trường cô lập Windows nâng cao bằng /setup-default-sandbox

Lệnh này chỉ xuất hiện trên Windows khi Codex đang dùng môi trường cô lập restricted-token bị hạn chế.

  1. Nhập /setup-default-sandbox.
  2. 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 môi trường cô lập Windows nâng cao và chọn thiết lập phê duyệt tự động tương ứng.

Sao chép phản hồi mới nhất bằng /copy

  1. Nhập /copy rồ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 xử lý. 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

  1. Nhập /raw, /raw on hoặ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 liên kết mặc định Alt+R hoặc lưu thiết lập mặc định bằng tui.raw_output_mode = true.

Cấp quyền đọc môi trường cô lập 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.

  1. Nhập /sandbox-add-read-dir C:\absolute\directory\path rồi nhấn Enter.
  2. 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 môi trường cô lập Windows và cấp quyền đọc thư mục đó cho các lệnh chạy trong môi trường cô lập sau này.

Kiểm tra phiên bằng /status

  1. Trong bất kỳ cuộc trò chuyện nào, nhập /status.
  2. 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

  1. Nhập /usage để mở menu mức sử dụng.
  2. Chọn hiển thị hoạt động token hoặc sử dụng một lần đặt lại đã nhận được và đang khả dụng.
  3. Để mở trực tiếp hoạt động token, hãy nhập /usage daily, /usage weekly hoặc /usage cumulative.

Kết quả mong đợi: Codex mở các thao tá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 sẽ 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

  1. Nhập /debug-config.
  2. 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, rulesexperimental_network khi đã cấu hình.

Dùng đầu ra này để gỡ lỗi nguyên nhân 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

  1. Nhập /statusline.
  2. Dùng bộ 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 hiện có 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

  1. Nhập /title.
  2. Dùng bộ 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 tab 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 đề hiện có bao gồm tên ứng dụng, dự án, chỉ báo xoay, 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

  1. Nhập /theme.
  2. Xem trước một giao diện trong bộ chọn, sau đó xác nhận.

Kết quả mong đợi: Codex cập nhật cách 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

  1. Nhập /pets (hoặc /pet) để mở bộ chọn thú cưng.
  2. Chọn thú cưng tích hợp 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 nền đã 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.

  1. Nhập /keymap.
  2. Chọn ngữ cảnh phím tắt và hành động bạn muốn thay đổi.
  3. Nhập liên kết 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 dùng những tên như ctrl-a, shift-enterpage-down. Liên kết theo ngữ cảnh ghi đè tui.keymap.global; danh sách liên kết trống sẽ hủy liên kết hành động.

Kiểm tra terminal nền bằng /ps

  1. Nhập /ps.
  2. Xem lại danh sách terminal 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 nền cùng tối đa ba dòng đầu ra không trống gần đây để bạn nhanh chóng đánh giá tiến độ.

Terminal 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 terminal nền bằng /stop

  1. Nhập /stop.
  2. Xác nhận nếu Codex yêu cầu trước khi dừng các terminal được liệt kê.

Kết quả mong đợi: Codex dừng tất cả terminal nền của phiên hiện tại. /clean vẫn khả dụng dưới dạng bí danh của /stop.

Giữ bản ghi gọn nhẹ bằng /compact

  1. Sau một cuộc trao đổi dài, nhập /compact.
  2. Xác nhận khi Codex đề xuất tóm tắt cuộc trò chuyện cho đến thời điểm đó.

Kết quả mong đợi: Codex thay thế các lượt trước bằng bản tóm tắt súc tích, giải phóng ngữ cảnh trong khi vẫn giữ những chi tiết quan trọng.

Xem lại thay đổi bằng /diff

  1. Nhập /diff để kiểm tra Git diff.
  2. 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ị những thay đổi bạn đã stage, những thay đổi chưa stage và các tệp Git chưa theo dõi để bạn có thể quyết định giữ lại nội dung nào.

Làm nổi bật tệp bằng /mention

  1. Nhập /mention theo sau là một đường dẫn, ví dụ /mention src/lib/api.ts.
  2. Chọn kết quả khớp trong 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

  1. Nhập /new rồi nhấn Enter.

Kết quả mong đợi: Codex bắt đầu cuộc trò chuyện mới trong cùng phiên CLI để bạn có thể chuyển cuộc trò chuyện mà không cần 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 nội dung hiển thị hiện tại trên terminal trước.

Đổi tên cuộc trò chuyện hiện tại bằng /rename

  1. Nhập /rename <name> hoặc nhập /rename để mở lời nhắc đặt tên.
  2. 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.

Tiếp tục cuộc trò chuyện đã lưu bằng /resume

  1. Nhập /resume rồi nhấn Enter.
  2. Chọn phiên bạn muốn trong bộ 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 từ 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

  1. Nhập /fork rồi nhấn Enter.

Kết quả mong đợi: Codex sao chép cuộc trò chuyện hiện tại thành cuộc trò chuyện mới với một 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ở bộ chọn phiên.

Tiếp tục trong ứng dụng dành cho 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 không 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 dành cho 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 chuyển khỏi cuộc trò chuyện chính.

  1. Nhập /side để mở cuộc trò chuyện phụ.
  2. Tùy chọn thêm văn bản trên cùng dòng, ví dụ /side Check whether this plan has an obvious risk.
  3. 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ở 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ế độ xem xét.

Tạo AGENTS.md bằng /init

  1. Chạy /init trong thư mục mà bạn muốn Codex tìm hướng dẫn lâu dài.
  2. Xem lại AGENTS.md đã tạo, sau đó chỉnh sửa cho phù hợp với quy ước của kho lưu trữ.

Kết quả mong đợi: Codex tạo một khung AGENTS.md để bạn tinh chỉnh và commit cho các phiên sau.

Yêu cầu xem xét cây làm việc bằng /review

  1. Nhập /review.
  2. Tiếp tục bằng /diff nế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à 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

  1. Nhập /mcp.
  2. Xem lại danh sách để xác nhận các máy chủ và công cụ MCP hiện có.

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 để đưa thông tin chẩn đoán máy chủ chi tiết vào. Nếu bạn truyền nội dung khác verbose, Codex sẽ hiển thị cách dùng lệnh.

Duyệt ứng dụng bằng /apps

  1. Nhập /apps.
  2. Chọn một ứng dụng trong 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ể yêu cầu Codex sử dụng ứng dụng đó ngay lập tức.

Duyệt plugin bằng /plugins

  1. Nhập /plugins.
  2. Chọn một tab marketplace, sau đó chọn plugin để kiểm tra khả năng hoặc thao tác hiện có.

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 plugin đó.

Xem và quản lý các hook vòng đời bằng /hooks

  1. Nhập /hooks.
  2. Chọn một sự kiện hook để kiểm tra các trình xử lý tương ứng.
  3. 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 trong trình duyệt hook của người dùng.

Chuyển luồng tác nhân bằng /agent

  1. Nhập /agent hoặc /subagents rồi nhấn Enter.
  2. Chọn luồng bạn muốn trong bộ 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

  1. Nhập /feedback rồi nhấn Enter.
  2. Làm theo lời nhắc để đính kè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ũ duy trì.

Đăng xuất bằng /logout

  1. Nhập /logout rồ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

  1. 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 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:

  1. Mở Command Palette (Cmd+Shift+P trên macOS hoặc Ctrl+Shift+P trên Windows/Linux).
  2. Chạy Preferences: Open Keyboard Shortcuts.
  3. Tìm Codex hoặc ID lệnh (ví dụ: chatgpt.newChat).
  4. Chọn biểu tượng bút chì, sau đó nhập phím tắt bạn muốn.

Lệnh 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 cần 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

  1. Trong trình soạn thảo Codex, nhập /.
  2. Chọn một lệnh trong danh sách hoặc tiếp tục nhập để lọc (ví dụ: /status).
  3. Nhấn Enter.

Các lệnh gạch chéo hiện có

Lệnh gạch chéo Mô tả
/approve Phê duyệt một lần thử lại cho hành động vừa bị đánh giá tự động từ chối khi đánh giá tự động đang hoạt động.
/cloud Chạy cuộc trò chuyện trên đám mây khi khả 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 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ộ của bạn.
/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 việc 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 lại các thay đổi chưa commit hoặc so sánh với một 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.