متغیرهای محیطی Claude Code (2026)

تنظیم ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN برای Claude Code روی QCode.cc، مشاهده تفاوت ANTHROPIC_API_KEY، به‌همراه تنظیمات هر ابزار و راستی‌آزمایی.

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

آخرین راستی‌آزمایی: 2026-10-26 · 📄 بر اساس مستندات رسمی (Claude Code v2.1.310، منتشرشده در 2026-10-23؛ تعریف‌های ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN / ANTHROPIC_API_KEY در 2026-10-26 دوباره با صفحات رسمی متغیرهای محیطی و دروازه بررسی شدند)

⚡ هنوز راه‌اندازی نکرده‌اید؟ یک فرمان همه کار را انجام می‌دهد: curl -fsSL https://qcode.cc/install/claude-code.sh | bash (Windows: irm https://qcode.cc/install/claude-code.ps1 | iex). به اسکریپت راه‌اندازی یک‌کلیکی مراجعه کنید.

تقریباً هر ابزار کدنویسی با هوش مصنوعی از متغیرهای محیطی استفاده می‌کند تا تصمیم بگیرد «به کدام سرویس متصل شود و از کدام کلید استفاده کند.» این دو قطعه اطلاعات را به QCode.cc معطوف کنید تا ابزار شما درخواست‌ها را به ما ارسال کند. این صفحه توضیح می‌دهد کدام متغیرها را تنظیم کنید، آن‌ها را کجا تنظیم کنید و چگونه راستی‌آزمایی کنید.

📖 مطمئن نیستید که BASE_URL باید به /api ختم شود یا پیشوند دیگری؟ کدام یک از دامنه‌های دسترسی را انتخاب کنید؟ با نقاط پایانی و مسیرهای API شروع کنید. هنوز ابزارهایتان را نصب نکرده‌اید؟ به نصب مراجعه کنید.

1. دو متغیر اصلی (Claude Code و Anthropic SDK)¶

اتصال به خانواده مدل‌های Claude فقط به دو متغیر محیطی نیاز دارد:

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_key"

• ANTHROPIC_BASE_URL — آدرس دسترسی که به پیشوند /api ختم می‌شود. SDK به‌طور خودکار /v1/messages را اضافه می‌کند.
• ANTHROPIC_AUTH_TOKEN — کلید QCode.cc شما که با cr_ شروع می‌شود و در داشبورد QCode.cc ایجاد می‌شود.

درباره AUTH_TOKEN: این قرارداد داخلی برای کلید رله است — کلید رله همیشه در ANTHROPIC_AUTH_TOKEN قرار می‌گیرد (نه در ANTHROPIC_API_KEY که همان متغیری است که API رسمی Anthropic به کار می‌برد). Claude Code آن را به‌صورت توکن Bearer ارسال می‌کند. اگر ابزار شما فقط ANTHROPIC_API_KEY را می‌شناسد، قرار دادن همان کلید cr_ در آن هم کار می‌کند.

⚠️ بدون اسلش انتهایی: از https://api.qcode.cc/api استفاده کنید، نه https://api.qcode.cc/api/. SDK مسیر /v1/messages را اضافه می‌کند، بنابراین یک اسلش اضافی به //v1/messages تبدیل می‌شود و 404 برمی‌گرداند.

این دو متغیر هم برای Claude Code و هم برای SDKهای رسمی Anthropic (Python / TypeScript) کار می‌کنند — SDK نیز ANTHROPIC_BASE_URL را می‌خواند، یا می‌توانید هنگام ساخت کلاینت base_url= را ارسال کنید.

2. جدول هر ابزار¶

ابزارهای مختلف متغیرهای محیطی متفاوتی را می‌خوانند. مورد خود را در جدول زیر پیدا کنید:

چند نکته:

