Hôm nay mình sẽ hướng dẫn anh em cách dùng Codex CLI, bắt đầu với thư mục thu-codex để cài công cụ, đăng nhập và gõ prompt bằng tiếng Việt.
Phần cài và đăng nhập dưới đây được soạn từ tài liệu chính thức của OpenAI. Mình chưa tự chạy thử nên anh em cứ đối chiếu tài liệu. Anh em cứ hiểu prompt là yêu cầu mình viết cho AI để nói rõ việc cần làm.
Tài liệu ghi Codex CLI là một agent của OpenAI chuyên làm việc với code, chạy ngay trên máy tính của anh em. Anh em cứ hiểu agent là AI nhận yêu cầu rồi làm việc với code.
Bước một: Chuẩn bị một thư mục thử
Anh em tạo thư mục trống tên thu-codex để bắt đầu thử.
Anh em mở terminal, tức cửa sổ gõ lệnh, rồi đi tới thư mục thu-codex vừa tạo. Trước khi gửi yêu cầu, anh em kiểm tra terminal đang mở đúng thư mục thử, để sau khi công cụ báo xong còn biết chính xác phải tìm file kết quả ở đâu.
Anh em đừng mở Codex trong thư mục công việc thật nhé. Mình chọn việc viết file giới thiệu dịch vụ vì ai cũng đọc được kết quả mà không cần biết code.
Bước hai: Cài để học cách dùng Codex CLI
Anh em dùng Mac hoặc Linux thì chạy lệnh đầu (bắt đầu bằng curl), còn Windows thì chạy lệnh thứ hai (bắt đầu bằng powershell) ngay bên dưới.
Nếu anh em dùng Mac hoặc Linux, tài liệu hướng dẫn chạy lệnh này trong terminal:
curl -fsSL https://chatgpt.com/codex/install.sh | shNếu anh em dùng Windows, mở cửa sổ powershell rồi chạy nguyên lệnh sau trong cửa sổ vừa mở:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"Anh em chọn lệnh theo hệ điều hành của mình, chờ lệnh chạy xong rồi sang bước sau. Anh em chỉ chạy một trong các lệnh cài: Mac/Linux dùng lệnh bắt đầu bằng curl, Windows dùng lệnh bắt đầu bằng powershell. Anh em chỉ chọn cách cài bằng npm hoặc Homebrew khi đã có sẵn công cụ tương ứng.
Tài liệu cũng có cách cài bằng npm hoặc Homebrew cho anh em đã dùng những công cụ này. Anh em cứ hiểu npm và Homebrew là công cụ cài phần mềm qua terminal.
Nếu anh em đã có sẵn npm thì tài liệu cho phép cài bằng lệnh này:
npm install -g @openai/codexNếu anh em đã có sẵn Homebrew thì dùng lệnh này để cài Codex:
brew install --cask codexMình để thêm hai cách cho anh em đã quen công cụ. Nếu anh em đã cài xong bằng một cách thì cứ chuyển sang bước mở công cụ, vì bài này không cần anh em chạy hết mọi lệnh cài được chép bên trên.
Bước ba: Mở công cụ trong thư mục thử
Cài xong, anh em gõ codex trong terminal đang mở ở thư mục thử để chạy Codex.
codexSau khi gõ codex, anh em chọn đăng nhập theo hướng dẫn mình viết ở bước tiếp theo. Lệnh cài chỉ đưa Codex lên máy, còn gõ codex mới là bắt đầu dùng.
Anh em kiểm tra terminal vẫn đang ở thư mục thử nhé. Nếu anh em đã chuyển sang thư mục khác trong lúc cài, hãy quay về thư mục thử trước khi mở công cụ, để file mới nằm đúng nơi mình định kiểm tra.
Nếu gõ codex mà terminal báo không tìm thấy lệnh, anh em đóng terminal, mở lại cửa sổ mới rồi gõ lại.
Bước bốn: Đăng nhập bằng tài khoản ChatGPT
Anh em đã gõ codex ở bước trước rồi thì cứ chọn “Sign in with ChatGPT” trên màn hình đó, không cần gõ lại. Tài liệu khuyên đăng nhập bằng tài khoản ChatGPT để dùng Codex trong gói Plus, Pro, Business, Edu hoặc Enterprise.
Anh em kiểm tra gói mình đang dùng trước khi đăng nhập. Tài liệu cũng cho phép dùng API key nhưng ghi rõ cách này cần thiết lập thêm. Anh em cứ hiểu API key là một chuỗi ký tự để phần mềm được phép dùng dịch vụ.
Bài này mình chỉ hướng dẫn đăng nhập bằng tài khoản ChatGPT, vì tài liệu chưa nói rõ các bước thiết lập khi dùng API key.
Bước năm: Giao một việc bằng tiếng Việt
Mình đề xuất anh em gõ prompt bằng tiếng Việt trong thư mục thử. Tài liệu chưa có ví dụ tiếng Việt để anh em chép theo, nên prompt dưới đây do mình soạn, với mục đích tạo một file có nội dung đọc được ngay.
Anh em bắt đầu bằng prompt yêu cầu tạo một file cụ thể.
Bạn hãy tạo file gioi-thieu.txt trong thư mục này để giới thiệu dịch vụ viết bài blog.Bạn hãy viết bằng tiếng Việt cho khách hàng là các quán cà phê nhỏ.Bạn chỉ làm việc trong thư mục này và không tự thêm thông tin về giá dịch vụ.
Anh em có thể giữ nguyên ví dụ để tập giao việc. Nếu anh em đổi sang dịch vụ khác, hãy thay phần dịch vụ và khách hàng trong prompt để lúc đọc kết quả còn có thông tin cụ thể làm căn cứ đối chiếu.
Sau khi Codex trả lời, anh em mở thư mục thử xem có file mới không. Anh em mở file để kiểm tra. Anh em đọc kỹ file xem có đúng dịch vụ và đúng khách hàng mình yêu cầu không, đừng tin mỗi lời báo “đã xong” của Codex.
Nếu thư mục chưa có file mới, anh em yêu cầu Codex tạo file gioi-thieu.txt ngay trong thư mục thử. Anh em kiểm tra tên file trước khi đọc nội dung nhé.
Nếu nội dung chưa ưng, anh em chỉ rõ phần cần sửa. Chẳng hạn, anh em yêu cầu rút ngắn phần giới thiệu hoặc bỏ một câu chưa đúng với dịch vụ mình thực sự cung cấp cho khách hàng, rồi đọc lại phần vừa sửa trong file.
Lỗi hay gặp
Anh em cứ hiểu installer là chương trình cài công cụ lên máy tính của mình. Tài liệu ghi installer mặc định tải từ releases.openai.com/codex khi anh em chạy lệnh cài.
Nếu không tải được metadata hoặc file từ đó thì installer tự chuyển sang GitHub Releases. Anh em cứ hiểu metadata là thông tin mà installer cần đọc để tìm đúng file tải về.
Nếu muốn ép installer tải từ GitHub Releases, anh em đặt CODEX_INSTALLER_USE_RELEASES_OPENAI_COM thành false. Anh em dùng Mac hoặc Linux thì chạy nguyên lệnh bên dưới để yêu cầu installer tải từ GitHub Releases.
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false shAnh em cài được rồi thì bỏ qua lệnh này nhé. Mình để lệnh ở phần lỗi để anh em có cách đổi nơi tải khi cần, chứ anh em không cần chạy lại installer sau khi đã mở được công cụ trong terminal.
Nguồn có một lệnh tương ứng cho Windows, nhưng dòng lệnh trong nguồn bị lỗi định dạng nên mình chưa chép vào bài, anh em xem trực tiếp trong tài liệu nhé. Mình chưa tự chạy thử, nên anh em đừng xem cách tải từ GitHub Releases là cách sửa mọi lỗi cài.
Nếu Codex hỏi quyền chạy lệnh hay tạo file thì anh em đọc kỹ rồi mới đồng ý. Anh em chỉ giao việc lớn hơn khi đã mở file thật và thấy nội dung đúng ý.
