راه‌اندازی ارائه‌دهنده Goose

ارائه‌دهنده‌های سازگار با Anthropic و OpenAI در goose را به QCode متصل کنید: کدام فیلد HOST کدام URL را می‌گیرد، و goose configure چه کاری نمی‌تواند انجام دهد

به کلید API نیاز دارید؟ ثبت‌نام ←·نقاط پایانی و Base URL ←

آخرین بازبینی: 2026-11-12 · 📄 بر اساس مستندات رسمی (goose v1.54.0، نسخه‌ای که بقیه این صفحه در 2026-10-13 بر اساس آن نوشته شده است؛ فهرست مدل‌های Claude در ادامه در 2026-11-12 دوباره با مستندات مدل Anthropic بررسی شد)

در یک نگاه¶

goose خود را «عامل هوش مصنوعی متن‌باز بومی شما — اپلیکیشن دسکتاپ، CLI و API» توصیف می‌کند. اکنون پروژه‌ای از Agentic AI Foundation است، بنابراین مستندات در goose-docs.ai قرار دارد (نشانی پیشین block.github.io/goose فقط تغییرمسیر می‌دهد) و مخزن aaif-goose/goose است، در حالی که فرمول Homebrew هنوز block-goose-cli نامیده می‌شود. نسخه ارجاع‌شده در این صفحه انتشار پایدار v1.54.0 است که در 2026-10-08 منتشر شد.

کدام پروتکل¶

هرگز Claude را از طریق نقطه پایانی سازگار با OpenAI فراخوانی نکنید. QCode شناسه‌های claude-* را فقط در سمت Anthropic Messages ارائه می‌دهد؛ سمت OpenAI آن‌ها را رد می‌کند (model_not_available_on_endpoint). دو ارائه‌دهنده را به‌جای یکی نگه دارید و برای هر نشست با goose run --provider … --model … انتخاب کنید. جزئیات: نقاط پایانی و مسیرهای API.

نام فیلد HOST است، نه base_url. goose از شما ANTHROPIC_HOST، OPENAI_HOST و GOOSE_PROVIDER__HOST را می‌خواهد. فقط میزبان به‌همراه پیشوند مسیر را وارد کنید — /v1/messages را در فیلد ننویسید. در سمت OpenAI، مسیر درخواست یک فیلد مستندشده جداگانه است: جدول رسمی OPENAI_BASE_PATH را چنین توصیف می‌کند: "Request path appended to the host (defaults to v1/chat/completions)". مستندات رسمی به‌روشنی بیان نمی‌کند که ANTHROPIC_HOST چگونه با مسیر messages ترکیب می‌شود؛ بنابراین این صفحه فقط مقدار QCode را بیان می‌کند و هیچ ادعایی به‌عنوان اندازه‌گیری‌شده ندارد.

نصب¶

CLI، با Homebrew یا اسکریپت رسمی:

brew install block-goose-cli

# or
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

goose update
goose --version

دسکتاپ: در macOS از Homebrew یا دکمه‌های دانلود استفاده کنید؛ در Linux صفحه رسمی بسته‌های .deb، .rpm و Flatpak را ارائه می‌دهد:

brew install --cask block-goose

پیکربندی Claude (ارائه‌دهنده Anthropic)¶

مسیر تعاملی از prompt‌های رسمی پیروی می‌کند:

goose configure
# Configure Providers (Change provider or update credentials)  -> choose Anthropic
# Provider Anthropic requires ANTHROPIC_API_KEY, please enter a value  -> your QCode key
# Enter your desired ANTHROPIC_HOST or press Enter to use the default.  -> https://api.qcode.cc/api

متغیرهایی که صفحه رسمی متغیرهای محیطی آن‌ها را زیر نقاط پایانی سفارشی گروه‌بندی می‌کند، بدون ویزارد همان کار را انجام می‌دهند:

export GOOSE_PROVIDER="anthropic"
export GOOSE_MODEL="claude-sonnet-5"
export GOOSE_PROVIDER__TYPE="anthropic"
export GOOSE_PROVIDER__HOST="https://api.qcode.cc/api"
export GOOSE_PROVIDER__API_KEY="cr_your_qcode_key"

در config.yaml (در macOS/Linux: ~/.config/goose/config.yaml) تنظیمات ارائه‌دهنده در کلیدهای active_provider و providers قرار دارند:

active_provider: anthropic
providers:
  anthropic:
    enabled: true
    model: claude-sonnet-5
    configured: true

• کلید در آن فایل قرار نمی‌گیرد: مستندات رسمی اعلام می‌کنند "Provider API keys do not go in config.yaml". آن را از طریق goose configure در مخزن کلید، در secrets.yaml یا در متغیر محیطی ارائه‌دهنده نگه دارید.
• گره‌های منطقه‌ای: میزبان را با https://asia.qcode.cc/api یا https://us.qcode.cc/api جایگزین کنید. همان کلید کار می‌کند.
• شناسه‌های Claude موجود در QCode: claude-sonnet-5، claude-sonnet-5-5، claude-opus-5، claude-opus-5-5، claude-haiku-5-5، claude-sonnet-4-6، claude-fable-5-2، claude-fable-5-1، claude-fable-5. به‌ازای هر توکن صورت‌حساب می‌شود؛ نرخ‌های هر مدل در https://qcode.cc/models فهرست شده‌اند
• claude-fable-5-2 همان Claude Fable 5.2 است که در 2026-11-09 منتشر شده و Fable کنونی در QCode است؛ نسخه قبلی claude-fable-5-1 همچنان به فروش می‌رسد. این مدل روی همان نقطه پایانی Anthropic Messages با پنجره زمینه 1M توکن و حداکثر خروجی 128K ارائه می‌شود؛ بنابراین در سمت goose فقط مقدار مدل تغییر می‌کند: export GOOSE_MODEL="claude-fable-5-2".

