Краткое руководство Claude Code

Спасибо за использование Claude Code! Этот мощный ИИ-помощник программиста поможет вам повысить эффективность программирования и автоматизировать задачи разработки.

1. Установка и настройка

1.1 Системные требования

Операционная система: macOS 10.15+, Ubuntu 20.04+/Debian 10+, или Windows через WSL
Аппаратное обеспечение: 4GB+ RAM
Программное обеспечение: Node.js 18+
Сеть: Подключение к интернету для аутентификации и ИИ-обработки

1.2 Шаги установки

Глобальная установка с помощью npm:

bash

npm install -g @anthropic-ai/claude-code

Важно: Не используйте sudo npm install -g, это может вызвать проблемы с разрешениями и риски безопасности.

После завершения установки перейдите в каталог проекта и запустите Claude Code:

bash

cd your-awesome-project
claude

2. Получение и настройка API ключа

2.1 Регистрация аккаунта

Перейдите на https://coultra.blueshirtmap.com
Нажмите кнопку регистрации для создания нового аккаунта
Введите необходимую информацию для регистрации

Регистрация аккаунта

2.2 Генерация API ключа

После успешного входа перейдите на страницу управления API ключами
Создайте новую группу API ключей
Выберите "ClaudeCode" в качестве имени группы
Сгенерируйте API ключ и скопируйте его

Создание токена

3. Настройка конфигурационного файла

3.1 Настройка API ключа

Способ настройки конфигурационного файла

Создайте или отредактируйте конфигурационный файл:

bash

# Пользовательские настройки (глобальные)
~/.claude/settings.json

# Настройки проекта (на уровне проекта)
.claude/settings.json

Пример конфигурационного файла:

json

{
    "env": {
      "ANTHROPIC_API_KEY": "ваш_API_ключ",
      "ANTHROPIC_BASE_URL": "https://coultra.blueshirtmap.com",
      "CLAUDE_CODE_MAX_OUTPUT_TOKENS":64000,
      "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":1,
      "CLAUDE_MODEL": "имя_модели_Claude"
    },
    "permissions": {
      "allow": [],
      "deny": []
    }
  }

3.2 Настройки разрешений (опционально)

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

Используйте команду /permissions для добавления или удаления инструментов
Отредактируйте файл settings.json для массовой настройки
Используйте CLI флаг --allowedTools для установки разрешений для конкретной сессии

3.4 Быстрая настройка - Скрипт одним кликом

После покупки API вам нужно только изменить строку 8 этого скрипта readonly API_KEY="", заполнить ваш API ключ (токен), сохранить этот скрипт как claudecode.sh, затем открыть терминал:

bash

chmod +x claudecode.sh
./claudecode.sh

Следуйте инструкциям.

bash

#!/bin/bash

# ==============================================================================
# 🔧 Область конфигурации - Настройте здесь вашу API конфигурацию
# ==============================================================================

# 🔑 API ключ - Введите ваш API ключ
readonly API_KEY=""

# 🌐 Базовый URL API - Введите ваш базовый адрес API (например: "https://coultra.blueshirtmap.com")
readonly API_BASE_URL="https://coultra.blueshirtmap.com"

# ==============================================================================
# Не изменяйте содержимое ниже
# ==============================================================================

# Константы скрипта
readonly CLAUDE_COMMAND="claude"
readonly NPM_PACKAGE="@anthropic-ai/claude-code"
readonly CLAUDE_DIR="$HOME/.claude"
readonly SETTINGS_FILE="$CLAUDE_DIR/settings.json"

# Определение операционной системы
detect_os() {
    case "$(uname -s)" in
        Darwin)
            echo "macos"
            ;;
        Linux)
            echo "linux"
            ;;
        *)
            echo "unknown"
            ;;
    esac
}

# Проверка полноты конфигурации
check_config() {
    if [ -z "$API_KEY" ] || [ -z "$API_BASE_URL" ]; then
        echo "❌ Конфигурация неполная! Отредактируйте скрипт и заполните следующую информацию:"
        echo "  - API_KEY: Ваш API ключ"
        echo "  - API_BASE_URL: Базовый адрес API (например: https://coultra.blueshirtmap.com )"
        exit 1
    fi
}

