Cấu hình môi trường Claude Code trên Windows

Hướng dẫn chi tiết cách cấu hình môi trường phát triển Claude Code trên hệ thống Windows, bao gồm cài đặt Node.js, cấu hình biến môi trường, v.v.

Yêu cầu hệ thống Windows

  • Windows 10 hoặc phiên bản cao hơn
  • Quyền quản trị viên (để cài đặt phần mềm)
  • Ít nhất 2GB dung lượng đĩa trống

Cài đặt Node.js

Phương pháp 1: Gói cài đặt chính thức (Khuyên dùng)

Bước 1: Tải Node.js

Truy cập trang web chính thức Node.js để tải gói cài đặt Windows phiên bản LTS (tệp .msi)

Bước 2: Chạy chương trình cài đặt

  1. Nhấp đúp vào tệp .msi đã tải
  2. Nhấp "Next" để tiếp tục cài đặt
  3. Chấp nhận thỏa thuận cấp phép
  4. Chọn đường dẫn cài đặt (khuyến nghị sử dụng đường dẫn mặc định)
  5. Đảm bảo chọn tùy chọn "Add to PATH"
  6. Nhấp "Install" để bắt đầu cài đặt

Bước 3: Xác minh cài đặt

Mở Command Prompt (cmd) hoặc PowerShell, chạy:

cmd
node --version
npm --version

Phương pháp 2: Sử dụng Chocolatey

PowerShell (管理员)
# Cài đặt Chocolatey (nếu chưa cài đặt)
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

# Cài đặt Node.js
choco install nodejs

Phương pháp 3: Sử dụng Winget

cmd
winget install OpenJS.NodeJS

Cấu hình biến môi trường

Cấu hình tạm thời (Có hiệu lực trong phiên hiện tại)

set ANTHROPIC_BASE_URL=https://i7dc.com/api
set ANTHROPIC_AUTH_TOKEN=你的key
cd your-project-folder
claude

Cấu hình vĩnh viễn (Khuyên dùng)

Phương pháp 1: Cấu hình qua thuộc tính hệ thống

  1. Nhấp chuột phải vào "This PC" → "Properties"
  2. Nhấp "Advanced system settings"
  3. Trong cửa sổ "System Properties", nhấp "Environment Variables"
  4. Trong "User variables" hoặc "System variables", nhấp "New"
  5. Thêm các biến sau:
    • Tên biến: ANTHROPIC_BASE_URL, Giá trị biến: https://i7dc.com/api
    • Tên biến: ANTHROPIC_AUTH_TOKEN, Giá trị biến: 你的key
  6. Nhấp "OK" để lưu

Phương pháp 2: Sử dụng PowerShell để cấu hình

PowerShell (管理员)
# Đặt biến môi trường cho người dùng hiện tại
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://i7dc.com/api", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的key", "User")

# Xác minh cài đặt
[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")
[Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User")

Cấu hình Windows Terminal (Khuyên dùng)

Để có trải nghiệm tốt hơn, khuyến nghị cài đặt Windows Terminal:

PowerShell
# Cài đặt qua Microsoft Store
winget install Microsoft.WindowsTerminal

# Hoặc cài đặt qua trình quản lý gói
choco install microsoft-windows-terminal

Cấu hình Windows Terminal Startup Profile

  1. Mở Windows Terminal
  2. Nhấn Ctrl + , để mở cài đặt
  3. Chọn "Profiles" → "Add new profile" trong menu bên trái
  4. Cấu hình như sau:
    • Tên: Claude Code
    • Dòng lệnh: powershell.exe
    • Thư mục khởi động: 你的项目目录
    • Thêm biến môi trường trong cài đặt nâng cao

Giải quyết các vấn đề thường gặp

Vấn đề 1: Lệnh node không được nhận dạng

Giải pháp:

cmd
# Kiểm tra biến môi trường PATH
echo %PATH%

# Thêm Node.js vào PATH thủ công (tạm thời)
set PATH=%PATH%;C:\Program Files\nodejs

Vấn đề 2: Tốc độ cài đặt npm chậm

Giải pháp:

cmd
# Sử dụng nguồn mirror trong nước
npm config set registry https://registry.npmmirror.com

Vấn đề 3: Giới hạn chính sách thực thi PowerShell

Giải pháp:

PowerShell (管理员)
# Tạm thời cho phép thực thi script
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# Cài đặt vĩnh viễn (cần quyền quản trị viên)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine

Vấn đề 4: Tường lửa chặn kết nối

Giải pháp:

  1. Mở cài đặt Windows Firewall
  2. Nhấp "Allow an app or feature through Windows Firewall"
  3. Tìm Node.js và chọn cả mạng "Private" và "Public"

Xác minh cấu hình

Sau khi hoàn tất cấu hình, khởi động lại Command Prompt hoặc PowerShell, chạy các lệnh sau để xác minh:

cmd
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%
claude --version

Nếu xuất ra giá trị biến môi trường và thông tin phiên bản chính xác, cấu hình thành công!

Bước tiếp theo

Sau khi hoàn tất cấu hình môi trường, bạn có thể:

  1. Chạy claude trong bất kỳ thư mục dự án nào để bắt đầu sử dụng
  2. Chọn chủ đề yêu thích của bạn
  3. Xác nhận lưu ý bảo mật và tin tưởng thư mục làm việc
  4. Bắt đầu cộng tác với đối tác lập trình AI!🚀
Cùng AI mang đến vô hạn đổi mới, vô tận cơ hội
Giới thiệu
Tính năng
Tài liệu sử dụng
Gói giá
Liên hệ
Điều khoản và chính sách
Điều khoản sử dụng
Chính sách quyền riêng tư
Luật Giao dịch Thương mại Đặc định