OpenCode
پیشنیاز: یک کلید API و موجودی کیف پول.
ساخت کلیدنصب و کلید
OpenCode یک عامل کدنویسی متنباز برای ترمینال است؛ با داتهوش روی مدلهای مختلف و با کیف پول تومانی کار میکند. با یکی از دو دستور نصبش کنید و کلید را در متغیر محیطی بگذارید. مقدار واقعی کلید را بهجای
dh_live_…وارد کنید.terminalcurl -fsSL https://opencode.ai/install | bash # or: npm i -g opencode-ai export DOTHOOSH_API_KEY="dh_live_…"
داتهوش را بهعنوان ارائهدهنده اضافه کنید
داتهوش هنوز در فهرست آمادهٔ OpenCode نیست، پس با فایل پیکربندی اضافهاش میکنید. این متن مخصوص OpenCode نسخهٔ ۲ است؛ آن را در
opencode.jsoncکنار پروژه یا در~/.config/opencode/opencode.jsoncبگذارید. شناسهٔ مدل را از کاتالوگ مدلها بردارید و در هر سه جای فایل بنویسید؛ پیشوند ارائهدهنده لازم نیست.opencode.jsonc{ "$schema": "https://opencode.ai/config.json", "providers": { "dothoosh": { "name": "Dothoosh (داتهوش)", "env": ["DOTHOOSH_API_KEY"], "package": "@opencode/ai/providers/openai-compatible", "settings": { "baseURL": "https://gateway.dothoosh.com/v1" }, "models": { "deepseek-flash": { "name": "deepseek-flash" } } } }, "model": "dothoosh/deepseek-flash" }نسخهٔ ۱ و قدیمیتر
نسخهٔ OpenCode را با
opencode --versionببینید. اگر ۱ یا قدیمیتر است، بهجای پیکربندی بالا از این استفاده کنید. کلید از همان متغیر محیطی خوانده میشود.opencode.json (v1){ "$schema": "https://opencode.ai/config.json", "provider": { "dothoosh": { "npm": "@ai-sdk/openai-compatible", "name": "Dothoosh (داتهوش)", "options": { "baseURL": "https://gateway.dothoosh.com/v1", "apiKey": "{env:DOTHOOSH_API_KEY}" }, "models": { "deepseek-flash": { "name": "deepseek-flash" } } } }, "model": "dothoosh/deepseek-flash" }اجرا و انتخاب مدل
در پوشهٔ پروژه
opencodeرا بزنید. اگرmodelرا در فایل نوشته باشید همان مدل انتخاب است؛ وگرنه/modelsرا بزنید، یکی از مدلهایdothoosh/…را بردارید و اولین پیام را بفرستید.terminalopencode
اتصال یکمرحلهای با /connect و انتخاب داتهوش از فهرست ارائهدهندههای OpenCode در راه است، اما زمان مشخصی ندارد. تا آن زمان از پیکربندی بالا استفاده کنید.
کار نکرد؟
401 · api_key_invalid
کلید اشتباه کپی شده، لغو شده یا غیرفعال است. مطمئن شوید DOTHOOSH_API_KEY در همان ترمینالی که opencode را اجرا میکنید تنظیم شده و کلید را در کنسول بررسی کنید.
402 · insufficient_available_balance
موجودی کیف پول کافی نیست. کیف پول را شارژ کنید و دوباره امتحان کنید؛ بدهی ایجاد نمیشود.
404 · model_not_found
شناسهٔ مدل باید دقیقاً همان شناسهٔ کاتالوگ مدلها باشد، بدون پیشوند ارائهدهنده. در فایل پیکربندی در هر سه جا یکی باشد.
کار طولانی و محدودیت context
در کار خیلی طولانی ممکن است گفتوگو از سقف context مدل بزرگتر شود. اندازهٔ آن را در کاتالوگ ببینید، /compact را بزنید یا نشست تازه شروع کنید.
فهرست کامل خطاها در راهنمای خطاها است.