Codex with ChatGPT

1. Codex with ChatGPT là gì?

Codex with ChatGPT là một phần bổ sung (gọi là "Skill") cho Codex, trợ lý lập trình của OpenAI. Nó chia việc làm hai: ChatGPT bản web lo phần suy nghĩ (lên kế hoạch, soát lại kết quả), còn Codex lo phần làm (sửa file, chạy lệnh, chạy kiểm thử). Ý tưởng của tác giả: gói ChatGPT trả phí bạn đang đóng tiền thường còn dư lượt dùng trên web, trong khi Codex lại tốn hạn mức cho việc lên kế hoạch. Công cụ này chuyển phần "nghĩ" sang gói web bạn đã trả.

Nói thẳng: đây là công cụ cho người đang dùng Codex để viết code. Nó không phải một ứng dụng chat mới và không có file cài .exe. Tuy vậy, tác giả thiết kế để người không rành kỹ thuật vẫn cài được: bạn dán một đoạn yêu cầu vào Codex và Codex tự làm gần hết.

Dự án miễn phí, mã nguồn mở (giấy phép MIT), không cần khóa API. Đây là dự án cộng đồng, không phải sản phẩm của OpenAI và không được OpenAI bảo trợ.

Hợp với bạn nếu:

• Bạn đã dùng Codex để làm dự án code và có gói ChatGPT trả phí (tài liệu dự án nhắc tới Plus/Pro).
• Bạn muốn ChatGPT lên kế hoạch và soát lại kết quả, còn Codex chỉ việc thực hiện.
• Bạn không muốn đưa cả thư mục dự án lên mạng: ChatGPT chỉ đọc những dòng nó cần, qua một kết nối chỉ-đọc.

Chưa hợp nếu:

• Bạn chưa dùng Codex, hoặc chỉ muốn chat với AI cho việc thường ngày.
• Bạn chỉ có điện thoại. Công cụ chạy trên máy tính.
• Bạn không có gói ChatGPT trả phí.

2. Cần chuẩn bị gì?

Thứ cần có	Chi tiết
Máy tính	Tài liệu hướng dẫn rõ cho macOS và Windows. Với Linux, phần cài cloudflared chỉ ghi "xem hướng dẫn của Cloudflare".
Codex	Trợ lý lập trình của OpenAI, đã cài và đăng nhập. Skill dùng trình duyệt có sẵn trong Codex để mở ChatGPT. Trang chính thức: https://openai.com/codex/
Tài khoản ChatGPT trả phí	Dự án nhắc tới gói Plus/Pro. Giá gói xem trên trang của OpenAI; dự án này không thu thêm tiền.
Node.js từ bản 20	Môi trường chạy chương trình viết bằng JavaScript. Tải tại https://nodejs.org/
Git	Công cụ tải mã nguồn từ GitHub. Tải tại https://git-scm.com/downloads
cloudflared	Chương trình nhỏ của Cloudflare, tạo đường kết nối an toàn để ChatGPT đọc được file trên máy bạn. Skill tự cài khi thiết lập.
Tài khoản Cloudflare và tên miền	Không bắt buộc. Chỉ cần nếu bạn muốn địa chỉ kết nối cố định.
Mạng	Bắt buộc, vì ChatGPT chạy trên web.

Lưu ý: Nếu thiếu Node.js, Git hay cloudflared, bạn không cần tự cài. Đoạn yêu cầu ở Bước 1 bảo Codex tự kiểm tra và cài cái còn thiếu (macOS dùng Homebrew, Windows dùng winget).

3. Cài đặt từng bước

Có hai cách. Cách A dành cho người mới: Codex làm hết. Cách B dành cho người quen dòng lệnh.

Bước 1 (Cách A): Dán yêu cầu cài đặt vào Codex

Mở Codex, tạo một cuộc trò chuyện mới rồi dán đoạn sau:

Hãy cài và cấu hình "Codex with ChatGPT" giúp tôi, tự làm toàn bộ:
1. Kiểm tra máy có git và Node.js từ bản 20 chưa, thiếu thì tự cài
   (macOS dùng Homebrew, Windows dùng winget). Cài thêm cloudflared.
2. Clone https://github.com/XiaoDuoYa/codex-with-chatgpt vào ~/codex-with-chatgpt
   (nếu đã có thì git pull).
3. Trong thư mục đó chạy: corepack pnpm install, rồi corepack pnpm build.
4. Chép skill/SKILL.md vào ~/.codex/skills/codex-with-chatgpt/SKILL.md và sửa dòng
   "The codex-with-chatgpt checkout lives at:" thành đường dẫn thật.
