مستندات

توضیح CLAUDE_CONFIG_DIR

آخرین به‌روزرسانی: ۲۷ مهر ۱۴۰۵
بررسی‌شده با ccam 0.5.0 و Claude Code 2.1.302

این صفحه به‌صورت ماشینی از انگلیسی ترجمه شده است. پیشنهاد اصلاح را با کمال میل می‌پذیریم. ویرایش این صفحه در GitHub

در این صفحه

CLAUDE_CONFIG_DIR به Claude Code می‌گوید به‌جای ~/.claude از کدام پوشه استفاده کند. هر چیزی که به حساب وابسته است در همان پوشه قرار دارد: ورود، تنظیمات، سرورهای MCP، پلاگین‌ها و تاریخچه گفتگو. اگر آن را به پوشه‌های مختلف اشاره دهید، حساب‌های جداگانه خواهید داشت.

CLAUDE_CONFIG_DIR=~/.claude-work claude

داخل پوشه چه چیزهایی هست

بررسی‌شده با Claude Code 2.1.302:

مسیر محتوا قابل اشتراک
.credentials.json توکن‌های ورود (Linux)، توکن‌های OAuth سرورهای MCP خیر
.claude.json جزئیات حساب، سرورهای MCP کاربر، وضعیت هر پروژه خیر (سرورهای MCP جداگانه)
settings.json مجوزها، hookها، مدل، خط وضعیت، پلاگین‌ها بله
CLAUDE.md دستورالعمل‌های سراسری بله
agents/، commands/، skills/، plugins/ افزونه‌ها بله
projects/ گفتگوها به‌صورت فایل‌های .jsonl، حافظه هر پروژه بله
history.jsonl تاریخچه پرامپت‌ها بله
sessions/، shell-snapshots/، cache/ و موارد دیگر وضعیت زمان اجرا خیر

دو نکته که کاربران را غافلگیر می‌کند

بدون CLAUDE_CONFIG_DIR، فایل .claude.json داخل ~/.claude نیست. در این حالت Claude Code آن را در ~/.claude.json، کنار پوشه، نگه می‌دارد. اگر شروع به استفاده از CLAUDE_CONFIG_DIR=~/.claude کنید، Claude Code به‌جای آن به دنبال ~/.claude/.claude.json می‌گردد و حساب شما را پیدا نمی‌کند. ccam import این مشکل را با پیوند دادن این دو حل می‌کند.

در macOS ورود در Keychain است، نه در پوشه. Claude Code آن را با نام Claude Code-credentials ذخیره می‌کند و وقتی CLAUDE_CONFIG_DIR تنظیم شده باشد، یک هش کوتاه از مسیر پوشه را به دنبال آن می‌آورد. بنابراین پوشه‌های جداگانه مدخل‌های جداگانه‌ای در Keychain می‌گیرند. اگر Keychain نوشتن را نپذیرد، Claude Code به‌جای آن از .credentials.json داخل پوشه استفاده می‌کند.

اشتراک‌گذاری بین پوشه‌ها

پیوندهای نمادین کار می‌کنند: Claude Code از طریق یک settings.json یا پوشه projects/ پیوندی می‌خواند و می‌نویسد و پیوند را حفظ می‌کند. سرورهای MCP استثنا هستند، زیرا .claude.json را با ورود شریک‌اند؛ به‌جای آن، آن‌ها را با --mcp-config بدهید.

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