Claude Code 终端 (CLI) 使用教程

Claude Code — это инструмент Agentic Coding, выпущенный компанией Anthropic, также известный как один из самых мощных программных агентов в мире. Терминал CLI является основной частью опыта Claude Code, вы можете запускать команду claude в любом терминале и взаимодействовать с ИИ для совместной работы над программированием. Этот документ в основном описывает, как установить, настроить и использовать Claude Code CLI через прокси-сервис AceData Cloud в терминале.

Процесс подачи заявки

Чтобы использовать Claude Code, сначала перейдите на страницу сервиса Claude Messages и нажмите кнопку «Acquire», чтобы получить необходимые учетные данные для запроса:

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

Установка Claude Code

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

macOS, Linux или Windows (включая WSL)
Node.js не является обязательным, способ установки по умолчанию автоматически обработает зависимости

Способы установки

Claude Code поддерживает несколько способов установки: Способ 1: Установка по умолчанию (рекомендуется) macOS / Linux / WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Способ 2: Homebrew (macOS / Linux)

brew install claude-code

Способ 3: WinGet (Windows)

winget install Claude.ClaudeCode

Установка по умолчанию будет автоматически обновляться в фоновом режиме, всегда поддерживая последнюю версию.

Настройка AceData Cloud API

После завершения установки по умолчанию вам будет предложено войти в свою учетную запись Anthropic. Мы можем использовать переменные окружения для настройки прокси API AceData Cloud, без необходимости в официальной подписке.

Настройка переменных окружения

Существует два способа настройки переменных окружения, выберите любой из них. Способ 1: Установка в конфигурационном файле Shell (рекомендуется) Добавьте следующий контент в ваш конфигурационный файл Shell (~/.zshrc, ~/.bashrc или ~/.bash_profile), заменив {token} на API токен, полученный в консоли AceData Cloud:

# AceData Cloud - Настройка прокси Claude Code
export ANTHROPIC_AUTH_TOKEN="{token}"
export ANTHROPIC_BASE_URL="https://api.acedata.cloud"

После изменения выполните следующую команду, чтобы применить настройки:

source ~/.zshrc  # или source ~/.bashrc

Способ 2: Установка в settings.json Claude Code Отредактируйте ~/.claude/settings.json (если не существует, создайте), добавив конфигурацию env:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud"
  }
}

Преимущество этого способа в том, что переменные окружения действуют только для Claude Code и не влияют на другие программы.

Подсказка: Токен API можно просмотреть в консоли AceData Cloud. Значение ANTHROPIC_AUTH_TOKEN будет автоматически добавлено с префиксом Bearer при отправке на сервер.

Начало работы

Запуск интерактивного режима

Откройте терминал, перейдите в каталог вашего проекта, затем выполните:

cd /path/to/your/project
claude

Вы увидите приветственный экран Claude Code, просто введите естественный язык, чтобы начать взаимодействие.

Часто используемые команды

Команда	Описание	Пример
`claude`	Запуск интерактивного режима	`claude`
`claude "задача"`	Выполнение одноразовой задачи	`claude "исправить ошибку сборки"`
`claude -p "запрос"`	Выполнение запроса и выход	`claude -p "объяснить эту функцию"`
`claude -c`	Продолжить последний диалог в текущем каталоге	`claude -c`
`claude -r`	Восстановить предыдущий диалог	`claude -r`
`claude commit`	Создание Git коммита	`claude commit`

Команды интерактивного режима

В интерактивном режиме можно использовать следующие встроенные команды:

Команда	Функция
`/help`	Показать справочную информацию
`/clear`	Очистить историю диалога
`/config`	Открыть панель настроек
`/model`	Переключить модель
`/mcp`	Управление MCP сервисом
`/compact`	Сжать контекст
`/memory`	Управление памятью
`/login`	Переключить учетную запись
`exit` или `Ctrl+C`	Выход

Примеры диалогового взаимодействия

# Анализ проекта
> что делает этот проект?

# Исправление ошибки
> есть ошибка, из-за которой пользователи могут отправлять пустые формы - исправь это

# Написание тестов
> напиши модульные тесты для функций калькулятора

# Рефакторинг кода
> рефакторинг модуля аутентификации для использования async/await

# Git операции
> зафиксируй мои изменения с описательным сообщением
> создай PR для этой функции

Расширенное использование

Конвейеры и скриптование

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

# Мониторинг логов и автоматическое уведомление
tail -f app.log | claude -p "если обнаружишь аномалию, сообщи мне"

# Автоматический перевод новых текстов
claude -p "если есть новые текстовые строки, переведи их на французский и создай PR"

# Код-ревью
git diff main | claude -p "проверь эти изменения"

Справочник переменных окружения

Вот некоторые из распространенных переменных окружения, поддерживаемых Claude Code:

Переменная	Описание
`ANTHROPIC_AUTH_TOKEN`	Значение для пользовательского заголовка Authorization (автоматически добавляется префикс Bearer)
`ANTHROPIC_API_KEY`	API ключ (отправляется как заголовок X-Api-Key)
`ANTHROPIC_BASE_URL`	Базовый URL API
`ANTHROPIC_MODEL`	Переопределение модели по умолчанию
`ANTHROPIC_SMALL_FAST_MODEL`	Модель уровня Haiku (для фоновых задач)
`MAX_THINKING_TOKENS`	Установка бюджета токенов на размышления (установите 0, чтобы отключить режим размышлений)
`DISABLE_COST_WARNINGS`	Установите 1, чтобы отключить предупреждения о расходах

Файл памяти проекта CLAUDE.md

Создайте файл CLAUDE.md в корневом каталоге проекта, чтобы предоставить Claude Code специфические для проекта инструкции и контекст. Claude автоматически загрузит этот файл при запуске.

# Описание проекта
Это полный стек проект на Django + Vue.js.

## Кодовые стандарты
- Использовать Python 3.12
- Следовать стилю кода PEP 8
- Все API должны иметь модульные тесты

Часто задаваемые вопросы

Что делать, если соединение не удалось?

Проверьте, правильно ли создан файл ~/.claude/config.json, содержимое должно быть {"primaryApiKey": "self"}
Убедитесь, что переменные окружения установлены правильно:
```
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL
```
Убедитесь, что токен API действителен (можно проверить в консоли)
Попробуйте перезапустить терминал

команда не найдена: claude

Если после установки появляется сообщение command not found, попробуйте:

Закрыть и снова открыть терминал
Проверить PATH: echo $PATH
Переустановить: curl -fsSL https://claude.ai/install.sh | bash

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

Войдите в консоль AceData Cloud, чтобы увидеть текущий остаток и использование вашего аккаунта.

Узнать больше

📖 Официальная документация Claude Code CLI
📋 Справочник команд CLI
🔧 Служба Claude Code AceData Cloud
💬 Если у вас есть вопросы, пожалуйста, свяжитесь с нами через службу поддержки платформы

​Процесс подачи заявки

​Установка Claude Code

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

​Способы установки

​Настройка AceData Cloud API

​Настройка переменных окружения

​Начало работы

​Запуск интерактивного режима

​Часто используемые команды

​Команды интерактивного режима

​Примеры диалогового взаимодействия

​Расширенное использование

​Конвейеры и скриптование

​Справочник переменных окружения

​Файл памяти проекта CLAUDE.md

​Часто задаваемые вопросы

​Что делать, если соединение не удалось?

​команда не найдена: claude

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

​Узнать больше