📚 Руководство по использованию Claude Code

Claude Code - это официальный помощник по программированию на основе ИИ от Anthropic, поддерживающий интеграцию через прокси-сервис cch. Это руководство поможет вам завершить установку и настройку на различных операционных системах.

macOS

Подготовка окружения: установка Node.js

claude требует среды выполнения Node.js (версия v18 или выше).

Способ 1: использование Homebrew (рекомендуется)

# 更新 Homebrew
brew update
# 安装 Node.js
brew install node

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

  1. Посетите https://nodejs.org/ https://nodejs.org/
  2. Загрузите версию LTS для macOS (требуется v18 или выше)
  3. Откройте загруженный файл .pkg и следуйте инструкциям мастера установки

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

node --version
npm --version

Если отображаются номера версий, установка выполнена успешно!

Установка claude claude

Официально рекомендуемый метод установки со следующими преимуществами:

  • Один исполняемый файл без зависимости Node.js
  • Более стабильный механизм автоматического обновления
  • Более быстрая скорость запуска

Способ 1: Homebrew (рекомендуется)

brew install --cask claude-code

Информация об автоматическом обновлении

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

Способ 2: скрипт curl

# 安装稳定版（默认）
curl -fsSL https://claude.ai/install.sh | bash

# 安装最新版
curl -fsSL https://claude.ai/install.sh | bash -s latest

# 安装指定版本
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

Проверка установки

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

claude --version

Если отображается номер версии, поздравляем! Claude Code успешно установлен.

Совет

Перед установкой убедитесь в удалении устаревших псевдонимов или символических ссылок. Используйте команду claude doctor для проверки типа установки и версии.

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

Способ 1: конфигурация settings.json (рекомендуется)

Путь к файлу конфигурации:

~/.claude/settings.json

Пояснение пути

  • Windows: C:/Users/your-username/.claude
  • Linux или macOS: ~/.claude
  • Если файл settings.json не существует, создайте его

Отредактируйте файл settings.json и добавьте следующее содержимое:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key-here",
    "ANTHROPIC_BASE_URL": "Текущий адрес сайта",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

Важное примечание

  • Замените your-api-key-here на ваш фактический ключ API
  • Как получить ключ: войдите в консоль → управление ключами API → создать ключ

Способ 2: конфигурация переменных окружения

Временная настройка (текущий сеанс):

export ANTHROPIC_BASE_URL="Текущий адрес сайта"
export ANTHROPIC_AUTH_TOKEN="your-api-key-here"

Постоянная настройка:

Добавьте в файл конфигурации оболочки ($~/.zshrc 或 ~/.bash_profile):

echo 'export ANTHROPIC_BASE_URL="Текущий адрес сайта"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key-here"' >> ~/.zshrc
source ~/.zshrc

Проверка конфигурации

После конфигурации проверьте правильность установки переменных окружения:

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

Пример ожидаемого вывода:

Текущий адрес сайта
sk_xxxxxxxxxxxxxxxxxx

Примечание

Если вывод пуст или показывает имя переменной, это означает, что установка переменной окружения не удалась. Повторите указанные выше действия.

Конфигурация расширения VS Code

Путь к файлу конфигурации: ~/.claude

  1. Найдите и установите Claude Code for VS Code в расширениях VS Code
  2. Создайте файл config.json в директории ~/.claude (если его нет)
  3. Добавьте следующее содержимое:
// Path: ~/.claude
{
  "primaryApiKey": "any-value"
}

Примечание

  • Это config.json, а не settings.json
  • Значение поля primaryApiKey может быть любым, если оно существует

Запуск claude

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

cd /path/to/your/project
claude

При первом запуске claude выполнит первоначальную конфигурацию.

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

1. Команда не найдена

# Проверьте глобальный путь установки npm и добавьте его в PATH (если его там нет)
npm config get prefix

# 添加到 PATH（如果不在）
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

2. Сбой подключения API

# 检查环境变量
echo $ANTHROPIC_AUTH_TOKEN

# 测试网络连接
curl -I Текущий адрес сайта

3. Обновление claude

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

Windows

Подготовка окружения: установка Node.js

claude требует среды выполнения Node.js (версия v18 или выше).

Способ 1: загрузка с официального сайта (рекомендуется)

  1. Посетите https://nodejs.org/ https://nodejs.org/
  2. Загрузите версию LTS (требуется v18 или выше)
  3. Дважды щелкните файл .msi и следуйте инструкциям мастера установки (сохраните параметры по умолчанию)

Способ 2: использование диспетчера пакетов

# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

Совет

Рекомендуется использовать PowerShell вместо CMD для лучшего опыта

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

node --version
npm --version

Если отображаются номера версий, установка выполнена успешно!

Установка claude claude

Официально рекомендуемый метод установки со следующими преимуществами:

  • Один исполняемый файл без зависимости Node.js
  • Более стабильный механизм автоматического обновления
  • Более быстрая скорость запуска

Способ 1: PowerShell