# Установка Homebrew (только macOS)
install_homebrew() {
    if ! command -v brew &> /dev/null; then
        echo "Установка Homebrew..."
        /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
        
        # Добавление Homebrew в PATH
        if [[ -f "/opt/homebrew/bin/brew" ]]; then
            eval "$(/opt/homebrew/bin/brew shellenv)"
        elif [[ -f "/usr/local/bin/brew" ]]; then
            eval "$(/usr/local/bin/brew shellenv)"
        fi
        
        echo "✅ Установка Homebrew завершена"
    else
        echo "ℹ️ Homebrew уже установлен"
    fi
}

# Установка пакетов на macOS
install_macos_packages() {
    install_homebrew
    
    # Установка Node.js (включает npm)
    if ! command -v node &> /dev/null; then
        echo "Установка Node.js..."
        brew install node
        echo "✅ Установка Node.js завершена"
    else
        echo "ℹ️ Node.js уже установлен"
    fi
    
    # Установка jq
    if ! command -v jq &> /dev/null; then
        echo "Установка jq..."
        brew install jq
        echo "✅ Установка jq завершена"
    else
        echo "ℹ️ jq уже установлен"
    fi
    
    # Установка Python3
    if ! command -v python3 &> /dev/null; then
        echo "Установка Python3..."
        brew install python3
        echo "✅ Установка Python3 завершена"
    else
        echo "ℹ️ Python3 уже установлен"
    fi
}

# Установка пакетов на Linux
install_linux_packages() {
    # Определение дистрибутива Linux
    if command -v apt-get &> /dev/null; then
        # Ubuntu/Debian
        echo "Обнаружена система Ubuntu/Debian"
        
        # Обновление менеджера пакетов
        echo "Обновление менеджера пакетов..."
        sudo apt-get update
        
        # Установка Node.js
        if ! command -v node &> /dev/null; then
            echo "Установка Node.js..."
            # Установка репозитория NodeSource
            curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
            sudo apt-get install -y nodejs
            echo "✅ Установка Node.js завершена"
        else
            echo "ℹ️ Node.js уже установлен"
        fi
        
        # Установка jq
        if ! command -v jq &> /dev/null; then
            echo "Установка jq..."
            sudo apt-get install -y jq
            echo "✅ Установка jq завершена"
        else
            echo "ℹ️ jq уже установлен"
        fi
        
        # Установка Python3
        if ! command -v python3 &> /dev/null; then
            echo "Установка Python3..."
            sudo apt-get install -y python3 python3-pip
            echo "✅ Установка Python3 завершена"
        else
            echo "ℹ️ Python3 уже установлен"
        fi
        
    elif command -v yum &> /dev/null; then
        # CentOS/RHEL
        echo "Обнаружена система CentOS/RHEL"
        
        # Установка Node.js
        if ! command -v node &> /dev/null; then
            echo "Установка Node.js..."
            curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
            sudo yum install -y nodejs
            echo "✅ Установка Node.js завершена"
        else
            echo "ℹ️ Node.js уже установлен"
        fi
        
        # Установка jq
        if ! command -v jq &> /dev/null; then
            echo "Установка jq..."
            sudo yum install -y jq
            echo "✅ Установка jq завершена"
        else
            echo "ℹ️ jq уже установлен"
        fi
        
        # Установка Python3
        if ! command -v python3 &> /dev/null; then
            echo "Установка Python3..."
            sudo yum install -y python3 python3-pip
            echo "✅ Установка Python3 завершена"
        else
            echo "ℹ️ Python3 уже установлен"
        fi
        
    elif command -v pacman &> /dev/null; then
        # Arch Linux
        echo "Обнаружена система Arch Linux"
        
        # Установка Node.js
        if ! command -v node &> /dev/null; then
            echo "Установка Node.js..."
            sudo pacman -S --noconfirm nodejs npm
            echo "✅ Установка Node.js завершена"
        else
            echo "ℹ️ Node.js уже установлен"
        fi
        
        # Установка jq
        if ! command -v jq &> /dev/null; then
            echo "Установка jq..."
            sudo pacman -S --noconfirm jq
            echo "✅ Установка jq завершена"
        else
            echo "ℹ️ jq уже установлен"
        fi
        
        # Установка Python3
        if ! command -v python3 &> /dev/null; then
            echo "Установка Python3..."
            sudo pacman -S --noconfirm python python-pip
            echo "✅ Установка Python3 завершена"
        else
            echo "ℹ️ Python3 уже установлен"
        fi
        
    else
        echo "❌ Неподдерживаемый дистрибутив Linux, установите следующие пакеты вручную:"
        echo "  - Node.js (включая npm)"
        echo "  - jq"
        echo "  - python3"
        exit 1
    fi
}

