Руководство по началу работы с Claude Code

Claude Code — официальный агентный инструмент Anthropic уровня CLI.

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

Claude Code — это агент, а не чат.

Подробные руководства см. здесь:https://www.example.com/claude-code/claude-code-tutorial.html

Основные возможности:

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

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

MacOS/Linux:

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

Homebrew (MacOS):

brew install --cask claude-code

Windows:

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

NPM:

Установите через npm. Убедитесь, что в вашей системе установлен Node.js v18 или выше.

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

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

cd your-project
claude

Войдите в свою учетную запись

При запуске интерактивного сеанса с помощью команды claude необходимо войти в систему:

claude
# 首次使用时会提示您登录
/login
# 按照提示使用您的账户登录

Если у вас есть возможность нормально использовать учетную запись Anthropic, можно начинать пользоваться. Если нет — можно использовать DeepSeek, GLM и другие локальные сервисы.

Интеграция DeepSeek с Claude Code

После установки Claude Code задайте в терминале следующие переменные среды:

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

Описание параметров:

CLAUDE_CODE_EFFORT_LEVEL: Глубина мышления, варианты: low / medium / max
ANTHROPIC_MODEL: Укажите модель deepseek-v4-pro[1m]
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1: Отключить ненужный трафик

Затем перейдите в каталог проекта, выполните команду claude — и можно начинать пользоваться.

cd my-project
claude

Справочная документация:https://api-docs.deepseek.com/zh-cn/guides/anthropic_api

Интеграция Alibaba Bailian с Claude Code

Модели серии Qwen от Alibaba Cloud Bailian поддерживают интерфейсы, совместимые с Anthropic API. Изменив следующие параметры, вы сможете вызывать модели серии Qwen в Claude Code.

ANTHROPIC_API_KEY (или ANTHROPIC_AUTH_TOKEN): замените на API Key Bailian. Адрес для получения:https://bailian.console.aliyun.com/cn-beijing/?tab=model#/api-key。
ANTHROPIC_BASE_URL: замените на совместимый адрес конечной точки Bailianhttps://dashscope.aliyuncs.com/apps/anthropic。
Название модели: замените на название модели, поддерживаемое Bailian (например, qwen3-max, qwen3-coder-plus и т. д.)

macOS/Linux：

Создайте и откройте файл конфигурации~/.claude/settings.json。

~Обозначает домашний каталог пользователя. Если каталог.claudeне существует, его нужно сначала создать. Можно выполнить в терминалеmkdir -p ~/.claude , чтобы создать его.

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

vim ~/.claude/settings.json

Замените YOUR_API_KEY на ваш выделенный API Key.

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3-coder-plus"
    }
}

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

Windows：

Выполните следующие команды в CMD, чтобы установить переменные среды:

setx ANTHROPIC_AUTH_TOKEN "YOUR_API_KEY"
setx ANTHROPIC_BASE_URL "https://dashscope.aliyuncs.com/apps/anthropic"
setx ANTHROPIC_MODEL "qwen3-coder-plus"

Замените YOUR_API_KEY на выделенный API-ключ тарифного плана.

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

echo %ANTHROPIC_AUTH_TOKEN%
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%

Выполните следующие команды в PowerShell, чтобы установить переменные среды:

# 用套餐专属 API Key 替换 YOUR_API_KEY
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://dashscope.aliyuncs.com/apps/anthropic", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "qwen3-coder-plus", [EnvironmentVariableTarget]::User)

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

echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL

Интеграция моделей серии Qwen в Claude Code

Во время диалога выполните команду/model <model name>, чтобы переключить модель.

/model qwen3-coder-plus

Также можно создать в корневом каталоге проекта файл.claude/settings.jsonи записать в него информацию о конфигурации модели для постоянной настройки.

{
  "env": {
    "ANTHROPIC_MODEL": "qwen3-coder-plus",
    "ANTHROPIC_SMALL_FAST_MODEL": "qwen-flash"
  }
}

Запустите Claude, и вы увидите информацию о конфигурации:

Интеграция больших моделей Zhipu AI с Claude Code

В этом разделе мы используем файл ~/.claude/settings.json для настройки большой модели. Перед началом вам нужно получить API-ключ на официальной платформе:GLM Coding Plan。

Отредактируйте или добавьте файл конфигурации Claude Code ~/.claude/settings.json и добавьте или измените в нём поле env

# 注意替换里面的your_zhipu_api_key 为您上一步获取到的 API Key
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "your_zhipu_api_key",
        "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
        "API_TIMEOUT_MS": "3000000",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
    }
}

Запустите claude, чтобы запустить Claude Code, введите/status, чтобы подтвердить статус модели:

Если нет, можно ввести/config, чтобы переключить модели.

При большом количестве больших моделей настройка становится затруднительной. Вы можете использовать сторонний инструмент CC Switch для удобного управления конфигурациями API этих популярных инструментов:https://github.com/farion1231/cc-switch/, Windows / macOS / Linux полностью поддерживаются.

Ссылки для скачивания установочных пакетов для каждой платформы:https://github.com/farion1231/cc-switch/releases。

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

Если вам не нравится использовать режим командной строки Claude Code, мы можем установить Claude Code в редакторе VS Code.

