Настройка системы Linux/macOS

В этом руководстве описаны распространенные способы настройки переменных окружения Claude Code для стороннего API в Linux и macOS. Замените sk-xxxx-uocode на API Key, созданный в управлении токенами UoCode.

Вариант 1: Файл конфигурации Shell (постоянно)

Bash (Linux и старые версии macOS)

Отредактируйте файл ~/.bashrc:

nano ~/.bashrc

Или используйте привычный редактор:

vim ~/.bashrc

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

# Настройка стороннего API для Claude Code
export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"
export ANTHROPIC_BASE_URL="https://www.uocode.com"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

После сохранения выполните:

source ~/.bashrc

Проверьте, что переменные применились:

echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

Zsh (по умолчанию в macOS Catalina и новее)

Отредактируйте файл ~/.zshrc:

nano ~/.zshrc

Добавьте в конец файла:

# Настройка стороннего API для Claude Code
export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"
export ANTHROPIC_BASE_URL="https://www.uocode.com"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

После сохранения выполните:

source ~/.zshrc

Fish Shell

Отредактируйте файл ~/.config/fish/config.fish:

nano ~/.config/fish/config.fish

Добавьте в конец файла:

# Настройка стороннего API для Claude Code
set -gx ANTHROPIC_AUTH_TOKEN "sk-xxxx-uocode"
set -gx ANTHROPIC_BASE_URL "https://www.uocode.com"
set -gx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC "1"

После сохранения перезапустите Fish Shell.

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

Если нужно использовать настройки только в текущей сессии:

export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"
export ANTHROPIC_BASE_URL="https://www.uocode.com"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

# Проверка
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

# Запуск Claude Code
claude

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

Вариант 3: Настройка на уровне проекта (.env + скрипт запуска)

Шаг 1: Создайте файл .env в корне проекта

cd your-awesome-project

cat > .env << 'EOF'
ANTHROPIC_AUTH_TOKEN=sk-xxxx-uocode
ANTHROPIC_BASE_URL=https://www.uocode.com
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
EOF

Шаг 2: Создайте run-claude.sh

cat > run-claude.sh << 'EOF'
#!/bin/bash

# Загрузка переменных окружения из .env
if [ -f .env ]; then
  echo "Загрузка переменных окружения..."
  export $(cat .env | xargs)
  echo "Переменные окружения загружены"
else
  echo "Предупреждение: файл .env не найден"
fi

# Проверка переменных окружения
echo "Текущая конфигурация:"
echo "ANTHROPIC_AUTH_TOKEN: $ANTHROPIC_AUTH_TOKEN"
echo "ANTHROPIC_BASE_URL: $ANTHROPIC_BASE_URL"

# Запуск Claude Code
echo "Запуск Claude Code..."
claude
EOF

Шаг 3: Добавьте право на выполнение

chmod +x run-claude.sh

Шаг 4: Запустите скрипт

./run-claude.sh

Шаг 5 (необязательно): Создайте системный ярлык

# Создать символическую ссылку в пользовательском bin-каталоге
ln -s $(pwd)/run-claude.sh ~/bin/my-claude

# Проверка
which my-claude

# Затем можно использовать из любого каталога
my-claude

Редактирование settings.json (рекомендуется, нагляднее)

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

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

{
  "claudeCode.allowDangerouslySkipPermissions": true,
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "sk-xxxx-uocode"
    },
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://www.uocode.com"
    },
    {
      "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
      "value": "1"
    }
  ],
  "claudeCode.preferredLocation": "panel",
  "claudeCode.initialPermissionMode": "bypassPermissions",
  "claudeCode.selectedModel": "claude-haiku-4-5-20251001"
}

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

Использование CLI в командной строке

Если вы запускаете Claude Code напрямую из терминала, сначала задайте переменные окружения, затем запустите claude:

export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"
export ANTHROPIC_BASE_URL="https://www.uocode.com"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

claude

Также можно указать модель при запуске:

ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode" ANTHROPIC_BASE_URL="https://www.uocode.com" CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1" claude -m claude-haiku-4-5-20251001

Проверьте, что CLI установлен корректно:

claude --version
claude doctor

Быстрый старт

Для Bash можно выполнить:

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://www.uocode.com"' >> ~/.bashrc
echo 'export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"' >> ~/.bashrc
source ~/.bashrc
claude

Для Zsh замените ~/.bashrc на ~/.zshrc.