Hướng dẫn Cấu hình Môi trường Claude Code & GLM-5.1 (Windows/macOS/Ubuntu)

Hướng dẫn này sẽ đưa bạn qua các bước cài đặt và cấu hình cần thiết để sử dụng Claude Code và GLM-5.1.

Bước 1: Cài đặt Node.js và Git

Trước khi bắt đầu, hãy đảm bảo hệ thống của bạn đã cài đặt Node.js và Git.

Tải xuống và Cài đặt: Truy cập trang web chính thức của Node.js để tải và cài đặt phiên bản Node.js mới nhất (khuyến nghị v18 trở lên). Chọn trình cài đặt phù hợp với hệ điều hành của bạn.
Xác minh Cài đặt: Sau khi cài đặt, mở Terminal hoặc Command Prompt và chạy lệnh sau để kiểm tra:
```
node -v
```
Nếu cài đặt thành công, phiên bản Node.js sẽ được hiển thị.

Windows: Tải và cài đặt Git for Windows. Sử dụng các tùy chọn mặc định và nhấn "Next" để hoàn tất.
macOS: Git thường được cài đặt sẵn. Bạn có thể kiểm tra bằng cách chạy git --version trong Terminal. Nếu chưa có, hệ thống sẽ tự động đề xuất cài đặt "Command Line Developer Tools".
Ubuntu: Chạy lệnh sau trong Terminal để cài đặt:
```
sudo apt update
sudo apt install git
```

Tiếp theo, chúng ta sẽ cài đặt gói Claude Code NPM trên toàn hệ thống. Sự khác biệt chính giữa các hệ điều hành là yêu cầu về quyền quản trị.

Lưu ý: Để có trải nghiệm cài đặt tốt nhất, bạn nên sử dụng kết nối mạng ổn định (ví dụ: sử dụng VPN hoặc proxy) khi chạy lệnh cài đặt.

Chạy lệnh cài đặt sau:

npm install -g @anthropic-ai/claude-code

Mở Terminal.
Vì việc cài đặt gói npm toàn cục yêu cầu quyền hệ thống, bạn cần thêm sudo vào trước lệnh.
Chạy lệnh cài đặt sau (bạn sẽ được yêu cầu nhập mật khẩu đăng nhập máy tính):
```
sudo npm install -g @anthropic-ai/claude-code
```

Sau khi cài đặt, hãy mở một cửa sổ Terminal mới và chạy lệnh sau để xác minh:
```
claude --version
```
Nếu Terminal hiển thị phiên bản, nghĩa là Claude Code đã được cài đặt thành công.
Lúc này, việc chạy claude sẽ báo lỗi vì nó mặc định cố gắng xác thực bằng khóa API chính thức của Anthropic, mà chúng ta chưa cung cấp hoặc cấu hình. Các bước tiếp theo sẽ hướng dẫn bạn sử dụng Khóa API và địa chỉ dịch vụ GLM-5.1 của ZhipuAI.

Truy cập Nền tảng mở Bigmodel ZhipuAI: https://open.bigmodel.cn/.
Lưu ý: Phiên bản GLM-5.1 tại Trung Quốc có thể bị giới hạn, trong khi phiên bản quốc tế Z.ai của ZhipuAI không bị hạn chế.
Sau khi đăng ký, thực hiện theo trình tự: Nhấp vào ảnh đại diện ở góc trên bên phải -> API key -> Thêm API key mới -> Nhập tên để xác định key -> Xác nhận.
Sau khi tạo thành công, nhấp vào biểu tượng sao chép bên cạnh API key và lưu trữ nó để sử dụng sau này.

Để Claude Code có thể kết nối thành công với API GLM-5.1, bạn cần cấu hình bốn biến môi trường quan trọng.

Bạn có thể chọn một trong các phương pháp sau:

