Kiểm tra môi trường

Hoạt động trên Windows, macOS và Linux (điều chỉnh đường dẫn nếu cần).

(1) Node.js

npm list -g --depth=0

• OK: đầu ra hoặc danh sách trống.
• Lỗi: "không tìm thấy lệnh" → cài đặt Node.js LTS (18+), mở lại terminal, thử lại.

node -v
npm -v

(2) Cài đặt CLI

npm i -g @anthropic-ai/claude-code@latest
npm i -g @openai/codex@latest
npm i -g @google/gemini-cli@latest

Chỉ cài đặt những công cụ bạn cần.

(3) Lần chạy đầu tiên (tạo thư mục cấu hình)

Chạy mỗi lệnh một lần để tạo ~/.claude, ~/.codex, và ~/.gemini.

claude

codex

gemini

Thoát bằng Ctrl+C hoặc theo hướng dẫn trên màn hình khi thấy giao diện UI hoặc trình hướng dẫn.

(4) Tiếp theo

Với khóa API:

• Claude Code
• Codex
• Gemini

Vấn đề cài đặt

Vấn đề	Khắc phục
EACCES	Tránh sudo npm -g; sử dụng nvm hoặc sửa lỗi npm prefix
Proxy công ty	Thiết lập HTTPS_PROXY / npm proxy
Phiên bản cũ	npm i -g package@latest