Cài đặt dành cho nhà phát triển

Trang Cài đặt chung bao gồm các tùy chọn của ứng dụng, trong đó có hồ sơ, phím tắt, thông báo, giao diện, cá nhân hóa, bộ nhớ và các cuộc trò chuyện đã lưu trữ.

Hành vi của dự án và terminal

Chọn nơi mở tệp, lượng đầu ra lệnh xuất hiện trong cuộc trò chuyện và vị trí mở các thẻ terminal theo mặc định.

Rà soát mã

Trong Cài đặt > Git, dùng Cách hiển thị rà soát để chọn Nội tuyến nhằm chạy /review trong cuộc trò chuyện hiện tại khi có thể, hoặc Tách riêng để bắt đầu một cuộc trò chuyện đánh giá riêng.

Đồng bộ hóa tiện ích mở rộng IDE

Khi ứng dụng ChatGPT dành cho máy tính và tiện ích mở rộng IDE đang mở trong cùng một dự án, chúng chia sẻ các cuộc trò chuyện đang hoạt động và ngữ cảnh trình soạn thảo. Bật Ngữ cảnh IDE từ trình soạn thảo của ứng dụng để cho phép Codex sử dụng các tệp hiện đang mở trong trình soạn thảo của bạn. Tắt tùy chọn này khi bạn muốn lời nhắc trong ứng dụng không bao gồm ngữ cảnh trình soạn thảo đó.

Bạn có thể mở cuộc trò chuyện trong ứng dụng từ tiện ích mở rộng IDE và tiếp tục cuộc trò chuyện IDE trong ứng dụng. Cả hai giao diện đều dùng cùng một dự án để xác định cuộc trò chuyện và ngữ cảnh nào được chia sẻ.

Cấu hình tác nhân

Các tác nhân Codex trong ứng dụng kế thừa cùng cấu hình với tiện ích mở rộng IDE và CLI. Dùng các nút điều khiển trong ứng dụng cho những cài đặt phổ biến hoặc chỉnh sửa config.toml để thiết lập các tùy chọn nâng cao. Xem Phê duyệt và bảo mật tác nhân và Kiến thức cơ bản về cấu hình để biết chi tiết.

Git

Dùng cài đặt Git để chuẩn hóa cách đặt tên nhánh và chọn việc Codex có sử dụng force push hay không. Bạn cũng có thể đặt lời nhắc mà Codex dùng để tạo thông điệp commit và phần mô tả pull request.

Tích hợp và MCP

Kết nối các công cụ bên ngoài thông qua Model Context Protocol (MCP). Bật các máy chủ được đề xuất hoặc thêm máy chủ của riêng bạn. Nếu máy chủ yêu cầu OAuth, ứng dụng sẽ khởi động quy trình xác thực. Các cài đặt này cũng áp dụng cho Codex CLI và tiện ích mở rộng IDE vì cấu hình MCP nằm trong config.toml. Xem Model Context Protocol để biết chi tiết.

Chế độ nhà phát triển của trình duyệt

Trong Chế độ nhà phát triển, bật Bật toàn quyền truy cập CDP để cho phép ChatGPT sử dụng Chrome DevTools Protocol nhằm lập hồ sơ hiệu năng và gỡ lỗi trình duyệt chuyên sâu hơn. Nếu tổ chức của bạn đã vô hiệu hóa quyền truy cập CDP đầy đủ, bạn không thể bật quyền này ở máy cục bộ. Xem Chế độ nhà phát triển để biết các yêu cầu về thiết lập, rủi ro, phê duyệt và quản trị viên.

Codex CLI đọc các thiết lập mặc định cá nhân của bạn từ ~/.codex/config.toml. Thêm tệp .codex/config.toml vào một dự án hoặc thư mục con đáng tin cậy khi bạn cần ghi đè thiết lập riêng cho dự án. CLI và tiện ích mở rộng IDE dùng chung các lớp cấu hình này.

Kiểm tra cài đặt của bạn

Sử dụng các lệnh sau để nắm được những thiết lập có hiệu lực cho phiên hiện tại:

Chạy /status để xem 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.
Chạy /debug-config để xem các lớp cấu hình theo thứ tự ưu tiên và nguồn của các yêu cầu trong chính sách được quản lý.
Khởi động Codex với --strict-config để coi các khóa config.toml không được nhận dạng là lỗi thay vì bỏ qua chúng.