5. Làm theo phần first-time setup trong SKILL.md (chạy c2c setup, mở ChatGPT bằng
   trình duyệt có sẵn để tạo connector và nhập mã ghép nối).
6. Chỉ gọi tôi khi cần đăng nhập hoặc nhập mã xác minh, mỗi lần một việc.
7. Xong thì cho tôi xem danh sách kiểm tra và xác nhận bài thử đọc file đã qua.

Đoạn trên là bản tóm gọn các bước mà dự án công bố. Bản gốc (tiếng Anh và tiếng Trung) nằm trong README của dự án: https://github.com/XiaoDuoYa/codex-with-chatgpt

Thấy gì là đúng: Codex bắt đầu chạy từng lệnh và báo tiến độ. Bạn chỉ cần ngồi chờ.

Bước 2: Đăng nhập khi được hỏi

Trong lúc cài, Codex có thể dừng lại nhờ bạn:

• Đăng nhập ChatGPT trong cửa sổ trình duyệt mà Codex mở.
• Bật "Developer mode" trong ChatGPT nếu chưa bật. Trang cài đặt nằm ở https://chatgpt.com/#settings/Security
• Đăng nhập Cloudflare, chỉ khi bạn chọn dùng địa chỉ cố định.

Mã ghép nối (pairing code) là mã dùng một lần, hết hạn sau khoảng 5 phút. Codex tự tạo và tự nhập, bạn không phải chép tay.

Thấy gì là đúng: sau khi đăng nhập, Codex tự làm tiếp mà không hỏi thêm.

Bước 3: Kiểm tra kết quả

Khi xong, Codex hiện một danh sách năm dòng có dấu tích:

✓ Project detected
✓ Workspace Bridge started
✓ Secure connection established
✓ ChatGPT connected
✓ File read test passed

Dòng cuối là "Ready." Đủ năm dấu tích nghĩa là cài thành công.

Cách B: Cài thủ công cho người quen dòng lệnh

Tải mã nguồn và dựng chương trình:

git clone https://github.com/XiaoDuoYa/codex-with-chatgpt
cd codex-with-chatgpt
corepack pnpm install
corepack pnpm build

Sau đó chép thư mục skill/ của repo vào ~/.codex/skills/codex-with-chatgpt/, mở file SKILL.md vừa chép và sửa dòng "The codex-with-chatgpt checkout lives at:" thành đường dẫn thư mục bạn vừa clone. Cuối cùng nói với Codex: "Set up Codex with ChatGPT."

4. Dùng lần đầu

Mở Codex trong thư mục dự án của bạn và giao việc như bình thường, thêm tên công cụ vào câu yêu cầu. Ví dụ:

Use Codex with ChatGPT to implement: thêm nút đổi giao diện sáng/tối cho trang chủ.

Với một thư mục dự án mới, bạn được nhờ làm một việc, chỉ một lần: tạo một "Project" trong ChatGPT, đặt tên theo thư mục dự án và chọn chế độ bộ nhớ chỉ trong project ("project-only memory"). Nếu thanh bên của ChatGPT không có mục Projects, di chuột vào chữ Chats, bấm dấu ba chấm rồi chọn Organize by project.

Sau đó bạn sẽ thấy vòng làm việc chạy tự động:

1. Codex gửi cho ChatGPT một tin nhắn ngắn mô tả việc cần làm.
2. ChatGPT tự đọc các file liên quan qua kết nối chỉ-đọc rồi trả về kế hoạch.
3. Codex sửa code và chạy kiểm thử trên máy bạn.
4. ChatGPT xem lại thay đổi thật và kết quả kiểm thử, rồi nhận xét.
5. Lặp lại cho tới khi xong.

Kết quả đầu tiên trông thế nào: trong Codex bạn thấy code đã được sửa. Trong ChatGPT, ở Project vừa tạo, có một cuộc trò chuyện ghi lại kế hoạch và phần soát lại.

5. Lỗi thường gặp và cách sửa

Việc đầu tiên khi có trục trặc, theo tác giả: nói với Codex "Update Codex with ChatGPT" rồi thử lại. Bản mới nhất sửa phần lớn lỗi đã biết. Nếu vẫn lỗi, nhờ Codex chạy lệnh kiểm tra:

c2c doctor

Lệnh này kiểm tra Node, thư mục dự án, cầu nối, kết nối và tự sửa những gì nó sửa được.