# Установка стабильной версии (по умолчанию)
irm https://claude.ai/install.ps1 | iex

# Установка последней версии
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest

# Установка конкретной версии
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

Способ 2: CMD

REM Установка стабильной версии (по умолчанию)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

REM Установка последней версии
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd latest && del install.cmd

REM Установка конкретной версии
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd

Проверка установки

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

claude --version

Если отображается номер версии, поздравляем! Claude Code успешно установлен.

Совет

Перед установкой убедитесь в удалении устаревших псевдонимов или символических ссылок. Используйте команду claude doctor для проверки типа установки и версии.

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

Способ 1: конфигурация settings.json (рекомендуется)

Путь к файлу конфигурации:

C:\Users\你的用户名\.claude\settings.json

Пояснение пути

  • Windows: C:/Users/your-username/.claude
  • Linux или macOS: ~/.claude
  • Если файл settings.json не существует, создайте его

Отредактируйте файл settings.json и добавьте следующее содержимое:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key-here",
    "ANTHROPIC_BASE_URL": "Текущий адрес сайта",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

Важное примечание

  • Замените your-api-key-here на ваш фактический ключ API
  • Как получить ключ: войдите в консоль → управление ключами API → создать ключ

Способ 2: конфигурация переменных окружения

Временная настройка (текущий сеанс):

$env:ANTHROPIC_BASE_URL = "Текущий адрес сайта"
$env:ANTHROPIC_AUTH_TOKEN = "your-api-key-here"

Постоянная настройка (уровень пользователя):

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "Текущий адрес сайта", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your-api-key-here", [System.EnvironmentVariableTarget]::User)

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

Проверка конфигурации

После конфигурации проверьте правильность установки переменных окружения:

Выполните в PowerShell:

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

Выполните в CMD:

echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%

Пример ожидаемого вывода:

Текущий адрес сайта
sk_xxxxxxxxxxxxxxxxxx

Примечание

Если вывод пуст или показывает имя переменной, это означает, что установка переменной окружения не удалась. Повторите указанные выше действия.

Конфигурация расширения VS Code

Путь к файлу конфигурации: C:\Users\你的用户名\.claude

  1. Найдите и установите Claude Code for VS Code в расширениях VS Code
  2. Создайте файл config.json в директории ~/.claude (если его нет)
  3. Добавьте следующее содержимое:
// Path: C:\Users\你的用户名\.claude
{
  "primaryApiKey": "any-value"
}

Примечание

  • Это config.json, а не settings.json
  • Значение поля primaryApiKey может быть любым, если оно существует

Запуск claude

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

cd C:\path\to\your\project
claude

При первом запуске claude выполнит первоначальную конфигурацию.

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

1. Команда не найдена

  • Убедитесь, что глобальный путь npm (обычно C:\Users\your-username\AppData\Roaming\npm) добавлен в PATH системы
  • Переоткройте окно PowerShell

2. Сбой подключения API

# 检查环境变量
echo $env:ANTHROPIC_AUTH_TOKEN

# 测试网络连接
Test-NetConnection -ComputerName Текущий адрес сайта -Port 443

3. Обновление claude

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

Linux

Подготовка окружения: установка Node.js

claude требует среды выполнения Node.js (версия v18 или выше).

Способ 1: использование официального репозитория (рекомендуется)

# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs

Способ 2: использование диспетчера пакетов системы

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

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

node --version
npm --version

Если отображаются номера версий, установка выполнена успешно!

Установка claude claude

Официально рекомендуемый метод установки со следующими преимуществами:

  • Один исполняемый файл без зависимости Node.js
  • Более стабильный механизм автоматического обновления
  • Более быстрая скорость запуска

Установка со скриптом curl

# Установка стабильной версии (по умолчанию)
curl -fsSL https://claude.ai/install.sh | bash

# Установка последней версии
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Установка конкретной версии
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

Особые примечания для Alpine Linux

Дистрибутивы на основе musl/uClibc (например Alpine Linux) требуют установки дополнительных зависимостей:

apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0

Проверка установки

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

claude --version

Если отображается номер версии, поздравляем! Claude Code успешно установлен.

Совет

Перед установкой убедитесь в удалении устаревших псевдонимов или символических ссылок. Используйте команду claude doctor для проверки типа установки и версии.

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

Способ 1: конфигурация settings.json (рекомендуется)

Путь к файлу конфигурации:

~/.claude/settings.json

Пояснение пути

  • Windows: C:/Users/your-username/.claude
  • Linux или macOS: ~/.claude
  • Если файл settings.json не существует, создайте его

Отредактируйте файл settings.json и добавьте следующее содержимое:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key-here",
    "ANTHROPIC_BASE_URL": "Текущий адрес сайта",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

Важное примечание

  • Замените your-api-key-here на ваш фактический ключ API
  • Как получить ключ: войдите в консоль → управление ключами API → создать ключ

Способ 2: конфигурация переменных окружения

Временная настройка (текущий сеанс):