Phương pháp 1: Sử dụng Command Prompt
Mở Command Prompt (không cần quyền quản trị) và thực thi hai lệnh sau. Hãy thay thế "YOUR_GLM_API_KEY" bằng API Key bạn vừa sao chép. Bạn có thể chọn loại mô hình là glm-5.1 hoặc glm-5-turbo theo nhu cầu. Cá nhân khuyên dùng glm-5.1 cho hiệu năng cao nhất.
```
setx ANTHROPIC_AUTH_TOKEN "YOUR_GLM_API_KEY"
setx ANTHROPIC_BASE_URL "https://open.bigmodel.cn/api/anthropic"
setx ANTHROPIC_MODEL "glm-5.1"
setx ANTHROPIC_SMALL_FAST_MODEL "glm-5.1"
```
Lưu ý: Lệnh setx thiết lập biến môi trường vĩnh viễn, nhưng chỉ có hiệu lực trên các cửa sổ dòng lệnh mới. Cần đóng và mở lại cửa sổ hiện tại để đọc các biến mới.
Phương pháp 2: Sử dụng bảng Thuộc tính Hệ thống
1. Trong thanh tìm kiếm của Windows, gõ "environment variables" và chọn "Edit the system environment variables".
2. Trong cửa sổ "System Properties", nhấp vào "Environment Variables...".
3. Trong mục "System variables", nhấp vào "New..." và thêm hai biến mới.

Trên macOS và Ubuntu, biến môi trường thường được cấu hình trong tệp cấu hình Shell của bạn.

Xác định loại Shell của bạn:
Chạy lệnh echo $SHELL trong Terminal.
- Nếu kết quả chứa zsh, tệp cấu hình của bạn là ~/.zshrc.
- Nếu kết quả chứa bash, tệp cấu hình của bạn là ~/.bashrc.
Chỉnh sửa tệp cấu hình:
Sử dụng trình soạn thảo văn bản yêu thích của bạn để mở tệp tương ứng. Ví dụ sử dụng nano:
```
# Nếu bạn dùng Zsh (mặc định trên macOS)
nano ~/.zshrc

# Nếu bạn dùng Bash
nano ~/.bashrc
```
Thêm biến môi trường:
Thêm các dòng sau vào cuối tệp. Thay thế "YOUR_GLM_API_KEY" bằng API Key thực tế của bạn.
```
export ANTHROPIC_AUTH_TOKEN="YOUR_GLM_API_KEY"
export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"
export ANTHROPIC_MODEL="glm-5.1"
export ANTHROPIC_SMALL_FAST_MODEL "glm-5.1"
```
Sau khi thêm, nhấn Ctrl + O để lưu và Ctrl + X để thoát trình soạn thảo.
Áp dụng cấu hình:
Chạy lệnh sau để áp dụng cấu hình ngay lập tức (hoặc khởi động lại Terminal):
```
# Nếu bạn đã sửa .zshrc
source ~/.zshrc

# Nếu bạn đã sửa .bashrc
source ~/.bashrc
```

Sau khi hoàn tất mọi cấu hình, bạn có thể khởi động Claude Code.

Mở một cửa sổ Terminal mới trong thư mục làm việc của bạn.
Nhập lệnh claude. Bạn sẽ thấy tùy chọn chọn giao diện. Sử dụng phím mũi tên lên/xuống để di chuyển và Enter để xác nhận.
```
claude
```
Lần đầu khởi chạy: Khi chạy lần đầu, chương trình sẽ yêu cầu bạn chọn phương thức đăng nhập. Chọn "Anthropic Console account". Vì chúng ta đã cài đặt khóa API qua biến môi trường, chương trình sẽ tự động đọc thông tin khóa và bỏ qua quy trình đăng nhập chính thức.
Tiếp theo, bạn sẽ thấy thông báo bảo mật, chỉ cần nhấn Enter.
Chương trình sẽ hỏi bạn có muốn tin cậy thư mục làm việc hiện tại không, chọn "Yes".
Sau khi đăng nhập thành công, bạn sẽ thấy giao diện như mô tả, với API Base URL đã được cấu hình.
Bây giờ bạn có thể sử dụng Claude Code được hỗ trợ bởi ZhipuAI GLM-5.1. Hãy thử yêu cầu nó tự giới thiệu để xác nhận hoạt động.

Đăng vào ngày 4 tháng 8 lúc 02:29