Dấu hiệu	Nguyên nhân	Cách sửa
Tắt Codex rồi mở lại, ChatGPT báo không kết nối được	Địa chỉ kết nối mặc định là địa chỉ tạm của Cloudflare. Tắt Codex thì địa chỉ đó hết hiệu lực.	Nhờ Codex chạy c2c doctor. Trong ChatGPT (trang https://chatgpt.com/plugins), xóa connector của đúng dự án này rồi để Codex tạo lại với địa chỉ mới. Không bấm "Reconnect": địa chỉ cũ đã chết.
Báo mã ghép nối sai hoặc hết hạn	Mã chỉ dùng một lần và hết hạn sau khoảng 5 phút.	Chờ tới khi trang "Authorize" của ChatGPT hiện ra rồi mới tạo mã mới bằng c2c pair.
Kết nối rớt liên tục ở mạng công ty hay trường học	cloudflared mặc định dùng giao thức QUIC, nhiều mạng chặn giao thức này.	Đặt biến môi trường C2C_TUNNEL_PROTOCOL=http2 rồi khởi động lại cầu nối. Bạn có thể nhờ Codex làm việc này.
Báo chưa cài cloudflared	Máy thiếu chương trình cloudflared.	macOS: brew install cloudflared. Windows: winget install Cloudflare.cloudflared.
Mỗi cuộc trò chuyện Codex mới lại "sửa kết nối" từ đầu	Codex chạy trong vùng cách ly nên không ghi được vào thư mục trạng thái của công cụ.	Nhờ Codex chạy c2c sandbox-allow. Lệnh này thêm thư mục đó vào danh sách được phép ghi trong cấu hình Codex.
ChatGPT báo ACCESS_DENIED_SENSITIVE_FILE khi đọc file	Không phải lỗi. File .env, khóa, thông tin đăng nhập bị chặn có chủ ý.	Không cần sửa. Muốn chặn thêm file, thêm quy tắc vào file .c2cignore.
Không thấy mục Projects trong ChatGPT	Thanh bên đang ở kiểu hiển thị khác.	Di chuột vào Chats, bấm dấu ba chấm, chọn Organize by project.

Nếu kẹt hoàn toàn, nhờ Codex dựng lại từ đầu:

c2c stop
c2c setup

6. Gỡ cài đặt / cập nhật

Cập nhật. Skill tự kiểm tra GitHub mỗi ngày một lần và tự cập nhật khi có bản mới. Bạn cũng có thể nói với Codex bất cứ lúc nào: "Update Codex with ChatGPT". Bản mới nhất lúc viết bài là v0.1.3 (phát hành 11/9/2026).

Gỡ cài đặt. Dự án chưa có tài liệu gỡ cài đặt riêng. Dựa trên những nơi tài liệu ghi là công cụ có lưu dữ liệu, bạn gỡ theo thứ tự sau:

1. Nhờ Codex chạy c2c stop để tắt cầu nối, và c2c unpair để hủy quyền đã cấp.
2. Mở https://chatgpt.com/plugins và xóa connector của từng dự án.
3. Xóa thư mục Skill: ~/.codex/skills/codex-with-chatgpt.
4. Xóa thư mục mã nguồn đã tải: ~/codex-with-chatgpt (hoặc nơi bạn đã clone).
5. Xóa thư mục trạng thái. Trên macOS: ~/Library/Application Support/codex-with-chatgpt. Trên Windows: %LOCALAPPDATA%\codex-with-chatgpt.

Nếu không chắc, cứ nhờ Codex: "Gỡ hoàn toàn Codex with ChatGPT khỏi máy tôi, liệt kê trước những gì sẽ xóa."

7. Câu hỏi hay gặp

Có mất tiền không? Bản thân công cụ miễn phí và không cần khóa API. Bạn vẫn cần gói ChatGPT trả phí và quyền dùng Codex. Giá các gói đó xem trên trang của OpenAI.

Code của tôi có bị đưa lên mạng không? Theo tài liệu dự án, thư mục dự án không bị tải lên nguyên cả khối. ChatGPT đọc đúng những dòng nó cần qua một kết nối chỉ-đọc có xác thực. Máy chủ cầu nối không có công cụ ghi, xóa hay chạy lệnh. File .env, khóa và thông tin đăng nhập bị chặn mặc định. Dù vậy, những dòng ChatGPT đã đọc thì đi qua đường hầm Cloudflare tới ChatGPT, nên hãy cân nhắc với dự án cần bảo mật cao.

Có cần mạng không? Có. ChatGPT chạy trên web và kết nối đi qua Cloudflare.

Đây có phải sản phẩm của OpenAI không? Không. Tác giả ghi rõ đây là dự án cộng đồng, không liên kết với OpenAI và không được OpenAI bảo trợ. Dự án đang ở phiên bản đầu (V1).

Tôi có cần hiểu MCP, OAuth, tunnel là gì không? Không. Tác giả thiết kế để Codex tự cấu hình hết. Bạn chỉ cần đăng nhập khi được hỏi.