Xem Các lệnh dành cho nhà phát triển để biết tài liệu tham khảo đầy đủ về các lệnh tương tác.

Thay đổi cài đặt cho một lần chạy

Sử dụng cờ chuyên dụng nếu có. Các ví dụ phổ biến bao gồm --model, --sandbox, --ask-for-approval, --profile và --search. Sử dụng -c hoặc --config để ghi đè bất kỳ khóa cấu hình nào được hỗ trợ cho một lần chạy.

Thiết lập ghi đè mô hình bên dưới yêu cầu quyền truy cập GPT-6.1 Sol. Nếu mô hình này chưa khả dụng cho tài khoản hoặc không gian làm việc của bạn, hãy bỏ --model hoặc chọn một mô hình được liệt kê bởi /model. Xem Khả năng sử dụng GPT-6.1 Sol theo gói.

codex --model gpt-6.1-sol
codex --profile deep-review
codex --config model_reasoning_effort='"medium"'

Các cờ dòng lệnh và giá trị --config có mức ưu tiên cao nhất. Để xem danh sách cờ đầy đủ, hãy tham khảo Các lệnh dành cho nhà phát triển.

Các lớp cấu hình

CLI áp dụng các cờ dòng lệnh và giá trị ghi đè --config trước thiết lập của dự án, hồ sơ, người dùng, hệ thống và thiết lập tích hợp sẵn. Hãy tận dụng thứ tự ưu tiên này để lưu các thiết lập mặc định dùng chung trong tệp cấu hình và thực hiện các thay đổi dùng một lần trên dòng lệnh.

Để xem thứ tự đầy đủ và các tùy chọn phổ biến, hãy tham khảo Kiến thức cơ bản về cấu hình.

Thay đổi cài đặt trong TUI

Giao diện đầu cuối tương tác cung cấp các trình chọn cho những thiết lập phổ biến về phiên và hiển thị như sau:

Mục tiêu	Lệnh	Cấu hình liên quan
Chọn chế độ terminal	`/tui`	`tui.fullscreen_transcript` (cần khởi động lại)
Chọn mô hình	`/model`	`model`, `model_reasoning_effort`
Thay đổi quyền	`/permissions`	Thiết lập phê duyệt và môi trường cô lập
Cấu hình công cụ tùy chọn	`/experimental`, `/memories`	Các khóa `config.toml` dành riêng cho tính năng
Tùy chỉnh giao diện đầu cuối	`/keymap`, `/statusline`, `/title`, `/theme`	Các khóa trong `[tui]`
Đặt mặc định chỉnh sửa	`/vim`, `/raw`	`tui.vim_mode_default`, `tui.raw_output_mode`

Một số lệnh chỉ áp dụng cho phiên hiện tại, trong khi một số trình chọn cho phép lưu lựa chọn. Hãy đặt khóa cấu hình liên quan khi bạn muốn sử dụng một giá trị mặc định cho các phiên sau. Để tìm hiểu quy trình tùy chỉnh giao diện đầu cuối, trình chỉnh sửa, tính năng hoàn thành và phím tắt, hãy xem Tùy chỉnh CLI.

Tài liệu tham khảo về cài đặt

Cấu hình nâng cao trình bày về hồ sơ, thao tác ghi đè dùng một lần và các quy trình nâng cao khác.
Tài liệu tham khảo về cấu hình liệt kê các khóa và giá trị hiện có.
Cấu hình mẫu cung cấp một tệp ví dụ hoàn chỉnh.
Biến môi trường ghi lại các biến được CLI và trình cài đặt sử dụng.

Tiện ích mở rộng Codex IDE có hai lớp thiết lập:

Thiết lập Codex kiểm soát hành vi của tác nhân được dùng chung với Codex CLI, bao gồm mô hình, mức độ suy luận, quyền, môi trường cô lập, MCP servers và tùy chỉnh cá nhân. Codex đọc các thiết lập này từ config.toml.
Thiết lập trình chỉnh sửa kiểm soát cách tiện ích mở rộng hoạt động trong VS Code và các trình chỉnh sửa tương thích. Những thiết lập này sử dụng các khóa chatgpt.* trong hệ thống thiết lập của trình chỉnh sửa.

