Kết nối Claude Desktop với TaiKhoanGiaRe từng bước

Hướng dẫn cấu hình Claude Desktop dùng API TaiKhoanGiaRe: nhập base URL, key, chọn model và kiểm tra kết nối trước khi sử dụng.

Claude Desktop phù hợp với người muốn làm việc với Claude trong một ứng dụng máy tính thay vì tự viết mã gọi API. Nếu đã có tài khoản TaiKhoanGiaRe, bạn có thể kết nối Claude Desktop qua API tương thích Anthropic, nhập secret key, chọn model và gửi một yêu cầu thử trước khi bắt đầu sử dụng.

Bài viết này tập trung vào quy trình kết nối Claude Desktop với TaiKhoanGiaRe. Bạn sẽ đi qua các bước chuẩn bị tài khoản, lấy key, khai báo base URL, chọn model, kiểm tra key trong tab Integrations và xử lý các lỗi cấu hình thường gặp. Các giá trị quan trọng cần nhớ là:

• Anthropic-compatible base URL: https://taikhoangiare.vn
• Header xác thực: x-api-key
• MCP server của TaiKhoanGiaRe: https://taikhoangiare.vn/mcp
• OpenAI-compatible base URL, dùng cho ứng dụng khác: https://taikhoangiare.vn/v1

Claude Desktop và Claude Code là hai cách tích hợp khác nhau. Nếu bạn cần làm việc trong terminal, hãy xem thêm bài cài Claude Code với TaiKhoanGiaRe. Còn trong bài này, mọi bước đều hướng tới Claude Desktop theo hướng dẫn tích hợp tại trang Claude Desktop.

1. Chuẩn bị tài khoản và credit

Trước hết, hãy đăng ký hoặc đăng nhập tài khoản TaiKhoanGiaRe tại trang đăng nhập. Mỗi tài khoản có đúng một secret key, được tạo tự động khi đăng ký. Hệ thống không có chức năng tạo nhiều key cho cùng một tài khoản.

Bạn cần có credit trước khi gửi các yêu cầu thật. TaiKhoanGiaRe sử dụng credit trả trước, không có subscription. Một credit có giá trị 55,8đ. Bạn có thể mua credit bằng chuyển khoản VietQR được xử lý qua PayOS trong tab Billing của khu vực tài khoản.

Các gói credit hiện có gồm:

Tài khoản mới có free trial credits. Nếu chỉ muốn kiểm tra quy trình trước, bạn có thể xem số dư trong khu vực tài khoản trước khi mua thêm. Chính sách hoàn credit cũng áp dụng khi một job bị lỗi; điều này hữu ích khi thử các tính năng tạo nội dung hoặc media. Với Claude Desktop, phần quan trọng nhất là tài khoản phải có key hợp lệ và còn số dư để thực hiện request.

2. Lấy secret key đúng cách

Sau khi đăng nhập, mở khu vực tài khoản và vào tab API keys. Tại đây, bạn sẽ thấy secret key đã được tạo sẵn. Dùng chức năng Show để hiển thị key khi cần sao chép.

Key cần được giữ kín như thông tin đăng nhập. Không đưa key vào bài viết, ảnh chụp màn hình, kho mã nguồn công khai hoặc tệp cấu hình được đồng bộ lên Git. Claude Desktop cần key để xác thực request, vì vậy người có key có thể sử dụng hạn mức của tài khoản.

Nếu nghi ngờ key đã bị lộ, dùng Rotate. Thao tác này vô hiệu hóa key hiện tại và tạo trạng thái key mới để bạn cập nhật lại trong các ứng dụng đang kết nối. Do mỗi tài khoản chỉ có một secret key, sau khi rotate, mọi nơi đang dùng key cũ cần được thay bằng key mới.

Bạn có thể ghi lại ba giá trị sau trong một nơi tạm thời, không công khai:

Anthropic base URL: https://taikhoangiare.vn
Authentication header: x-api-key
API key: YOUR_TAIKHOANGIARE_SECRET_KEY

Không thêm /v1 vào Anthropic base URL. Địa chỉ https://taikhoangiare.vn/v1 là base URL OpenAI-compatible, còn Claude Desktop cần endpoint tương thích Anthropic là https://taikhoangiare.vn.

3. Cấu hình Claude Desktop với base URL và key

Mở hướng dẫn Claude Desktop của TaiKhoanGiaRe để đối chiếu giao diện và các bước theo hệ điều hành của bạn. Trong phần cấu hình provider hoặc API tương thích Anthropic, nhập base URL:

https://taikhoangiare.vn

