راه‌اندازی T3 Code با QCode.cc

اتصال T3 Code v0.1.7 به QCode.cc: تنظیم ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN روی یک نمونه Claude، افزودن یک مدل سفارشی و سپس بررسی.

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

آخرین بررسی: 2026-11-09 · 📄 طبق مستندات رسمی (T3 Code v0.1.7، منتشرشده در 2026-11-04؛ مستندات T3 Code روی شاخه main در 2026-11-09 خوانده شد)

نگاه کلی¶

کدام پروتکل¶

T3 Code خودش API مدل را فراخوانی نمی‌کند. در پرسش‌های متداول رسمی آمده است: «T3 Code از همان هارنس‌ها استفاده می‌کند. خودش هارنس نیست و بدون هارنس کار نمی‌کند.» برای Claude، هارنس همان Claude Code است، بنابراین QCode به همان شکلی وصل می‌شود که برای خود Claude Code انجام می‌شود: یک Base URL از نوع Anthropic Messages و یک کلید QCode.

پرسش‌های متداول رسمی به این پرسش که آیا می‌توانید به‌جای اشتراک از کلید API یا OpenRouter استفاده کنید پاسخ مثبت می‌دهد: در Settings یک نمونه ارائه‌دهنده دیگر اضافه کنید و کلیدها و نقطه پایانی مخصوص خودش را به آن بدهید؛ پیکربندی اشتراک شما دست‌نخورده می‌ماند.

مدل‌های Claude فقط روی پروتکل Anthropic کار می‌کنند، بنابراین Base URL به /api ختم می‌شود؛ خود Claude Code مسیر /v1/messages را اضافه می‌کند. / انتهایی اضافه نکنید. جدول کامل پروتکل‌ها در نقاط پایانی و مسیرهای API آمده است.

نصب¶

T3 Code به حداقل یک ارائه‌دهنده نیاز دارد که روی ماشینی که عامل‌ها را اجرا می‌کند نصب شده باشد. برای این راهنما، همان Claude Code است؛ ابتدا آن را با راهنمای نصب QCode نصب کنید. نمونه Claude که در بخش پیکربندی اضافه می‌کنید، با کلید QCode شما احراز هویت می‌شود.

سپس T3 Code را نصب کنید. فرمان‌های رسمی:

curl -fsSL https://t3.codes/install.sh | sh

در Windows، در PowerShell:

irm https://t3.codes/install.ps1 | iex

برای شروع سرور و باز کردن اپلیکیشن وب محلی، t3 را اجرا کنید. برای امتحان کردن یک‌بار بدون نصب، npx t3@latest را اجرا کنید. اپلیکیشن دسکتاپ نیز از انتشارهای GitHub یا یک مدیر بسته در دسترس است:

برای Mac‌های Intel فایل اجرایی t3 وجود ندارد؛ در آنجا از اپلیکیشن دسکتاپ استفاده کنید. سایر پلتفرم‌ها و اپلیکیشن‌های موبایل در راهنمای نصب رسمی فهرست شده‌اند.

پیکربندی¶

دستورالعمل رسمی برای روتری که از پروتکل Anthropic استفاده می‌کند، یک نمونه Claude جداگانه با پوشه پیکربندی مخصوص خود است. این مراحل آن را برای QCode اعمال می‌کنند.

راهنمای نصب رسمی می‌افزاید که هر نمونه ارائه‌دهنده می‌تواند متغیرهای محیطی خودش را داشته باشد، مانند کلیدهای API یا یک Base URL سفارشی، و اینکه T3 Code مقادیر علامت‌گذاری‌شده به‌عنوان حساس را پس از ذخیره نمایش نمی‌دهد.

1. «Settings > Providers» را باز کنید و یک نمونه Claude اضافه کنید. «Binary path» را روی claude نگه دارید. «CLAUDE_CONFIG_DIR path» را روی پوشه‌ای مخصوص خودش تنظیم کنید؛ مثال رسمی OpenRouter از ~/.claude_openrouter استفاده می‌کند، بنابراین نامی مانند ~/.claude_qcode از همان ایده پیروی می‌کند.
2. در «Environment variables» آن نمونه، اضافه کنید:

تخصیص‌های متغیر باید در «Environment variables» باشند، نه در «Launch arguments». 3. اگر آن پوشه پیکربندی Claude ورود ذخیره‌شده در کش Anthropic دارد، پیش از شروع، /logout را در یک نشست Claude Code که از همان پوشه استفاده می‌کند اجرا کنید. راهنمای رسمی هشدار می‌دهد که اعتبارنامه‌های ورود ذخیره‌شده در کش می‌توانند با توکن روتر تعارض داشته باشند. 4. مدل را در T3 Code انتخاب کنید. برای مدلی خارج از فهرست داخلی، آن نمونه Claude را در «Settings > Providers» باز کنید و شناسه کامل مدل آن را با «Add custom model» اضافه کنید، برای مثال claude-sonnet-5 از qcode.cc/models. سپس آن را در انتخاب‌گر مدل چت انتخاب کنید.

