یک کنترلر شلوغ دارید که باید بازنویسی شود و دو تست هم قرمز مانده‌اند. Claude Code، ابزار برنامه‌نویسی Anthropic، می‌تواند کل پروژه را بخواند، تغییر را پیشنهاد بدهد و تست‌ها را اجرا کند. ولی برای حساب Anthropic کارت ارزی لازم است. با یک کلید دسترسی (API Key) از وبسرویس گیسو، همین Claude Code در VS Code با مدل‌های Claude کار میکند. اعتبار را با کارت بانکی خودتان می‌خرید و هزینهٔ هر درخواست بهاندازهٔ مصرف از آن کم میشود. راه‌اندازی‌اش حدود ۱۵ دقیقه وقت می‌گیرد.
وبسرویس گیسو در یک نگاه
با یک کلید به مدل‌های چند سازنده دسترسی دارید: Claude از Anthropic، GPT از OpenAI، Gemini از گوگل، DeepSeek و بقیه. گیسو نمایندهٔ هیچ‌کدام از این شرکت‌ها نیست. وبسرویس گیسو دو قالب را با همان کلید می‌پذیرد: قالب سازگار با OpenAI برای گفت‌وگو، تصویر، صدا، ویدیو و موسیقی، و قالب پیام‌های Anthropic که زبان Claude Code است. اشتراک ماهانهای در کار نیست و هزینهٔ هر درخواست از اعتبار هوش مصنوعی حساب شما کم میشود. برای هر کلید می‌توانید سقف هزینه بگذارید و مدل، توکن و هزینهٔ هر درخواست را در اپ می‌بینید. متن درخواستها و پاسخ‌ها، از جمله کدی که Claude Code میفرستد، در گیسو ذخیره نمی‌شود و فقط مشخصات هر درخواست می‌ماند. ولی این متن به سرویس‌دهندهٔ همان مدل می‌رسد و از آنجا قاعدهٔ نگهداری دادهٔ خود او را دارد.
| قالب | نشانی | چه کسی از آن استفاده میکند |
|---|---|---|
| سازگار با OpenAI | https://gisoo.pro/api/v1 | کتابخانه‌های openai در پایتون و Node، و بیشتر ابزارها و افزونه‌ها |
| پیام‌های Anthropic | https://gisoo.pro/api/v1/messages (نشانی پایه: https://gisoo.pro/api) | Claude Code در ترمینال و VS Code، و SDK رسمی Anthropic |
Claude Code چیست و چرا داخل VS Code؟
Claude Code تکمیل‌کنندهٔ خودکار کد نیست. یک عامل (Agent) است: فایل‌های پروژه را جست‌وجو میکند و می‌خواند، برای کاری که خواسته‌اید تغییر پیشنهاد میدهد و با اجازهٔ شما فرمان‌های ترمینال را اجرا میکند، مثلاً تست‌ها را. افزونهٔ VS Code همین کار را کنار کد شما انجام میدهد. هر تغییر را خط‌به‌خط (Diff) در ویرایشگر می‌بینید و پیش از ثبت، قبول یا رد می‌کنید.
پیش از شروع
- حساب گیسو. حساب گیسو همان حساب نِت اَرز است. اگر یکی را دارید، دیگری را هم دارید.
- اعتبار هوش مصنوعی. Claude Code در هر قدم همهٔ گفت‌وگو و فایل‌هایی را که خوانده دوباره میفرستد و سقف خروجی بزرگی میخواهد. گیسو پیش از هر درخواست، بیشترین هزینهٔ ممکن آن (تا ۱۶٬۳۸۴ توکن خروجی) را کنار میگذارد و بعد فقط هزینهٔ واقعی را کم میکند. برای کار واقعی چند دلار اعتبار داشته باشید.
- احراز هویت. پیش از احراز هویت (KYC)، کل مصرف حساب به ۲ دلار محدود است. برای کار روزمره با Claude Code، احراز هویت را از «تنظیمات» اپ، ردیف «احراز هویت»، کامل کنید. بررسی مدارک معمولاً تا ۲۴ ساعت کاری طول می‌کشد، پس پیش از شروع کار اصلی انجامش بدهید.
- VS Code. نسخهٔ به‌روز VS Code روی کامپیوترتان نصب باشد.
قدم ۱: ساختن کلید مخصوص Claude Code
در اپ گیسو بخش «وبسرویس» را باز کنید و یک پروژه به نام «Claude Code» بسازید. برای پروژه می‌توانید بودجهٔ ماهانه به دلار بگذارید. داخل همین پروژه یک کلید تازه بسازید و «سقف هزینهٔ کل ($)» را روی عددی بگذارید که اگر کاری از کنترل خارج شد، بیشتر از آن خرج نشود. انقضا و «سقف درخواست در دقیقه (RPM)» هم اختیاری‌اند. کلید با sk-gisoo-v1- شروع میشود و متن کاملش را فقط یک بار، همان لحظهٔ ساخت، می‌بینید. همان‌جا کپی‌اش کنید.
قدم ۲: نصب افزونهٔ Claude Code در VS Code
در VS Code پنل افزونه‌ها (Extensions) را باز کنید، Claude Code را جست‌وجو کنید و افزونه‌ای را نصب کنید که ناشرش Anthropic است. خود Claude Code داخل افزونه است و برای VS Code نصب جداگانهٔ خط فرمان لازم ندارد. اگر بعد از نصب پیامی برای ورود به حساب Anthropic دیدید، وارد نشوید. قدم بعد این پیام را خاموش میکند.
قدم ۳: معرفی گیسو به Claude Code در settings.json
Claude Code تنظیم‌هایش را از فایل settings.json در پوشهٔ .claude خانهٔ شما می‌خواند. در ویندوز این فایل در %USERPROFILE%\.claude\settings.json است و در مک و لینوکس در ~/.claude/settings.json. اگر فایل یا پوشه وجود ندارد، بسازیدش و این متن را در آن بگذارید. به‌جای sk-gisoo-v1-... کلید خودتان را بنویسید:
{
"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",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}| متغیر | کارش |
|---|---|
ANTHROPIC_BASE_URL | نشانی گیسو. بدون /v1، چون Claude Code خودش /v1/messages را به آخرش اضافه میکند. |
ANTHROPIC_AUTH_TOKEN | کلید گیسوی شما. |
ANTHROPIC_MODEL | مدل اصلی که Claude Code با آن کار میکند. |
ANTHROPIC_DEFAULT_SONNET_MODEL و ANTHROPIC_DEFAULT_OPUS_MODEL | مدلی که پشت گزینه‌های Sonnet و Opus در Claude Code قرار می‌گیرد، وقتی مدل را عوض می‌کنید. |
ANTHROPIC_DEFAULT_HAIKU_MODEL | مدل سبکی که Claude Code برای کارهای جانبی کوچک به کار می‌گیرد. |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | گزارش خطا، آمار استفاده و بررسی بهروزرسانی را خاموش میکند تا Claude Code برای این کارها به سرورهای دیگر وصل نشود. |
حالا پیام ورود را خاموش کنید. پالت فرمان (Command Palette) را با Ctrl+Shift+P باز کنید (در مک Cmd+Shift+P)، فرمان Preferences: Open User Settings (JSON) را بزنید و این خط را به فایل تنظیم VS Code اضافه کنید:
{
"claudeCode.disableLoginPrompt": true
}اگر فایل از قبل چیزی دارد، فقط خط "claudeCode.disableLoginPrompt": true را داخل همان آکولادها اضافه کنید. افزونه تنظیم claudeCode.environmentVariables را هم دارد، ولی خود Anthropic پیشنهاد میکند متغیرها در ~/.claude/settings.json بمانند تا ترمینال و VS Code یک تنظیم داشته باشند. بعد از ذخیره، از پالت فرمان Developer: Reload Window را اجرا کنید.
همین کلید در Claude Code ترمینال هم کار میکند. اگر فایل بالا را ساخته باشید، فقط claude را اجرا کنید. برای یک بار امتحان بدون فایل، در مک و لینوکس:
export ANTHROPIC_BASE_URL="https://gisoo.pro/api"
export ANTHROPIC_AUTH_TOKEN="sk-gisoo-v1-..."
export ANTHROPIC_MODEL="claude-sonnet-5-5"
claudeقدم ۴: اولین اجرا و آزمایش
یک پروژهٔ کوچک را در VS Code باز کنید و از نماد Claude Code پنلش را بیاورید. اولین کار را بی‌خطر انتخاب کنید، کاری که چیزی را تغییر نمی‌دهد:
Claude Code فایل‌ها را جست‌وجو میکند و جواب میدهد. بعد در اپ گیسو، بخش «وبسرویس»، «گزارش مصرف» را باز کنید. درخواستها باید با نام مدل و هزینه آنجا باشند. اگر هستند، اتصال درست است. هر وقت خواستید مدل را وسط کار عوض کنید، در کادر پیام Claude Code بنویسید /model.
کدام مدل را بگذارید؟
برای کار روزمره، Claude Sonnet 5.5 انتخاب متعادلی است و از Opus ارزان‌تر تمام میشود. برای بازنویسی‌های سخت که چند فایل به هم گره خورده‌اند، Claude Opus 5.5 را امتحان کنید و حواستان به هزینهٔ بیشترش باشد. Claude Haiku 4.5 کارهای جانبی کوچک Claude Code را سریع و کم‌هزینه انجام میدهد. قیمت امروز مدل‌ها برای هر یک میلیون توکن:
| مدل | ورودی، هر میلیون توکن | خروجی، هر میلیون توکن |
|---|---|---|
| GPT-5 nano OpenAI | $$0.07 ≈ ۱۸٬۳۸۹ سکه | $$0.56 ≈ ۱۴۷٬۱۱۲ سکه |
| GPT-4o mini OpenAI | $$0.21 ≈ ۵۵٬۱۶۷ سکه | $$0.84 ≈ ۲۲۰٬۶۶۸ سکه |
| GPT-5.6 Luna OpenAI | $$0.28 ≈ ۷۳٬۵۵۶ سکه | $$1.68 ≈ ۴۴۱٬۳۳۶ سکه |
| GPT-5 mini OpenAI | $$0.35 ≈ ۹۱٬۹۴۵ سکه | $$2.80 ≈ ۷۳۵٬۵۶۰ سکه |
| DeepSeek Flash DeepSeek | $$0.42 ≈ ۱۱۰٬۳۳۴ سکه | $$1.68 ≈ ۴۴۱٬۳۳۶ سکه |
| Kimi K2.7 Code Moonshot (Kimi) | $$0.93 ≈ ۲۴۶٬۸۵۴ سکه | $$4.69 ≈ ۱٬۲۳۲٬۰۶۳ سکه |
| Gemini 3.8 Flash Google Gemini | $$1.05 ≈ ۲۷۵٬۸۳۵ سکه | $$5.25 ≈ ۱٬۳۷۹٬۱۷۵ سکه |
| Gemini 3.6 Flash Google Gemini | $$1.05 ≈ ۲۷۵٬۸۳۵ سکه | $$5.25 ≈ ۱٬۳۷۹٬۱۷۵ سکه |
| Qwen3 Max Thinking Qwen (Alibaba) | $$1.09 ≈ ۲۸۶٬۸۶۹ سکه | $$5.46 ≈ ۱٬۴۳۴٬۳۴۲ سکه |
| Claude Haiku 4.5 Anthropic | $$1.40 ≈ ۳۶۷٬۷۸۰ سکه | $$7.00 ≈ ۱٬۸۳۸٬۹۰۰ سکه |
| GPT-5 OpenAI | $$1.75 ≈ ۴۵۹٬۷۲۵ سکه | $$14.00 ≈ ۳٬۶۷۷٬۸۰۰ سکه |
| DeepSeek V4 Pro DeepSeek | $$1.84 ≈ ۴۸۵٬۴۷۰ سکه | $$5.54 ≈ ۱٬۴۵۶٬۴۰۹ سکه |
| GPT-5.6 Terra OpenAI | $$2.80 ≈ ۷۳۵٬۵۶۰ سکه | $$16.80 ≈ ۴٬۴۱۳٬۳۶۰ سکه |
| Claude Sonnet 5 Anthropic | $$2.80 ≈ ۷۳۵٬۵۶۰ سکه | $$14.00 ≈ ۳٬۶۷۷٬۸۰۰ سکه |
| Grok 4.7 xAI (Grok) | $$2.80 ≈ ۷۳۵٬۵۶۰ سکه | $$8.40 ≈ ۲٬۲۰۶٬۶۸۰ سکه |
| GPT-5.6 Sol OpenAI | $$5.60 ≈ ۱٬۴۷۱٬۱۲۰ سکه | $$28.00 ≈ ۷٬۳۵۵٬۶۰۰ سکه |
| Claude Opus 5.5 Anthropic | $$5.60 ≈ ۱٬۴۷۱٬۱۲۰ سکه | $$28.00 ≈ ۷٬۳۵۵٬۶۰۰ سکه |
| GPT-6 Astra OpenAI | $$14.00 ≈ ۳٬۶۷۷٬۸۰۰ سکه | $$70.00 ≈ ۱۸٬۳۸۹٬۰۰۰ سکه |
توکن تکه‌ای از متن است؛ هر کلمهٔ فارسی معمولاً به چند توکن شکسته میشود. ورودی متنی است که می‌فرستید (همراه با پیام‌های قبلی گفت‌وگو) و خروجی جوابی است که مدل می‌نویسد.
بهروزرسانی: ۱۴۰۵/۰۷/۰۹ ۲۱:۱۹ مبلغ‌ها به سکه، با قیمت امروز همان مدل در گیسو
مدل‌های دیگر گیسو هم با همین قالب کار می‌کنند، مثلاً deepseek-v4-pro یا gemini-3.8-flash. فقط نامشان را در ANTHROPIC_MODEL بگذارید. ولی Claude Code برای خواندن فایل و ویرایش، بر فراخوانی ابزار (Tool Calling) تکیه دارد و مدل‌های Claude این دستورها را دقیق‌تر دنبال می‌کنند. مدل‌های دیگر ممکن است در ویرایش‌های چندمرحله‌ای راه را گم کنند. یک نکته هم دربارهٔ نام‌ها: نامی که با [1m] تمام میشود در گیسو شناخته نمی‌شود. همیشه نام ساده، مثل claude-sonnet-5-5، را بنویسید.
هزینه را پایین نگه دارید
- کش پرامپت (Prompt Caching) کار میکند. برای مدل‌های Claude، بخشی از ورودی که در قدم‌های بعدی تکرار میشود، مثل دستورهای ثابت و فایل‌هایی که قبلاً خوانده شده، ارزان‌تر حساب میشود. برای همین هزینهٔ یک جلسهٔ طولانی معمولاً از جمع سادهٔ توکن‌هایش کمتر است.
- کارهای نامربوط را از هم جدا کنید. وقتی یک کار تمام شد، با
/clearگفت‌وگوی تازه شروع کنید، یا با/compactتاریخچه را خلاصه کنید. هر قدم همهٔ گفت‌وگو را دوباره میفرستد. هرچه پنجرهٔ زمینه (Context Window) پرتر باشد، هزینه بیشتر و دقت مدل کمتر میشود. - فایل CLAUDE.md را کوتاه نگه دارید. این فایل در هر درخواست فرستاده میشود. فقط قاعده‌های اصلی پروژه را در آن بنویسید، همان کاری که یک دستور سیستمی خوب میکند.
- برای کار بزرگ اول نقشه بخواهید. بنویسید «اول برنامهٔ تغییر را بگویید و بعد از تأیید من شروع کنید». اگر برداشت مدل اشتباه باشد، پیش از خرج شدن اعتبار معلوم میشود.
- سقف‌ها را جدی بگیرید. سقف هزینهٔ کلید و بودجهٔ ماهانهٔ پروژه تور ایمنی شما هستند. بعد از اولین ساعت کار واقعی، گزارش مصرف را ببینید تا تصویر درستی از هزینهٔ کارتان داشته باشید.
چه چیزهایی از راه گیسو کار نمی‌کند
بیشتر کار Claude Code، یعنی خواندن و ویرایش فایل و اجرای فرمان، از راه گیسو کامل کار میکند. چند قابلیت که به سرورهای خود Anthropic وابسته‌اند، نه:
| قابلیت | وضعیت |
|---|---|
| جست‌وجوی وب داخلی Claude Code | کار نمی‌کند، چون ابزار سمت سرور Anthropic است. |
| خواندن لینکی که خودتان در پیام میگذارید | به شبکهٔ شما بستگی دارد. Claude Code صفحه را خودش باز میکند، ولی پیش از آن از سرور Anthropic میپرسد آن دامنه امن است یا نه. اگر آن سرور از شبکهٔ شما در دسترس نباشد، کار با خطای «Unable to verify if domain … is safe to fetch» متوقف میشود. |
| فکر کردن طولانی (Extended Thinking) | نادیده گرفته میشود و پاسخ بدون آن می‌آید. |
| Message Batches و Files API | در گیسو نیستند. Claude Code برای کار روزمره به آن‌ها نیازی ندارد. |
امنیت کلید
کلید را هیچ‌وقت در فایلی نگذارید که در گیت (Git) ثبت میشود. فایل .claude/settings.json داخل پوشهٔ پروژه برای تنظیم‌های مشترک تیم است و معمولاً در مخزن ثبت میشود. اگر می‌خواهید تنظیم فقط برای یک پروژه باشد، کلید را در .claude/settings.local.json بگذارید و آن را به .gitignore اضافه کنید. اگر کلید لو رفت، در اپ با «باطل کردن» از کار بیندازیدش و کلید تازه بسازید. برای کلیدی که روی سرور کار میکند، هنگام ساخت فهرست آدرس‌های IP مجاز هم بگذارید. این فهرست بعد از ساخت عوض نمی‌شود.
اگر کار نکرد
| نشانه | علت | راه‌حل |
|---|---|---|
| خطای 401 یا authentication | کلید اشتباه کپی شده، نام متغیر غلط است، یا کلید باطل یا متوقف شده. | نام ANTHROPIC_AUTH_TOKEN و خود کلید را دوباره بررسی کنید. اگر لازم بود کلید تازه بسازید. |
| insufficient_credit | اعتبار برای مبلغی که پیش از هر درخواست کنار گذاشته میشود کافی نیست، یا سقف ۲ دلاری پیش از احراز هویت پر شده. | اعتبار را شارژ کنید و اگر هنوز احراز هویت نکرده‌اید، کاملش کنید. |
| مدل پیدا نمی‌شود | نامی نوشته‌اید که در کاتالوگ گیسو نیست، مثلاً نامی با [1m]. | نام را با فهرست مدل‌ها مقایسه کنید و نام ساده بنویسید. |
| خطای 429 | درخواستها از سقف دقیقه‌ای کلید (RPM) گذشته‌اند. | کمی صبر کنید. سقف دقیقه‌ای کلید بعد از ساخت عوض نمی‌شود، پس اگر همیشه به آن می‌خورید، کلیدی با سقف بالاتر بسازید. |
| افزونه باز هم ورود به حساب میخواهد | claudeCode.disableLoginPrompt ذخیره نشده یا پنجره دوباره بارگذاری نشده. | تنظیم را بررسی کنید و Developer: Reload Window را بزنید. |
| تغییر تنظیم اثری ندارد | فایل JSON خطای نگارشی دارد، مثلاً ویرگول جاافتاده، یا پنجره بارگذاری نشده. | فایل را در VS Code باز کنید تا خطا را نشان بدهد، درستش کنید و پنجره را دوباره بارگذاری کنید. |
کلیدی که ساختید فقط مال Claude Code نیست. همان کلید در SDK رسمی Anthropic، و با نشانی https://gisoo.pro/api/v1 در ابزارهایی که با OpenAI سازگارند، کار میکند. جزئیات قالب Anthropic، از پاسخ جریانی تا کش پرامپت، در راهنمای سازگاری با Anthropic و Claude Code آمده است. اگر تازه با وبسرویس آشنا می‌شوید، اول شروع سریع را بخوانید.