Tiếp theo, nhập secret key đã lấy trong tab API keys. Khi công cụ yêu cầu kiểu xác thực, dùng API key theo header x-api-key. Đây là điểm khác với nhiều SDK OpenAI, thường dùng header Authorization: Bearer. Với Claude Desktop qua endpoint Anthropic-compatible, hãy ưu tiên đúng thông tin xác thực được ghi trong hướng dẫn:

x-api-key: YOUR_TAIKHOANGIARE_SECRET_KEY

Không nhập base URL OpenAI vào trường Anthropic. Nếu nhập nhầm https://taikhoangiare.vn/v1, Claude Desktop có thể gọi sai nhóm endpoint. Khi đó, lỗi thường xuất hiện trước cả bước chọn model.

Sau khi lưu cấu hình, mở lại phần chọn model của Claude Desktop. Chọn một model ID đang có trong danh sách model của TaiKhoanGiaRe. Các model có thể dùng để kiểm tra gồm:

• claude-sonnet-5
• claude-opus-5-5
• gpt-5.5
• deepseek-v4-flash

Nếu mục đích là kiểm tra kết nối Claude Desktop, nên bắt đầu bằng một model Claude như claude-sonnet-5 hoặc claude-opus-5-5. Khi cần xem toàn bộ model ID, khả năng và giá, mở danh sách models và prices. Không tự viết tên model theo tên hiển thị trong một ứng dụng khác; hãy sao chép đúng model ID được cung cấp.

Danh sách bán tại TaiKhoanGiaRe còn có các ID như claude-haiku-4-5, claude-opus-4-6, claude-opus-4-7, claude-opus-4-8, claude-opus-5, claude-sonnet-4-6, deepseek-v4-pro, deepseek-v4.1-flash, grok-4.5, grok-4.6, grok-4.7 và kimi-k3. Tuy nhiên, giao diện Claude Desktop có thể hiển thị hoặc lọc model theo cách riêng, nên hãy dùng model xuất hiện trong phần chọn model sau khi cấu hình.

4. Kiểm tra key ở tab Integrations trước khi chat

Đừng bắt đầu bằng một cuộc hội thoại dài ngay sau khi lưu cấu hình. Trước tiên, quay lại khu vực tài khoản TaiKhoanGiaRe, mở tab Integrations và chọn Claude Desktop. Tab này cho phép kiểm tra key bằng một tiny real request, đồng thời cung cấp cURL và hướng dẫn tích hợp tương ứng.

1. Mở tab Integrations trong dashboard.
2. Chọn hướng dẫn Claude Desktop.
3. Kiểm tra base URL đang là https://taikhoangiare.vn.
4. Kiểm tra key đã được nhập đúng, không có khoảng trắng thừa ở đầu hoặc cuối.
5. Chọn một model ID có trong danh sách, chẳng hạn claude-sonnet-5.
6. Gửi tiny real request theo hướng dẫn.
7. Chỉ chuyển sang Claude Desktop sau khi request kiểm tra trả về phản hồi hợp lệ.

Việc kiểm tra trong tab Integrations giúp tách lỗi tài khoản khỏi lỗi cấu hình ứng dụng. Nếu request trong Integrations cũng thất bại, hãy kiểm tra key, model ID và số dư trước. Nếu request kiểm tra thành công nhưng Claude Desktop không phản hồi, vấn đề nhiều khả năng nằm ở base URL, trường API key hoặc cấu hình cục bộ của Claude Desktop.

Bạn cũng có thể dùng cURL theo mẫu trong hướng dẫn để đối chiếu. Không cần tự đoán endpoint nếu trang tích hợp đã cung cấp lệnh cụ thể. Khi chạy lệnh, thay phần key mẫu bằng secret key của bạn và không lưu lệnh đó vào nơi công khai.

5. Gửi tin nhắn thử và theo dõi chi phí

Sau khi key đã được kiểm tra, quay lại Claude Desktop, chọn model đã cấu hình và gửi một yêu cầu ngắn, chẳng hạn yêu cầu giải thích một đoạn code nhỏ. Mục tiêu của bước này là xác nhận đủ bốn thành phần: Claude Desktop gửi request, TaiKhoanGiaRe nhận đúng endpoint, model được chọn hợp lệ và phản hồi trở lại ứng dụng.

Trong dashboard, tab Overview hiển thị balance, spend today, last 7 days và tokens. Tab Usage cho phép xem dữ liệu trong today, 7 hoặc 30 days, lọc theo product và theo dõi mức sử dụng. Đây là nơi nên kiểm tra sau khi gửi một vài request thay vì chỉ dựa vào giao diện Claude Desktop.

Chi phí phụ thuộc model và lượng token input, output. Bảng giá model được tính theo 1 triệu token trên TaiKhoanGiaRe:

