Thiết lập Claude Code

Claude Code dùng Anthropic Messages gốc. Base URL NexusAPI là https://nexusapi.link; không thêm /v1.

Yêu cầu hệ thống

macOS 13+, Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+ hoặc Windows 10 phiên bản 1809+;
ít nhất 4 GB bộ nhớ và CPU x64 hoặc ARM64;
mạng có thể kết nối NexusAPI;
khi dùng Git Bash trên Windows, có thể cài Git for Windows.

1. Cài Claude Code

Dùng trình cài chính thức:

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

Có thể dùng winget install Anthropic.ClaudeCode trên Windows hoặc brew install --cask claude-code trên macOS. Kiểm tra cài đặt:

Windows WinGet

winget install Anthropic.ClaudeCode

macOS Homebrew

brew install --cask claude-code

claude --version
claude doctor

2. Tạo NexusAPI Key

Trong Quản lý token → Thêm token, chọn nhóm có chứa model cần dùng cho Claude Code và đặt hạn mức. Đừng chỉ dựa vào tên mô hình; xác nhận ở Chợ mô hình hoặc ma trận khả năng.

Chọn cài đặt key an toàn

Dùng tên dễ nhận biết theo dự án và hạn mức phù hợp. Chỉ bật hạn chế model hoặc IP allowlist khi hiểu rõ ảnh hưởng; đặt ngày hết hạn cho key thử nghiệm ngắn hạn.

3. Tạo cấu hình cấp người dùng

Xác định thư mục cấu hình

Hệ thống	Đường dẫn
macOS / Linux / WSL	`~/.claude/settings.json`
Windows	`%USERPROFILE%\\.claude\\settings.json`

Trên macOS, Linux, WSL hoặc Git Bash:

mkdir -p ~/.claude
touch ~/.claude/settings.json

Trên Windows PowerShell, hãy tạo thư mục trước rồi mở tệp cấu hình:

New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude"
notepad "$env:USERPROFILE\.claude\settings.json"

Đặt biến môi trường

Gộp các giá trị sau vào env hiện có, không ghi đè MCP hoặc quyền khác:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_NEXUSAPI_KEY",
    "ANTHROPIC_BASE_URL": "https://nexusapi.link"
  }
}

Lưu trong thư mục người dùng, không lưu trong kho dự án.

Chỉ tắt các trường thử nghiệm khi lỗi tương thích yêu cầuChỉ khi lỗi nói rõ về context_management hoặc trường thử nghiệm không được hỗ trợ, hãy thêm CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 vào env rồi thử lại. Cài đặt này tắt một số trường preview và không phải cấu hình mặc định cho mọi người dùng.

4. Khởi động và kiểm tra

Mở terminal mới, chuyển vào thư mục dự án rồi chạy:

cd your-project-folder

claude

Dùng /status để xác nhận Anthropic base URL là https://nexusapi.link và nguồn xác thực là ANTHROPIC_AUTH_TOKEN, sau đó gửi một câu hỏi ngắn. Chỉ tin cậy các thư mục dự án bạn nhận biết.

Vấn đề thường gặp

Kiểm tra hai biến, trạng thái key và việc mở lại terminal. Không sửa trực tiếp các tệp trạng thái đăng nhập nội bộ của Claude.

Không thể kết nối dịch vụ Anthropic

Chạy claude doctor, kiểm tra cú pháp JSON của settings.json và hai biến môi trường rồi mở lại terminal. Nếu vẫn lỗi, lưu nguyên văn lỗi, claude --version và đầu ra claude doctor.

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR BAD REQUEST

Không dùng script ghi đè các trường trạng thái nội bộ trong .claude.json. Các trường này có thể đổi theo phiên bản, và ghi đè có thể làm mất trạng thái đăng nhập hoặc cài đặt hiện có.

PowerShell chặn trình cài

Trước hết hãy dùng WinGet hoặc trình cài chính thức từ Windows CMD. Nếu đã xác nhận chỉ chính sách thực thi của người dùng hiện tại gây lỗi, chỉ thay đổi trong phạm vi người dùng đó:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

Không thay đổi chính sách toàn máy chỉ để cài một client.

`fetch failed`

Gửi một câu hỏi ngắn thông thường. Nếu thành công, vấn đề có thể là WebFetch hoặc chức năng mạng độc lập khác.
Nếu mọi cuộc gọi mô hình đều lỗi, chạy claude doctor và kiểm tra Base URL bằng /status.
Kiểm tra DNS, firewall, mạng công ty hoặc proxy đáng tin có chặn nexusapi.link không.
Mở terminal mới và chỉ thử một lần. Nếu lỗi tiếp diễn, lưu phiên bản, đầu ra doctor, lỗi đầy đủ và Request ID rồi làm tự kiểm tra.

Trạng thái `offline`

Một số chức năng phụ kiểm tra dịch vụ riêng. Hãy xác nhận lời gọi gateway thực tế bằng /status và yêu cầu mô hình ngắn trước khi coi NexusAPI đang lỗi.

WebFetch lỗi nhưng chat thường vẫn hoạt động

WebFetch có thể dùng kiểm tra an toàn tên miền và truy cập mạng bên ngoài riêng. Nếu yêu cầu văn bản ngắn hoạt động, giữ nguyên Base URL NexusAPI và xử lý lỗi WebFetch theo quy tắc mạng của Claude Code.

Yêu cầu API thất bại

Đóng phiên hiện tại, mở phiên claude mới và chỉ thử một yêu cầu ngắn. Nếu lỗi lặp lại, lưu Request ID rồi làm tự kiểm tra.

Bắt đầu

Mô hình và thanh toán

Công cụ khách hàng

Khắc phục sự cố

API cho nhà phát triển

Thiết lập Claude Code

Yêu cầu hệ thống

1. Cài Claude Code

Windows WinGet

macOS Homebrew

2. Tạo NexusAPI Key

Chọn cài đặt key an toàn

3. Tạo cấu hình cấp người dùng

Xác định thư mục cấu hình

Đặt biến môi trường

4. Khởi động và kiểm tra

Vấn đề thường gặp

Không thể kết nối dịch vụ Anthropic

PowerShell chặn trình cài

`fetch failed`

Trạng thái `offline`

WebFetch lỗi nhưng chat thường vẫn hoạt động

Yêu cầu API thất bại

Tài liệu chính thức

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

​1. Cài Claude Code

​Windows WinGet

​macOS Homebrew

​2. Tạo NexusAPI Key

​Chọn cài đặt key an toàn

​3. Tạo cấu hình cấp người dùng

​Xác định thư mục cấu hình

​Đặt biến môi trường

​4. Khởi động và kiểm tra

​Vấn đề thường gặp

​Invalid API Key · Please run /login

​Không thể kết nối dịch vụ Anthropic

​PowerShell chặn trình cài

​fetch failed

​Trạng thái offline

​WebFetch lỗi nhưng chat thường vẫn hoạt động

​Yêu cầu API thất bại

​Tài liệu chính thức

Yêu cầu hệ thống

1. Cài Claude Code

Windows WinGet

macOS Homebrew

2. Tạo NexusAPI Key

Chọn cài đặt key an toàn

3. Tạo cấu hình cấp người dùng

Xác định thư mục cấu hình

Đặt biến môi trường

4. Khởi động và kiểm tra

Vấn đề thường gặp

`Invalid API Key · Please run /login`

Không thể kết nối dịch vụ Anthropic

PowerShell chặn trình cài

`fetch failed`

Trạng thái `offline`

WebFetch lỗi nhưng chat thường vẫn hoạt động

Yêu cầu API thất bại

Tài liệu chính thức