Cách Sử Dụng Claude Code với OpenRouter

Nếu bạn yêu thích quy trình làm việc mượt mà của Claude Code (công cụ CLI từ Anthropic), thì bạn có thể đã biết rằng theo mặc định, nó mong đợi định dạng API của Anthropic. Nhưng nếu bạn muốn sử dụng một mô hình khác, hoặc khám phá các mô hình mới không có sẵn thông qua API trực tiếp của Anthropic thì sao? Và đó là lúc OpenRouter phát huy tác dụng! Nó cung cấp quyền truy cập API thống nhất, tương thích với OpenAI cho hàng trăm mô hình từ nhiều nhà cung cấp khác nhau.

Bằng cách kết nối hai hệ thống này, bạn có thể tận dụng những gì tốt nhất của cả hai thế giới: giao diện thân thiện với nhà phát triển của Claude Code và danh mục mô hình phong phú của OpenRouter. Sự tích hợp này chính là điều chúng tôi đang đề cập đến là “Claude Code với Openrouter.”

Mấu chốt là sử dụng một "router / proxy" dịch giữa hai định dạng API. Sau khi bạn đã thiết lập, bạn có thể chạy Claude Code như bình thường, nhưng với OpenRouter hỗ trợ phần backend.

💡

Bạn muốn một công cụ kiểm thử API tuyệt vời tạo ra Tài liệu API đẹp mắt?

Bạn muốn một nền tảng tích hợp, tất cả trong một để Đội ngũ Nhà phát triển của bạn làm việc cùng nhau với năng suất tối đa?

Apidog đáp ứng mọi yêu cầu của bạn và thay thế Postman với mức giá phải chăng hơn nhiều!

nút

Ưu điểm chính khi sử dụng Claude Code với Openrouter

Việc kết hợp Claude Code và Openrouter mang lại một loạt các lợi ích mạnh mẽ:

Truy cập hơn 400 mô hình — bao gồm các biến thể của Claude, các mô hình kiểu GPT, LLM mã nguồn mở, và nhiều hơn nữa.
Không cần đăng ký Anthropic — bạn chỉ trả tiền cho những gì bạn sử dụng thông qua mô hình giá trả theo mức sử dụng của Openrouter.
Chuyển đổi mô hình linh hoạt — thay đổi mô hình trong phiên làm việc của Claude Code bằng /model, hoặc định tuyến dựa trên loại nhiệm vụ (nhẹ nhàng so với suy luận, chi phí so với hiệu suất).
Tối ưu hóa chi phí — các mô hình chi phí thấp hoặc miễn phí cho các tác vụ thông thường, các mô hình mạnh mẽ chỉ khi cần: lý tưởng cho các nhà phát triển có ngân sách hạn hạn.
Định tuyến cục bộ hoặc dựa trên đám mây — chạy mọi thứ cục bộ để bảo mật, hoặc lưu trữ bộ định tuyến của bạn để sử dụng chung trong nhóm, CI/CD, hoặc tự động hóa đám mây.
Công cụ & tính linh hoạt — một số bộ định tuyến hỗ trợ các tính năng nâng cao như truyền trực tuyến, dự phòng mô hình, đa kênh nhà cung cấp, và tích hợp với các quy trình làm việc phát triển rộng hơn.

Nhấp để xem thêm về Claude Code

Điều kiện tiên quyết

Trước khi bắt đầu, hãy đảm bảo bạn có:

1. Claude Code được cài đặt toàn cục (ví dụ thông qua npm install -g @anthropic-ai/claude-code).

2. Một tài khoản Openrouter với khóa API hợp lệ (sk-or-...) (Tạo tài khoản tại OpenRouter).

3. Một công cụ router/proxy (Docker là dễ nhất, nhưng các router dựa trên Node.js cũng hoạt động) để xử lý việc chuyển đổi định dạng

4. Thoải mái cơ bản khi sử dụng biến môi trường và dòng lệnh

Với thiết lập này, bạn sẽ có thể trỏ Claude Code đến router — router này sau đó sẽ chuyển tiếp các yêu cầu đến Openrouter và định tuyến các phản hồi trở lại.

Phương pháp 1: y-router (Đơn giản nhất và được khuyến nghị)

Một trong những router được sử dụng rộng rãi nhất cho thiết lập này là y-router. Nó hoạt động như một bộ dịch giữa định dạng API mong đợi của Anthropic và API kiểu OpenAI của Openrouter (xem kho lưu trữ tại: GitHub). Dưới đây là cách thực hiện từng bước với y-router:

1. Triển khai y-router cục bộ (khuyến nghị Docker):

git clone https://github.com/luohy15/y-router.git
cd y-router
docker compose up -d

Điều này sẽ khởi động một dịch vụ router cục bộ lắng nghe (theo mặc định) trên http://localhost:8787.

2. Cấu hình biến môi trường của bạn để Claude Code gửi yêu cầu của nó đến y-router, không phải trực tiếp đến Anthropic:

export ANTHROPIC_BASE_URL="http://localhost:8787"
export ANTHROPIC_AUTH_TOKEN="sk-or-<your-openrouter-key>"
export ANTHROPIC_MODEL="z-ai/glm-4.5-air"   # for a fast, lightweight model
# or export ANTHROPIC_MODEL="z-ai/glm-4.5"   # for a more powerful model

3. Chạy Claude Code:

claude

Giao diện sẽ khởi động như thường lệ. Nếu bạn gõ /model, bạn sẽ thấy mô hình được Openrouter hỗ trợ được chọn. Chúc mừng — bạn hiện đang sử dụng Claude Code với Openrouter. (ishan.rs)

Phương pháp này giữ cho việc định tuyến cục bộ, đơn giản và nằm trong tầm kiểm soát của bạn — lý tưởng cho các nhà phát triển thích sự riêng tư và chi phí tối thiểu.

Phương pháp 2: Claude Code Router (dựa trên npm, giàu tính năng)

Nếu bạn không muốn sử dụng Docker, có một lựa chọn mạnh mẽ khác: Claude Code Router — một công cụ router dựa trên Node.js được thiết kế để cấp quyền truy cập cho Claude Code đến các nhà cung cấp bên ngoài (xem kho lưu trữ tại GitHub). Dưới đây là cách thiết lập:

1. Cài đặt toàn cục:

npm install -g @musistudio/claude-code-router

Sau đó tạo một tệp cấu hình (ví dụ: ~/.claude-code-router/config.json) với các cài đặt và mô hình ưu tiên của bạn. Nhiều người dùng đưa Openrouter vào làm nhà cung cấp, chỉ định khóa API của họ và liệt kê các mô hình được hỗ trợ (chi tiết hơn về phương pháp này tại lgallardo.com).

2. Khởi động router:

ccr start

Sau khi chạy, hãy đặt ANTHROPIC_BASE_URL thành URL của router và sử dụng claude như thường lệ. Router sẽ dịch các yêu cầu và cho phép chuyển đổi động giữa các mô hình — bao gồm hành vi dự phòng, quy tắc định tuyến, và nhiều hơn nữa.

Phương pháp này mạnh mẽ nếu bạn muốn kiểm soát nhiều hơn đối với việc định tuyến mô hình, các chính sách dự phòng hoặc tích hợp vào các chuỗi công cụ lớn hơn (như CI/CD, tập lệnh tự động, hoặc các thử nghiệm đa mô hình).

Giao diện người dùng bộ định tuyến mã Claude của Musi Studio

Phương pháp 3: Proxy Openrouter trực tiếp (Thiết lập tối thiểu để kiểm thử nhanh)

Nếu bạn chỉ muốn kiểm tra hoặc thử nghiệm nhanh — mà không cần chạy một router đầy đủ — bạn có thể thử trỏ Claude Code trực tiếp đến một proxy hoặc bộ điều hợp tối thiểu tương thích với Openrouter. Một số giải pháp cộng đồng tồn tại để làm điều này dễ dàng hơn (xem kho lưu trữ của họ tại GitHub).

Ví dụ, bạn có thể đặt:

export ANTHROPIC_BASE_URL="https://proxy-your-choice.com"
export ANTHROPIC_AUTH_TOKEN="sk-or-<your-key>"
export ANTHROPIC_MODEL="openrouter/model-name"

Sau đó chạy Claude Code. Cách tiếp cận này hữu ích cho các thử nghiệm ngắn hạn hoặc các thử nghiệm nhanh. Tuy nhiên, nó có thể thiếu tính mạnh mẽ (ví dụ: đối với truyền trực tuyến, gọi công cụ hoặc các phiên dài hạn), tùy thuộc vào cách triển khai proxy.

Giao diện người dùng chuyển đổi mô hình Openrouter

Các phương pháp hay nhất & Mẹo để có trải nghiệm mượt mà

