Source: https://aiprimetech.io/vi/learn/use-claude-api-with-factory-droid/

[Trang chủ](/vi/) / [Tìm hiểu](/vi/learn/) / Chạy Factory Droid với Claude 

# Chạy Factory Droid với Claude 

Droid của Factory là một CLI dạng tác nhân cùng loại với Claude Code, cho phép bạn dùng mô hình riêng thông qua tệp cấu hình. Khi trỏ đến cổng kết nối AI Prime Tech, các vòng lặp tác nhân của Droid chạy trên Claude, bên cạnh mọi mô hình khác mà cổng kết nối cung cấp. 

## Chỉnh sửa tệp cài đặt 

Droid đọc ~/.factory/settings.json. Thêm một mảng customModels, trong đó mỗi mục mô tả một mô hình bạn muốn sử dụng. Đây là đường dẫn cấu hình hiện hành; config.json cũ là cấu hình kế thừa và không hỗ trợ đầy đủ những gì settings.json hỗ trợ. 

Một tệp bao quát toàn bộ thiết lập Droid của bạn, nên một danh sách customModels duy nhất xác định tất cả các mô hình mà CLI có thể chuyển đổi qua lại. Hãy lưu cấu hình ở cấp người dùng thay vì theo từng dự án. 

Biết rằng settings.json là tệp hiện hành giúp tránh nhiều nhầm lẫn, vì các ghi chú và chủ đề thảo luận cũ vẫn nhắc đến config.json, còn một số tính năng hoạt động khác nhau giữa hai tệp. Khi một tính năng hoạt động ở nơi này nhưng không hoạt động ở nơi kia, settings.json gần như luôn là tệp nên tin cậy. Khi các hướng dẫn mâu thuẫn, ưu tiên settings.json thay cho config.json sẽ giải quyết phần lớn vấn đề. Tệp mới hơn là tệp được Factory hỗ trợ tích cực, và đó là nơi cú pháp biến thực sự hoạt động. 

## Mô tả mô hình 

Mỗi mục customModels nhận một ID mô hình, một baseUrl, một apiKey, một provider và maxOutputTokens. Đặt model thành ID trên cổng kết nối, chẳng hạn claude-sonnet-4-5, và baseUrl thành địa chỉ máy chủ của cổng kết nối. 

Các trường này kết hợp với nhau để cho Droid biết chính xác cách truy cập mô hình. Vì Droid không mặc định dùng một nhà cung cấp duy nhất, bạn cần chỉ định rõ từng thành phần; nhờ đó, Droid đủ linh hoạt để kết nối đến một cổng kết nối. 

Việc chỉ định rõ như vậy cho phép một bản cài đặt Droid cung cấp quyền truy cập vào nhiều mô hình Claude trên cùng một cổng kết nối, mỗi mô hình là một mục customModels riêng dùng chung baseUrl và khóa. CLI coi chúng là các mô hình riêng biệt có thể lựa chọn, dù tất cả đều trỏ đến cùng một điểm cuối phía thượng nguồn. Chính các trường được chỉ định rõ cho phép một bản cài đặt truy cập nhiều mô hình Claude qua một điểm cuối. Mỗi mục dùng chung baseUrl và khóa nhưng giữ ID mô hình riêng, nên cổng kết nối thực hiện định tuyến còn Droid chỉ cần chọn tên. 

## Chọn chế độ nhà cung cấp 

Trường provider thiết lập định dạng truyền dữ liệu. Dùng anthropic cho giao diện Messages gốc của cổng kết nối, openai cho kiểu Responses, hoặc generic-chat-completion-api cho điểm cuối chat /v1 theo kiểu OpenAI. Với Claude trên cổng kết nối, anthropic là lựa chọn phù hợp tự nhiên. 

Đặt provider khớp với giao diện thực tế của cổng kết nối giúp tránh lỗi khi chạy lần đầu. Với provider anthropic, Droid sử dụng định dạng gốc mà cổng kết nối cung cấp cho Claude. 

Ba chế độ nhà cung cấp cũng tương ứng rõ ràng với các giao diện mà một cổng kết nối đa mô hình có thể cung cấp, nên nếu cùng cổng kết nối đó cung cấp một mô hình theo kiểu OpenAI, bạn sẽ thêm mô hình ấy dưới dạng một mục riêng với generic-chat-completion-api. Giữ provider của từng mục khớp với giao diện tương ứng là nguyên tắc giúp cấu hình hỗn hợp không gặp lỗi. Đặt provider khớp với giao diện trong mọi mục là nguyên tắc giúp cấu hình cổng kết nối hỗn hợp hoạt động suôn sẻ. Một mục Claude gốc và một mục theo kiểu OpenAI có thể cùng tồn tại mà không gây xung đột. 