دو جزئیات از راهنمای رسمی: متغیرهای ANTHROPIC_DEFAULT_*_MODEL نام‌های مستعار Claude Code مانند sonnet را نگاشت می‌کنند؛ آن‌ها شناسه مدل صریح انتخاب‌شده در T3 Code را جایگزین نمی‌کنند. مدل‌های سفارشی ممکن است کنترل‌های تلاش، تفکر یا زمینه کمتری نسبت به مدل‌های داخلی داشته باشند.

همان کلید روی دامنه‌های دسترسی دیگر QCode (us.qcode.cc، asia.qcode.cc) کار می‌کند؛ میزبان را در ANTHROPIC_BASE_URL عوض کنید و مسیر /api را نگه دارید. به نقاط پایانی و مسیرهای API مراجعه کنید.

نمونه‌های Codex¶

راهنمای Codex در T3 Code ورود با ChatGPT یا با ورود موجود Codex CLI را پوشش می‌دهد. اینکه نمونه‌ای که از Codex نصب‌شده شما استفاده می‌کند پیکربندی خود را از کجا می‌خواند، در سورس T3 Code قابل مشاهده است (انتشار v0.1.7؛ شاخه main که در 2026-11-09 خوانده شد همان خطوط را دارد):

• برای نمونه‌ای که از Codex نصب‌شده استفاده می‌کند، T3 Code سرور اپلیکیشن Codex را راه‌اندازی می‌کند و CODEX_HOME را روی «CODEX_HOME path» که وارد کرده‌اید تنظیم می‌کند (apps/server/src/provider/CodexProvider.ts، خطوط 476–482). مثال خود راهنمای Codex در آنجا از ~/.codex استفاده می‌کند.
• شمای سرور اپلیکیشن Codex که در سورس همراه شده است، لایه پیکربندی کاربر را به‌صورت $CODEX_HOME/config.toml توصیف می‌کند (packages/effect-codex-app-server/src/_generated/schema.gen.ts، خط 19730).
• اتصالی که با ChatGPT در T3 Code برقرار می‌شود متفاوت است: T3 Code model_provider خودش را تنظیم می‌کند و OPENAI_BASE_URL را برای آن حذف می‌کند (apps/server/src/provider/CodexManagedRuntime.ts، خطوط 24–26 و 124)، بنابراین تنظیمات QCode در آنجا اعمال نمی‌شوند.

بنابراین، در T3 Code v0.1.7، نمونه Codex که از نصب موجود Codex شما استفاده می‌کند، config.toml پوشه خانه Codex خود را می‌خواند. ابتدا Codex را برای QCode همان‌طور که در راهنمای Codex توضیح داده شده راه‌اندازی کنید: ارائه‌دهنده qcode در ~/.codex/config.toml و کلید شما به‌عنوان OPENAI_API_KEY در ~/.codex/auth.json. سپس در «Settings > Providers»، یک نمونه Codex اضافه کنید، «Configure manually» را انتخاب کنید و ویزارد را کامل کنید؛ «CODEX_HOME path» آن نمونه را به پوشه‌ای اشاره دهید که این دو فایل را نگه می‌دارد (برای مثال ~/.codex). آن نمونه را از انتخاب‌گر مدل گفتگو انتخاب کنید.

بررسی¶

1. یک گفتگوی جدید آغاز کنید، نمونه Claude و مدل سفارشی را انتخاب کنید و پیام کوتاهی مانند ping بفرستید.
2. probe.qcode.cc را باز کنید، کلید QCode خود را وارد کنید و بررسی کنید که درخواست با مدلی که انتخاب کرده‌اید نمایش داده شود. این معادل QCode برای توصیه رسمی به تأیید مدل در داشبورد فعالیت روتر است.
3. برای آزمایش کلید و مسیر بدون T3 Code:

curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: YOUR_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"}]}'

عیب‌یابی¶

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

• T3 Code اعلام می‌کند که نرم‌افزاری در مراحل اولیه است: «ما در مراحل بسیار بسیار ابتدایی این پروژه هستیم. انتظار باگ داشته باشید.»
• پیکربندی روتر در راهنمای رسمی برای نمونه‌های Claude نوشته شده است؛ مدل‌های GPT از طریق نمونه Codex می‌روند، همان‌طور که در بخش نمونه‌های Codex در بالا توضیح داده شد.
• در اتصال از راه دور، T3 Code از پیکربندی Claude روی سرور متصل استفاده می‌کند، بنابراین نمونه را روی همان ماشین تنظیم کنید.

مرتبط¶

• نقاط پایانی و مسیرهای API — جدول پروتکل × خانواده مدل
• مروری بر سازگاری ابزارها — کدام ابزارها با کدام پروتکل صحبت می‌کنند
• Codex CLI — config.toml برای QCode
• DeepSeek Harness (dsh) — یک هارنس عامل با فرم API مدل سفارشی

سازمانی ←