پیکربندی GPT و مدل‌های چینی (سازگار با OpenAI)¶

ارائه‌دهنده داخلی OpenAI «می‌تواند به API رسمی OpenAI (api.openai.com) یا هر نقطه پایانی سازگار با OpenAI متصل شود»، و راهنمای رسمی برای چنین دروازه‌ای این است که «OPENAI_HOST را روی ریشه پراکسی خود تنظیم کنید (بدون مسیر انتهایی) و OPENAI_BASE_PATH را روی مسیری که سرو می‌کند (معمولاً v1/chat/completions) تنظیم کنید»:

export OPENAI_API_KEY="cr_your_qcode_key"
export OPENAI_HOST="https://api.qcode.cc"
export OPENAI_BASE_PATH="openai/v1/chat/completions"
export GOOSE_PROVIDER="openai"
export GOOSE_MODEL="gpt-6.1-sol"

راه جایگزین این است که مسیر پیش‌فرض مستندشده را نگه دارید و پیشوند را به میزبان منتقل کنید، export OPENAI_HOST="https://api.qcode.cc/openai"، و OPENAI_BASE_PATH را روی v1/chat/completions باقی بگذارید. در هر دو حالت، درخواست به URL نقطه پایانی مستندشده https://api.qcode.cc/openai/v1/chat/completions ارسال می‌شود.

به‌عنوان ارائه‌دهنده سفارشی نام‌دار¶

goose configure را اجرا کنید، Custom Providers را انتخاب کنید، سپس Add A Custom Provider (متن خط منو «Add a new OpenAI/Anthropic/Ollama compatible Provider» است):

ارائه‌دهنده کلید خود را از متغیر محیطی‌ای می‌خواند که به آن اختصاص داده‌اید. در عبارت رسمی، «سپس از api_key_env برای تنظیم کلید نشست خود استفاده کنید»، با مثال مستندشده:

export CUSTOM_CORP_API_API_KEY="your-api-key"
goose session start --provider custom_corp_api

از نام ارائه‌دهنده و متغیر کلید خودتان به‌جای custom_corp_api / CUSTOM_CORP_API_API_KEY استفاده کنید. اگر ترجیح می‌دهید فایل JSON را خودتان بنویسید، آن را در macOS/Linux: ~/.config/goose/custom_providers/ قرار دهید. به دو نکته توجه کنید: «ارائه‌دهندگان سفارشی باید از قالب‌های API سازگار با OpenAI، Anthropic یا Ollama استفاده کنند.» و مثال‌های رسمی فقط "engine": "openai" را نشان می‌دهند — مستندات هیچ مقداری برای سمت Anthropic منتشر نمی‌کنند، بنابراین ارائه‌دهندگان سفارشی سازگار با Anthropic را از طریق goose configure بسازید و بگذارید goose همان خط را بنویسد.

شناسه‌های مدل چینی در QCode شامل deepseek-v4.1-flash، deepseek-v4-flash، deepseek-v4-pro، glm-5.3، glm-5.2، qwen3.8-max، qwen3.8-flash، qwen3.7-plus، kimi-k3 است — به مدل‌های چینی مراجعه کنید.

بررسی¶

goose info
goose run --provider anthropic --model claude-sonnet-5 -t "ping"

توضیح goose info چنین است: «Shows goose information, including the version, configuration file location, session storage, and logs.» در goose run، --provider یعنی «Specify the provider to use for this session (overrides environment variable)» و --model یعنی «Specify the model to use for this session (overrides environment variable)».

پیش از عیب‌یابی خود goose، نقطه پایانی را تأیید کنید:

KEY="cr_your_qcode_key"
curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

بدنه JSON حاوی content یعنی سمت نقطه پایانی پاسخ داده است و مشکل باقی‌مانده در تنظیمات goose است. این صفحه از مستندات رسمی ساخته شده است؛ کلید آزمایشی وجود نداشت، بنابراین هیچ درخواستی در اینجا با QCode آزمایش نشد.

عیب‌یابی / محدودیت‌های شناخته‌شده¶

صورتحساب به‌ازای هر توکن است؛ نرخ‌های هر مدل در https://qcode.cc/models فهرست شده‌اند.

مرتبط¶

• نقاط پایانی و مسیرهای API — پروتکل × خانواده مدل
• سازگاری ابزارها — کدام ابزارها کدام پروتکل را می‌پذیرند
• راه‌اندازی OpenCode — یک عامل ترمینالی دیگر روی همان دو نقطه پایانی
• راه‌اندازی Crush — همان جفت ارائه‌دهنده، یک فایل پیکربندی JSON به‌جای ویزارد
• یکپارچه‌سازی Aider — هر دو نقطه پایانی نیز، بر اساس نام مدل انتخاب می‌شوند
• انتخاب مدل
• مدل‌های چینی

سازمانی ←