پرش به محتوای اصلی
یکپارچه‌سازی

اتصال Claude Code به دات‌هوش

هر راهنما چند گام کوتاه دارد: کلید، آدرس پایه، شناسه مدل.

Claude Code

CLI
حدود ۱ دقیقهپروتکل Anthropic۳ گام

پیش‌نیاز: یک کلید API و موجودی کیف پول.

ساخت کلید
  1. دو متغیر محیطی

    در ترمینال یا فایل پروفایل شل تنظیم کنید. Claude Code از مسیر سازگار با Anthropic استفاده می‌کند؛ آدرس پایه را بدون /v1/messages بدهید و کلید را با ANTHROPIC_API_KEY بفرستید.

    ~/.zshrc
    export ANTHROPIC_BASE_URL="https://gateway.dothoosh.com/anthropic"
    export ANTHROPIC_API_KEY="$DOTHOOSH_API_KEY"
  2. اجرا با مدل سازگار

    شناسه مدل باید یکی از مدل‌هایی باشد که پروتکل Anthropic Messages برایشان در کاتالوگ مدل‌ها آمده است؛ مدل بدون این پروتکل از این مسیر سرو نمی‌شود.

    terminal
    claude --model claude-fable-5-1
  3. کلید و مدل را با curl بیازمایید

    اگر Claude Code خطا داد، همین درخواست را مستقیم بزنید تا مشکل کلید یا مدل از مشکل ابزار جدا شود.

    terminal
    curl https://gateway.dothoosh.com/anthropic/v1/messages \
      -H "x-api-key: $DOTHOOSH_API_KEY" \
      -H "anthropic-version: 2023-06-01" \
      -H "Content-Type: application/json" \
      -d '{"model":"claude-fable-5-1","max_tokens":256,"messages":[{"role":"user","content":"سلام"}]}'

محدودیت شناخته‌شده: این پیکربندی روی مسیر Anthropic دات‌هوش کار می‌کند، اما هنوز نتیجه تأییدشده سرتاسری برای Claude Code منتشر نشده است. تا آن زمان هر فراخوانی با قواعد مسیر Anthropic بررسی می‌شود: فیلدهای ناشناخته رد می‌شوند و فقط مدل‌هایی سرو می‌شوند که پروتکل Anthropic Messages برایشان تأیید شده است.

کار نکرد؟

401 · api_key_invalid

کلید اشتباه کپی شده، لغو شده یا غیرفعال است. کلید را دوباره از متغیر محیطی بخوانید و وضعیتش را در کنسول بررسی کنید.

400 · insufficient_available_balance

موجودی کیف پول کافی نیست. کیف پول را شارژ کنید؛ بدهی ایجاد نمی‌شود.

404 · model_not_found

شناسه مدل را از کاتالوگ مدل‌ها کپی کنید؛ شناسه‌ها پیشوند ارائه‌دهنده ندارند.

429 · api_key_rpm_exceeded

از سقف درخواست در دقیقه کلید عبور کرده‌اید. محدودیت‌های کلید بعد از ساخت ویرایش نمی‌شوند؛ برای سقف بالاتر، کلید تازه با RPM بالاتر بسازید.

401 · api_key_malformed

کلید در سرآیند Authorization رفته است، اما مسیر Anthropic فقط x-api-key را می‌پذیرد. کلید را با ANTHROPIC_API_KEY (یا api_key در SDK) بدهید.

400 · unsupported_capability

مدل انتخابی پروتکل Anthropic Messages ندارد. از کاتالوگ مدلی را بردارید که این پروتکل برایش آمده، یا از مسیر OpenAI استفاده کنید.