Откройте VS Code, перейдите в магазин расширений, найдитеClaude Codeи установите:

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

Таким образом, пользователи с аккаунтами могут использовать /login для входа:

Вы также можете ввести /config в диалоговом окне, чтобы перейти к настройкам, и установить флажок в конфигурации Disable Login Prompt, чтобы закрыть страницу входа:

Справочник по связанным командам

Список встроенных команд Claude Code

Команда	Описание
`/add-dir`	Добавить дополнительный рабочий каталог
`/agents`	Управление выделенными ИИ-субагентами
`/bashes`	Просмотр и управление фоновыми задачами
`/bug`	Сообщить об ошибке (отправить беседу в Anthropic)
`/clear`	Очистить историю беседы
`/compact [指令]`	Сжать беседу, при необходимости добавить ключевые инструкции
`/config`	Открыть интерфейс настроек (вкладка «Конфигурация»)
`/context`	Визуализировать текущее использование контекста в виде цветной сетки
`/cost`	Показать статистику использования токенов
`/doctor`	Проверить работоспособность установки Claude Code
`/exit`	Выйти из REPL
`/export [文件名]`	Экспортировать текущий диалог в файл или буфер обмена
`/help`	Получить справку по использованию, показать все доступные команды
`/hooks`	Управление конфигурациями хуков для событий инструментов
`/ide`	Управление интеграциями с IDE и отображение статуса
`/init`	Инициализировать проект с помощью руководства CLAUDE.md
`/install-github-app`	Настроить Claude GitHub Actions для репозитория
`/login`	Переключать аккаунты Anthropic
`/logout`	Выйти из аккаунта Anthropic
`/mcp`	Управление подключениями к серверам MCP и аутентификацией OAuth
`/memory`	Редактировать файл памяти CLAUDE.md
`/model`	Выбрать или изменить модель ИИ
`/output-style [样式]`	Непосредственно задать стиль вывода или выбрать из меню
`/permissions`	Просмотреть или обновить разрешения
`/plugin`	Управление плагинами Claude Code
`/pr-comments`	Просмотреть комментарии к PR
`/privacy-settings`	Просмотреть и обновить настройки конфиденциальности
`/release-notes`	Просмотреть примечания к выпуску
`/resume`	Возобновить беседу
`/review`	Запросить проверку кода
`/rewind`	Откатить беседу и/или код
`/sandbox`	Включить инструмент sandbox bash с изоляцией файловой системы и сети
`/security-review`	Выполнить проверку безопасности ожидающих изменений в текущей ветке
`/status`	Открыть интерфейс настроек (вкладка Status), показывающий версию, модель, учётную запись и состояние подключения
`/statusline`	Настроить интерфейс строки состояния Claude Code
`/terminal-setup`	Установить клавишу перевода строки Shift+Enter (только для iTerm и VSCode)
`/todos`	Показать текущие задачи
`/usage`	Отображать лимиты использования плана и статус ограничения скорости (только для планов по подписке)
`/vim`	Войти в режим vim, переключаясь между режимами вставки и команд

Пользовательские типы команд

Тип команды	Расположение	Описание
Команды проекта	`.claude/commands/`	Хранятся в репозитории, доступны команде
Личные команды	`~/.claude/commands/`	Доступны во всех проектах
Команды плагинов	Плагина`commands/`Содержание	Распространение через Plugin Marketplace
Команды MCP	Предоставляется MCP-сервером	Формат:`/mcp__<服务器名>__<提示名>`

Команды оболочки (вне сессий)

Команда	Описание
`claude`	Запустить интерактивную сессию Claude Code
`claude -p "查询"`	Неинтерактивный режим, завершается после вывода результатов
`claude --dangerously-skip-permissions`	Пропустить все проверки разрешений (опасный режим)
`claude --debug`	Включить режим отладки
`claude --mcp-debug`	Режим отладки MCP
`claude mcp add`	Добавить MCP-сервер
`claude mcp list`	Список настроенных MCP-серверов
`claude mcp remove`	Удалить MCP-сервер

Особенности

Поддержка пользовательских команд:

$ARGUMENTS- Захват всех аргументов
$1, $2, $3...- Доступ к отдельным позиционным аргументам
@filename- Ссылка на содержимое файлов
!command- Выполнение команд bash и включение вывода

Метаданные frontmatter команды:

allowed-tools- Список инструментов, доступных команде
argument-hint- Описания подсказок параметров
description- Краткое описание команды
model- Указать модель
disable-model-invocation- Запретить вызов инструмента SlashCommand

Для получения дополнительной связанной информации вы можете/helpПосмотреть полный список доступных команд (включая ваши пользовательские команды).

Связанные ресурсы

Учебник по Claude Code:https://www.example.com/claude-code/claude-code-tutorial.html
Репозиторий с открытым исходным кодом:https://github.com/anthropics/claude-code
Официальная документация:https://code.claude.com/docs/zh-CN/overview
DeepSeek Anthropic API：https://api-docs.deepseek.com/zh-cn/guides/anthropic_api
Интеграция модели Zhipu AI с Claude Code:https://docs.bigmodel.cn/cn/coding-plan/tool/claude#claude-code

Другие расширения

Vibe Coding Инструменты