Mở cài đặt Codex

Chọn biểu tượng bánh răng trong thanh bên Codex, sau đó chọn Cài đặt Codex. Sử dụng bảng thiết lập cho các tùy chọn điều khiển tác nhân phổ biến, hoặc chọn Mở config.toml để chỉnh sửa trực tiếp lớp cấu hình đang hoạt động.

Để xem thứ tự các lớp cấu hình và các khóa phổ biến, hãy tham khảo Kiến thức cơ bản về cấu hình. Để xem mọi khóa config.toml được hỗ trợ, hãy tham khảo Tài liệu tham khảo về cấu hình.

Thay đổi một cài đặt của trình soạn thảo

Để thay đổi một thiết lập, hãy làm theo các bước sau:

Mở phần thiết lập của trình chỉnh sửa.
Tìm kiếm @ext:openai.chatgpt, Codex hoặc tên thiết lập.
Cập nhật giá trị.

Tiện ích mở rộng cũng tuân theo các thiết lập phông chữ trò chuyện tích hợp sẵn của VS Code trên các giao diện trò chuyện Codex.

Tài liệu tham khảo về cài đặt trình soạn thảo

Cài đặt	Mặc định	Mô tả
`chatgpt.commentCodeLensEnabled`	`true`	Hiển thị CodeLens phía trên các chú thích `TODO` để Codex có thể xử lý chúng.
`chatgpt.openOnStartup`	`false`	Đưa thanh bên Codex vào tiêu điểm khi tiện ích khởi động xong.
`chatgpt.followUpQueueMode`	`queue`	Chọn để các tin nhắn được gửi trong khi một lượt chạy đang diễn ra chờ đến lượt chạy tiếp theo (`queue`) hoặc điều hướng lượt chạy hiện tại (`steer`). Tiện ích coi giá trị cũ `interrupt` là `steer`. Nhấn `Cmd`/`Ctrl`+`Shift`+`Enter` để đảo ngược hành vi cho một tin nhắn.
`chatgpt.composerEnterBehavior`	`enter`	Chọn để `Enter` luôn gửi (`enter`), `Cmd`/`Ctrl`+`Enter` gửi lời nhắc nhiều dòng (`cmdIfMultiline`), hoặc luôn bắt buộc dùng phím bổ trợ (`cmdAlways`).
`chatgpt.reviewDelivery`	`inline`	Chạy `/review` trong cuộc trò chuyện hiện tại khi có thể (`inline`) hoặc bắt đầu một cuộc trò chuyện đánh giá riêng (`detached`).
`chatgpt.localeOverride`	Tự động	Đặt ngôn ngữ ưu tiên cho giao diện người dùng Codex. Để trống để tự động phát hiện.
`chatgpt.runCodexInWindowsSubsystemForLinux`	`false`	Chỉ dành cho Windows: Chạy Codex trong WSL khi WSL khả dụng. Hãy dùng tùy chọn này khi các kho lưu trữ và công cụ của bạn nằm trong WSL2 hoặc khi bạn cần công cụ chạy nguyên bản trên Linux. Việc thay đổi cài đặt này sẽ tải lại VS Code.
`chatgpt.cliExecutable`	Chưa đặt	Chỉ dành cho phát triển: Đặt đường dẫn đến tệp thực thi Codex CLI. Bạn không cần cài đặt này trừ khi đang phát triển Codex CLI; việc ghi đè thủ công tệp thực thi đi kèm có thể khiến một số phần của tiện ích không hoạt động.
`chat.fontSize`	Mặc định của trình soạn thảo	Kiểm soát văn bản trò chuyện trong thanh bên Codex, bao gồm nội dung trò chuyện và trình soạn tin.
`chat.editor.fontSize`	Mặc định của trình soạn thảo	Kiểm soát nội dung được kết xuất dưới dạng mã trong các cuộc trò chuyện Codex, bao gồm đoạn mã và phần khác biệt.

Các khóa chatgpt.* ở trên thuộc về tiện ích IDE và không được đặt trong config.toml. Đối với các cài đặt dùng chung cho tác nhân, hãy xem Kiến thức cơ bản về cấu hình, Cấu hình nâng cao, và Tài liệu tham khảo về cấu hình.

Tìm kiếm gần đây

Tìm kiếm đề xuất

Điều hướng tài liệu