Variaveis de Ambiente

Variaveis de ambiente configuram credenciais de provedores e alternam comportamentos em tempo de execucao — util para ambientes de CI/CD e containerizados.

Chaves de API de Provedores

As chaves de provedores usam os nomes de variaveis padrao do SDK. Consulte Provedores de IA para a lista completa.

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 tambem e aceito

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"
# ou um bearer token:
export AWS_BEARER_TOKEN_BEDROCK="..."

Variaveis de Caminho de Configuracao

Flags de Comportamento

Estas variaveis alternam comportamentos em tempo de execucao. Flags booleanas sao habilitadas quando definidas com um valor verdadeiro (1, true).

Credenciais do Servidor

Usadas por cyberstrike serve e cyberstrike web:

export CYBERSTRIKE_SERVER_PASSWORD="..."   # obrigatorio para iniciar o servidor
export CYBERSTRIKE_SERVER_USERNAME="admin" # opcional, existem valores padrao

Referenciando Variaveis na Configuracao

Arquivos de configuracao suportam duas substituicoes — e apenas estas duas:

Variaveis de Ambiente — {env:VAR}

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

{env:VAR} e substituido pelo valor de VAR, ou uma string vazia se nao definido. Sintaxe estilo shell ${VAR}, $VAR e sintaxe de valor padrao ({env:VAR:-default}) nao sao suportadas.

Conteudo de Arquivos — {file:path}

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

Caminhos podem ser relativos ao arquivo de configuracao, absolutos ou comecar com ~/ para o diretorio home.

Sobrescrita de Permissoes para Automacao

cyberstrike run (nao interativo) rejeita automaticamente qualquer chamada de ferramenta que normalmente solicitaria aprovacao. Para pre-aprovar ferramentas em CI, passe um mapa de permissoes JSON via CYBERSTRIKE_PERMISSION:

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

O valor segue o mesmo formato do campo permission da configuracao. Consulte Permissoes.

Configuracao do Shell

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

Arquivos .env

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

# Carregue antes de iniciar
source .env && cyberstrike

Integracao 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

Ordem de Prioridade

As fontes de configuracao sao mescladas nesta ordem (a mais alta vence):

1. Argumentos de linha de comando
2. Configuracao gerenciada empresarial
3. CYBERSTRIKE_CONFIG_CONTENT (JSON inline)
4. Configuracao do diretorio .cyberstrike/
5. Configuracao do projeto (cyberstrike.json / .jsonc)
6. CYBERSTRIKE_CONFIG (arquivo personalizado)
7. Configuracao global (~/.config/cyberstrike/)
8. Remoto .well-known/cyberstrike
9. Valores padrao

Consulte a Referencia de Configuracao para detalhes.

Verificando Variaveis

# Listar variaveis ativas do Cyberstrike
env | grep CYBERSTRIKE

# Verificar se uma chave de provedor esta definida (sem imprimi-la completamente)
echo "${ANTHROPIC_API_KEY:0:12}..."

Seguranca

1. Nunca exiba chaves de API completas
2. Use gerenciamento de secrets em CI/CD
3. Rotacione chaves periodicamente
4. Restrinja permissoes de .env: chmod 600 .env

Documentacao Relacionada

• Referencia de Configuracao - Todas as opcoes de configuracao
• Configuracao do Projeto - Configuracoes do projeto
• Configuracao Global - Configuracoes globais
• Autenticacao - Configuracao de autenticacao