Chuyển đến nội dung chính
Claude Code đọc cấu hình liên quan đến Anthropic. Khi kết nối 4096bytes, không dán địa chỉ tương thích OpenAI vào trường không liên quan và không tự thêm /v1/messages. Hãy dùng cấu hình dành cho Claude Code trong bảng điều khiển.
Nên quản lý Provider Claude Code bằng CC Switch. Cách này giúp chuyển giữa 4096bytes, Claude chính thức và các Provider khác mà không phải sửa biến môi trường nhiều lần.

​
Điều kiện trước

  • Bạn đã hoàn thành Tạo tài khoản.
  • Bạn đã hoàn thành Lấy API Key.
  • Claude Code đã được cài và lệnh claude có thể khởi động.
  • Bạn đã sao chép cấu hình Claude Code từ bảng điều khiển.
Nếu bạn dùng cả gói Claude chính thức và API Key 4096bytes, hãy đặt hai cấu hình trong profile terminal hoặc CC Switch Profile riêng để tránh biến môi trường ghi đè nhau.

​
Cài đặt

Nếu chưa cài Claude Code, hãy xem tài liệu cài đặt Claude Code chính thức. macOS, Linux hoặc WSL: 
curl -fsSL https://claude.ai/install.sh | bash
Windows với WinGet: 
winget install Anthropic.ClaudeCode
Nếu bạn dùng npm để quản lý CLI toàn cục: 
npm install -g @anthropic-ai/claude-code
Sau khi cài, mở lại terminal và kiểm tra: 
claude --version

​
Sao chép cấu hình từ bảng điều khiển

1

Mở API Keys

Mở bảng điều khiển và vào API Keys.
2

Tìm key cần dùng

Nên tạo key riêng cho Claude Code, ví dụ claude-code-work hoặc claude-code-mac.
3

Mở Use key

Trong dòng key đó, nhấn Use key. Nếu bảng điều khiển có lựa chọn ứng dụng khách, chọn Claude Code.
4

Chọn hệ điều hành

Chọn macOS / Linux, Windows PowerShell hoặc Windows CMD, rồi sao chép lệnh bảng điều khiển cung cấp.
Sao chép cấu hình Cấu hình trong bảng điều khiển sẽ tự điền API Key hiện tại. Ví dụ trong tài liệu dùng YOUR_4096BYTES_API_KEY làm placeholder.

​
Biến môi trường tạm thời

Dùng cách này để thử nhanh. Khi đóng terminal, cấu hình sẽ mất hiệu lực.

​
macOS hoặc Linux

export ANTHROPIC_BASE_URL="https://api.4096bytes.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_4096BYTES_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude
Nếu phiên bản Claude Code yêu cầu ANTHROPIC_API_KEY, hãy dùng: 
export ANTHROPIC_BASE_URL="https://api.4096bytes.com"
export ANTHROPIC_API_KEY="YOUR_4096BYTES_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude
Không cấu hình đồng thời ANTHROPIC_AUTH_TOKEN và ANTHROPIC_API_KEY. Ưu tiên tên biến được hiển thị trong hộp thoại Use key.

​
Windows PowerShell

$env:ANTHROPIC_BASE_URL = "https://api.4096bytes.com"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_4096BYTES_API_KEY"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"
claude
Nếu bảng điều khiển dùng ANTHROPIC_API_KEY, thay dòng thứ hai bằng: 
$env:ANTHROPIC_API_KEY = "YOUR_4096BYTES_API_KEY"

​
Windows CMD

set ANTHROPIC_BASE_URL=https://api.4096bytes.com
set ANTHROPIC_AUTH_TOKEN=YOUR_4096BYTES_API_KEY
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude
Nếu bảng điều khiển dùng ANTHROPIC_API_KEY, thay dòng thứ hai bằng: 
set ANTHROPIC_API_KEY=YOUR_4096BYTES_API_KEY

​
Ghi vào cấu hình Claude Code

Nếu muốn dùng lâu dài, hãy ghi biến môi trường vào tệp cấu hình Claude Code. 
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.4096bytes.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_4096BYTES_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}
Đường dẫn thường gặp là ~/.claude/settings.json. Lưu xong hãy khởi động lại Claude Code.
Không đưa API Key vào .env, README, ảnh chụp hoặc tài liệu chia sẻ. Claude Code đọc môi trường của terminal hiện tại, nên cũng cần tránh để lộ key trong log và ảnh chụp.

​
Ghi vào cấu hình shell

Bạn cũng có thể ghi cấu hình vào ~/.zshrc hoặc ~/.bashrc. 
export ANTHROPIC_BASE_URL="https://api.4096bytes.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_4096BYTES_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
Sau đó chạy: 
source ~/.zshrc
Nếu dùng Bash: 
source ~/.bashrc
Rồi chạy: 
claude

​
Chỉ định mô hình

Nếu Claude Code cần chỉ định mô hình rõ ràng, hãy dùng tên mô hình tương ứng với Claude Code hoặc chế độ tương thích Claude trong bảng điều khiển. 
claude --model PASTE_MODEL_NAME_FROM_DASHBOARD
Tên mô hình phải khớp hoàn toàn với bảng điều khiển.

​
Lưu ý

  • Base URL dùng địa chỉ gốc trong bảng điều khiển, ví dụ https://api.4096bytes.com. Không tự thêm /v1/messages.
  • Sau khi đổi Provider, mở lại terminal hoặc xác nhận biến môi trường đã cập nhật.
  • Nếu dùng CC Switch, xác nhận Profile hiện tại đã chuyển sang 4096bytes.
  • Nếu chạy Claude Code trong terminal của VS Code, cần mở lại VS Code sau khi sửa biến môi trường.

​
Xử lý lỗi thường gặp

Vấn đềCách xử lý
Xác thực thất bạiXác nhận API Key đầy đủ và chỉ bật một trong hai biến ANTHROPIC_AUTH_TOKEN hoặc ANTHROPIC_API_KEY.
Sai địa chỉDùng địa chỉ gốc bảng điều khiển hiển thị. Không thêm đường dẫn request đầy đủ.
Vẫn dùng dịch vụ chính thứcMở lại terminal và kiểm tra biến môi trường Claude cũ còn tồn tại không.
Mô hình không khả dụngDùng tên mô hình Claude Code hoặc tương thích Claude được hiển thị trong bảng điều khiển.
Không hiệu lực trong VS CodeĐóng và mở lại VS Code để terminal đọc biến môi trường mới.