## Xử lý khóa API 

Đặt khóa trong apiKey, tốt nhất dưới dạng tham chiếu ${VAR} như ${AIPRIME_API_KEY} để thông tin bí mật nằm trong môi trường thay vì trong tệp. Lưu ý rằng việc mở rộng ${VAR} hoạt động trong settings.json nhưng không hoạt động trong config.json cũ. 

Trường apiKey cũng không được để trống, ngay cả khi cổng kết nối về mặt kỹ thuật có thể chấp nhận yêu cầu ẩn danh. Droid kiểm tra để đảm bảo trường này có giá trị, nên luôn cung cấp khóa hoặc biến chứa khóa đó. 

Hai điều này giải thích một lỗi thường gặp: người dùng đặt ${VAR} trong config.json cũ, nơi biến không được mở rộng, và Droid nhận một chuỗi nguyên văn chưa được phân giải. Hãy dùng settings.json cho dạng biến và đảm bảo biến thực sự được xuất trong shell khởi chạy Droid. Xác nhận biến đã được xuất trong shell khởi chạy là bước cuối cùng mà mọi người thường bỏ sót. Droid chỉ thấy các biến có trong môi trường đã khởi chạy nó. 

## Chuyển đổi và chạy 

Trong Droid CLI, chuyển đổi giữa các mô hình đã cấu hình bằng lệnh /model. Thêm một mục thứ hai cho claude-opus-4-8 và bạn có thể chuyển sang mô hình đó cho các tác vụ khó hơn mà không cần sửa lại cấu hình. 

Từ đó, Droid chạy vòng lặp tác nhân với Claude trên cổng kết nối. Vì thiết lập nằm trong settings.json, cùng một cấu hình được áp dụng mỗi lần bạn khởi động CLI. 

Chuẩn bị sẵn cả mục Sonnet lẫn Opus giúp bạn chọn mô hình phù hợp với tác vụ ngay trong lúc làm việc — Sonnet cho công việc triển khai thường xuyên, Opus khi vấn đề cần suy luận sâu hơn — tất cả đều qua cổng kết nối mà không cần cấu hình lại. Lệnh chuyển đổi /model giúp bạn thực hiện thay đổi đó bằng một dòng ngay giữa phiên. Việc chuyển đổi bằng một dòng /model giữa phiên giúp chọn mô hình theo tác vụ trở nên dễ dàng. Bạn chuyển từ Sonnet sang Opus mà không cần rời khỏi phiên. 

Sao chép

```
// ~/.factory/settings.json
{
  "customModels": [
    {
      "model": "claude-sonnet-4-5",
      "baseUrl": "https://aiprimetech.io",
      "apiKey": "${AIPRIME_API_KEY}",
      "provider": "anthropic",
      "maxOutputTokens": 8192
    }
  ]
}
// export AIPRIME_API_KEY=<key>   (apiKey must NOT be empty)
// Switch models in the CLI with /model
```

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

 Làm thế nào để chạy Factory Droid với Claude?

Thêm một mục customModels trong ~/.factory/settings.json với provider anthropic, baseUrl https://aiprimetech.io,, ID mô hình của bạn và apiKey. Chuyển đổi bằng /model. Dùng giá trị provider nào cho Claude?

anthropic cho giao diện Messages gốc. openai hoặc generic-chat-completion-api dành cho các điểm cuối theo kiểu OpenAI. Có thể để trống apiKey không?

Không — Droid yêu cầu một giá trị. Dùng tham chiếu ${VAR} như ${AIPRIME_API_KEY}; việc mở rộng biến hoạt động trong settings.json, không hoạt động trong config.json cũ. Làm thế nào để chuyển đổi mô hình?

Dùng lệnh /model trong Droid CLI để chuyển đổi giữa bất kỳ mục nào trong danh sách customModels của bạn.  

Bắt đầu sử dụng Claude chỉ trong vài phút

Lấy khóa API — không cần tài khoản Anthropic hay đăng ký danh sách chờ.[Lấy khóa API của bạn](/register) 

AI Prime Tech là một cổng API độc lập. AI Prime Tech không liên kết với, không được Anthropic chứng thực và không phải là đại lý bán lại của Anthropic. Claude và các tên mô hình liên quan là nhãn hiệu của chủ sở hữu tương ứng.    

## Các hướng dẫn khác về Claude API