export ANTHROPIC_BASE_URL="Текущий адрес сайта"
export ANTHROPIC_AUTH_TOKEN="your-api-key-here"

Постоянная настройка:

Добавьте в файл конфигурации оболочки ($~/.bashrc 或 ~/.zshrc):

echo 'export ANTHROPIC_BASE_URL="Текущий адрес сайта"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key-here"' >> ~/.bashrc
source ~/.bashrc

Проверка конфигурации

После конфигурации проверьте правильность установки переменных окружения:

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

Пример ожидаемого вывода:

Текущий адрес сайта
sk_xxxxxxxxxxxxxxxxxx

Примечание

Если вывод пуст или показывает имя переменной, это означает, что установка переменной окружения не удалась. Повторите указанные выше действия.

Конфигурация расширения VS Code

Путь к файлу конфигурации: ~/.claude

  1. Найдите и установите Claude Code for VS Code в расширениях VS Code
  2. Создайте файл config.json в директории ~/.claude (если его нет)
  3. Добавьте следующее содержимое:
// Path: ~/.claude
{
  "primaryApiKey": "any-value"
}

Примечание

  • Это config.json, а не settings.json
  • Значение поля primaryApiKey может быть любым, если оно существует

Запуск claude

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

cd /path/to/your/project
claude

При первом запуске claude выполнит первоначальную конфигурацию.

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

1. Команда не найдена

# Проверьте глобальный путь установки npm и добавьте его в PATH (если его там нет)
npm config get prefix

# 添加到 PATH（如果不在）
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

2. Сбой подключения API

# 检查环境变量
echo $ANTHROPIC_AUTH_TOKEN

# 测试网络连接
curl -I Текущий адрес сайта

3. Обновление claude

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

📚 Руководство по использованию Codex CLI

Codex - это официальный помощник программирования на основе ИИ OpenAI, поддерживающий интеграцию через прокси cch. Примечание: Codex использует формат, совместимый с OpenAI, конечная точка должна включать путь /v1.

macOS

Подготовка окружения: установка Node.js

claude требует среды выполнения Node.js (версия v18 или выше).

Способ 1: использование Homebrew (рекомендуется)

# 更新 Homebrew
brew update
# 安装 Node.js
brew install node

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

  1. Посетите https://nodejs.org/ https://nodejs.org/
  2. Загрузите версию LTS для macOS (требуется v18 или выше)
  3. Откройте загруженный файл .pkg и следуйте инструкциям мастера установки

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

node --version
npm --version

Если отображаются номера версий, установка выполнена успешно!

Установка codex codex

Выполните:

npm i -g @openai/codex --registry=https://registry.npmmirror.com

Проверка установки:

codex --version

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

Способ 1: метод конфигурационного файла (рекомендуется)

  1. Откройте проводник файлов, найдите папку ~/.codex (создайте, если она не существует)
  2. Создайте файл config.toml
  3. Откройте текстовым редактором и добавьте следующее содержимое:
model_provider = "cch"
model = "gpt-5.1-codex"
model_reasoning_effort = "high"
disable_response_storage = true
sandbox_mode = "workspace-write"

[features]
plan_tool = true
apply_patch_freeform = true
view_image_tool = true
web_search_request = true
unified_exec = false
streamable_shell = false
rmcp_client = true

[model_providers.cch]
name = "cch"
base_url = "Текущий адрес сайта/v1"
wire_api = "responses"
env_key = "CCH_API_KEY"
requires_openai_auth = true

[sandbox_workspace_write]
network_access = true
  1. Создайте файл auth.json и добавьте:
{
  "OPENAI_API_KEY": "your-api-key-here"
}

Важное примечание

  • Замените your-api-key-here на ваш ключ API cch
  • Примечание: Codex использует формат, совместимый с OpenAI, конечная точка включает путь /v1

Способ 2: конфигурация переменных окружения

Установите переменные окружения:

echo 'export CCH_API_KEY="your-api-key-here"' >> ~/.zshrc
source ~/.zshrc

Конфигурация расширения VS Code

  1. Найдите и установите Codex – OpenAI's coding agent в расширениях VS Code
  2. Убедитесь, что вы настроили config.toml и auth.json в соответствии с указанными выше шагами
  3. Установите переменную окружения CCH_API_KEY

Важно

env_key может быть только названием переменной окружения (например CCH_API_KEY), а не полным ключом. Если вы прямо укажете ключ, это приведет к ошибке токена.

Запуск codex

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

cd /path/to/your/project
codex

При первом запуске codex выполнит первоначальную конфигурацию.

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

1. Команда не найдена

# Проверьте глобальный путь установки npm и добавьте его в PATH (если его там нет)
npm config get prefix

# 添加到 PATH（如果不在）
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

2. Сбой подключения API

# 检查环境变量
echo $CCH_API_KEY

# 测试网络连接
curl -I Текущий адрес сайта

3. Обновление codex

npm i -g @openai/codex --registry=https://registry.npmmirror.com

Windows

Подготовка окружения: установка Node.js

