Cấu hình thủ công Claude Code (settings.json)

Bạn muốn tự tay kiểm soát, hoặc CC-Switch không phù hợp với môi trường của bạn? Chỉ cần làm theo các bước dưới đây để tự tạo tệp cấu hình.

Các bước cấu hình

1. Mở thư mục cấu hình Claude Code

Mở terminal, chạy lệnh tương ứng theo hệ điều hành:

Windows (CMD)

start "" "%USERPROFILE%\.claude"

macOS (Terminal)

open "$HOME/.claude"

2. Tạo mới settings.json và ghi cấu hình

Trong thư mục vừa mở, tạo mới một tệp, đặt tên là settings.json, với nội dung như sau (lấy kênh chính chủ CC làm ví dụ):

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "Dán ApiKey của bạn vào đây",
    "ANTHROPIC_BASE_URL": "https://api.nexthub.cc",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

Địa chỉ endpoint

Địa chỉ endpoint của NextHub là https://api.nexthub.cc (không thêm /v1 ở cuối). Claude Code sẽ tự động nối /v1/messages vào phía sau; nếu bạn viết thừa /v1, yêu cầu thực tế sẽ trở thành /v1/v1/messages và gặp lỗi 404 ngay.

Tùy chọn: các biến môi trường nên bổ sung

Ba mục trên là cấu hình tối thiểu cần có để chạy được. Muốn yên tâm hơn thì có thể bổ sung theo nhu cầu (đều là tùy chọn, không điền cũng dùng được):

Biến môi trường	Giá trị khuyên dùng	Tác dụng
CLAUDE_CODE_DISABLE_TERMINAL_TITLE	"1"	Cấm đổi tiêu đề terminal
DISABLE_TELEMETRY	"1"	Tắt gửi dữ liệu telemetry
DISABLE_ERROR_REPORTING	"1"	Tắt báo cáo lỗi tự động
DISABLE_BUG_COMMAND	"1"	Tắt lệnh góp ý bug tích hợp
DISABLE_AUTOUPDATER	"1"	Tắt kiểm tra cập nhật tự động

3. Nhập ApiKey và lưu tệp

Thay thế giá trị của ANTHROPIC_AUTH_TOKEN bằng ApiKey bạn đã tạo tại Quản lý khóa (token), sau đó lưu tệp.

4. Chạy claude để kiểm tra

claude

Cấu hình thành công!

Thấy Claude phản hồi bình thường? Chúc mừng! Claude Code đã kết nối thành công với NextHub. 🎉