[Cách lấy khóa Claude API](/vi/learn/how-to-get-a-claude-api-key/)[Giải thích giá API Claude](/vi/learn/claude-api-pricing-explained/)[Cách tiết kiệm nhất để sử dụng Claude API](/vi/learn/cheapest-way-to-use-claude-api/)[Cursor không giới hạn với Claude API](/learn/use-claude-api-with-cursor/)[Truy cập Claude Code không giới hạn](/vi/learn/use-claude-api-with-claude-code/)[Cổng Claude API so với truy cập trực tiếp Anthropic](/vi/learn/claude-api-vs-anthropic-direct/)[Sử dụng Claude qua API tương thích với OpenAI](/vi/learn/openai-compatible-claude-api/)[Giải thích các mô hình Claude: so sánh Claude Opus, Sonnet, Haiku và Fable — tất cả mô hình API Claude, tên mô hình Anthropic và giá (2026)](/vi/learn/claude-api-models-compared/)[Thanh toán Claude API bằng tiền mã hóa](/vi/learn/claude-api-with-crypto-payment/)[Truy cập Claude API không cần vào danh sách chờ](/vi/learn/claude-api-without-waitlist/)[Cách giảm lượng token sử dụng với Claude](/vi/learn/how-to-reduce-claude-token-usage/)[Cline không giới hạn với Claude API](/vi/learn/use-claude-api-with-cline/)[Roo Code không giới hạn với Claude API](/vi/learn/use-claude-api-with-roo-code/)[Claude không giới hạn trong các IDE JetBrains](/vi/learn/use-claude-api-with-jetbrains/)[Sử dụng Aider không giới hạn với Claude API](/vi/learn/use-claude-api-with-aider/)[Claude không giới hạn trong VS Code](/vi/learn/use-claude-api-with-vscode/)[Cấu hình OpenCode cho Claude: thiết lập opencode.json, mô hình và các lỗi thường gặp](/vi/learn/use-claude-api-with-opencode/)[Chạy tác nhân Hermes không giới hạn trên Claude](/vi/learn/run-hermes-agent-with-claude-api/)[Chạy OpenClaw không giới hạn trên Claude](/vi/learn/run-openclaw-with-claude-api/)[API tương thích với Anthropic có nghĩa là gì](/vi/learn/anthropic-compatible-api/)[Khóa API Claude Code — ANTHROPIC_API_KEY: cách lấy, thiết lập và khi nào nên dùng claude setup-token thay thế](/vi/learn/claude-code-api-key-setup/)[Chi phí API Claude Code — Giá và cách cắt giảm](/vi/learn/claude-code-api-costs/)[Giải thích các lỗi API Claude: lỗi máy chủ 500, quá tải 529, giới hạn tốc độ 429, yêu cầu không hợp lệ 400 — và cách khắc phục từng lỗi](/vi/learn/claude-api-errors-troubleshooting/)[Cách mua tín dụng Claude API — và vì sao tín dụng Claude tốt hơn mọi lời chào mời "mua tài khoản Claude"](/vi/learn/buy-claude-api-credits/)[API Claude miễn phí: có khóa API Claude miễn phí không, và điều gì thực sự miễn phí trong 2026?](/vi/learn/claude-api-free-trial/)[Claude API so với gói thuê bao Claude Pro/Max — Nên chọn loại nào](/vi/learn/claude-api-vs-subscription/)[Chạy Codex CLI trên Claude](/vi/learn/use-claude-api-with-codex/)[Kết nối Claude với n8n](/vi/learn/use-claude-api-with-n8n/)[Định tuyến LiteLLM tới Claude](/vi/learn/use-claude-api-with-litellm/)[Sử dụng Claude trong Kilo Code](/vi/learn/use-claude-api-with-kilo-code/)[Tích hợp Claude vào GitHub Copilot](/vi/learn/use-claude-api-with-github-copilot/)[Kết nối Zed với Claude qua cổng API](/vi/learn/use-claude-api-with-zed/)[Kết nối Cherry Studio với Claude](/vi/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic trong LangChain: nhập, base_url, truyền dữ liệu dạng luồng, công cụ và lỗi](/vi/learn/use-claude-api-with-langchain/)[SDK Python của Anthropic: cài đặt, thiết lập base_url, truyền dữ liệu dạng luồng và xử lý lỗi](/vi/learn/anthropic-python-sdk/)[Claude với Vercel AI SDK: baseURL của createAnthropic, truyền dữ liệu dạng luồng và cách khắc phục lỗi](/vi/learn/use-claude-api-with-vercel-ai-sdk/)[Giải thích API của Claude Code](/vi/learn/claude-code-api/)[Tích hợp API Claude vào ứng dụng của bạn](/vi/learn/claude-api-integration/)[Cách sử dụng Claude không giới hạn — và vì sao không có "Claude Code bẻ khóa"](/vi/learn/get-unlimited-claude-usage/)