claude требует среды выполнения Node.js (версия v18 или выше).

Способ 1: загрузка с официального сайта (рекомендуется)

  1. Посетите https://nodejs.org/ https://nodejs.org/
  2. Загрузите версию LTS (требуется v18 или выше)
  3. Дважды щелкните файл .msi и следуйте инструкциям мастера установки (сохраните параметры по умолчанию)

Способ 2: использование диспетчера пакетов

# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

Совет

Рекомендуется использовать PowerShell вместо CMD для лучшего опыта

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

node --version
npm --version

Если отображаются номера версий, установка выполнена успешно!

Установка codex codex

Запустите PowerShell с правами администратора,Выполните:

npm i -g @openai/codex --registry=https://registry.npmmirror.com

Проверка установки:

codex --version

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

Способ 1: метод конфигурационного файла (рекомендуется)

  1. Откройте проводник файлов, найдите папку C:\Users\你的用户名\.codex (создайте, если она не существует)
  2. Создайте файл config.toml
  3. Откройте текстовым редактором и добавьте следующее содержимое:
model_provider = "cch"
model = "gpt-5.1-codex"
model_reasoning_effort = "high"
disable_response_storage = true
sandbox_mode = "workspace-write"
windows_wsl_setup_acknowledged = true

[features]
plan_tool = true
apply_patch_freeform = true
view_image_tool = true
web_search_request = true
unified_exec = false
streamable_shell = false
rmcp_client = true

[model_providers.cch]
name = "cch"
base_url = "Текущий адрес сайта/v1"
wire_api = "responses"
env_key = "CCH_API_KEY"
requires_openai_auth = true

[sandbox_workspace_write]
network_access = true
  1. Создайте файл auth.json и добавьте:
{
  "OPENAI_API_KEY": "your-api-key-here"
}

Важное примечание

  • Замените your-api-key-here на ваш ключ API cch
  • Примечание: Codex использует формат, совместимый с OpenAI, конечная точка включает путь /v1

Способ 2: конфигурация переменных окружения

Выполните в PowerShell:

[System.Environment]::SetEnvironmentVariable("CCH_API_KEY", "your-api-key-here", [System.EnvironmentVariableTarget]::User)

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

Конфигурация расширения VS Code

  1. Найдите и установите Codex – OpenAI's coding agent в расширениях VS Code
  2. Убедитесь, что вы настроили config.toml и auth.json в соответствии с указанными выше шагами
  3. Установите переменную окружения CCH_API_KEY

Важно

env_key может быть только названием переменной окружения (например CCH_API_KEY), а не полным ключом. Если вы прямо укажете ключ, это приведет к ошибке токена.

Запуск codex

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

cd C:\path\to\your\project
codex

При первом запуске codex выполнит первоначальную конфигурацию.

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

1. Команда не найдена

  • Убедитесь, что глобальный путь npm (обычно C:\Users\your-username\AppData\Roaming\npm) добавлен в PATH системы
  • Переоткройте окно PowerShell

2. Сбой подключения API

# 检查环境变量
echo $env:CCH_API_KEY

# 测试网络连接
Test-NetConnection -ComputerName Текущий адрес сайта -Port 443

3. Обновление codex

npm i -g @openai/codex --registry=https://registry.npmmirror.com

Linux

Подготовка окружения: установка Node.js

claude требует среды выполнения Node.js (версия v18 или выше).

Способ 1: использование официального репозитория (рекомендуется)

# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs

Способ 2: использование диспетчера пакетов системы

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

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

node --version
npm --version

Если отображаются номера версий, установка выполнена успешно!

Установка codex codex

Выполните:

npm i -g @openai/codex --registry=https://registry.npmmirror.com

Проверка установки:

codex --version

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

Способ 1: метод конфигурационного файла (рекомендуется)

  1. Откройте проводник файлов, найдите папку ~/.codex (создайте, если она не существует)
  2. Создайте файл config.toml
  3. Откройте текстовым редактором и добавьте следующее содержимое:
model_provider = "cch"
model = "gpt-5.1-codex"
model_reasoning_effort = "high"
disable_response_storage = true
sandbox_mode = "workspace-write"

[features]
plan_tool = true
apply_patch_freeform = true
view_image_tool = true
web_search_request = true
unified_exec = false
streamable_shell = false
rmcp_client = true

[model_providers.cch]
name = "cch"
base_url = "Текущий адрес сайта/v1"
wire_api = "responses"
env_key = "CCH_API_KEY"
requires_openai_auth = true

[sandbox_workspace_write]
network_access = true
  1. Создайте файл auth.json и добавьте:
{
  "OPENAI_API_KEY": "your-api-key-here"
}

Важное примечание

  • Замените your-api-key-here на ваш ключ API cch
  • Примечание: Codex использует формат, совместимый с OpenAI, конечная точка включает путь /v1

Способ 2: конфигурация переменных окружения

Установите переменные окружения:

echo 'export CCH_API_KEY="your-api-key-here"' >> ~/.bashrc
source ~/.bashrc