# Установка Claude Code
install_claude_code() {
    if command -v "$CLAUDE_COMMAND" &> /dev/null; then
        echo "ℹ️ Claude Code уже установлен"
    else
        echo "Установка Claude Code..."
        
        if ! command -v npm &> /dev/null; then
            echo "❌ npm не установлен, невозможно установить Claude Code"
            exit 1
        fi
        
        if ! npm install -g "$NPM_PACKAGE"; then
            echo "❌ Установка Claude Code не удалась"
            exit 1
        fi
        
        echo "✅ Установка Claude Code завершена"
    fi
}

# Настройка Claude Code
configure_claude_code() {
    echo "Настройка Claude Code..."
    
    # Создание директории .claude
    if [ ! -d "$CLAUDE_DIR" ]; then
        mkdir -p "$CLAUDE_DIR"
    fi
    
    # Резервное копирование оригинальной конфигурации (если существует)
    if [ -f "$SETTINGS_FILE" ]; then
        cp "$SETTINGS_FILE" "$SETTINGS_FILE.backup"
        echo "ℹ️ Оригинальная конфигурация сохранена как settings.json.backup"
    fi
    
    # Создание нового файла конфигурации
    cat > "$SETTINGS_FILE" << EOF
{
  "env": {
    "ANTHROPIC_API_KEY": "$API_KEY",
    "ANTHROPIC_BASE_URL": "$API_BASE_URL",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": 64000,
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  },
  "permissions": {
    "allow": [],
    "deny": []
  },
  "apiKeyHelper": "echo '$API_KEY'"
}
EOF
    
    echo "✅ Создание файла конфигурации завершено"
}

# Главная функция
main() {
    echo "🚀 Скрипт автоматической установки и настройки Claude Code"
    echo "========================================================="
    
    # Проверка конфигурации
    check_config
    
    # Определение операционной системы
    OS=$(detect_os)
    echo "Обнаруженная операционная система: $OS"
    
    # Установка зависимостей в зависимости от операционной системы
    case "$OS" in
        "macos")
            install_macos_packages
            ;;
        "linux")
            install_linux_packages
            ;;
        *)
            echo "❌ Неподдерживаемая операционная система: $OS"
            exit 1
            ;;
    esac
    
    # Установка Claude Code
    install_claude_code
    
    # Настройка Claude Code
    configure_claude_code
    
    echo "🎉 Все настройки завершены!"
    echo "Расположение файла конфигурации: $SETTINGS_FILE"
    echo "Теперь вы можете использовать команду 'claude'!"
}

# Запуск главной функции
main "$@"

4. Основное использование

Интерфейс Claude

4.1 Способы запуска

Интерактивный режим

bash

claude

Запуск с начальным промптом

bash

claude "explain this project"

Неинтерактивный режим

bash

claude -p "explain this function"

Обработка ввода по конвейеру

bash

cat logs.txt | claude -p "explain"

4.2 Общие команды

claude update - Обновление до последней версии
claude -c - Продолжение последнего разговора
claude -r <session-id> - Восстановление конкретной сессии
claude mcp - Настройка MCP сервера

5. Продвинутые функции

5.1 CLI справочник

Claude Code предоставляет богатые опции командной строки для настройки поведения:

Основные CLI команды

Команда	Описание	Пример
`claude`	Запуск интерактивного REPL	`claude`
`claude "query"`	Запуск REPL с начальным промптом	`claude "explain this project"`
`claude -p "query"`	Запрос через SDK с последующим выходом	`claude -p "explain this function"`
`claude -c`	Продолжение последнего разговора	`claude -c`
`claude update`	Обновление до последней версии	`claude update`

Важные CLI флаги

Флаг	Описание	Пример
`--allowedTools`	Список разрешенных инструментов	`--allowedTools "Bash(git log:*)" "Read"`
`--verbose`	Включение подробного логирования	`claude --verbose`
`--model`	Установка используемой модели	`claude --model claude-sonnet-4`
`--permission-mode`	Указание режима разрешений	`claude --permission-mode plan`
`--dangerously-skip-permissions`	Пропуск запросов разрешений (используйте осторожно)	`claude --dangerously-skip-permissions`

