Переменные окружения

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

Поддерживаемые переменные

ANTHROPIC_API_KEY / CRAFT_ANTHROPIC_API_KEY

Предоставьте ключ API Anthropic без локального хранения. Оба имени поддерживаются; CRAFT_ANTHROPIC_API_KEY имеет приоритет, если оба заданы.

export ANTHROPIC_API_KEY="sk-ant-api03-..."
craft -p "Check my tasks"

CRAFT_CLAUDE_OAUTH_TOKEN

Предоставьте OAuth-токен Claude (для подписок Claude Pro/Max) без локального хранения.

export CRAFT_CLAUDE_OAUTH_TOKEN="your-oauth-token"

ANTHROPIC_BASE_URL

Переопределите URL конечной точки API. Это устанавливается автоматически AIKraft Agents при настройке не-Anthropic провайдера (OpenRouter, Vercel AI Gateway, Ollama или пользовательский endpoint) через интерфейс.

export ANTHROPIC_BASE_URL="https://openrouter.ai/api"

Вы также можете установить это вручную для маршрутизации всех вызовов API через пользовательский endpoint:

# Use OpenRouter
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"

# Use local Ollama
export ANTHROPIC_BASE_URL="http://localhost:11434"

Эта переменная обычно управляется AIKraft Agents на основе вашей конфигурации API-провайдера. Вам нужно устанавливать её вручную только для автоматизации или сценариев CI.

AWS Credentials (Bedrock)

При использовании AWS Bedrock с authType: "environment", дочерний процесс наследует стандартные переменные окружения AWS из вашей оболочки:

export AWS_ACCESS_KEY_ID="AKIA..."
export AWS_SECRET_ACCESS_KEY="..."
export AWS_SESSION_TOKEN="..."     # optional, for STS temporary credentials
export AWS_REGION="us-east-1"      # or set awsRegion in the connection config
export AWS_PROFILE="my-profile"    # use a named profile from ~/.aws/credentials

Эти переменные следуют стандартной цепочке учетных данных AWS SDK — ~/.aws/credentials, SSO-сессии, IAM-роли и профили экземпляров все работают.

С authType: "iam_credentials" учетные данные вводятся в интерфейсе и автоматически инъектируются в дочерний процесс. В этом случае вам не нужно устанавливать эти переменные окружения.

CRAFT_CONFIG_DIR

Переопределите каталог конфигурации по умолчанию. По умолчанию AIKraft Agents хранит конфигурацию в ~/.craft-agent/.

export CRAFT_CONFIG_DIR="/custom/path/to/config"

Это влияет на расположение:

• config.json
• preferences.json
• credentials.enc
• Конфигурации workspace

CRAFT_LOCAL_MCP_ENABLED

Включите или отключите поддержку локальных MCP-серверов (подпроцессы stdio).

export CRAFT_LOCAL_MCP_ENABLED="false"

Эта переменная требует точной строчной строки "true" для включения. Значения вроде "True", "TRUE", "yes" или "1" будут рассматриваться как отключенные.

Это также можно настроить для каждого workspace в настройщике workspace.

CRAFT_DEBUG

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

export CRAFT_DEBUG="true"

Переменные серверного режима

Эти переменные настраивают удалённый сервер при работе в автономном или встроенном режиме.

CRAFT_SERVER_TOKEN

Токен носителя для аутентификации сервера. Требуется как для сервера, так и для клиента.

export CRAFT_SERVER_TOKEN=$(openssl rand -hex 32)

CRAFT_SERVER_URL

URL сервера для подключений клиента. Устанавливайте это на стороне клиента для подключения к удалённому серверу.

export CRAFT_SERVER_URL=wss://your-server:9100

CRAFT_RPC_HOST

Адрес привязки для сервера. По умолчанию 127.0.0.1 (только localhost). Установите 0.0.0.0, чтобы принимать удалённые подключения.

export CRAFT_RPC_HOST=0.0.0.0