Конфигурация расширения VS Code

  1. Найдите и установите Codex – OpenAI's coding agent в расширениях VS Code
  2. Убедитесь, что вы настроили config.toml и auth.json в соответствии с указанными выше шагами
  3. Установите переменную окружения CCH_API_KEY

Важно

env_key может быть только названием переменной окружения (например CCH_API_KEY), а не полным ключом. Если вы прямо укажете ключ, это приведет к ошибке токена.

Запуск codex

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

cd /path/to/your/project
codex

При первом запуске codex выполнит первоначальную конфигурацию.

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

1. Команда не найдена

# Проверьте глобальный путь установки npm и добавьте его в PATH (если его там нет)
npm config get prefix

# 添加到 PATH（如果不在）
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

2. Сбой подключения API

# 检查环境变量
echo $CCH_API_KEY

# 测试网络连接
curl -I Текущий адрес сайта

3. Обновление codex

npm i -g @openai/codex --registry=https://registry.npmmirror.com

📚 Руководство по использованию Gemini CLI

Gemini CLI - это официальный инструмент командной строки для программирования с использованием ИИ от Google, поддерживающий интеграцию через прокси-сервис cch. Это руководство поможет вам завершить установку и настройку на различных операционных системах.

macOS

Подготовка окружения: установка Node.js

claude требует среды выполнения Node.js (версия v18 или выше).

Способ 1: использование Homebrew (рекомендуется)

# 更新 Homebrew
brew update
# 安装 Node.js
brew install node

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

  1. Посетите https://nodejs.org/ https://nodejs.org/
  2. Загрузите версию LTS для macOS (требуется v18 или выше)
  3. Откройте загруженный файл .pkg и следуйте инструкциям мастера установки

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

node --version
npm --version

Если отображаются номера версий, установка выполнена успешно!

Установка gemini gemini

Убедитесь, что у вас установлен Node.js 18 или выше, затем глобально установите Gemini CLI:

npm install -g @google/gemini-cli

Проверка установки:

gemini --version

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

Метод 1: Конфигурационный файл (рекомендуется)

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

Конфигурационные файлы Gemini CLI находятся в каталоге ~/.gemini/.

macOS / Linux:

mkdir -p ~/.gemini
Создание файла конфигурации .env

Создайте файл .env в каталоге ~/.gemini/:

macOS / Linux:

nano ~/.gemini/.env

Добавьте следующее содержимое:

GOOGLE_GEMINI_BASE_URL=Текущий адрес сайта
GEMINI_API_KEY=your-api-key-here
GEMINI_MODEL=gemini-3-pro-preview
Создание файла конфигурации settings.json

Создайте файл settings.json в каталоге ~/.gemini/:

{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

Этот конфигурационный файл включает интеграцию с IDE и устанавливает метод аутентификации на API Key.

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

  • GOOGLE_GEMINI_BASE_URL: Базовый URL API cch
  • GEMINI_API_KEY: Ваш API-ключ, созданный в консоли cch
  • GEMINI_MODEL: Используемая модель (по умолчанию gemini-2.5-pro)

Важно

  • Замените YOUR_API_KEY_HERE на ваш фактический API-ключ
  • Как получить ключ: Войдите в консоль → Управление API-ключами → Создать ключ

Метод 2: Конфигурация переменных окружения

Если вы хотите использовать временно, вы можете настроить через переменные окружения:

macOS / Linux:

export GOOGLE_GEMINI_BASE_URL="Текущий адрес сайта"
export GEMINI_API_KEY="your-api-key-here"
export GEMINI_MODEL="gemini-2.5-pro"

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

Запуск и проверка

Запуск Gemini CLI

Перейдите в каталог проекта и запустите Gemini CLI:

cd /path/to/your/project
gemini

При первом запуске Gemini CLI прочитает настройки из конфигурационного файла.

Проверка конфигурации

Попробуйте отправить простой запрос в Gemini CLI для тестирования подключения:

Привет, пожалуйста, помогите мне создать программу hello world на Python

Если Gemini CLI отвечает нормально, конфигурация успешна!

Использование режима Agent

Gemini CLI поддерживает режим Agent, который может автоматически планировать и выполнять сложные задачи:

gemini --agent

В режиме Agent Gemini будет:

  • Автоматически анализировать требования задачи
  • Разрабатывать планы выполнения
  • Выполнять пошагово и проверять результаты
  • Корректировать стратегии на основе обратной связи

Общие проблемы

1. Команда не найдена

# Проверьте глобальный путь установки npm и добавьте его в PATH (если его там нет)
npm config get prefix

# 添加到 PATH（如果不在）
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

2. Сбой подключения API

  • Проверьте, правильно ли установлен GEMINI_API_KEY в переменных окружения или конфигурационном файле
  • Проверьте, правильный ли GOOGLE_GEMINI_BASE_URL
  • Тестируйте сетевое подключение

3. Обновление gemini

npm install -g @google/gemini-cli

Windows

Подготовка окружения: установка Node.js

claude требует среды выполнения Node.js (версия v18 или выше).

Способ 1: загрузка с официального сайта (рекомендуется)

  1. Посетите https://nodejs.org/ https://nodejs.org/
  2. Загрузите версию LTS (требуется v18 или выше)
  3. Дважды щелкните файл .msi и следуйте инструкциям мастера установки (сохраните параметры по умолчанию)

Способ 2: использование диспетчера пакетов

# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

Совет

Рекомендуется использовать PowerShell вместо CMD для лучшего опыта

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

node --version
npm --version

Если отображаются номера версий, установка выполнена успешно!

Установка gemini gemini

Убедитесь, что у вас установлен Node.js 18 или выше, затем глобально установите Gemini CLI:

npm install -g @google/gemini-cli

Проверка установки:

gemini --version

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

Метод 1: Конфигурационный файл (рекомендуется)

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

Конфигурационные файлы Gemini CLI находятся в каталоге ~/.gemini/.

Windows (PowerShell):

mkdir $env:USERPROFILE\.gemini
Создание файла конфигурации .env

Создайте файл .env в каталоге ~/.gemini/:

Windows: Создайте файл .env в каталоге %USERPROFILE%\.gemini\

Добавьте следующее содержимое:

GOOGLE_GEMINI_BASE_URL=Текущий адрес сайта
GEMINI_API_KEY=your-api-key-here
GEMINI_MODEL=gemini-3-pro-preview
Создание файла конфигурации settings.json

Создайте файл settings.json в каталоге ~/.gemini/:

{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

Этот конфигурационный файл включает интеграцию с IDE и устанавливает метод аутентификации на API Key.

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

  • GOOGLE_GEMINI_BASE_URL: Базовый URL API cch
  • GEMINI_API_KEY: Ваш API-ключ, созданный в консоли cch
  • GEMINI_MODEL: Используемая модель (по умолчанию gemini-2.5-pro)

Важно

  • Замените YOUR_API_KEY_HERE на ваш фактический API-ключ
  • Как получить ключ: Войдите в консоль → Управление API-ключами → Создать ключ

Метод 2: Конфигурация переменных окружения

Если вы хотите использовать временно, вы можете настроить через переменные окружения:

Windows (PowerShell):

$env:GOOGLE_GEMINI_BASE_URL="Текущий адрес сайта"
$env:GEMINI_API_KEY="your-api-key-here"
$env:GEMINI_MODEL="gemini-2.5-pro"

Windows (CMD):

set GOOGLE_GEMINI_BASE_URL=Текущий адрес сайта
set GEMINI_API_KEY=your-api-key-here
set GEMINI_MODEL=gemini-3-pro-preview

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

Запуск и проверка

Запуск Gemini CLI

Перейдите в каталог проекта и запустите Gemini CLI:

cd C:\path\to\your\project
gemini

При первом запуске Gemini CLI прочитает настройки из конфигурационного файла.

Проверка конфигурации

Попробуйте отправить простой запрос в Gemini CLI для тестирования подключения:

Привет, пожалуйста, помогите мне создать программу hello world на Python

Если Gemini CLI отвечает нормально, конфигурация успешна!

Использование режима Agent

Gemini CLI поддерживает режим Agent, который может автоматически планировать и выполнять сложные задачи:

gemini --agent

В режиме Agent Gemini будет:

  • Автоматически анализировать требования задачи
  • Разрабатывать планы выполнения
  • Выполнять пошагово и проверять результаты
  • Корректировать стратегии на основе обратной связи

Общие проблемы

1. Команда не найдена

  • Убедитесь, что глобальный путь npm (обычно C:\Users\your-username\AppData\Roaming\npm) добавлен в PATH системы
  • Переоткройте окно PowerShell

2. Сбой подключения API

  • Проверьте, правильно ли установлен GEMINI_API_KEY в переменных окружения или конфигурационном файле
  • Проверьте, правильный ли GOOGLE_GEMINI_BASE_URL
  • Тестируйте сетевое подключение

3. Обновление gemini

npm install -g @google/gemini-cli

Linux

Подготовка окружения: установка Node.js

claude требует среды выполнения Node.js (версия v18 или выше).

Способ 1: использование официального репозитория (рекомендуется)

# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs

Способ 2: использование диспетчера пакетов системы

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

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

node --version
npm --version

Если отображаются номера версий, установка выполнена успешно!

Установка gemini gemini

Убедитесь, что у вас установлен Node.js 18 или выше, затем глобально установите Gemini CLI:

npm install -g @google/gemini-cli

Проверка установки:

gemini --version

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

Метод 1: Конфигурационный файл (рекомендуется)

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

Конфигурационные файлы Gemini CLI находятся в каталоге ~/.gemini/.

macOS / Linux:

mkdir -p ~/.gemini
Создание файла конфигурации .env

Создайте файл .env в каталоге ~/.gemini/:

macOS / Linux:

nano ~/.gemini/.env

Добавьте следующее содержимое:

GOOGLE_GEMINI_BASE_URL=Текущий адрес сайта
GEMINI_API_KEY=your-api-key-here
GEMINI_MODEL=gemini-3-pro-preview
Создание файла конфигурации settings.json

Создайте файл settings.json в каталоге ~/.gemini/:

{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

Этот конфигурационный файл включает интеграцию с IDE и устанавливает метод аутентификации на API Key.

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

  • GOOGLE_GEMINI_BASE_URL: Базовый URL API cch
  • GEMINI_API_KEY: Ваш API-ключ, созданный в консоли cch
  • GEMINI_MODEL: Используемая модель (по умолчанию gemini-2.5-pro)

Важно

  • Замените YOUR_API_KEY_HERE на ваш фактический API-ключ
  • Как получить ключ: Войдите в консоль → Управление API-ключами → Создать ключ

Метод 2: Конфигурация переменных окружения

Если вы хотите использовать временно, вы можете настроить через переменные окружения:

macOS / Linux:

export GOOGLE_GEMINI_BASE_URL="Текущий адрес сайта"
export GEMINI_API_KEY="your-api-key-here"
export GEMINI_MODEL="gemini-2.5-pro"

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

Запуск и проверка

Запуск Gemini CLI

Перейдите в каталог проекта и запустите Gemini CLI:

cd /path/to/your/project
gemini

При первом запуске Gemini CLI прочитает настройки из конфигурационного файла.

Проверка конфигурации

Попробуйте отправить простой запрос в Gemini CLI для тестирования подключения:

Привет, пожалуйста, помогите мне создать программу hello world на Python

Если Gemini CLI отвечает нормально, конфигурация успешна!

Использование режима Agent

Gemini CLI поддерживает режим Agent, который может автоматически планировать и выполнять сложные задачи:

gemini --agent

В режиме Agent Gemini будет:

  • Автоматически анализировать требования задачи
  • Разрабатывать планы выполнения
  • Выполнять пошагово и проверять результаты
  • Корректировать стратегии на основе обратной связи

Общие проблемы

1. Команда не найдена

# Проверьте глобальный путь установки npm и добавьте его в PATH (если его там нет)
npm config get prefix

# 添加到 PATH（如果不在）
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

2. Сбой подключения API

  • Проверьте, правильно ли установлен GEMINI_API_KEY в переменных окружения или конфигурационном файле
  • Проверьте, правильный ли GOOGLE_GEMINI_BASE_URL
  • Тестируйте сетевое подключение

3. Обновление gemini

npm install -g @google/gemini-cli

📚 Руководство по использованию Droid CLI

Droid - это интерактивный помощник программирования на основе ИИ, разработанный Factory AI, поддерживающий интеграцию через прокси-сервис cch. Перед использованием вы должны зарегистрировать и войти в свой официальный аккаунт Droid.

macOS

Установка droid droid

Выполните:

curl -fsSL https://app.factory.ai/cli | sh

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

Предварительное условие: сначала необходимо войти в официальный аккаунт Droid

  1. Выполните команду droid
  2. Следуйте подсказкам для входа в официальный аккаунт Factory через браузер
  3. После успешного входа вы можете продолжить конфигурацию пользовательских моделей

Конфигурация пользовательских моделей

Путь к файлу конфигурации:

~/.factory/config.json

Отредактируйте файл конфигурации и добавьте следующее содержимое:

{
  "custom_models": [
    {
      "model_display_name": "Sonnet 4.5 [cch]",
      "model": "claude-sonnet-4-5-20250929",
      "base_url": "Текущий адрес сайта",
      "api_key": "your-api-key-here",
      "provider": "anthropic"
    },
    {
      "model_display_name": "GPT-5-Codex [cch]",
      "model": "gpt-5-codex",
      "base_url": "Текущий адрес сайта/v1",
      "api_key": "your-api-key-here",
      "provider": "openai"
    }
  ]
}

Важные примечания

  • Замените your-api-key-here на ваш ключ API cch
  • Формат Anthropic: используйте Текущий адрес сайта (без /v1)
  • Формат OpenAI: используйте Текущий адрес сайта/v1 (требуется /v1)

Переключение моделей

  1. Перезагрузите Droid
  2. Введите команду /model
  3. Выберите GPT-5-Codex [cch] или Sonnet 4.5 [cch]
  4. Начните использовать!

Запуск droid

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

cd /path/to/your/project
droid

При первом запуске droid выполнит первоначальную настройку.

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

1. Команда не найдена

# Проверьте глобальный путь установки npm и добавьте его в PATH (если еще не добавлен)
npm config get prefix

# 添加到 PATH（如果不在）
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

2. Обновление droid

Повторно запустите скрипт установки для обновления до последней версии.

Windows

Установка droid droid

Выполните в PowerShell:

irm https://app.factory.ai/cli/windows | iex

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

Предварительное условие: сначала необходимо войти в официальный аккаунт Droid

  1. Выполните команду droid
  2. Следуйте подсказкам для входа в официальный аккаунт Factory через браузер
  3. После успешного входа вы можете продолжить конфигурацию пользовательских моделей

Конфигурация пользовательских моделей

Путь к файлу конфигурации:

%USERPROFILE%\.factory\config.json

Отредактируйте файл конфигурации и добавьте следующее содержимое:

{
  "custom_models": [
    {
      "model_display_name": "Sonnet 4.5 [cch]",
      "model": "claude-sonnet-4-5-20250929",
      "base_url": "Текущий адрес сайта",
      "api_key": "your-api-key-here",
      "provider": "anthropic"
    },
    {
      "model_display_name": "GPT-5-Codex [cch]",
      "model": "gpt-5-codex",
      "base_url": "Текущий адрес сайта/v1",
      "api_key": "your-api-key-here",
      "provider": "openai"
    }
  ]
}

Важные примечания

  • Замените your-api-key-here на ваш ключ API cch
  • Формат Anthropic: используйте Текущий адрес сайта (без /v1)
  • Формат OpenAI: используйте Текущий адрес сайта/v1 (требуется /v1)

Переключение моделей

  1. Перезагрузите Droid
  2. Введите команду /model
  3. Выберите GPT-5-Codex [cch] или Sonnet 4.5 [cch]
  4. Начните использовать!

Запуск droid

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

cd C:\path\to\your\project
droid

При первом запуске droid выполнит первоначальную настройку.

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

1. Команда не найдена

  • Убедитесь, что глобальный путь npm (обычно C:\Users\your-username\AppData\Roaming\npm) добавлен в системный PATH
  • Перезапустите окно PowerShell

2. Обновление droid

Повторно запустите скрипт установки для обновления до последней версии.

Linux

Установка droid droid

Выполните:

curl -fsSL https://app.factory.ai/cli | sh

Совет

Пользователи Linux должны убедиться, что установлен xdg-utils:

sudo apt-get install xdg-utils

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

Предварительное условие: сначала необходимо войти в официальный аккаунт Droid

  1. Выполните команду droid
  2. Следуйте подсказкам для входа в официальный аккаунт Factory через браузер
  3. После успешного входа вы можете продолжить конфигурацию пользовательских моделей

Конфигурация пользовательских моделей

Путь к файлу конфигурации:

~/.factory/config.json

Отредактируйте файл конфигурации и добавьте следующее содержимое:

{
  "custom_models": [
    {
      "model_display_name": "Sonnet 4.5 [cch]",
      "model": "claude-sonnet-4-5-20250929",
      "base_url": "Текущий адрес сайта",
      "api_key": "your-api-key-here",
      "provider": "anthropic"
    },
    {
      "model_display_name": "GPT-5-Codex [cch]",
      "model": "gpt-5-codex",
      "base_url": "Текущий адрес сайта/v1",
      "api_key": "your-api-key-here",
      "provider": "openai"
    }
  ]
}

Важные примечания

  • Замените your-api-key-here на ваш ключ API cch
  • Формат Anthropic: используйте Текущий адрес сайта (без /v1)
  • Формат OpenAI: используйте Текущий адрес сайта/v1 (требуется /v1)

Переключение моделей

  1. Перезагрузите Droid
  2. Введите команду /model
  3. Выберите GPT-5-Codex [cch] или Sonnet 4.5 [cch]
  4. Начните использовать!

Запуск droid

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

cd /path/to/your/project
droid

При первом запуске droid выполнит первоначальную настройку.

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

1. Команда не найдена

# Проверьте глобальный путь установки npm и добавьте его в PATH (если еще не добавлен)
npm config get prefix

# 添加到 PATH（如果不在）
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

2. Обновление droid

Повторно запустите скрипт установки для обновления до последней версии.

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

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

  • /help - Просмотр справочной информации
  • /clear - Очистить историю чата и начать новый разговор
  • /compact - Суммировать текущий разговор
  • /cost - Просмотреть сумму расходов в текущем разговоре
  • /model - Переключение моделей (только для Droid)
  • Для получения дополнительных команд см. официальную документацию Для получения дополнительных команд см. официальную документацию

🔍 Общее устранение неполадок

Ошибка установки

  • Проверьте нормальность подключения к сети
  • Убедитесь, что у вас есть права администратора (Windows) или используйте sudo (macOS / Linux)
  • Попробуйте использовать прокси или зеркало источника (npm может использовать параметр --registry)

Ключ API недействителен

  • Убедитесь, что ключ скопирован правильно (без лишних пробелов)
  • Проверьте, находится ли ключ в периоде действия
  • Убедитесь, что разрешения учетной записи в порядке
  • Убедитесь, что используется правильный формат конечной точки (Anthropic без /v1, OpenAI с /v1)

Ошибка конфигурации конечной точки

  • Claude Code / Droid модель Anthropic: используйте Текущий адрес сайта (без /v1)
  • Codex / Droid модель OpenAI: используйте Текущий адрес сайта/v1 (должна включать /v1)