6. Практические уроки

6.1 Понимание новой кодовой базы

Быстрое получение обзора

Когда вы присоединяетесь к новому проекту и хотите быстро понять структуру, следуйте этим шагам:

Перейдите в корневой каталог проекта: cd /path/to/project
Запустите Claude Code: claude
Запросите обзор кодовой базы: > Расскажи мне обзор этой кодовой базы
Узнайте больше о конкретных компонентах:
- > Объясни основные архитектурные паттерны, используемые здесь
- > Какие основные модели данных?
- > Как обрабатывается аутентификация?

Советы:

Начинайте с широких вопросов и постепенно фокусируйтесь на конкретных областях
Спрашивайте о конвенциях кодирования и паттернах, используемых в проекте
Запросите глоссарий терминов, специфичных для проекта

6.2 Эффективное исправление багов

Диагностика сообщений об ошибках

Когда возникают ошибки, вы можете найти и исправить проблемы следующим образом:

Поделитесь сообщением об ошибке с Claude: > Получил ошибку при запуске npm test
Запросите предложения по исправлению: > Предложи способы исправить @ts-ignore в user.ts
Примените исправление: > Обнови user.ts для добавления предложенной проверки на null

Советы:

Сообщите Claude команду и трассировку стека для воспроизведения проблемы
Упомяните шаги для воспроизведения ошибки, если они есть
Укажите, является ли ошибка периодической или постоянной

7. Продвинутые функции

7.1 IDE интеграция

Claude Code поддерживает подключения к основным IDE:

Можно просматривать и взаимодействовать с изменениями Claude Code напрямую в IDE
Claude Code в настоящее время поддерживает VSCode и JetBrains
Пользователи Linux/macOS могут использовать плагины напрямую

7.2 Переключение моделей и настройки

Claude Code поддерживает гибкое переключение между Claude 4 Opus и Claude 4 Sonnet:

Настоятельно рекомендуется использовать Claude 4 Sonnet. Похожий опыт использования как у Claude 4 Opus, но стоимость на уровне 1/5
По умолчанию выбирает Claude 4 Sonnet, можно изменить в настройках после входа

7.3 Управление контекстом

Claude Code поддерживает сжатие контекста для экономии очков:

Claude Code обычно имеет длинный контекст, для экономии очков рекомендуется использовать следующую команду для сжатия
/compact [ваше описание]

7.4 Восстановление разговоров

Claude Code может восстанавливать предыдущие разговоры:

Вы можете восстановить последний разговор командой: claude --continue
Это немедленно восстанавливает последний разговор без промптов

8. Решение общих проблем

8.1 Проблемы сохранения памяти

Как Claude Code сохраняет память?

Claude Code сохраняет память в ~/.claude. Если нет особых требований, пожалуйста, не удаляйте этот каталог.

8.2 Проблемы с именами моделей

Почему иногда отвечает с неправильным именем модели?

TryAllAI обязуется не заменять запрошенную модель и не смешивать другие модели. Это потому, что Claude Code не использует модели серии Claude 4 при использовании простых задач.

8.3 Ошибки командной строки

Как решить ошибки выполнения параметров командной строки?

Такие проблемы часто возникают в WSL и являются ошибкой самого агента. Рекомендуется использовать macOS/Ubuntu, в таких средах меньше проблем.

5.2 Разрешения и безопасность

Claude Code принимает консервативный подход к разрешениям:

Конфигурация разрешений инструментов

json

{
  "permissions": {
    "allow": [
      "Read",
      "Write",
      "Bash(git status, git log, git diff)"
    ],
    "deny": [
      "Bash(rm, rmdir)"
    ]
  }
}

Используйте команду `/permissions` для интерактивного управления разрешениями

5.3 Контекст рабочего пространства

Claude Code автоматически определяет ваше рабочее пространство:

Сканирует файлы проекта для понимания структуры
Читает файлы README, package.json и другие файлы конфигурации
Анализирует зависимости и настройки проекта

5.4 Создание файла CLAUDE.md

Создайте файл CLAUDE.md в корне проекта для предоставления контекста:

markdown

# Описание проекта
Это веб-приложение React с бэкендом Node.js...

