اگر از Claude Code برای توسعه نرم‌افزار، برنامه‌نویسی با Next.js، Angular، React یا سایر فریمورک‌ها استفاده می‌کنید، احتمالاً متوجه شده‌اید که با بزرگ‌تر شدن پروژه، میزان مصرف توکن نیز افزایش پیدا می‌کند. این موضوع نه تنها هزینه استفاده از مدل‌های هوش مصنوعی را بیشتر می‌کند، بلکه باعث کاهش سرعت پاسخ‌گویی و افزایش زمان تحلیل پروژه نیز می‌شود.

در این مقاله یاد می‌گیریم چگونه با استفاده از فایل CLAUDE.md، مدیریت صحیح Context و ساختار مناسب پروژه، مصرف توکن در Claude Code را به شکل چشمگیری کاهش دهیم.

چرا Claude Code توکن زیادی مصرف می‌کند؟

Claude Code برای درک بهتر پروژه، فایل‌ها و ساختار کد را بررسی می‌کند. هرچه تعداد فایل‌ها بیشتر باشد، حجم بیشتری از اطلاعات وارد Context مدل می‌شود.

به عنوان مثال اگر پروژه شما شامل موارد زیر باشد:

  • صدها فایل TypeScript
  • کامپوننت‌های متعدد React یا Angular
  • فایل‌های تنظیمات
  • مستندات طولانی

Claude Code باید بخش زیادی از این اطلاعات را پردازش کند و همین موضوع باعث افزایش مصرف توکن می‌شود.

فایل CLAUDE.md چیست؟

فایل CLAUDE.md یک فایل Markdown ساده است که به عنوان حافظه و راهنمای پروژه عمل می‌کند.

به جای اینکه Claude Code هر بار کل پروژه را تحلیل کند، می‌تواند ابتدا این فایل را بخواند و اطلاعات مهم پروژه را از آن دریافت کند.

نمونه ساختار فایل:

# Project Overview

## Stack
- Next.js 15
- TypeScript
- MongoDB
- TailwindCSS

## Coding Rules
- Never use any
- Use Server Actions
- Use App Router

## Folder Structure
src/app
src/components
src/lib

این فایل باعث می‌شود مدل سریع‌تر ساختار پروژه را درک کند.

مزایای استفاده از CLAUDE.md

استفاده از فایل CLAUDE.md مزایای متعددی دارد:

کاهش مصرف توکن

مدل به جای بررسی صدها فایل، ابتدا خلاصه پروژه را مطالعه می‌کند.

افزایش سرعت پاسخ‌دهی

زمان مورد نیاز برای تحلیل پروژه کاهش پیدا می‌کند.

جلوگیری از اشتباهات تکراری

می‌توانید قوانین کدنویسی تیم را در این فایل ثبت کنید.

حفظ استانداردهای پروژه

تمام توسعه‌دهندگان و Agentهای هوش مصنوعی از یک مجموعه قوانین پیروی می‌کنند.

ساخت فایل Architecture برای پروژه

یکی از بهترین روش‌ها این است که معماری پروژه را در فایل جداگانه ذخیره کنید.

نمونه:

docs/
├── architecture.md
├── database.md
├── api.md

فایل architecture.md می‌تواند شامل موارد زیر باشد:

  • ساختار پروژه
  • ارتباط ماژول‌ها
  • نحوه مدیریت State
  • الگوی طراحی استفاده شده

ایجاد فایل Database Documentation

یکی از بخش‌هایی که معمولاً توکن زیادی مصرف می‌کند، تحلیل ساختار دیتابیس است.

بهتر است فایل database.md ایجاد کنید و اطلاعات زیر را در آن قرار دهید:

Collections

  • users
  • projects
  • subscriptions
  • payments

Relations

  • User → Projects
  • User → Subscription

این کار باعث می‌شود Claude Code بدون بررسی تمام مدل‌ها و Schemaها، ساختار دیتابیس را درک کند.

چگونه Context را مدیریت کنیم؟

یکی از اشتباهات رایج این است که از Claude Code درخواست کنیم کل پروژه را تحلیل کند.

درخواست نامناسب:

Analyze my entire project

درخواست بهتر:

Analyze only src/app/auth

یا:

Review only login page and authentication service

هرچه محدوده درخواست کوچک‌تر باشد، مصرف توکن نیز کمتر خواهد شد.

استفاده از دستور Compact

در پروژه‌های بزرگ، مکالمات طولانی باعث افزایش Context می‌شوند.

Claude Code قابلیت فشرده‌سازی مکالمات را در اختیار شما قرار می‌دهد.

دستور:

/compact

این دستور خلاصه‌ای از مکالمات قبلی ایجاد می‌کند و حجم Context را کاهش می‌دهد.

فایل‌های غیرضروری را از تحلیل خارج کنید

برخی پوشه‌ها نیازی به بررسی توسط Agent ندارند:

node_modules/
dist/
.next/
coverage/
build/

نادیده گرفتن این فایل‌ها باعث بهبود عملکرد و کاهش مصرف توکن می‌شود.

بهترین ساختار برای پروژه‌های Next.js و Angular

برای اکثر پروژه‌های حرفه‌ای پیشنهاد می‌شود ساختار زیر را داشته باشید:

project/
├── CLAUDE.md
├── README.md
├── docs/
│   ├── architecture.md
│   ├── database.md
│   ├── api.md
│   └── business-rules.md

این ساختار به Claude Code کمک می‌کند تا بدون نیاز به بررسی تمام فایل‌ها، تصویر دقیقی از پروژه داشته باشد.

جمع‌بندی

اگر می‌خواهید هزینه استفاده از Claude Code را کاهش دهید و سرعت توسعه را افزایش دهید، مهم‌ترین اقدام ایجاد فایل CLAUDE.md و مستندسازی بخش‌های اصلی پروژه است.

بهترین راهکارها عبارت‌اند از:

  • ایجاد فایل CLAUDE.md
  • مستندسازی معماری پروژه
  • مستندسازی دیتابیس
  • محدود کردن محدوده تحلیل فایل‌ها
  • استفاده از دستور /compact
  • حذف پوشه‌های غیرضروری از فرآیند تحلیل

با رعایت این نکات می‌توانید مصرف توکن Claude Code را بین 50 تا 90 درصد کاهش دهید و تجربه بسیار بهتری در توسعه پروژه‌های بزرگ داشته باشید.