> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sử dụng Claude Desktop với CometAPI

> Sử dụng hướng dẫn này để cấu hình Claude Desktop với CometAPI bằng cách thiết lập base URL, API key và các tùy chọn model hoặc provider.

Sử dụng hướng dẫn này để kết nối Cowork trên third-party inference của Claude Desktop với CometAPI. Cấu hình này cho phép Claude Desktop gửi các yêu cầu Claude Messages API đến CometAPI từ Cowork, Projects và các quy trình làm việc trên desktop được hỗ trợ.

Tài liệu tham khảo chính thức:

* [Cài đặt và thiết lập Claude Desktop](https://claude.com/docs/cowork/3p/installation)
* [Cấu hình gateway Claude Desktop](https://claude.com/docs/cowork/3p/gateway)
* [Tài liệu tham khảo cấu hình Claude Desktop](https://claude.com/docs/cowork/3p/configuration)

<Note>
  Third-party inference của Claude Desktop yêu cầu một gateway tương thích với Anthropic. CometAPI hỗ trợ các model Claude thông qua [Anthropic Messages API](/api/text/anthropic-messages).
</Note>

<Warning>
  Nội dung bạn gửi từ Claude Desktop sẽ được xử lý bởi CometAPI và nhà cung cấp model đã chọn. Không gửi dữ liệu mật trừ khi tổ chức của bạn cho phép quy trình làm việc đó.
</Warning>

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

* Claude Desktop được cài đặt từ [claude.com/download](https://claude.com/download)
* Một bản dựng Claude Desktop có **Developer mode** và **Configure third-party inference**
* Một tài khoản CometAPI với API key đang hoạt động
* Quyền truy cập vào các model Claude trong CometAPI
* Một đường mạng có thể truy cập `https://api.cometapi.com`

Bắt đầu từ màn hình đăng nhập Claude Desktop. Nếu bạn đã đăng nhập bằng tài khoản Anthropic, hãy đăng xuất trước khi cấu hình third-party inference.

## Cấu hình

<Steps>
  <Step title="Bật chế độ nhà phát triển">
    Mở Claude Desktop và giữ nguyên ở màn hình đăng nhập. Trong menu ứng dụng, mở **Help** → **Troubleshooting**, sau đó chọn **Enable Developer Mode**.

    Trên Windows, menu có thể khó truy cập trước khi đăng nhập. Hãy đưa con trỏ vào trường email, nhấn `Tab` cho đến khi menu được chọn, rồi nhấn `Enter`.
  </Step>

  <Step title="Mở cài đặt inference bên thứ ba">
    Sau khi bật chế độ nhà phát triển, mở **Developer** → **Configure third-party inference**.

    Cửa sổ cấu hình sẽ mở ra với một số phần trong thanh bên trái. Sử dụng phần **Connection** cho các thiết lập CometAPI.
  </Step>

  <Step title="Cấu hình gateway">
    Trong phần **Connection**, nhập các giá trị CometAPI bên dưới:

    | Trường                | Giá trị                                                 |
    | --------------------- | ------------------------------------------------------- |
    | Inference provider    | Gateway                                                 |
    | Gateway               | Anthropic-compatible                                    |
    | Gateway base URL      | `https://api.cometapi.com`                              |
    | Gateway API key       | API key CometAPI của bạn, chẳng hạn như `$COMETAPI_KEY` |
    | Gateway auth scheme   | Bearer                                                  |
    | Gateway extra headers | Để trống                                                |

    Giữ nguyên base URL chính xác như hiển thị. Claude Desktop yêu cầu base URL HTTPS.

    Ảnh chụp màn hình sau đây hiển thị phần Connection đã được điền các giá trị CometAPI.

    <img src="https://mintcdn.com/cometapi/wsQpBp8rhXV0Hvh3/images/integrations/claude-desktop-cometapi-connection.png?fit=max&auto=format&n=wsQpBp8rhXV0Hvh3&q=85&s=879de5e2a4587861f220a7f6e0f7d2a5" alt="Cài đặt Connection của Claude Desktop với gateway base URL của CometAPI, trường API key và sơ đồ xác thực bearer đã được điền" width="1800" height="1440" data-path="images/integrations/claude-desktop-cometapi-connection.png" />
  </Step>

  <Step title="Thêm model ID">
    Trong **Model list**, thêm thủ công các model ID sau:

    | Model ID                    | Mục đích sử dụng khuyến nghị          |
    | --------------------------- | ------------------------------------- |
    | `claude-opus-4-7`           | Lập kế hoạch phức tạp và tác vụ agent |
    | `claude-sonnet-4-6`         | Sử dụng desktop thông thường          |
    | `claude-haiku-4-5-20251001` | Prompt gọn nhẹ và bản nháp nhanh      |

    Model đầu tiên trong danh sách sẽ trở thành model mặc định. Đặt `claude-sonnet-4-6` ở vị trí đầu tiên nếu bạn muốn model mặc định dùng cho mục đích chung.

    <Tip>
      Khả năng khả dụng của model có thể thay đổi. Nếu một model không xuất hiện trong Claude Desktop sau khi cấu hình, hãy xác minh quyền truy cập trên [trang Models của CometAPI](/vi/overview/models).
    </Tip>

    Ảnh chụp màn hình sau đây hiển thị danh sách model với ba model ID Claude đã được cấu hình cho CometAPI.

    <img src="https://mintcdn.com/cometapi/wsQpBp8rhXV0Hvh3/images/integrations/claude-desktop-cometapi-model-list.png?fit=max&auto=format&n=wsQpBp8rhXV0Hvh3&q=85&s=63dcdfe05db59c09782e1514e09a734d" alt="Danh sách model của Claude Desktop hiển thị claude-opus-4-7, claude-sonnet-4-6 và claude-haiku-4-5-20251001 cho CometAPI" width="1764" height="1278" data-path="images/integrations/claude-desktop-cometapi-model-list.png" />
  </Step>

  <Step title="Áp dụng cấu hình cục bộ">
    Nhấp vào **Apply locally**. Claude Desktop ghi cấu hình đã chọn vào hồ sơ người dùng cục bộ và khởi động lại ứng dụng.

    Nếu ứng dụng không khởi động lại, hãy thoát hoàn toàn khỏi Claude Desktop rồi mở lại.
  </Step>

  <Step title="Bắt đầu một phiên Cowork">
    Trên màn hình đăng nhập, chọn tùy chọn Cowork trên inference bên thứ ba. Mở Cowork hoặc Projects, chọn một trong các model Claude đã cấu hình, rồi gửi một prompt thử nghiệm ngắn.

    Phản hồi thành công xác nhận rằng Claude Desktop đang sử dụng CometAPI cho các lệnh gọi model.
  </Step>
</Steps>

## Xác minh cấu hình

Sử dụng một prompt ngắn không yêu cầu công cụ bên ngoài:

```text theme={null}
Reply with one sentence: Claude Desktop is connected through CometAPI.
```

Nếu Claude Desktop trả về phản hồi, thì base URL, API key và danh sách model đã được cấu hình chính xác.

Ảnh chụp màn hình sau đây hiển thị phản hồi Cowork thành công thông qua CometAPI.

<img src="https://mintcdn.com/cometapi/wsQpBp8rhXV0Hvh3/images/integrations/claude-desktop-cometapi-chat.png?fit=max&auto=format&n=wsQpBp8rhXV0Hvh3&q=85&s=93bb3b1a60de0d7edbd25cb6ba3b58d8" alt="Phản hồi Cowork của Claude Desktop sử dụng CometAPI sau khi thiết lập inference bên thứ ba" width="2880" height="1600" data-path="images/integrations/claude-desktop-cometapi-chat.png" />

Để kiểm tra các thiết lập đã được phát hiện, mở **Help** → **Troubleshooting** → **Copy Managed Configuration Report**. Các giá trị bí mật sẽ được ẩn trong báo cáo đã sao chép.

## Khắc phục sự cố

<AccordionGroup>
  <Accordion title="Menu nhà phát triển không xuất hiện">
    Xác nhận rằng bạn đã chọn **Help** → **Troubleshooting** → **Enable Developer Mode**. Sau đó thoát hoàn toàn Claude Desktop và mở lại.

    Nếu không có tùy chọn này, hãy cài đặt một bản dựng Claude Desktop có hỗ trợ cấu hình inference bên thứ ba.
  </Accordion>

  <Accordion title="Claude Desktop mở luồng đăng nhập tiêu chuẩn">
    Hãy kiểm tra các mục sau:

    * **Inference provider** được đặt thành **Gateway**.
    * **Gateway base URL** là `https://api.cometapi.com`.
    * **Gateway API key** chứa API key CometAPI của bạn và không có khoảng trắng thừa.
    * Bạn đã nhấp vào **Apply locally** và khởi động lại hoàn toàn Claude Desktop.
  </Accordion>

  <Accordion title="Xác thực kết nối thất bại">
    Xác nhận rằng base URL bắt đầu bằng `https://`. Claude Desktop không chấp nhận gateway URL HTTP thuần.

    Đồng thời xác nhận rằng tài khoản CometAPI của bạn có quyền truy cập vào các model Claude và API key chưa bị xóa hoặc vô hiệu hóa.
  </Accordion>

  <Accordion title="Các model đã cấu hình không xuất hiện">
    Mở lại **Developer** → **Configure third-party inference** và kiểm tra các mục trong **Model list**. Model ID phải khớp với các ID mà CometAPI cung cấp.

    Thêm từng model ID như một mục riêng biệt. Không đưa dấu ngoặc kép, dấu phẩy hoặc khoảng trắng thừa vào các trường trong giao diện.
  </Accordion>

  <Accordion title="Base URL tương thích OpenAI không hoạt động">
    Claude Desktop third-party inference yêu cầu một gateway tương thích Anthropic cho luồng này. Hãy dùng `https://api.cometapi.com` và các model ID Claude được liệt kê ở trên.
  </Accordion>

  <Accordion title="Tab Code hoạt động khác">
    Tab Code sử dụng engine Claude Code bên trong Claude Desktop. Một số cài đặt trên desktop có thể không áp dụng cho các phiên Code theo cùng cách như khi áp dụng cho Cowork.

    Đối với việc sử dụng terminal độc lập, hãy xem [hướng dẫn tích hợp Claude Code](/vi/integrations/claude-code).
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#howto",
        "name": "Sử dụng Claude Desktop với CometAPI",
        "description": "Sử dụng hướng dẫn này để cấu hình Claude Desktop với CometAPI bằng cách thiết lập base URL, API key và các tùy chọn model hoặc provider.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-1",
            "position": 1,
            "name": "Bật chế độ nhà phát triển",
            "text": "Hoàn thành bước Bật chế độ nhà phát triển trong hướng dẫn Sử dụng Claude Desktop với CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-2",
            "position": 2,
            "name": "Mở cài đặt inference bên thứ ba",
            "text": "Hoàn thành bước Mở cài đặt inference bên thứ ba trong hướng dẫn Sử dụng Claude Desktop với CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-3",
            "position": 3,
            "name": "Cấu hình gateway",
            "text": "Hoàn thành bước Cấu hình gateway trong hướng dẫn Sử dụng Claude Desktop với CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-4",
            "position": 4,
            "name": "Thêm model ID",
            "text": "Hoàn thành bước Thêm model ID trong hướng dẫn Sử dụng Claude Desktop với CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-5",
            "position": 5,
            "name": "Áp dụng cấu hình cục bộ",
            "text": "Hoàn thành bước Áp dụng cấu hình cục bộ trong hướng dẫn Sử dụng Claude Desktop với CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-6",
            "position": 6,
            "name": "Bắt đầu một phiên Cowork",
            "text": "Hoàn thành bước Bắt đầu một phiên Cowork trong hướng dẫn Sử dụng Claude Desktop với CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Tài liệu CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Tích hợp",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Sử dụng Claude Desktop với CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/claude-desktop"
          }
        ]
      }
    ]
    }
    `}
</script>