Khi sử dụng Claude Code, điều quan trọng là phải hiểu cách các phương thức xác thực được ưu tiên để tránh chi phí API không mong muốn và đảm bảo rằng bạn đang sử dụng tài khoản mà bạn dự định.
Cách xác thực hoạt động
-
Claude Code ưu tiên các khóa API biến môi trường hơn các đăng ký đã xác thực.
-
Đây là hành vi có chủ ý được thiết kế để cho bạn sự linh hoạt trong việc chọn phương thức xác thực của mình.
-
Khi một khóa API được đặt làm biến môi trường, bạn sẽ bị tính phí theo mức giá sử dụng theo giao dịch của API bằng tài khoản API liên kết với khóa đó.
-
Điều này xảy ra ngay cả khi bạn đã đăng nhập vào Claude Code với gói đăng ký claude.ai hoặc một tài khoản Console khác.
Thực hành tốt nhất
Để sử dụng Claude Code với gói đăng ký Claude của bạn:Giữ biến môi trường ANTHROPIC_API_KEY không được đặt.
-
Điều này ngăn chặn các khoản phí API bất ngờ và đảm bảo bạn đang sử dụng lượng sử dụng được bao gồm trong gói đăng ký của mình.
-
Nếu bạn cần sử dụng một khóa API cụ thể thỉnh thoảng, hãy chỉ đặt nó tạm thời khi cần.
-
Chạy /status trong Claude Code định kỳ để xác minh phương thức xác thực hiện tại của bạn.
Cảnh báo xung đột xác thực
Claude Code sẽ thông báo cho bạn khi có xung đột giữa đăng ký đã xác thực của bạn và khóa API biến môi trường:
-
Trong quá trình thiết lập ban đầu, nếu phát hiện một khóa API trong các biến môi trường của bạn, Claude Code sẽ yêu cầu bạn xác nhận phương thức xác thực mà bạn muốn sử dụng.
-
Sau khi đăng nhập thành công, bạn sẽ thấy một thông báo nếu cả hai thông tin đăng nhập đều hoạt động, cảnh báo bạn về khả năng phát sinh phí API không mong muốn.
Kiểm tra cấu hình hiện tại của bạn
Để xác minh xem khóa API có được đặt dưới dạng biến môi trường hay không, hãy chạy /status trong Claude Code. Điều này sẽ hiển thị cho bạn phương thức xác thực nào đang hoạt động.
Để kiểm tra biến môi trường của bạn trực tiếp, hãy chạy một trong các lệnh này trong terminal (bên ngoài Claude Code):
macOS/Linux:
echo $ANTHROPIC_API_KEY
CMD của Windows:
echo %ANTHROPIC_API_KEY%
Windows PowerShell:
echo $env:ANTHROPIC_API_KEY
Thiết lập khóa API tạm thời
Nếu bạn cần sử dụng khóa API chỉ cho phiên làm việc của terminal hiện tại:
macOS/Linux:
xuất ANTHROPIC_API_KEY='api-key-của-bạn-ở-đây'
CMD của Windows:
set ANTHROPIC_API_KEY=your-api-key-here
Windows PowerShell:
$env:ANTHROPIC_API_KEY="your-api-key-here"
Đặt biến môi trường khóa API một cách vĩnh viễn
macOS/Linux:
Đối với zsh (mặc định trên macOS):
bash
# Thêm vào tệp cấu hình shell
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
# Áp dụng các thay đổi
nguồn ~/.zshrc
Đối với bash:
bash
# Thêm vào tệp cấu hình shell
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.bash_profile
# Áp dụng các thay đổi
nguồn ~/.bash_profile
Windows:
-
Mở Thuộc tính Hệ thống → Nâng cao → Biến Môi trường
-
Dưới mục “Biến người dùng”, nhấp vào “Mới”
-
Tên biến: ANTHROPIC_API_KEY
-
Giá trị biến: your-api-key-here
-
Nhấn OK và khởi động lại terminal của bạn
Xóa một biến môi trường khóa API
macOS/Linux (tạm thời):
hủy ANTHROPIC_API_KEY
macOS (vĩnh viễn):
# Xóa khỏi tệp cấu hình
sed -i '' '/ANTHROPIC_API_KEY/d' ~/.zshrc
source ~/.zshrc
Linux (vĩnh viễn)
sed -i '/ANTHROPIC_API_KEY/d' ~/.zshrc
CMD của Windows:
đặt ANTHROPIC_API_KEY=
Windows PowerShell:
Remove-Item Env:ANTHROPIC_API_KEY
Windows (vĩnh viễn): Xóa biến khỏi cài đặt Biến Môi trường Hệ thống.
Những vấn đề phổ biến cần tránh
-
Đặt biến môi trường trong các tệp cấu hình shell và quên chúng đi.
-
Không khởi động lại terminal của bạn sau khi thay đổi các biến môi trường.
-
Giả sử bạn đang sử dụng đăng ký của mình khi một khóa API được cấu hình trong môi trường của bạn.
Nếu bạn có bất kỳ câu hỏi nào, xin vui lòngliên hệ đội ngũ Hỗ trợ của chúng tôi.
Hỗ trợ tư vấn, đào tạo và chuyển giao giải pháp AI cho cá nhân, doanh nghiệp và tổ chức.
Liên hệ qua Zalo