• Codex CLI برای یافتن نقطه پایانی، OPENAI_BASE_URL را نمی‌خواند؛ بلکه از base_url در فایل پیکربندی ~/.codex استفاده می‌کند (که به /openai ختم می‌شود و از پروتکل OpenAI Responses استفاده می‌کند). برای نحو دقیق به نقاط پایانی و مسیرهای API مراجعه کنید.
• ابزارهای سازگار با OpenAI (SDK رسمی OpenAI، LangChain، کلاینت‌های عمومی) OPENAI_BASE_URL و OPENAI_API_KEY را می‌خوانند، و base به /openai/v1 ختم می‌شود.
• Gemini / Antigravity (QCode فعلاً Gemini را ارائه نمی‌دهد؛ فقط برای مرجع پروتکل): base به /gemini ختم می‌شود؛ خود SDK مسیر /v1beta/ را اضافه می‌کند. همان کلید cr_ کار می‌کند.

یک کلید در همه پروتکل‌ها کار می‌کند: کلید cr_ شما مستقل از پروتکل است — /api متعلق به Anthropic و /openai/v1 متعلق به OpenAI است. تغییر ابزار فقط یعنی تغییر BASE_URL؛ کلید همان می‌ماند. QCode فعلاً مدل‌های Gemini را ارائه نمی‌دهد.

مدل‌های در دسترس¶

پس از اتصال، بر اساس پروتکل ابزار خود یک نام مدل انتخاب کنید (جزئیات بیشتر در نقاط پایانی و مسیرهای API):