Prompt caching được bật. Cache reads được tính theo mức giá cache trong bảng giá. Ví dụ đã được tính sẵn cho claude-sonnet-5: một lượt agent gồm 100.000 token đọc cache + 5.000 token input mới + 1.000 token output = 276đ; 1.000 lượt như vậy = 275.992đ. Một tin nhắn chat gồm 1.000 input + 500 output = 29đ; 1.000 tin nhắn = 29.401đ.

Các con số trên là ví dụ theo cấu trúc token cụ thể, không phải mức phí cố định cho mọi cuộc trò chuyện. Để theo dõi hoạt động thực tế của Claude Desktop, hãy xem Usage và Overview trong dashboard.

6. Xử lý lỗi kết nối thường gặp

Claude Desktop báo lỗi xác thực

Kiểm tra secret key có bị thiếu ký tự, thừa khoảng trắng hoặc đã bị Rotate hay không. Nếu key đã được rotate, hãy lấy key hiện tại bằng chức năng Show và cập nhật lại cấu hình Claude Desktop. Nhớ dùng x-api-key, không thay bằng header Bearer nếu trường cấu hình đang yêu cầu Anthropic API key.

Không tìm thấy model

Đối chiếu model ID với danh sách trong trang models. Tên phải khớp cả dấu gạch nối và số phiên bản, ví dụ claude-sonnet-5 không giống một tên tự đặt trong Claude Desktop. Nếu model không xuất hiện, mở lại phần tích hợp và chọn model từ danh sách được cung cấp ở đó.

Request gửi sai endpoint

Anthropic base URL phải là https://taikhoangiare.vn, không có /v1. Địa chỉ có /v1 dành cho OpenAI-compatible API. Đây là lỗi cấu hình cần kiểm tra đầu tiên nếu key đúng nhưng request vẫn không tới được model.

Request bị từ chối do số dư

Mở Overview hoặc Billing để kiểm tra balance và lịch sử thanh toán. Nếu cần nạp thêm, dùng VietQR qua PayOS trong tab Billing. Bạn có thể xem hướng dẫn riêng về nạp credit bằng VietQR qua PayOS.

Muốn dùng công cụ MCP

Nếu nhu cầu của bạn là để một AI agent gọi các công cụ như chat, list_models, generate_image, generate_video, text_to_speech hoặc balance, endpoint MCP của TaiKhoanGiaRe là https://taikhoangiare.vn/mcp. Đây là hướng tích hợp khác với việc chỉ dùng Claude Desktop để chat qua Anthropic-compatible API. Hãy xem hướng dẫn MCP server trước khi cấu hình.

Checklist kết nối Claude Desktop

• Đã đăng nhập TaiKhoanGiaRe và kiểm tra balance.
• Đã lấy secret key tại tab API keys bằng Show.
• Đã ghi nhớ tài khoản chỉ có một key; Rotate sẽ vô hiệu hóa key hiện tại.
• Đã dùng Anthropic base URL https://taikhoangiare.vn.
• Đã dùng xác thực x-api-key.
• Đã chọn model ID có trong danh sách, chẳng hạn claude-sonnet-5.
• Đã gửi tiny real request tại tab Integrations.
• Đã gửi một tin nhắn ngắn trong Claude Desktop trước khi sử dụng lâu hơn.
• Đã kiểm tra Usage sau các request đầu tiên.

Tóm lại, quy trình ổn định nhất là lấy đúng một secret key, dùng đúng Anthropic base URL không có /v1, chọn model ID chính xác và kiểm tra bằng tiny real request trong tab Integrations trước khi chat. Khi mọi thứ hoạt động, theo dõi balance và Usage để chủ động quản lý credit.

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

Claude Desktop dùng base URL nào của TaiKhoanGiaRe?

Dùng Anthropic-compatible base URL https://taikhoangiare.vn, không thêm /v1. Địa chỉ https://taikhoangiare.vn/v1 dành cho OpenAI-compatible API.

Tôi lấy API key ở đâu?

Đăng nhập dashboard, mở tab API keys và dùng chức năng Show để hiển thị secret key được tạo tự động khi đăng ký. Mỗi tài khoản chỉ có một key; Rotate sẽ vô hiệu hóa key hiện tại.

Vì sao nên kiểm tra key trong tab Integrations trước?

Tab Integrations gửi một tiny real request để xác nhận key, base URL và model hoạt động trước khi bạn dùng Claude Desktop. Nếu request này thành công nhưng ứng dụng vẫn lỗi, bạn có thể tập trung kiểm tra cấu hình cục bộ của Claude Desktop.

Claude Desktop cần header xác thực nào?

Với endpoint tương thích Anthropic, dùng API key theo header x-api-key. Không tự thay bằng Authorization: Bearer khi cấu hình Claude Desktop.

← Về trang Blog