CRAFT_RPC_PORT

Порт сервера. По умолчанию 9100.

export CRAFT_RPC_PORT=9100

CRAFT_RPC_TLS_CERT / CRAFT_RPC_TLS_KEY

Файлы сертификата PEM и закрытого ключа для TLS. Требуются для удалённых подключений (wss://). Можно опустить для локальной разработки.

export CRAFT_RPC_TLS_CERT=/path/to/cert.pem
export CRAFT_RPC_TLS_KEY=/path/to/key.pem

CRAFT_RPC_TLS_CA

Необязательный файл цепочки CA PEM для пользовательских центров сертификации.

export CRAFT_RPC_TLS_CA=/path/to/ca.pem

Переменные разработки

Эти переменные в первую очередь используются для разработки и многопроцессных сценариев.

CRAFT_VITE_PORT

Переопределите порт dev-сервера Vite. Автоматически устанавливается при запуске из пронумерованных папок экземпляров.

export CRAFT_VITE_PORT="5173"

CRAFT_APP_NAME

Переопределите отображаемое имя приложения. Полезно для различения нескольких экземпляров.

export CRAFT_APP_NAME="AIKraft Agents [Dev]"

CRAFT_INSTANCE_NUMBER

Идентификатор экземпляра для поддержки множественных экземпляров. При установке добавляет значок на иконку док-панели.

export CRAFT_INSTANCE_NUMBER="1"

CRAFT_DEEPLINK_SCHEME

Пользовательская схема deep link URL. По умолчанию craftagents.

export CRAFT_DEEPLINK_SCHEME="craftagents1"

VITE_DEV_SERVER_URL

URL dev-сервера Vite. Используется внутренне во время разработки.

export VITE_DEV_SERVER_URL="http://localhost:5173"

Приоритет

Для учетных данных API порядок поиска:

1. Переменная окружения CRAFT_ANTHROPIC_API_KEY или ANTHROPIC_API_KEY
2. Переменная окружения CRAFT_CLAUDE_OAUTH_TOKEN (для OAuth)
3. Сохранённые учетные данные в ~/.craft-agent/credentials.enc
4. Интерактивный запрос (если запущено интерактивно)

Для базового URL API:

1. Переменная окружения ANTHROPIC_BASE_URL
2. Базовый URL подключения (настроенный в LLM-подключениях)
3. По умолчанию (https://api.anthropic.com)

Для выбора модели:

1. Модель по умолчанию LLM-подключения (если задана)
2. Модель по умолчанию на уровне приложения (для каждого провайдера)
3. Системная модель по умолчанию (Claude Sonnet)

Для каталога конфигурации:

1. Переменная окружения CRAFT_CONFIG_DIR
2. По умолчанию ~/.craft-agent/

Примеры использования

Конвейер CI/CD

#!/bin/bash
export ANTHROPIC_API_KEY="${SECRETS_ANTHROPIC_KEY}"

craft -w "Work" -p "Generate release notes from recent commits"

Контейнер Docker

ENV ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
ENV CRAFT_CONFIG_DIR=/app/config

CMD ["craft", "-w", "default", "-p", "..."]

Временное переопределение

Используйте другой ключ API для одной команды:

ANTHROPIC_API_KEY="sk-ant-different-key" craft -p "Quick check"

Пользовательский каталог конфигурации

export CRAFT_CONFIG_DIR="/home/user/.config/craft-agent"
craft -p "Using custom config location"

Примечания по безопасности

Избегайте размещения ключей API непосредственно в истории команд или скриптах. Используйте менеджеры секретов или безопасную инъекцию переменных окружения.

Безопасные альтернативы:

# Read from file
export ANTHROPIC_API_KEY=$(cat ~/.secrets/anthropic-key)

# Read from secret manager
export ANTHROPIC_API_KEY=$(aws secretsmanager get-secret-value --secret-id anthropic-key --query SecretString --output text)

# Use .env file (not committed to git)
source .env && craft -p "..."