## Архитектура
- Фронтенд: React + TypeScript
- Бэкенд: Express.js + PostgreSQL
- Аутентификация: JWT токены

## Важные соглашения
- Используйте camelCase для переменных JavaScript
- Компоненты React должны быть в PascalCase

5.5 Функции разработки

Автоматическое выполнение тестов

Claude Code может запускать тесты и интерпретировать результаты:

Обнаруживает проблемы в неудачных тестах
Предлагает исправления на основе сообщений об ошибках
Может обновлять тесты в соответствии с изменениями кода

Управление зависимостями

Проверяет обновления пакетов
Анализирует уязвимости безопасности
Предлагает альтернативные пакеты

Рефакторинг кода

Claude Code может помочь с крупномасштабным рефакторингом:

Переименование функций и переменных во всей кодовой базе
Обновление устаревших API
Реструктуризация каталогов

5.6 MCP (Протокол модели контекста)

Claude Code поддерживает MCP для расширения функциональности:

Установка MCP-сервера

bash

claude mcp add my-server /path/to/server

Конфигурация MCP-сервера

Если вы хотите расширить функциональность Claude, подключив его к выделенным инструментам и внешним серверам, выполните следующие шаги:

Добавьте MCP Stdio сервер:
- Базовый синтаксис: claude mcp add <name> <command> [args...]
- Пример: добавить локальный сервер: claude mcp add my-server -e API_KEY=123 -- /path/to/server arg1 arg2
Управляйте MCP серверами:
- Перечислите все настроенные серверы: claude mcp list
- Получите подробную информацию о конкретном сервере: claude mcp get my-server
- Удалите сервер: claude mcp remove my-server

Советы:

Используйте флаг -s или --scope с project (по умолчанию) или global, чтобы указать, где хранить конфигурацию
Используйте флаг -e или --env для установки переменных среды (например, -e KEY=value)
MCP следует архитектуре клиент-сервер, где Claude Code (клиент) может подключаться к нескольким выделенным серверам

Подключение к серверу Postgres MCP

Если вы хотите, чтобы Claude имел доступ только для чтения к базе данных PostgreSQL для запросов и проверки схемы, выполните следующие шаги:

Добавьте сервер Postgres MCP:

bash

   claude mcp add postgres-server /path/to/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/mydb"

Используйте Claude для запросов к базе данных:
- > Опишите схему нашей пользовательской таблицы
- > Какие последние заказы в системе?
- > Покажите связь между клиентами и счетами

Советы:

Сервер Postgres MCP предоставляет доступ только для чтения, обеспечивая безопасность
Claude может помочь вам исследовать структуру базы данных и выполнять аналитические запросы
Используйте это для быстрого понимания схемы базы данных в незнакомых проектах
Убедитесь, что ваша строка подключения использует учетные данные с минимально необходимыми привилегиями

6. Практические учебники

6.3 Создание новых функций

Пошаговая разработка функций

При создании новых функций Claude Code может помочь вам в планировании и реализации:

Планирование: > Мне нужно добавить функцию рейтинга пользователей в наше приложение
Дизайн архитектуры: > Как следует структурировать модель рейтинга и API эндпойнты?
Реализация: > Создай REST API для рейтингов пользователей
Тестирование: > Напиши unit тесты для новой функции рейтинга

Пример workflow

> Добавь функцию рейтинга пользователей
- Claude предложит структуру базы данных
- Создаст миграции
- Реализует API эндпойнты
- Добавит фронтенд компоненты
- Напишет тесты

6.4 Анализ производительности

Claude Code может помочь выявить узкие места в производительности:

Анализ кода

> Найди потенциальные проблемы производительности в этом файле
> Как можно оптимизировать этот SQL запрос?
> Предложи улучшения для этого React компонента

Мониторинг ресурсов

Анализ использования памяти
Оптимизация сетевых запросов
Улучшение времени загрузки

6.5 Совместная разработка

Обзор кода

Claude Code может помочь в процессе обзора кода:

> Проверь этот pull request на возможные проблемы
> Предложи улучшения для этого кода
> Есть ли здесь проблемы безопасности?

Документация кода

Автоматическое создание комментариев
Генерация JSDoc/TSDoc
Создание README файлов

7. Продвинутые функции

7.1 IDE интеграция

Claude Code поддерживает подключения к основным IDE:

Можно просматривать и взаимодействовать с изменениями Claude Code напрямую в IDE
Claude Code в настоящее время поддерживает VSCode и JetBrains
Если вы используете Linux/macOS, вы можете использовать плагин напрямую
- Если вы используете VSCode, вызовите Claude Code во встроенном терминале VSCode, плагин установится автоматически
- Если вы используете JetBrains, загрузите плагин по ссылке: Claude Code [Beta] - IntelliJ IDEs Plugin
Возможно, потребуется вручную указать IDE или проверить подключение IDE с помощью команды: > /ide
Если вы используете VSCode+WSL, предварительно установите плагин WSL из магазина расширений VSCode
Для получения дополнительной информации обратитесь к официальной документации Claude Code

7.2 Переключение моделей и настройки

Claude Code поддерживает гибкое переключение между Claude 4 Opus и Claude 4 Sonnet:

Настоятельно рекомендуется использовать Claude 4 Sonnet. Опыт использования аналогичен Claude 4 Opus, но тарификация составляет только 1/5
По умолчанию выбрана Claude 4 Sonnet, можно изменить в настройках после входа
Если вы не отключили "Принудительное использование Sonnet" на сайте, переключение модели в /model не будет работать
Используйте эту команду в Claude Code для переключения модели: > /model

7.3 Управление контекстом

Claude Code поддерживает сжатие контекста для экономии очков:

Claude Code обычно имеет длинный контекст, рекомендуется использовать следующую slash-команду для сжатия и экономии очков, более длинные контексты часто требуют больше очков
/compact [ваше описание]

7.4 Восстановление разговоров

Claude Code может восстанавливать предыдущие разговоры:

Используйте следующую команду для восстановления последнего разговора: claude --continue
Это немедленно восстановит ваш последний разговор без каких-либо подсказок
Если нужно отобразить время, введите команду: claude --resume
Отобразится интерактивный селектор разговоров, показывающий:
- Время начала разговора
- Начальный промпт или резюме разговора
- Количество сообщений
Используйте клавиши со стрелками для навигации и нажмите Enter для выбора разговора, можно использовать этот метод для выбора контекста

7.5 Обработка изображений

Claude Code может обрабатывать изображения:

Можно использовать любой из следующих методов:
- Перетащить изображение в окно Claude Code (на macOS)
- Скопировать изображение и вставить его с помощью Ctrl+v в CLI (на macOS)
- Указать путь к изображению: > Проанализируй это изображение: /path/to/your/image.png
Можно полностью использовать естественный язык для запросов:
- > Это скриншот ошибки. Что ее вызывает?
- > Что показано на этом изображении?
- > Опиши элементы UI на этом скриншоте
- > Создай CSS для соответствия этому макету дизайна
- > Какая HTML структура может воссоздать этот компонент?

7.6 Глубокое мышление

Claude Code поддерживает глубокое мышление:

Нужно запросить глубокое мышление на естественном языке
> Мне нужно реализовать новую систему аутентификации OAuth2 для нашего API. Глубоко подумай о лучшем способе реализации этого в нашей кодовой базе.
> Подумай о потенциальных уязвимостях безопасности в этом подходе
> Глубже подумай о граничных случаях, которые мы должны обработать
Рекомендуется использовать эту функцию для сложных задач, это также потребляет значительное количество очков

7.7 Продвинутые операции Git

Claude Code поддерживает операции Git с использованием естественного языка:

> Зафиксируй мои изменения
> Создай pull request
> Какой коммит добавил тесты markdown в прошлом декабре?
> Сделай rebase на main ветку и разреши конфликты слияния

Использование рабочих деревьев Git

Можно использовать рабочие деревья для создания изолированных сред разработки:

Если нужно работать над несколькими задачами одновременно и полностью изолировать код между экземплярами Claude Code, можно использовать эту функцию
Рабочие деревья Git позволяют извлекать несколько веток из одного репозитория в отдельные каталоги. Каждое рабочее дерево имеет свой рабочий каталог с изолированными файлами, разделяя одну и ту же историю Git
Создание нового рабочего дерева:

bash

  # Создать рабочее дерево с новой веткой
  git worktree add ../project-feature-a -b feature-a
  
  # Или создать рабочее дерево с существующей веткой
  git worktree add ../project-bugfix bugfix-123

Запуск Claude Code в каждом рабочем дереве:

