اجرای Claude Code تو سندباکس ابری با TanStack AI
خلاصهٔ کاملتر
این مقاله قسمت سوم مجموعهٔ نویسنده دربارهٔ TanStack AIه، یه SDK برای اضافه کردن قابلیتهای هوش مصنوعی به نرمافزار. قبلاً درخواستهای ساده، streaming و structured output رو پوشش داده بود و حالا سراغ Sandbox API رفته؛ یعنی اجرای یه ایجنت تو یه کانتینر ابری ایزوله که میتونه واقعاً کد بنویسه و اجرا کنه.
سناریوی نویسنده اینه: یه اپ سادهٔ وب داره با صفحههای ادمین برای Vercel و Railway. اونجا یه فیچر رو با prompt درخواست میکنه و Claude Code تو سندباکس، ریپو رو کلون میکنه، branch میسازه، تغییر رو اعمال میکنه و با GitHub CLI یه PR باز میکنه. نویسنده میگه ابزارهایی مثل Codex هم این کارو میکنن، ولی اونجا لپتاپت باید روشن باشه؛ این روش جایگزین خوبیه اگه یه سیستم همیشه روشن نداری.
برای راهاندازی یه توکن GitHub با دسترسی خوندن و نوشتن به Contents و Pull requests لازمه، بهعلاوهٔ کلید API از Anthropic. برای Vercel سه مقدار VERCEL_TOKEN، VERCEL_TEAM_ID و VERCEL_PROJECT_ID و برای Railway دو مقدار RAILWAY_ENVIRONMENT_ID و RAILWAY_TOKEN میخوای. خود سندباکس با defineSandbox تعریف میشه: ریپوی منبع، دستورهای setup، secretها و یه دستورالعمل برای ایجنت. تو Vercel باید Claude Code و GitHub CLI رو خودت تو setup نصب کنی، ولی ایمیج Railway اینا رو از قبل داره.
تنظیم lifecycle: { reuse: "thread" } باعث میشه برای همون threadId همون سندباکس دوباره استفاده بشه؛ یعنی سؤالها و توضیحهای بعدی، context قبلی رو گم نمیکنن. بقیهٔ کد مثل قبله و سندباکس فقط یه middleware جدیده:
const stream = chat({
adapter: claudeCodeText("claude-opus-4-8"),
messages,
threadId,
runId,
middleware: [withPersistence(chatPersistence), withSandbox(sandboxVercel)],
});برای پاکسازی، آبجکت سندباکس یه متد destroy داره و ردیفهای مربوط هم باید از دیتابیس persistence حذف بشن. نویسنده هشدار میده که فعلاً پاکسازی @tanstack/ai-sandbox-vercel درست کار نمیکنه: سندباکس فقط متوقف میشه، پاک نمیشه و snapshotهای دیسک هم میمونن، پس بهتره با API خود Vercel یه اسکریپت پاکسازی بنویسی. Railway این مشکل رو نداره و برای checkpointهایی که میمونن هم پولی نمیگیره. جمعبندی نویسنده اینه که سرعت و تجربه به پای اجرای مستقیم Claude Code نمیرسه، ولی وقتی دور از لپتاپی کافیه.
نکات کلیدی:
- Sandbox API تو TanStack AI ایجنت رو تو یه کانتینر ابری مثل Vercel یا Railway اجرا میکنه
- سندباکس با withSandbox فقط یه middleware اضافه تو فراخوانی chat هست
- ایمیج Vercel نه Claude Code داره نه GitHub CLI، ولی Railway هر دو رو داره
- lifecycle: { reuse: "thread" } سندباکس رو برای هر threadId نگه میداره
- متد destroy تو پکیج Vercel فعلاً سندباکس رو فقط متوقف میکنه و snapshotها رو پاک نمیکنه




