환경 변수

환경 변수는 제공자 자격 증명을 구성하고 런타임 동작을 토글합니다 — CI/CD 및 컨테이너 환경에 유용합니다.

제공자 API 키

제공자 키는 SDK의 표준 변수 이름을 사용합니다. 전체 목록은 AI 제공자를 참조하세요.

Anthropic

export ANTHROPIC_API_KEY="sk-ant-api03-..."

OpenAI

export OPENAI_API_KEY="sk-proj-..."

Google (Gemini)

export GOOGLE_GENERATIVE_AI_API_KEY="AI..."
# GEMINI_API_KEY도 허용됩니다

OpenRouter

export OPENROUTER_API_KEY="sk-or-..."

Groq

export GROQ_API_KEY="gsk_..."

Azure OpenAI

export AZURE_RESOURCE_NAME="your-resource"
export AZURE_API_KEY="..."

AWS Bedrock

export AWS_ACCESS_KEY_ID="AKIA..."
export AWS_SECRET_ACCESS_KEY="..."
export AWS_REGION="us-east-1"
# 또는 bearer 토큰:
export AWS_BEARER_TOKEN_BEDROCK="..."

설정 경로 변수

동작 플래그

이 변수들은 런타임 동작을 토글합니다. 불리언 플래그는 참값(1, true)으로 설정하면 활성화됩니다.

서버 자격 증명

cyberstrike serve 및 cyberstrike web에서 사용:

export CYBERSTRIKE_SERVER_PASSWORD="..."   # 서버 시작에 필요
export CYBERSTRIKE_SERVER_USERNAME="admin" # 선택 사항, 기본값 존재

설정에서 변수 참조

설정 파일은 두 가지 치환만 지원합니다:

환경 변수 — {env:VAR}

{
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:ANTHROPIC_API_KEY}"
      }
    }
  }
}

{env:VAR}는 VAR의 값으로 대체되거나, 설정되지 않은 경우 빈 문자열로 대체됩니다. 쉘 스타일의 ${VAR}, $VAR, 기본값 구문({env:VAR:-default})은 지원되지 않습니다.

파일 내용 — {file:path}

{
  "instructions": ["{file:./SECURITY.md}"]
}

경로는 설정 파일 기준 상대 경로, 절대 경로, 또는 홈 디렉토리용 ~/로 시작할 수 있습니다.

자동화를 위한 권한 재정의

cyberstrike run (비대화형)은 프롬프트가 필요한 도구 호출을 자동으로 거부합니다. CI에서 도구를 사전 승인하려면 CYBERSTRIKE_PERMISSION으로 JSON 권한 맵을 전달합니다:

export CYBERSTRIKE_PERMISSION='{"bash":"allow","edit":"allow","read":"allow"}'

값은 설정의 permission 필드와 동일한 형태를 따릅니다. 권한을 참조하세요.

쉘 구성

Bash / Zsh

export ANTHROPIC_API_KEY="sk-ant-..."
export CYBERSTRIKE_AUTO_SHARE=1

Fish

set -gx ANTHROPIC_API_KEY "sk-ant-..."
set -gx CYBERSTRIKE_AUTO_SHARE 1

.env 파일

ANTHROPIC_API_KEY=sk-ant-...
CYBERSTRIKE_PERMISSION={"bash":"allow"}

# 실행 전 로드
source .env && cyberstrike

CI/CD 통합

GitHub Actions

env:
  ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
  CYBERSTRIKE_PERMISSION: '{"bash":"allow","read":"allow","edit":"allow"}'

steps:
  - name: Security Scan
    run: cyberstrike run "scan for vulnerabilities"

GitLab CI

variables:
  CYBERSTRIKE_PERMISSION: '{"bash":"allow","read":"allow"}'

security_scan:
  script:
    - cyberstrike run "analyze code for security issues"

Docker

Docker Run

docker run -it \
  -e ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY" \
  -e CYBERSTRIKE_PERMISSION='{"bash":"allow"}' \
  cyberstrike/cyberstrike

Docker Compose

services:
  cyberstrike:
    image: cyberstrike/cyberstrike
    environment:
      - ANTHROPIC_API_KEY
      - CYBERSTRIKE_AUTO_SHARE=1
    env_file:
      - .env

우선순위 순서

설정 소스는 이 순서로 병합됩니다 (가장 높은 것이 적용):

1. 명령줄 인수
2. 엔터프라이즈 관리 설정
3. CYBERSTRIKE_CONFIG_CONTENT (인라인 JSON)
4. .cyberstrike/ 디렉토리 설정
5. 프로젝트 설정 (cyberstrike.json / .jsonc)
6. CYBERSTRIKE_CONFIG (커스텀 파일)
7. 전역 설정 (~/.config/cyberstrike/)
8. 원격 .well-known/cyberstrike
9. 기본값

자세한 내용은 구성 레퍼런스를 참조하세요.

변수 확인

# 활성 Cyberstrike 변수 나열
env | grep CYBERSTRIKE

# 제공자 키가 설정되어 있는지 확인 (전체를 출력하지 않고)
echo "${ANTHROPIC_API_KEY:0:12}..."

보안

1. 전체 API 키를 절대 에코하지 마세요
2. CI/CD에서 시크릿 관리를 사용하세요
3. 정기적으로 키를 교체하세요
4. .env 권한을 제한하세요: chmod 600 .env

관련 문서

• 구성 레퍼런스 - 모든 구성 옵션
• 프로젝트 구성 - 프로젝트 설정
• 전역 구성 - 전역 설정
• 인증 - 인증 설정