Документація

Що таке CLAUDE_CONFIG_DIR

Останнє оновлення 19 жовтня 2026 р.
Перевірено з 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 Дозволи, хуки, модель, рядок стану, плагіни Так
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 дані входу зберігаються у в'язці ключів, а не в теці. Claude Code зберігає їх під назвою Claude Code-credentials, після якої йде короткий хеш шляху до теки, якщо задано CLAUDE_CONFIG_DIR. Тому окремі теки отримують окремі записи у в'язці ключів. Якщо в'язка ключів відмовляє в записі, Claude Code натомість використовує .credentials.json у теці.

Спільне використання між теками

Символьні посилання працюють: Claude Code читає й записує через пов'язаний settings.json або теку projects/ і зберігає посилання. Виняток становлять сервери MCP, бо вони ділять .claude.json з даними входу; натомість передавайте їх через --mcp-config.

ccam побудовано саме на цих правилах. Як він пов'язує теки, див. у розділі спільне використання, а загальну картину описано в посібнику з кількох облікових записів.