ابزارها · 2026-08-30

Zed روی یک نقطه پایانی سازگار با OpenAI
یک ارائه‌دهنده در Agent Settings اضافه کنید

از 2026-10-07، ارائه‌دهنده openai_compatible در Zed برای مدل‌های GPT و GLM / DeepSeek (مثلاً gpt-6-sol، glm-5.3) مقدار api_url را https://api.qcode.cc/openai/v1 می‌گیرد. Claude نمی‌تواند از نقطه پایانی سازگار با OpenAI استفاده کند: یک ارائه‌دهنده anthropic_compatible با api_url برابر https://api.qcode.cc/api اضافه کنید. شناسه مدل‌ها را از /models کپی کنید.

به‌روزرسانی شده 2026-11-14

این ابزار را به نقطه پایانی QCode متصل کنید — یک کلید برای Claude، GPT و مدل‌های چینی.

#zed#سازگار با OpenAI#api_url#BYOK

نکات کلیدی

4

فیلدهایی که پر می‌کنید

بخش رسمی سازگار با OpenAI: نام ارائه‌دهنده، API URL، شناسه مدل و پنجره زمینه. کلیدها در رابط تنظیمات یا در یک متغیر محیطی قرار می‌گیرند — نه در settings.json.

2026-10-07

تاریخ دریافت مستندات

zed.dev/docs/ai/use-api-access، اولین دریافت 2026-08-30، بازبینی 2026-10-07.

/openai/v1

شکل api_url

نمونه رسمی https://example.com/v1 است. نقطه پایانی سازگار با OpenAI در QCode برابر https://api.qcode.cc/openai/v1 است؛ Zed خودش /chat/completions را اضافه می‌کند، پس آن را در فیلد URL نچسبانید و اسلش انتهایی را حذف کنید.

tools

قابلیت پیش‌فرض

openai_compatible به‌صورت پیش‌فرض tools: true و images: false دارد. جدول قابلیت‌های رسمی را دنبال کنید.

دسترسی API در Zed به چه معناست

Zed یک ویرایشگر گرافیکی با Agent و Inline Assistant داخلی است. مستندات رسمی زمانی از دسترسی API صحبت می‌کنند که کلید API ارائه‌دهنده یا صورت‌حساب مصرف داشته باشید و آن را در Agent Settings پیکربندی کنید. نقطه‌های پایانی سازگار با OpenAI یکی از مسیرهای مستندشده هستند — نه یک ترفند client-id.

آنچه هنوز جست‌وجو می‌شود

در تاپیک‌های 2026-08، Zed در کنار Cursor و OpenCode در دستور‌العمل‌های «ویرایشگر را به یک دروازه سازگار با OpenAI وصل کنید» دیده می‌شود. این سایت هنوز صفحه‌ای برای Zed نداشت. این صفحه توضیح می‌دهد که نقطه پایانی سفارشی رسمی چگونه کار می‌کند و سپس پس از چسباندن QCode چه کاری انجام دهید.

گاه‌شمار

مستندات منتشرشده

صفحه Use API Access نقطه‌های پایانی سازگار با OpenAI را فهرست می‌کند. آن‌ها را در رابط کاربری (agent: open settings) یا زیر language_models.openai_compatible در settings.json اضافه کنید.

کلیدها کجا ذخیره می‌شوند

کلیدهایی که در رابط تنظیمات ذخیره می‌شوند به زنجیره کلید سیستم می‌روند. متغیرهای محیطی openai_compatible از شناسه ارائه‌دهنده ساخته می‌شوند (my-gateway → MY_GATEWAY_API_KEY). کلیدها را در settings.json قرار ندهید.

2026-08-30

این عبارت در این دریافت همچنان معتبر است. custom_headers می‌تواند سرآیندهای HTTP اضافه کند؛ سرآیندهایی که Zed مدیریت می‌کند (از جمله Authorization) در صورت تلاش برای بازنویسی، با یک هشدار نادیده گرفته می‌شوند.

موارد تأییدشده در برابر نکات احتیاطی

تأییدشده

Zed مستندات openai_compatible و anthropic_compatible را دارد: api_url سفارشی، شناسه مدل، پنجره زمینه. کلیدها از طریق رابط کاربری یا متغیر محیطی. openai_compatible به‌صورت پیش‌فرض tools: true دارد. مستندات در 2026-10-07 بازبینی شد.

نکات احتیاطی

به گفته مستندات رسمی: کلیدهای API را در settings.json قرار ندهید. custom_headers نمی‌تواند Authorization را بازنویسی کند. External Agents و Terminal Threads اغلب مدل‌ها را در خود عامل پیکربندی می‌کنند — مسیری متفاوت از قابلیت‌های هوش مصنوعی خود Zed.

کدام مسیر

openai_compatible (این صفحه)