• مدل‌های Claude (پیش‌فرض روزانه خط 5 است): claude-sonnet-5 (1M، متعادل)، claude-opus-5 (1M، پرچم‌دار کنونی)، claude-fable-5 (1M، رده برتر)، claude-sonnet-4-6 / claude-opus-4-8 / claude-opus-4-7 (نسل قبل، همچنان در فروش)، claude-haiku-5-5 (1M، سریع‌ترین)
• خانواده GPT: gpt-6.1-sol (توصیه‌شده)، gpt-6-sol، gpt-5.6-terra، gpt-5.6-sol
• خانواده Gemini: QCode فعلاً آن را ارائه نمی‌دهد؛ لطفاً از Claude، GPT یا مدل‌های چینی استفاده کنید
• خانواده چینی (GLM / Kimi / DeepSeek / Qwen): glm-5.3، kimi-k3، deepseek-v4-pro، qwen3.8-max و مدل‌های هم‌خانواده — به مدل‌های خانواده چینی مراجعه کنید
• تصویر: gpt-image-2 (نقطه پایانی https://api.qcode.cc/qcode-img/v1)

طول زمینه Claude Code: Claude Code به‌طور پیش‌فرض از پنجره 200K استفاده می‌کند؛ زمینه 1M به‌صورت انتخابی توسط claude-opus-5، claude-sonnet-5، claude-fable-5، claude-opus-4-8 و claude-sonnet-4-6 پشتیبانی می‌شود.

3. محل تنظیم آن‌ها¶

اینکه یک متغیر محیطی را کجا تنظیم می‌کنید، دامنه اثر آن را مشخص می‌کند. سه رویکرد رایج:

① فایل rc شل (پایدار، سراسری) — آن را در ~/.zshrc (macOS / zsh) یا ~/.bashrc (Linux / bash) بنویسید تا هر ترمینال جدید به‌طور خودکار آن را بخواند:

echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="cr_your_key"' >> ~/.zshrc
source ~/.zshrc

کاربران bash باید ~/.zshrc را با ~/.bashrc جایگزین کنند.

② فایل .env پروژه (پایدار، مخصوص هر پروژه) — یک فایل .env در ریشه پروژه قرار دهید؛ فقط به همان پروژه اعمال می‌شود و برای استفاده از کلیدهای متفاوت در هر پروژه مناسب است:

ANTHROPIC_BASE_URL=https://api.qcode.cc/api
ANTHROPIC_AUTH_TOKEN=cr_your_key

فایل .env کلید شما را در خود دارد — یادتان باشد آن را به .gitignore اضافه کنید و هرگز آن را کامیت نکنید.

③ تنظیمات خود ابزار (مخصوص هر ابزار) — برخی ابزارها فایل پیکربندی یا رابط کاربری خود را دارند، مثلاً ~/.codex در Codex CLI، یا پنل تنظیمات یک افزونه ویرایشگر. چنین تنظیماتی فقط روی همان ابزار اعمال می‌شود.

پایدار در برابر هر جلسه: هر سه روش بالا پایدار هستند. اگر می‌خواهید چیزی را فقط در جلسه فعلی ترمینال امتحان کنید، کافی است export (macOS/Linux) یا $env: (Windows PowerShell) را اجرا کنید — با بستن ترمینال از بین می‌رود:

# macOS / Linux, per-session
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_key"

# Windows PowerShell, per-session
$env:ANTHROPIC_BASE_URL = "https://api.qcode.cc/api"
$env:ANTHROPIC_AUTH_TOKEN = "cr_your_key"

نکته اولویت: متغیرهای محیطی که هنگام راه‌اندازی فرایند خوانده می‌شوند بر فایل‌های پیکربندی اولویت دارند. پس از ویرایش فایل rc شل، یادتان باشد آن را source کنید یا ترمینال جدیدی باز کنید؛ وقتی یک متغیر در چند جا تنظیم شده باشد، مقداری که فرایند واقعاً به ارث می‌برد ملاک است.

4. 🇨🇳 نکته‌ای برای کاربران چین¶

کاربران سرزمین اصلی چین باید میزبان BASE_URL را از api.qcode.cc به asia.qcode.cc تغییر دهند (نود آسیا، نزدیک‌ترین از میان کره / تایوان / هنگ‌کنگ، از نظر جغرافیایی نزدیک‌ترین):

export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_key"

همین موضوع برای سایر پروتکل‌ها هم صادق است: ابزارهای سازگار با OpenAI از https://asia.qcode.cc/openai/v1 استفاده می‌کنند و Codex از https://asia.qcode.cc/openai. هر سه دامنه دسترسی قابلیت‌های یکسانی ارائه می‌دهند؛ همان کلید در همه آن‌ها کار می‌کند، بنابراین اگر asia ناپایدار بود به api.qcode.cc (مسیریابی جهانی Route 53) برگردید. به نقاط پایانی و مسیرهای API مراجعه کنید.

5. بررسی¶

پس از تنظیم متغیرها، ابتدا درستی مقادیر را بررسی کنید:

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

سپس با curl بررسی کنید که نشانی دسترسی قابل دسترس است (بدون کلید — فقط برای آزمودن مسیر و شبکه):

curl -s -o /dev/null -w '%{http_code}' \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  https://api.qcode.cc/v1/models
# → 200 = network, path and key all good

تفسیر: 200 یعنی شبکه، نقطه پایانی و کلید همه درست تنظیم شده‌اند. 401 یعنی کلید نامعتبر است یا درست ارسال نشده (بررسی کنید پیشوند cr_ به‌طور کامل کپی شده باشد)؛ 404 معمولاً یعنی پیشوند مسیر اشتباه است. توجه: دسترسی به نقطه پایانی بدون کلید به‌جای خطا، یک صفحه معرفی HTML (HTTP 200) برمی‌گرداند — اگر آن صفحه را دیدید، کلید شما پیوست نشده است. خودآزمایی‌های کامل curl: نقاط پایانی و مسیرهای API.

یک آزمون سرتاسری با کلید واقعی خود اجرا کنید:

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

یک پاسخ JSON عادی یعنی متغیرهای محیطی شما تنظیم شده‌اند و آماده شروع هستید.

می‌خواهید مدل، طول زمینه و مصرف هر درخواست را ببینید؟ هر دامنه دسترسی به probe.qcode.cc گزارش می‌دهد — کلید cr_ خود را وارد کنید تا آن‌ها را ببینید.

6. متغیرهای مرتبط با دروازه¶

وقتی Claude Code با یک دروازه شخص ثالث (شامل QCode) صحبت می‌کند، این متغیرهای رسمی اهمیت دارند. تعاریف از مرجع متغیرهای محیطی و راهنمای اتصال به دروازه (بررسی‌شده در 2026-10-26):

💡 هنوز کلید ندارید؟ نحوه انتخاب پلن را ببینید، سپس کلید cr_ خود را در داشبورد دریافت کنید؛ کلید در هر گزینه‌ای که انتخاب کنید یکسان کار می‌کند. نرخ‌های هر مدل در qcode.cc/models است.

سازمانی ←