Cấu hình Claude Code: cách sử dụng tại Trung Quốc, proxy và địa chỉ API, các biến môi trường thường dùng

Sử dụng tại Trung Quốc: trỏ đến cổng, không cần VPN

# ~/.zshrc / ~/.bashrc / PowerShell 配置文件
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=你的网关密钥
claude

Claude Code đọc hai biến này giống như SDK chính thức; yêu cầu sẽ được gửi đến cổng thay vì api.anthropic.com, nên mạng tại Trung Quốc có thể kết nối trực tiếp. Chỉ nhập tên miền, không thêm /v1. Sau khi thiết lập, mở lại terminal, vào phiên làm việc và dùng /status để xác nhận. Tiện ích VS Code và ứng dụng máy tính đọc môi trường của shell đã khởi chạy chúng; sau khi thay đổi cấu hình, cần thoát hoàn toàn trình soạn thảo rồi khởi chạy lại từ terminal mới.

Khi nào cần proxy

Chỉ cần khi mạng của bạn kết nối không ổn định ngay cả với chính cổng. Cách thiết lập giống các công cụ dòng lệnh khác:

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

Nếu /login đăng nhập OAuth bị hết thời gian chờ ("vượt quá thời gian chờ 15000ms"), phần lớn là do vấn đề proxy hoặc DNS; đăng nhập bằng khóa API có thể bỏ qua hoàn toàn OAuth.

Cấu hình mô hình

export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Claude Code lựa chọn theo cấp (Sonnet / Opus / Haiku); ba biến này xác định mô hình cụ thể tương ứng với từng cấp. Cấp Haiku quan trọng hơn bạn tưởng: Claude Code dùng nó cho các tác vụ nhỏ trong mỗi phiên, nên trỏ đến mô hình giá rẻ có thể tiết kiệm đáng kể. Cổng hiện cung cấp 33 ID mô hình Claude, có thể chọn tất cả trong/model .

Tệp cấu hình nằm ở đâu

• CLAUDE.md(thư mục gốc dự án) — bộ nhớ dự án: lệnh dựng, lệnh kiểm thử, quy ước;CLAUDE.local.md là ghi chú cá nhân, không đưa vào kho mã.
• .claude/settings.json(dự án)/ ~/.claude/settings.json(toàn cục) — quyền, hook, biến môi trường, statusLine.
• .claude/agents/ — định nghĩa tác tử con;.claude/skills/ và ~/.claude/skills/ — kỹ năng.
• .mcp.json — cấu hình máy chủ MCP dùng chung cho dự án.

Khắc phục lỗi cấu hình

• 404 và nhật ký xuất hiện /v1/v1/messages → BASE_URL có thêm phần thừa /v1。
• 401 / khóa không hợp lệ → khóa và địa chỉ không khớp: địa chỉ cổng phải đi cùng khóa của cổng.
• Đã đăng nhập Max nhưng vẫn bị tính phí theo token → môi trường vẫn có ANTHROPIC_API_KEY, khóa được ưu tiên hơn phiên đăng nhập; nếu không muốn dùng thì unset.
• Mô hình không tồn tại → ID đó không nằm trong danh sách /v1/models của điểm cuối hiện tại.
• Vừa khởi động đã thoát sau khi sửa settings.json → lỗi cú pháp JSON (thừa dấu phẩy), hãy kiểm tra bằng công cụ xác thực.

Chi phí

Khi trỏ đến cổng, cách tính phí cũng thay đổi: hạn mức được bán với giá bằng 7.69231 lần mệnh giá, $13 nhận được hạn mức $100; người dùng nhiều có thể chọn gói không giới hạn từ $0.80. Xem chi tiết trên trang giá.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Câu hỏi thường gặp

AI Prime Tech là một cổng API độc lập, không có quan hệ liên kết với Anthropic và không được Anthropic chứng thực hay tài trợ. “Claude” và “Claude Code” là các nhãn hiệu của Anthropic. Các tính năng Claude Code được mô tả ở đây dựa trên tài liệu công khai của Anthropic tại thời điểm viết và thường xuyên thay đổi; giá và danh sách mô hình trên trang này được đọc từ cấu hình hiện hành của cổng API này.