bash

  # Перейти в рабочее дерево
  cd ../project-feature-a
  
  # Запустить Claude Code в этой изолированной среде
  claude

7.8 Другие продвинутые функции

Claude Code поддерживает множество продвинутых функций:

Claude Code можно использовать как Unix-подобный инструмент
Claude Code поддерживает пользовательские slash-команды
Claude Code поддерживает добавление аргументов команд с $ARGUMENTS
Claude Code поддерживает расширенную конфигурацию настроек
Claude Code поддерживает интеграцию GitHub Actions
Claude Code поддерживает разработку SDK
Claude Code поддерживает протокол модельного контекста (MCP)

8. Устранение неполадок

8.1 Проблемы с сохранением памяти

Как Claude Code сохраняет память?

Claude Code сохраняет память в ~/.claude. Если нет особых требований, не удаляйте этот каталог.

8.2 Проблемы с именами моделей

Почему иногда отвечает с неправильным именем модели?

TryAllAI обязуется не заменять запрошенную модель и не смешивать другие модели. Это потому, что Claude Code не использует модели серии Claude 4 при выполнении простых задач.

8.3 Ошибки командной строки

Как решить ошибки выполнения параметров командной строки?

8.4 Очистка Claude Code

Как полностью очистить Claude Code?

Можно выполнить следующую команду для очистки информации о входе в Claude Code:

bash

rm ~/.claude* -rf

8.5 Ошибки API

Как решить API Error, Tools Error?

Обычно это проблемы сети, выйдите и используйте claude -c для повторного выполнения. Если проблема не исчезает, обратитесь в службу поддержки.

8.6 Ошибки OAuth аутентификации

Решение ошибок OAuth аутентификации

Убедитесь, что в переменных среды не настроен прокси перед входом в систему
Если проблема сохраняется, игнорируйте всплывающий браузер, скопируйте ссылку из терминала и откройте ее, проверьте с помощью кода верификации

8.7 Проблемы с таймаутом ответа

Что делать при долгом отсутствии ответа?

Рекомендуется нажать ctrl+c и перезапустить Claude Code, часто это проблемы сети
Если командная строка все еще не отвечает, рекомендуется завершить процесс и начать новую сессию, это не повлияет на ваш прогресс работы
Можно восстановить последнюю сессию следующей командой: claude -c

9. Заключение

Claude Code - это мощный ИИ-помощник программиста, с правильной настройкой и использованием он может значительно повысить эффективность разработки. Рекомендуется:

Начинать с основных функций и постепенно изучать продвинутые возможности
Настраивать конфигурацию согласно требованиям проекта
Использовать файл CLAUDE.md для записи информации, специфичной для проекта
Использовать правильное управление разрешениями для безопасности
Изучать расширение функциональности с помощью MCP и пользовательских команд

Приятного использования! Если у вас есть проблемы, обратитесь к официальной документации или поддержке сообщества.

Краткое руководство Claude Code ​

1. Установка и настройка ​

1.1 Системные требования ​

1.2 Шаги установки ​

2. Получение и настройка API ключа ​

2.1 Регистрация аккаунта ​

2.2 Генерация API ключа ​

3. Настройка конфигурационного файла ​

3.1 Настройка API ключа ​

Способ настройки конфигурационного файла ​

3.2 Настройки разрешений (опционально) ​

3.4 Быстрая настройка - Скрипт одним кликом ​

4. Основное использование ​

4.1 Способы запуска ​

Интерактивный режим ​

Запуск с начальным промптом ​

Неинтерактивный режим ​

Обработка ввода по конвейеру ​

4.2 Общие команды ​

5. Продвинутые функции ​

5.1 CLI справочник ​

Основные CLI команды ​

Важные CLI флаги ​

6. Практические уроки ​

6.1 Понимание новой кодовой базы ​

Быстрое получение обзора ​

6.2 Эффективное исправление багов ​

Диагностика сообщений об ошибках ​

7. Продвинутые функции ​

7.1 IDE интеграция ​

7.2 Переключение моделей и настройки ​

7.3 Управление контекстом ​

7.4 Восстановление разговоров ​

8. Решение общих проблем ​

8.1 Проблемы сохранения памяти ​

Как Claude Code сохраняет память? ​

8.2 Проблемы с именами моделей ​

Почему иногда отвечает с неправильным именем модели? ​

8.3 Ошибки командной строки ​

