Tài liệu ChatGPT
Tiếng Việt
Liên hệ goolvyouyou@gmail.com

WSL

Chạy và khắc phục sự cố Codex trong Windows Subsystem for Linux

Khi bạn sử dụng WSL2, Codex chạy bên trong môi trường Linux thay vì dùng Windows sandbox gốc. Hãy chọn WSL2 khi bạn cần công cụ gốc của Linux, các kho mã và quy trình phát triển của bạn đã nằm trong WSL2 hoặc không chế độ Windows sandbox gốc nào hoạt động trong môi trường của bạn.

WSL1 được hỗ trợ đến Codex 0.114. Kể từ Codex 0.115, sandbox Linux đã chuyển sang bubblewrap, vì vậy WSL1 không còn được hỗ trợ.

Khởi chạy VS Code từ bên trong WSL

Để xem hướng dẫn từng bước, hãy tham khảo hướng dẫn WSL chính thức của VS Code.

Điều kiện tiên quyết

  • Windows đã cài đặt WSL. Để cài đặt WSL, hãy mở PowerShell với tư cách quản trị viên, rồi chạy wsl --install (Ubuntu là lựa chọn phổ biến).
  • VS Code đã cài đặt tiện ích mở rộng WSL.

Mở VS Code từ terminal WSL

# From your WSL shell
cd ~/code/your-project
code .

Thao tác này mở một cửa sổ WSL từ xa, cài đặt VS Code Server nếu cần và bảo đảm terminal tích hợp chạy trong Linux.

Xác nhận bạn đã kết nối với WSL

  • Tìm thanh trạng thái màu xanh lá hiển thị WSL: <distro>.
  • Terminal tích hợp phải hiển thị đường dẫn Linux (chẳng hạn như /home/...) thay vì C:\.
  • Bạn có thể xác minh bằng:
  echo $WSL_DISTRO_NAME

Lệnh này in tên bản phân phối của bạn.

Nếu bạn không thấy "WSL: ..." trên thanh trạng thái, hãy nhấn Ctrl+Shift+P, chọn WSL: Reopen Folder in WSL và lưu kho mã dưới /home/... (không phải C:\) để đạt hiệu suất tốt nhất.

Nếu ứng dụng Windows hoặc bộ chọn dự án không hiển thị kho mã WSL của bạn, hãy nhập \\wsl$ vào bộ chọn tệp hoặc Explorer, rồi điều hướng đến thư mục chính của bản phân phối.

Sử dụng Codex CLI với WSL

Chạy các lệnh sau từ PowerShell hoặc Windows Terminal với quyền nâng cao:

# Install default Linux distribution (like Ubuntu)
wsl --install

# Start a shell inside Windows Subsystem for Linux
wsl

Sau đó, chạy các lệnh sau từ shell WSL:

# Install and run Codex in WSL
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

Làm việc với mã bên trong WSL

  • Làm việc trong các đường dẫn được gắn kết từ Windows như /mnt/c/... có thể chậm hơn so với làm việc trong đường dẫn gốc của Windows. Hãy lưu kho mã dưới thư mục chính Linux (như ~/code/my-app) để có tốc độ I/O nhanh hơn và ít gặp sự cố về liên kết tượng trưng cũng như quyền hơn:
  mkdir -p ~/code && cd ~/code
  git clone https://github.com/your/repo.git
  cd repo
  • Nếu cần truy cập tệp từ Windows, bạn có thể tìm thấy chúng tại \\wsl$\Ubuntu\home\&lt;user&gt; trong Explorer.

Khắc phục sự cố và câu hỏi thường gặp

Các kho mã lớn có vẻ chậm trong WSL

  • Hãy bảo đảm bạn không làm việc dưới /mnt/c. Di chuyển kho mã sang WSL (ví dụ: ~/code/...).
  • Tăng bộ nhớ và CPU cho WSL nếu cần; cập nhật WSL lên phiên bản mới nhất:
  wsl --update
  wsl --shutdown

VS Code trong WSL không tìm thấy codex

Xác minh tệp nhị phân tồn tại và nằm trên PATH bên trong WSL:

which codex || echo "codex not found"

Nếu không tìm thấy tệp nhị phân, hãy làm theo hướng dẫn thiết lập Codex CLI.