Cách dùng OpenRouter trong Claude Code (và khi nào không nên dùng)

Phương án 1: kết nối Claude Code trực tiếp với OpenRouter

OpenRouter cung cấp một endpoint Messages tương thích với Anthropic bên cạnh API theo kiểu OpenAI. Claude Code chỉ cần URL cơ sở và một khóa, nên cách thiết lập vẫn dùng hai biến như với bất kỳ cổng nào — hãy xem tài liệu OpenRouter để biết đường dẫn cơ sở hiện tại nếu đường dẫn bên dưới đã thay đổi:

export ANTHROPIC_BASE_URL=https://openrouter.ai/api
export ANTHROPIC_AUTH_TOKEN=sk-or-...     # your OpenRouter key
claude --model anthropic/claude-sonnet-5   # OpenRouter's model id format

ID mô hình tuân theo cách đặt tên vendor/model của OpenRouter, và bạn cũng dùng cách đặt tên này trong các biến cho từng cấp mô hình (ANTHROPIC_DEFAULT_SONNET_MODEL và các biến tương tự). Chạy /status để xác nhận endpoint và /model để chuyển đổi. Việc tính phí theo OpenRouter: giá niêm yết của mô hình cộng phí nền tảng OpenRouter trên tín dụng, nên phương án này tốn *nhiều hơn* một chút so với dùng trực tiếp Anthropic — mục đích là sự tiện lợi và dùng chung một tài khoản, không phải tiết kiệm chi phí.

Phương án 2: claude-code-router cho các mô hình không phải Claude

claude-code-router là một proxy cục bộ nhận yêu cầu từ Claude Code và chuyển tiếp từng yêu cầu tới nhà cung cấp bạn chọn theo quy tắc — mặc định, nền, suy luận, ngữ cảnh dài. Cấu hình OpenRouter làm nhà cung cấp bằng khóa của bạn, chọn mô hình cho từng tuyến rồi khởi chạy bằng ccr code. Đây là cách mọi người chạy các mô hình có trọng số mở hoặc mô hình của nhà cung cấp khác bên trong Claude Code.

// ~/.claude-code-router/config.json (excerpt)
{
  "Providers": [{
    "name": "openrouter",
    "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
    "api_key": "sk-or-...",
    "models": ["anthropic/claude-sonnet-5", "google/gemini-2.5-pro", "deepseek/deepseek-chat"]
  }],
  "Router": { "default": "openrouter,anthropic/claude-sonnet-5", "background": "openrouter,deepseek/deepseek-chat" }
}

Những gì gặp lỗi: vòng lặp tác nhân của Claude Code dựa vào định dạng sử dụng công cụ của Anthropic, và bộ định tuyến phải chuyển đổi định dạng đó cho các mô hình theo kiểu OpenAI. Các mô hình mạnh xử lý được; các mô hình nhỏ hơn bỏ qua lệnh gọi công cụ, bịa đường dẫn tệp hoặc phớt lờ giao thức cấp quyền, khiến phiên làm việc sa vào việc thử lại liên tục. Giữ các tuyến *mặc định* và *suy luận* trên một mô hình Claude, đồng thời dùng các tuyến khác cho tác vụ nền, thì đây là một cấu hình tốt.

Chi phí thực tế

• OpenRouter trực tiếp: giá niêm yết của Anthropic + phí của OpenRouter. Tiện lợi, nhưng không bao giờ rẻ hơn Anthropic.
• claude-code-router + OpenRouter: chi phí tùy theo các mô hình được định tuyến tới; khoản tiết kiệm đến từ việc chuyển tác vụ nền sang các mô hình rẻ, không phải vì Claude rẻ hơn.
• Cổng Claude (trang web này): cùng các mô hình Claude, được tính phí theo giá niêm yết bằng tín dụng mua với giá thấp hơn mệnh giá 87% ($13 → $100 giá trị sử dụng), hoặc gói không giới hạn có mức phí cố định từ $1. GPT-6 / GPT-5.x cũng được cung cấp thông qua nhóm Codex.

Nếu bạn chỉ muốn dùng Claude, hãy bỏ qua OpenRouter

Hầu hết những người tìm kiếm "OpenRouter trong Claude Code" muốn một trong hai điều: giảm hóa đơn Claude, hoặc thanh toán mà không cần tài khoản bảng điều khiển Anthropic. OpenRouter giải quyết điều thứ hai và khiến điều thứ nhất tệ hơn. Một cổng giải quyết cả hai — vẫn hai biến đó, không cần proxy:

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude

Và có thể kết hợp cả hai: khai báo cổng này làm nhà cung cấp kiểu Anthropic trong claude-code-router và định tuyến các cấp mô hình Claude tới đó, đồng thời gửi tác vụ nền sang nơi khác. Hướng dẫn về hệ sinh thái trình bày bộ định tuyến chi tiết hơn.

Tất cả các gói không giới hạn →

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.