Kiểm tra khả năng tương thích của mô hình — không phải tất cả các mô hình đều hỗ trợ các tính năng nâng cao như gọi công cụ hoặc cửa sổ ngữ cảnh dài. Sử dụng các mô hình nhẹ hơn cho các tác vụ đơn giản, các mô hình có khả năng hơn cho các tác vụ nặng như suy luận hoặc viết mã.
Bảo mật khóa API của bạn — hãy coi khóa API Openrouter của bạn như một bí mật; lưu trữ nó một cách an toàn và không bao giờ để lộ nó ở phía client.
Quản lý chi phí — theo dõi việc sử dụng token khi sử dụng các mô hình lớn; xem xét bộ nhớ đệm lời nhắc, các mô hình dự phòng hoặc định tuyến dựa trên nhiệm vụ để tối ưu hóa cân bằng chi phí/hiệu suất.
Kiểm tra thiết lập định tuyến — sau khi cấu hình, luôn kiểm tra bằng các lệnh đơn giản (ví dụ: claude --model <model>) để đảm bảo mọi thứ được định tuyến chính xác.
Sử dụng định tuyến dự phòng để đảm bảo độ tin cậy — trong các thiết lập đa mô hình, cấu hình các tùy chọn dự phòng để nếu một mô hình không khả dụng, router có thể tự động chuyển sang mô hình khác.

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

Q1. Tôi có cần trả tiền cho Anthropic để sử dụng Claude Code với Openrouter không?
Không. Khi được cấu hình với Openrouter (thông qua router hoặc proxy), Claude Code sẽ sử dụng khóa API Openrouter của bạn cho các yêu cầu — bạn không cần đăng ký trả phí Anthropic.

Q2. Tôi có thể chuyển đổi mô hình ngay lập tức trong cùng một phiên Claude Code không?
Có. Nhiều router (và bản thân Claude Code) cho phép bạn chuyển đổi mô hình bằng cách sử dụng /model <model_name>. Điều này hoạt động trong giữa cuộc trò chuyện trong hầu hết các trường hợp.

Q3. Tất cả các mô hình trong Openrouter có tương thích với các tính năng của Claude Code (như thực thi công cụ, truyền trực tuyến) không?
Không phải lúc nào cũng vậy. Một số mô hình “chỉ văn bản” hoặc nhẹ hơn có thể không hỗ trợ gọi công cụ, ngữ cảnh dài hoặc truyền trực tuyến. Đối với các quy trình làm việc phức tạp, hãy sử dụng các mô hình được biết là hỗ trợ các tính năng đó.

Q4. Router Docker cục bộ có an toàn hơn router được lưu trữ không?
Thường thì có. Chạy một router cục bộ giúp bạn kiểm soát hoàn toàn và tránh làm lộ khóa API của bạn cho các dịch vụ bên ngoài. Các router được lưu trữ tiện lợi nhưng có thể có những đánh đổi về bảo mật hoặc độ tin cậy.

Q5. Tôi có thể tích hợp thiết lập này vào CI/CD hoặc quy trình làm việc tự động không?
Hoàn toàn có thể. Các công cụ như Claude Code Router hỗ trợ các tệp cấu hình và biến môi trường, điều này giúp chúng dễ dàng tích hợp vào các đường ống tự động hóa (GitHub Actions, tập lệnh, v.v.).

Kết luận

Sử dụng Claude Code với Openrouter là một cách thanh lịch, mạnh mẽ để giải phóng bản thân khỏi các khóa nhà cung cấp duy nhất trong khi vẫn giữ một giao diện nhà phát triển quen thuộc, tinh gọn. Cho dù bạn chọn chạy một router cục bộ thông qua Docker, sử dụng một router dựa trên Node.js, hay kiểm thử thông qua một proxy tối thiểu — bạn đang mở cánh cửa đến một danh mục mô hình khổng lồ, các tùy chọn chi phí linh hoạt và quy trình làm việc được tùy chỉnh.

Đối với các nhà phát triển, các dự án phụ hoặc các nhóm muốn tối ưu hóa mã hóa được hỗ trợ bởi AI mà không tốn nhiều chi phí, thiết lập này mang lại sự cân bằng hấp dẫn giữa kiểm soát, tính linh hoạt và khả năng mở rộng. Chỉ với một vài bước cấu hình, bạn có thể mở rộng đáng kể những gì trợ lý AI của mình có thể làm — sau đó chuyển đổi hoặc mở rộng khi nhu cầu của bạn phát triển.

Hãy thử xem: phiên viết mã tiếp theo của bạn có thể sớm được hỗ trợ bởi một mô hình mà bạn chưa từng nghĩ là có thể — tất cả đều nằm trong giao diện Claude Code quen thuộc.

💡

nút