Шпаргалка по настройкам Claude Code

Claude Code удобнее всего настраивать через три уровня конфигурации. Они решают разные задачи и не должны путаться между собой.

Где хранить настройки

~/.claude/settings.json

Личные настройки для всех проектов на этой машине.

Используйте для:

• любимой модели
• языка интерфейса
• темы
• личных разрешений
• общих удобств

.claude/settings.json

Общие настройки проекта, которые подходят всей команде.

Используйте для:

• project-level permissions
• hooks
• mcpServers
• общих плагинов
• правил, которые должны работать одинаково у всех

.claude/settings.local.json

Локальные переопределения только для вас.

Используйте для:

• секретов и токенов
• локальных прокси
• ANTHROPIC_BASE_URL
• машинозависимых путей
• личных временных изменений

Простое правило выбора

• Нужно всем — пишите в .claude/settings.json
• Нужно только вам — пишите в ~/.claude/settings.json
• Нужно только на этой машине или это секрет — пишите в .claude/settings.local.json

Что обычно настраивают

Авторизация и сервер

• ANTHROPIC_BASE_URL — если используете свой Anthropic-compatible сервер
• ANTHROPIC_AUTH_TOKEN — если прокси ждёт bearer token
• ANTHROPIC_API_KEY — если нужен API key-режим Anthropic

Права доступа

• permissions.allow
• permissions.deny
• permissions.ask
• permissions.defaultMode

Автоматизация

• hooks — запуск команд, проверок и форматирования по событиям
• mcpServers — подключение MCP-серверов
• enabledPlugins — включение плагинов

Поведение и интерфейс

• model
• language
• theme
• editorMode
• verbose
• statusLine
• spinnerTipsEnabled

Почему это разделение важно

Такой подход помогает:

• не коммитить секреты в репозиторий
• не ломать настройки коллегам
• держать командные правила отдельно от личных
• быстро понимать, где искать нужную опцию

Практический пример

Если вы работаете через локальный proxy или совместимый сервер, то обычно держат в локальном файле только то, что относится к этой машине:

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:8317",
    "ANTHROPIC_AUTH_TOKEN": "..."
  }
}

А общие для команды правила — в .claude/settings.json.

Короткий вывод

• settings.json — общее
• settings.local.json — личное и секретное
• ~/.claude/settings.json — личное глобальное

Если сомневаетесь, спрашивайте себя: «Это нужно всем, только мне или только этой машине?» — и ответ почти всегда становится очевидным.