Hướng dẫn cài đặt

Hướng dẫn cài đặt nhà cung cấp

Xem các bước cài đặt và cách khắc phục sự cố theo công cụ.

Cấu hình Claude Code

Claude Code là công cụ lập trình dòng lệnh của Anthropic dành cho nhà phát triển. Công cụ có thể đọc dự án hiện tại, giải thích mã nguồn, chỉnh sửa tệp tin, chạy lệnh kiểm tra, đồng thời phối hợp với mô hình Claude để xử lý các tác vụ phát triển phức tạp hơn.

Công cụ này là gì và dùng để làm gì

Chỉnh sửa mã nguồnCông cụ dòng lệnhMô hình ClaudeCần thận trọng khi cấp quyền

Nên bắt đầu cấu hình ở đâu

Vị tríPhù hợp với aiMô tả
~/. claude/settings.jsonNgười muốn lưu cấu hình vĩnh viễnGhi các biến môi trường liên quan đến Claude Code vào tệp cấu hình, giúp khắc phục sự cố dễ dàng hơn.
Biến môi trường terminal hiện tạiNgười chỉ muốn thử nghiệm tạm thờiThường sẽ không còn hiệu lực sau khi đóng terminal.
CC SwitchNgười quản lý nhiều CLI cùng lúcTrước tiên cấu hình Provider trên trang CC Switch, sau đó áp dụng cho Claude Code

Cách điền Key và địa chỉ giao diện

Nếu sử dụng Claude chính thức, hãy ưu tiên làm theo quy trình đăng nhập hoặc Key chính thức của Anthropic / Claude Code. Nếu sử dụng provider AI, bạn phải xác nhận rằng provider đó hỗ trợ giao diện Claude / Anthropic, tuyệt đối không nhập địa chỉ tương thích OpenAI thông thường vào Claude Code.

Ví dụ settings.json của Claude Code
{ "env": { "ANTHROPIC_API_KEY": "YOUR_KEY", "ANTHROPIC_BASE_URL": "https://YOUR_PROVIDER_CLAUDE_API_URL", "ANTHROPIC_MODEL": "PROVIDER_SUPPORTED_CLAUDE_MODEL" } }
Cài đặtNguồn lấyLỗi thường gặp
ANTHROPIC_API_KEYKey Claude / Anthropic trong trang quản trị providerKhông dùng tên ghi chú của token làm Key
ANTHROPIC_BASE_URLĐịa chỉ giao diện Claude / Anthropic do provider cung cấpKhông sao chép địa chỉ tương thích OpenAI
ANTHROPIC_MODELTên mô hình Claude trong danh sách mô hình của providerSao chép chính xác chữ hoa chữ thường, dấu gạch nối và số phiên bản

Cách kiểm tra sau khi lưu

Thử nghiệm tối thiểu với Claude Code
claude "Please reply only: Configuration successful"

Nếu hệ thống vẫn đang dùng cấu hình cũ, trước tiên hãy kiểm tra xem có Key cũ hoặc Base URL cũ trong biến môi trường của hệ thống hay không. Thứ tự ưu tiên của biến môi trường có thể khiến các cài đặt bạn vừa thay đổi không có hiệu lực.

Tài liệu chính thức về cài đặt Claude Code Xem phạm vi và phương pháp cấu hình của settings.json.
Biến môi trường của Claude Code Xem hướng dẫn về các biến xác thực, Base URL và mô hình.