اتصال Claude Code به گیسو؛ تنظیم و مدل‌ها

Q: آیا Claude Code با گیسو کار میکند؟

بله. گیسو Messages API را میپذیرد و Claude Code با تنظیم ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN به آن وصل میشود. ابزارهای فایل و ترمینال روی کامپیوتر خودتان اجرا میشوند.

Q: هزینه از کجا کم میشود؟

از اعتبار پیشپرداخت گیسو، نه از اشتراک Claude. شارژ با کارت بانکی ایرانی از ۵۰٬۰۰۰ سکه شروع میشود و اشتراک ماهانه ندارد.

Q: آیا گیسو همان Anthropic است؟

نه. گیسو برند مستقلی است و نمایندهٔ Anthropic نیست؛ مدلها را از راه API خودش در دسترس میگذارد و Claude Code را خود Anthropic میسازد.

Q: جستوجوی وب Claude Code کار میکند؟

ابزارهای سمت سرور Anthropic، مثل جستوجوی وب داخلی، از راه گیسو کار نمیکنند. سرورهای MCP محلی و ابزارهای روی کامپیوتر شما کار میکنند.

اتصال Claude Code به گیسو

Claude Code ابزار کدنویسی Anthropic در ترمینال است و گیسو Messages API آن را می‌پذیرد. با شش متغیر محیطی، Claude Code به‌جای حساب Anthropic از اعتبار گیسو استفاده می‌کند و هزینه به‌اندازهٔ مصرف از آن کم می‌شود. گیسو نمایندهٔ Anthropic نیست و مدل‌ها را از راه API خودش در اختیارتان می‌گذارد.

# Linux / macOS — this terminal only export ANTHROPIC_BASE_URL="https://gisoo.pro/api" export ANTHROPIC_AUTH_TOKEN="sk-gisoo-v1-..." export ANTHROPIC_MODEL="claude-sonnet-5-5" export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5-5" export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5" export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5" claude

# Windows PowerShell — this window only $env:ANTHROPIC_BASE_URL = "https://gisoo.pro/api" $env:ANTHROPIC_AUTH_TOKEN = "sk-gisoo-v1-..." $env:ANTHROPIC_MODEL = "claude-sonnet-5-5" $env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5-5" $env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5" $env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5" claude

{ "env": { "ANTHROPIC_BASE_URL": "https://gisoo.pro/api", "ANTHROPIC_AUTH_TOKEN": "sk-gisoo-v1-...", "ANTHROPIC_MODEL": "claude-sonnet-5-5", "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5", "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5" } }

خلاصهٔ مشخصات

نشانی (ANTHROPIC_BASE_URL): https://gisoo.pro/api (بدون /v1؛ برای سرورهای ایران: https://ir.gisoo.pro/api)
کلید (ANTHROPIC_AUTH_TOKEN): کلید گیسو از بخش API اپ
مدل اصلی: claude-sonnet-5-5
مدل سنگین‌تر: claude-opus-5-5
مدل سبک: claude-haiku-4-5
هزینه: از اعتبار پیش‌پرداخت گیسو؛ شارژ از ۵۰٬۰۰۰ سکه
محدودیت پیش‌فرض: ۶۰ درخواست در دقیقه برای هر کلید

اتصال در پنج قدم

۱

Claude Code را نصب کنید

با npm: npm install -g @anthropic-ai/claude-code (نیازمند Node.js 18 یا بالاتر). نصب از منبع خود Anthropic انجام می‌شود.
۲

کلید بسازید

در اپ گیسو، بخش API، یک کلید مخصوص Claude Code بسازید و برایش سقف هزینه بگذارید.
۳

متغیرها را بگذارید

یکی از سه نمونهٔ بالا را اجرا کنید یا آن‌ها را در ~/.claude/settings.json بنویسید تا برای همهٔ پروژه‌ها ثابت بماند.
۴

claude را اجرا کنید

در پوشهٔ پروژه دستور claude را بزنید و یک کار کوچک بدهید.
۵

مصرف را ببینید

هزینهٔ واقعی در گزارش مصرف پنل گیسو است، نه در فرمان /cost خود Claude Code.

انتخاب مدل