از این مسیر زمانی استفاده کنید که Base URL سفارشی دارید. برای QCode مقدار https://api.qcode.cc/openai/v1 را وارد کنید و آن را فقط برای مدل‌های GPT و GLM / DeepSeek به کار ببرید؛ Claude از طریق anthropic_compatible (https://api.qcode.cc/api) می‌رود.

ارائه‌دهندگان رسمی

کلیدهای Anthropic / OpenAI / Google AI همچنان از بلوک‌های خودشان استفاده می‌کنند. اشتراک ChatGPT Plus یک کلید API نیست؛ مستندات رسمی اشتراک و دسترسی API را جدا کرده‌اند.

قدم بعدی

① Agent Settings را باز کنید (agent: open settings)، زیر LLM Providers روی Add Provider کلیک کنید و نام ارائه‌دهنده، API URL برابر https://api.qcode.cc/openai/v1، شناسه یک مدل GPT یا GLM / DeepSeek از /models (مثلاً gpt-6-sol، glm-5.3) و پنجره زمینه را پر کنید. ② برای Claude، دوباره روی Add Provider کلیک کنید و Anthropic را انتخاب کنید (anthropic_compatible در settings.json)، با API URL برابر https://api.qcode.cc/api، بدون /v1، و مدلی مانند claude-sonnet-5. ③ کلید API را در رابط تنظیمات یا در متغیر محیطی‌ای که Zed از نام ارائه‌دهنده می‌سازد وارد کنید (upper snake case به‌همراه _API_KEY) — هرگز در settings.json — سپس مدل را در پنل Agent انتخاب کنید. تغییر مدل یعنی تغییر شناسه.

در QCode

نقطه پایانی سازگار با OpenAI در QCode برابر https://api.qcode.cc/openai/v1 است و مدل‌های GPT و GLM / Kimi / DeepSeek / Qwen را ارائه می‌دهد؛ Claude فقط روی نقطه پایانی Anthropic یعنی https://api.qcode.cc/api اجرا می‌شود و اشتباه گرفتن آن‌ها خطای model_not_available_on_endpoint را برمی‌گرداند. یک کلید روی هر دو کار می‌کند. اینکه کدام شناسه‌های مدل کار می‌کنند به فهرست زنده /models بستگی دارد — این صفحه کاتالوگی را به‌عنوان همیشه‌فروش تثبیت نمی‌کند.

پرسش‌های متداول

آیا Zed می‌تواند با یک دروازه سفارشی سازگار با OpenAI ارتباط برقرار کند؟

بله. صفحه Use API Access بخشی برای نقطه‌های پایانی سازگار با OpenAI دارد. رابط کاربری یا settings.json.

api_url باید تا چه سطحی از مسیر را در بر بگیرد؟

در /openai/v1 توقف کنید: https://api.qcode.cc/openai/v1. خود Zed مسیر /chat/completions را اضافه می‌کند. برای Claude از طریق anthropic_compatible، از https://api.qcode.cc/api بدون /v1 استفاده کنید.

آیا می‌توانم کلید را در settings.json قرار دهم؟

مستندات رسمی می‌گویند خیر. از رابط کاربری تنظیمات (keychain) یا یک متغیر محیطی استفاده کنید.

آیا ChatGPT Plus به‌عنوان کلید API محسوب می‌شود؟

مستندات رسمی اشتراک‌های ChatGPT را از دسترسی API OpenAI جدا می‌کند. این صفحه مسیر کلید API / نقطه پایانی سازگار است.

آیا می‌توانم Authorization را با custom_headers بازنویسی کنم؟

مشاهده رسمی: هدرهای مدیریت‌شده توسط Zed، از جمله Authorization، در صورت تلاش برای بازنویسی آن‌ها با یک هشدار نادیده گرفته می‌شوند. این صفحه دستورالعمل دور زدن نیست.

شناسه‌های مدل از کجا می‌آیند؟

کاتالوگ زنده /models. شناسه را در available_models.name کپی کنید.

منابع

Zed Use API Access (zed.dev/docs/ai/use-api-access)، دریافت‌شده در 2026-08-30 و بازبینی‌شده در 2026-10-07. بخش‌ها: نقاط پایانی سازگار با OpenAI، نقاط پایانی سازگار با Anthropic، کلیدهای API و متغیرهای محیطی، هدرهای سفارشی. مقادیر نقاط پایانی QCode از صفحات Zed و endpoints در docs.qcode.cc پیروی می‌کنند (دریافت‌شده در 2026-10-07).

افزودن یک ارائه‌دهنده در Zed

GPT و GLM: openai_compatible + https://api.qcode.cc/openai/v1. Claude: anthropic_compatible + https://api.qcode.cc/api.

اول امتحان کنید، بعد تصمیم بگیرید

مطمئن نیستید کدام سطح را انتخاب کنید؟ با Starter ($9.00/ماه) شروع کنید و وقتی راضی بودید ارتقا دهید — ارزش استفاده‌نشده پلن قبلی به موجودی شما برمی‌گردد.