Hướng dẫn Claude Code Series 6: Cách xác thực - Đăng nhập qua trình duyệt và cấu hình thủ công API Key

Quy trình xác thực: Đăng nhập qua trình duyệt và cấu hình thủ công API Key

Sau khi cài đặt Claude Code, bạn cần phải xác thực để sử dụng. Bạn cần liên kết công cụ với tài khoản Anthropic của mình. Có hai cách liên kết: Đăng nhập qua trình duyệt và Cấu hình thủ công API Key. Cả hai cách đều cho kết quả giống nhau, hãy chọn cách thuận tiện cho bạn.

Cách 1: Đăng nhập qua trình duyệt (Khuyến nghị)

Claude Code cung cấp lệnh xác thực tự động claude login, nó sẽ mở trình duyệt, cho phép bạn ủy quyền trên trang web, sau đó tự động ghi lại thông tin xác thực vào terminal.

Các bước thực hiện:

Trong terminal, nhập:

bash claude login

Hệ thống sẽ xuất ra một dòng hướng dẫn và tự động mở trang ủy quyền của Anthropic trong trình duyệt mặc định của bạn.
Nếu không tự động mở, terminal sẽ in ra một đường dẫn, bạn có thể sao chép và mở bằng trình duyệt.
Đăng nhập vào tài khoản Anthropic của bạn trong trình duyệt (nếu đã đăng nhập, trang này sẽ yêu cầu ủy quyền trực tiếp).
Nhấp vào "Cho phép" hoặc "Ủy quyền", trang trình duyệt sẽ hiển thị "Ủy quyền thành công, có thể đóng trang này".
Quay lại terminal, bạn sẽ thấy thông báo xác thực hoàn tất. Lúc này, chạy lệnh claude đã được liên kết với tài khoản của bạn.

Cách 2: Cấu hình thủ công API Key

Nếu bạn sử dụng máy chủ không có giao diện đồ họa, container, hoặc không muốn xác thực qua trình duyệt, bạn có thể lấy API Key từ bảng điều khiển Anthropic và cấu hình vào Claude Code.

Các bước:

Mở trình duyệt, truy cập https://console.anthropic.com, đăng nhập vào tài khoản Anthropic của bạn.
Vào trang API Keys (thường nằm trong Cài đặt hoặc Tùy chọn nhà phát triển), nhấp vào "Tạo API Key".
Đặt tên cho Key (ví dụ: claude-code-local), sau khi tạo sao chép ngay lập tức.
Lưu ý: Key này chỉ hiển thị một lần, nếu đóng trang sẽ không thấy lại. Nếu quên lưu, hãy xóa key cũ và tạo lại.
Quay lại terminal, có hai cách để cung cấp Key cho Claude Code:

A. Sử dụng biến môi trường:

bash export ANTHROPIC_API_KEY=api-key-của-bạn

Thêm dòng này vào tệp ~/.bashrc hoặc ~/.zshrc để tự động có hiệu lực mỗi lần.

B. Ghi cấu hình vào tệp:

Claude Code cũng đọc tệp cấu hình riêng. Chỉnh sửa thủ công ~/.claude/config.json (nếu không có thì tạo mới), ghi:

json { "apiKey": "api-key-của-bạn" }

Lưu ý: Nên đặt quyền tệp này là 600 (chmod 600 ~/.claude/config.json) để ngăn người dùng khác đọc.

Kiểm tra kết nối:

bash claude "Xin chào, hãy trả lời 'OK'"

Nếu nhận được phản hồi bình thường, nghĩa là Key đã được cấu hình đúng.

Những sai sót thường gặp khi cấu hình thủ công:

Key có bắt đầu bằng sk-ant- hay sk- không? Không, API Key của Anthropic thực sự bắt đầu bằng sk-ant-api03- và là chuỗi dài. Khi sao chép, đừng thiếu ký tự.
Nếu bạn đã đặt cả biến môi trường và tệp cấu hình, biến môi trường có độ ưu tiên cao hơn. Chỉ giữ một cách để tránh nhầm lẫn.
Key là thông tin thanh toán, không được đưa vào kho Git. Khuyến nghị sử dụng .gitignore để bỏ qua toàn bộ thư mục ~/.claude hoặc tệp cấu hình.

Chuyển đổi tài khoản hoặc đăng xuất

Muốn đổi tài khoản khác hoặc xóa thông tin xác thực cục bộ:

Nếu sử dụng claude login: thực hiện claude logout, sau đó chạy lại claude login.
Nếu cấu hình thủ công Key: xóa biến môi trường hoặc key cũ trong tệp cấu hình, thay bằng key mới.

Kiểm tra xác thực có hoạt động không

claude "Giải thích thư mục hiện tại dùng để làm gì"

Nếu nó đọc được tổng quan dự án của bạn, nghĩa là môi trường đã sẵn sàng.