نقش	نام در Claude Code
مدل اصلی، کار روزمره	claude-sonnet-5-5
بازنویسی‌ها و کارهای سخت	claude-opus-5-5
کارهای جانبی و سریع	claude-haiku-4-5
آزمایش با هزینهٔ کم (غیر Claude)	deepseek-v4-flash

چه چیزی کار نمی‌کند

قابلیت	وضعیت
خواندن و ویرایش فایل، اجرای فرمان، جست‌وجو در پروژه	کار می‌کند؛ این ابزارها روی کامپیوتر شما اجرا می‌شوند
جست‌وجوی وب و ابزار کد سمت سرور Anthropic	کار نمی‌کند
MCP سمت سرور Anthropic	کار نمی‌کند؛ سرورهای MCP محلی کار می‌کنند
فکر کردن طولانی (thinking)	نادیده گرفته می‌شود

خطاها و راه‌حل

خطای 401 یعنی کلید اشتباه است یا فاصله و کاراکتر اضافه دارد. کلید را دوباره از اپ کپی کنید.

خطای 404 معمولاً از /v1 اضافه در ANTHROPIC_BASE_URL می‌آید؛ برای Claude Code نشانی باید بدون /v1 باشد.

اگر پاسخ خطای کمبود اعتبار بود، موجودی برای نگه‌داشتن هزینهٔ درخواست کافی نیست. حساب را شارژ کنید یا سقف خروجی را کمتر بگیرید.

خطای 429 یعنی از سقف ۶۰ درخواست در دقیقهٔ کلید گذشته‌اید. کمی صبر کنید یا از پشتیبانی بخواهید سقف را بالا ببرند.

اگر از سرور داخل ایران کار می‌کنید و اتصال کند است، نشانی را روی https://ir.gisoo.pro/api بگذارید.

محدودیت‌ها

Claude Code در هر قدم کل زمینه را می‌فرستد؛ یک کار متوسط ده‌ها درخواست با ورودی بلند است. برای کلیدش سقف هزینه بگذارید و مصرف روز اول را زیر نظر بگیرید.

پیش از تأیید هویت، سقف مصرف حساب ۲ دلار است.

راهنمای فنی کامل این اتصال، از جمله جدول متغیرها، در مستندات Claude Code آمده است.

راهنمای فنی کامل: Claude Code با گیسو · سازگاری با Anthropic

پرسش‌های پرتکرار

آیا Claude Code با گیسو کار می‌کند؟

بله. گیسو Messages API را می‌پذیرد و Claude Code با تنظیم ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN به آن وصل می‌شود. ابزارهای فایل و ترمینال روی کامپیوتر خودتان اجرا می‌شوند.

هزینه از کجا کم می‌شود؟

از اعتبار پیش‌پرداخت گیسو، نه از اشتراک Claude. شارژ با کارت بانکی ایرانی از ۵۰٬۰۰۰ سکه شروع می‌شود و اشتراک ماهانه ندارد.

آیا گیسو همان Anthropic است؟

نه. گیسو برند مستقلی است و نمایندهٔ Anthropic نیست؛ مدل‌ها را از راه API خودش در دسترس می‌گذارد و Claude Code را خود Anthropic می‌سازد.

نشانی را با /v1 بنویسم یا بدون آن؟

بدون /v1: https://gisoo.pro/api. Claude Code خودش مسیر /v1/messages را اضافه می‌کند.

می‌توانم مدل غیر Claude را در Claude Code بگذارم؟

بله، فقط با نام مدل در ANTHROPIC_MODEL. اما Claude Code برای Claude ساخته شده و مدل‌های دیگر ابزارهایش را با دقت کمتری به کار می‌برند؛ پیش از کار جدی روی یک کار کوچک امتحانشان کنید.

جست‌وجوی وب Claude Code کار می‌کند؟

ابزارهای سمت سرور Anthropic، مثل جست‌وجوی وب داخلی، از راه گیسو کار نمی‌کنند. سرورهای MCP محلی و ابزارهای روی کامپیوتر شما کار می‌کنند.

از Cursor و Cline هم می‌شود استفاده کرد؟

بله، با نشانی OpenAI-سازگار گیسو. راهنمای هر دو در مستندات گیسو هست.