Как решить ошибки выполнения параметров командной строки? ​

5.2 Разрешения и безопасность ​

Конфигурация разрешений инструментов ​

Используйте команду /permissions для интерактивного управления разрешениями ​

5.3 Контекст рабочего пространства ​

5.4 Создание файла CLAUDE.md ​

5.5 Функции разработки ​

Автоматическое выполнение тестов ​

Управление зависимостями ​

Рефакторинг кода ​

5.6 MCP (Протокол модели контекста) ​

Установка MCP-сервера ​

Конфигурация MCP-сервера ​

Подключение к серверу Postgres MCP ​

6. Практические учебники ​

6.3 Создание новых функций ​

Пошаговая разработка функций ​

Пример workflow ​

6.4 Анализ производительности ​

Анализ кода ​

Мониторинг ресурсов ​

6.5 Совместная разработка ​

Обзор кода ​

Документация кода ​

7. Продвинутые функции ​

7.1 IDE интеграция ​

7.2 Переключение моделей и настройки ​

7.3 Управление контекстом ​

7.4 Восстановление разговоров ​

7.5 Обработка изображений ​

7.6 Глубокое мышление ​

7.7 Продвинутые операции Git ​

Использование рабочих деревьев Git ​

7.8 Другие продвинутые функции ​

8. Устранение неполадок ​

8.1 Проблемы с сохранением памяти ​

Как Claude Code сохраняет память? ​

8.2 Проблемы с именами моделей ​

Почему иногда отвечает с неправильным именем модели? ​

8.3 Ошибки командной строки ​

Как решить ошибки выполнения параметров командной строки? ​

Краткое руководство Claude Code

1. Установка и настройка

1.1 Системные требования

1.2 Шаги установки

2. Получение и настройка API ключа

2.1 Регистрация аккаунта

2.2 Генерация API ключа

3. Настройка конфигурационного файла

3.1 Настройка API ключа

Способ настройки конфигурационного файла

3.2 Настройки разрешений (опционально)

3.4 Быстрая настройка - Скрипт одним кликом

4. Основное использование

4.1 Способы запуска

Интерактивный режим

Запуск с начальным промптом

Неинтерактивный режим

Обработка ввода по конвейеру

4.2 Общие команды

5. Продвинутые функции

5.1 CLI справочник

Основные CLI команды

Важные CLI флаги

6. Практические уроки

6.1 Понимание новой кодовой базы

Быстрое получение обзора

6.2 Эффективное исправление багов

Диагностика сообщений об ошибках

7. Продвинутые функции

7.1 IDE интеграция

7.2 Переключение моделей и настройки

7.3 Управление контекстом

7.4 Восстановление разговоров

8. Решение общих проблем

8.1 Проблемы сохранения памяти

Как Claude Code сохраняет память?

8.2 Проблемы с именами моделей

Почему иногда отвечает с неправильным именем модели?

8.3 Ошибки командной строки

Как решить ошибки выполнения параметров командной строки?

5.2 Разрешения и безопасность

Конфигурация разрешений инструментов

Используйте команду `/permissions` для интерактивного управления разрешениями

5.3 Контекст рабочего пространства

5.4 Создание файла CLAUDE.md

5.5 Функции разработки

Автоматическое выполнение тестов

Управление зависимостями

Рефакторинг кода

5.6 MCP (Протокол модели контекста)

Установка MCP-сервера

Конфигурация MCP-сервера

Подключение к серверу Postgres MCP

6. Практические учебники

6.3 Создание новых функций

Пошаговая разработка функций

Пример workflow

6.4 Анализ производительности

Анализ кода

Мониторинг ресурсов

6.5 Совместная разработка

Обзор кода

Документация кода

7. Продвинутые функции

7.1 IDE интеграция

7.2 Переключение моделей и настройки

7.3 Управление контекстом

7.4 Восстановление разговоров

7.5 Обработка изображений

7.6 Глубокое мышление

7.7 Продвинутые операции Git

Использование рабочих деревьев Git

7.8 Другие продвинутые функции

8. Устранение неполадок

8.1 Проблемы с сохранением памяти

Как Claude Code сохраняет память?

8.2 Проблемы с именами моделей

Почему иногда отвечает с неправильным именем модели?

8.3 Ошибки командной строки

Как решить ошибки выполнения параметров командной строки?