T3 Code چیست؟ چگونه از کلید API خودتان استفاده کنید (نوامبر 2026)
تا 2026-11-09، T3 Code به گفته README خودش یک «سطح کنترل هارنس عامل» است: برنامه‌ای برای دسکتاپ، وب و موبایل که عامل‌های کدنویسی مانند Claude Code و Codex را که از قبل روی ماشین شما نصب شده‌اند کنترل میکند. این پروژه متنباز با مجوز MIT است و آخرین انتشار آن در GitHub نسخه v0.1.7 (2026-11-04) است. برای اجرای آن با کلید API خودتان، در Settings > Providers یک نمونه Claude جداگانه اضافه کنید و ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN را در بخش متغیرهای محیطی آن تنظیم کنید؛ در QCode این مقدار https://api.qcode.cc/api و کلید cr_ شماست.
به‌روزرسانی شده 2026-11-14
این ابزار را به نقطه پایانی QCode متصل کنید — یک کلید برای Claude، GPT و مدل‌های چینی.
- صورتحساب بهازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- به‌صورت خودخدمت: شارژ حساب و فعال‌سازی فوری
چهار نکته از منابع رسمی
متنباز تحت مجوز MIT
مخزن pingdotgg/t3code مجوز MIT License و Copyright (c) 2026 T3 Tools Inc. را دارد. README می‌افزاید: «ما در این پروژه خیلی خیلی در ابتدای کار هستیم. انتظار باگ داشته باشید.»
آخرین انتشار: 2026-11-04
GitHub نسخه v0.1.7 را که در 2026-11-04 منتشر شده، به‌عنوان آخرین انتشار علامت‌گذاری میکند. بیلدهای Nightly به‌عنوان پیش‌انتشار منتشر می‌شوند، برای مثال v0.1.8-nightly.20261109.4399 در 2026-11-09.
عامل‌هایی که خودتان همراه می‌آورید
جدول ارائه‌دهندگان در راهنمای نصب شامل Codex، Claude، Cursor، Grok Build، Kiro، OpenCode، Antigravity، Pi، Muse Code و fx است. T3 Code رابط است؛ عاملی که نصب میکنید کار را انجام میدهد.
نقطه پایانی خودتان در یک نمونه Claude قرار میگیرد
در متغیرهای محیطی یک نمونه Claude: ANTHROPIC_BASE_URL، ANTHROPIC_AUTH_TOKEN (با برچسب Sensitive) و ANTHROPIC_API_KEY که صراحتاً خالی است. مثال رسمی از OpenRouter استفاده میکند؛ مراحل زیر از همان سه متغیر برای QCode استفاده می‌کنند.
T3 Code چیست؟
تا 2026-11-09، README مربوط به T3 Code آن را «سطح کنترل هارنس عامل» توصیف میکند که عامل‌های روی ماشین شما را از طریق برنامه موبایل (iOS و Android)، برنامه وب و برنامه دسکتاپ مبتنی بر Electron کنترل میکند. وب‌سایت رسمی آن را «لایه کنترل متنباز برای عامل‌های کدنویسی» می‌نامد. پرسشهای متداول این تفکیک را توضیح میدهد: «T3 Code از همان هارنس‌ها استفاده میکند. این خودش هارنس نیست و بدون یک هارنس کار نمیکند.» Claude Code، Codex و سایر عامل‌ها فراخوانی مدل را انجام می‌دهند و ابزارها را اجرا می‌کنند؛ T3 Code جایی است که تردها را شروع میکنید، یک عامل انتخاب میکنید و از دستگاه‌های دیگر به ماشین خود دسترسی پیدا میکنید. پیش از شروع یک ترد، حداقل یک عامل را نصب کنید و در آن وارد شوید. پرسشهای متداول هزینه T3 Code را «هیچ» اعلام میکند: شما اشتراک یا کلید خودتان را می‌آورید و مانند قبل به ارائهدهنده خود پرداخت میکنید.
2026-11-04: v0.1.7 آخرین انتشار است
GitHub نسخه v0.1.7 را که در 2026-11-04 منتشر شده، به‌عنوان آخرین انتشار T3 Code فهرست میکند. پیشانتشارهای Nightly جداگانه منتشر می‌شوند؛ v0.1.8-nightly.20261109.4399 در 2026-11-09 منتشر شد. راهنمای نصب میگوید برای نصب کانال Nightly مقدار T3CODE_CHANNEL=nightly را تنظیم کنید، یا برای تثبیت یک نسخه دقیق، T3CODE_VERSION را تنظیم کنید.
خط زمانی
مخزن pingdotgg/t3code در GitHub ایجاد شد.
v0.1.7 به‌عنوان آخرین انتشار منتشر شد.
بررسی‌شده: README، راهنمای نصب، پرسشهای متداول و راهنماهای Claude و Codex در شاخه main؛ نسخه Nightly با شماره v0.1.8-nightly.20261109.4399 منتشر شده است.
آنچه T3 Code مستند میکند و آنچه باز می‌گذارد
مستندشده توسط T3 Code
① پیش از شروع یک ترد به یک ارائهدهنده نصب‌شده و احراز هویت‌شده نیاز دارید؛ می‌توانید T3 Code را اجرا کنید و ارائه‌دهندگان را بعداً پیکربندی کنید. ② مقادیر محرمانه در متغیرهای محیطی یک نمونه را می‌توان حساس علامت‌گذاری کرد؛ پس از ذخیره، T3 Code مقادیر اصلی آنها را نمایش نمی‌دهد. ③ برای OpenRouter و سایر روترها، راهنمای Claude از یک نمونه Claude جداگانه با پوشه پیکربندی مختص خود استفاده میکند و متغیرهای نقطه پایانی و اعتبارنامه را در بخش Environment variables همان نمونه قرار میدهد. ④ تخصیص متغیرها نباید در Launch arguments قرار گیرد. ⑤ متغیرهای ANTHROPIC_DEFAULT_*_MODEL نام‌های مستعار Claude Code مانند sonnet را نگاشت می‌کنند؛ آنها جایگزین شناسه مدل صریح انتخاب‌شده در T3 Code نمی‌شوند. ⑥ مدل‌های سفارشی ممکن است کنترل‌های کمتری برای تلاش، تفکر یا زمینه نسبت به مدل‌های داخلی داشته باشند. ⑦ در اتصال راه دور، T3 Code از پیکربندی Claude روی سرور متصل استفاده میکند. ⑧ کد و promptهای شما از ماشین شما به ارائهدهنده شما می‌روند، نه به سرورهای T3؛ رویدادهای پایه مصرف محصول را می‌توان با T3CODE_TELEMETRY_ENABLED=false خاموش کرد.
آنچه منابع رسمی باز می‌گذارند
تا 2026-11-09: ① فهرست‌های عامل‌ها از صفحه‌ای به صفحه دیگر متفاوت است. README از Claude Code، Codex، Cursor، Grok Build، OpenCode، Google Antigravity و fx نام می‌برد؛ پرسشهای متداول از Pi و Muse Code نام می‌برد اما از fx نام نمی‌برد؛ جدول ارائه‌دهندگان در راهنمای نصب طولانی‌ترین است و Kiro را هم فهرست میکند. ② پرسشهای متداول T3 Code میگوید T3 Code از طریق Agent SDK شرکت Anthropic، Claude را هدایت میکند و این کار محدودیت‌های 5 ساعته Claude را سریع‌تر از استفاده مستقیم از Claude Code مصرف میکند، بدون آن‌که بر سقف‌های هفتگی تأثیر بگذارد؛ میگوید این موضوع به Anthropic گزارش شده است و هیچ تاریخی برای رفع آن ارائه نمی‌دهد. ③ جدیدترین انتشار‌های GitHub پیشانتشارهای nightly نسخه v0.1.8 هستند؛ v0.1.7 هنوز آخرین انتشار پایدار است و مستندات هیچ تاریخی برای انتشار بعدی نمی‌دهند.
دو روش برای ورود
از ورود Claude Code خودتان استفاده کنید
پرسشهای متداول رسمی به این پرسش که «آیا میتوانم از T3 Code با اشتراک Claude Code خود استفاده کنم؟» چنین پاسخ میدهد: «بله.» Claude Code را نصب کنید، claude auth login را اجرا کنید، سپس ارائهدهنده را در Settings > Providers فعال کنید.
از کلید API خودتان استفاده کنید
در Settings نمونه ارائهدهنده دیگری اضافه کنید و کلیدها و نقطه پایانی خودش را به آن بدهید. هر نمونه می‌تواند متغیرهای محیطی خودش را داشته باشد، مانند کلیدهای API یا یک Base URL سفارشی، و ورود موجود شما دستنخورده میماند. مراحل Claude در بخش بعدی آمده است.
چگونه T3 Code را با کلید API خودتان اجرا کنید
① Claude Code را نصب کنید، سپس T3 Code را: اپ دسکتاپ (در Windows با winget install T3Tools.T3Code، در macOS با brew install --cask t3-code) یا خط فرمان با curl -fsSL https://t3.codes/install.sh | sh (در Windows PowerShell: irm https://t3.codes/install.ps1 | iex)، سپس t3 را اجرا کنید. Macهای Intel فایل اجرایی t3 ندارند، پس در آن‌جا از اپ دسکتاپ استفاده کنید. ② در Settings > Providers یک نمونه Claude اضافه کنید، Binary path را روی claude نگه دارید و مسیر CLAUDE_CONFIG_DIR مخصوص خودش را به آن بدهید؛ مثال رسمی ~/.claude_openrouter است، بنابراین ~/.claude_qcode از همان ایده پیروی میکند. ③ در بخش Environment variables همان نمونه، ANTHROPIC_BASE_URL را روی https://api.qcode.cc/api، ANTHROPIC_AUTH_TOKEN را روی کلید QCode خود (با برچسب Sensitive) و ANTHROPIC_API_KEY را روی مقدار بهصراحت خالی تنظیم کنید. ④ اگر آن پوشه تنظیمات ورود ذخیره‌شده‌ای داشته باشد، در یک نشست Claude Code که از آن استفاده میکند، /logout را اجرا کنید. ⑤ برای مدلی خارج از فهرست داخلی، شناسه کامل آن را با Add custom model اضافه کنید، برای مثال claude-sonnet-5، و آن را در انتخاب‌گر مدل چت انتخاب کنید.
اجرای T3 Code با کلید API QCode
در تاریخ 2026-11-09، QCode مدل‌های Claude را روی پروتکل Anthropic ارائه میدهد، با محاسبه صورتحساب بهازای هر توکن و نرخ هر مدل در /models، که claude-sonnet-5 و claude-opus-5 در آن فهرست شده‌اند؛ مستندات QCode می‌گویند خانواده‌های GLM، Kimi، DeepSeek و Qwen روی همان نقطه پایانی Anthropic کار می‌کنند و شناسه‌های آنها هم در /models فهرست شده‌اند. سه مرحله: ① ثبت‌نام کنید و حساب کاربری خود را شارژ کنید (Alipay، WeChat Pay، کارت‌ها، رمزارز و موارد دیگر)؛ ② یک پلن شخصی یا یک بسته پرداخت بهازای مصرف بخرید و کلید API خود را که با cr_ شروع میشود کپی کنید؛ ③ کلید و Base URL را همان‌طور که بالا گفتیم در نمونه Claude در T3 Code قرار دهید؛ مقاله مستندات QCode در https://docs.qcode.cc/en/docs/ide/t3code همان راه‌اندازی را گام‌به‌گام توضیح میدهد. برای پلن ماهانه آماده نیستید؟ بسته‌های پرداخت بهازای مصرف برای سهمیه یک‌باره‌ای که ظرف 7 روز استفاده میکنید، از $4 آغاز می‌شوند؛ اگر از قبل پلن شخصی دارید، هر زمان به سهمیه بیشتری نیاز داشتید، یک بسته تقویتی اضافه کنید.
پرسشهای متداول
T3 Code چقدر هزینه دارد؟
پرسشهای متداول رسمی چنین پاسخ میدهد: «هیچ چیز.» T3 Code متنباز است (MIT) و شما اشتراک یا کلید خودتان را فراهم میکنید؛ هنوز هم مانند گذشته به ارائهدهنده خود پرداخت میکنید. با یک کلید QCode، مصرف بهازای هر توکن و با نرخ هر مدل در /models صورتحساب میشود.
آیا میتوانم از T3 Code بدون اشتراک Claude استفاده کنم؟
بله. پرسشهای متداول رسمی میگوید در Settings نمونه ارائهدهنده دیگری اضافه کنید و کلیدها و نقطه پایانی خودش را به آن بدهید. برای QCode، این یعنی یک نمونه Claude با Base URL مربوط به QCode در ANTHROPIC_BASE_URL، کلید cr_ شما در ANTHROPIC_AUTH_TOKEN و ANTHROPIC_API_KEY که بهصراحت خالی گذاشته میشود، مانند مراحل بالا. ورود موجود شما دستنخورده میماند.
آیا T3 Code جای Claude Code یا Codex را میگیرد؟
نه. پرسشهای متداول رسمی میگوید: «T3 Code از همان harnessها استفاده میکند. خودش یک harness نیست و بدون یکی از آنها کار نمیکند.» حداقل یک عامل، مانند Claude Code، را نصب کنید و وارد آن شوید، سپس از T3 Code برای اجرا و کنترل آن استفاده کنید.
چگونه ANTHROPIC_BASE_URL را در T3 Code تنظیم کنم؟
Settings > Providers را باز کنید، نمونه Claude را انتخاب کنید و متغیر را زیر Environment variables اضافه کنید؛ تخصیص متغیرها در Launch arguments قرار نمی‌گیرد. برای QCode مقدار https://api.qcode.cc/api است که بدون اسلش انتهایی نوشته میشود. همان کلید روی us.qcode.cc و asia.qcode.cc هم کار میکند، برای مثال https://asia.qcode.cc/api.
چرا ارائهدهنده یا مدل سفارشی من در T3 Code نمایش داده نمیشود؟
پرسشهای متداول رسمی میگوید CLI تقریباً همیشه روی ماشینی که سرور را اجرا میکند نصب نیست یا در PATH آن قرار ندارد؛ ابتدا همانجا وارد شوید، یا در تنظیمات ارائهدهنده Binary path را به مسیر همان CLI تنظیم کنید. برای مدل سفارشی، شناسه کامل آن را با Add custom model اضافه کنید. اگر کلید شما درست است اما ورود همچنان ناموفق میماند، در یک نشست Claude Code که از همان پوشه پیکربندی استفاده میکند /logout را اجرا کنید، زیرا اعتبارنامههای ورود کششده میتوانند با توکن تعارض داشته باشند.
آیا میتوانم در T3 Code از GPT یا Codex با کلید API خودم استفاده کنم؟
برای Codex، بله: از یک نمونه Codex استفاده کنید که Codex نصب‌شده شما را با پیکربندی QCode آن اجرا میکند؛ مدل‌های GPT از نمونه Claude عبور نمی‌کنند، زیرا QCode آنها را روی نقاط پایانی OpenAI خود ارائه میدهد. راهنمای Codex در T3 Code ورود با ChatGPT و ورود موجود Codex را پوشش میدهد. در سورس T3 Code (شاخه main، خوانده‌شده در 2026-11-09)، چنین نمونه‌ای مسیر CODEX_HOME خود را به Codex میدهد و شمای app-server همراه Codex لایه پیکربندی کاربر را به‌صورت $CODEX_HOME/config.toml توصیف میکند. بنابراین ~/.codex/config.toml و auth.json را مانند صفحه Codex در QCode تنظیم کنید (base_url = "https://api.qcode.cc/openai"، wire_api = "responses")، سپس با Configure manually یک نمونه Codex اضافه کنید. اتصال ChatGPT درون T3 Code جداست: model_provider خودش را تنظیم میکند و OPENAI_BASE_URL را حذف میکند. نسخه فعلی T3 Code حرف آخر را می‌زند.
منابع
README، راهنمای نصب، پرسشهای متداول، راهنماهای Claude و Codex، LICENSE و فایل‌های سورس T3 Code در مخزن pingdotgg/t3code در GitHub (شاخه main)، GitHub Releases API و سایت t3.codes، همه خوانده‌شده در 2026-11-09. QCode: qcode.cc/models، qcode.cc/pricing و صفحه‌های Endpoints & API Paths، Installation و Codex در docs.qcode.cc، بازیابی‌شده در 2026-11-09.
T3 Code را با کلید خودتان اجرا کنید
یک کلید API QCode برای Claude Code، Codex و موارد دیگر، با محاسبه هزینه بهازای توکن؛ نرخ هر مدل در /models آمده است.
مطالب مرتبط
بسته‌های پرداخت بهازای مصرف
بسته‌های سهمیه یک‌باره معتبر به مدت 7 روز، بدون اشتراک؛ نرخ هر مدل در /models آمده است.
Claude Code بدون اشتراک Claude
Claude Code را با یک کلید API و ANTHROPIC_AUTH_TOKEN اجرا کنید؛ نیازی به اشتراک Claude نیست.
جایگزین‌های Cursor در 2026
یک IDE دیگر، یک عامل ترمینالی مانند Claude Code یا Codex CLI، یا مدل‌های چینی، هرکدام با کلید API خودتان.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
مطالب این صفحه در 2026-11-09 با مخزن و سایت T3 Code بررسی شده است؛ صفحه‌های رسمی اولویت دارند. T3 Code نرم‌افزاری در مراحل اولیه است که بیلدهای شبانه منتشر میکند، بنابراین نام منوها و گزینه‌ها تابع نسخه‌ای است که نصب میکنید. موجود بودن مدل‌های QCode تابع /models است.