Variáveis de ambiente

Esta página lista as variáveis de ambiente que mudam o comportamento do Neuro Harness, as que o instalador aceita e as que as sessões recebem. Nenhuma é obrigatória.

Variáveis da CLI

Variável	Padrão	O que muda
NEURO_HARNESS_HOME	~/.neuro-harness	Pasta da distribuição: Harness, perfil, cofre, motor e log
NEURO_HARNESS_PROFILE	neuro	Perfil do Harness usado pela CLI
NEURO_HARNESS_PORT	3082	Porta do painel. Se estiver ocupada, o Harness usa uma porta livre
NEURO_WORKDIR	~/Neuro	Pasta de trabalho das sessões
NEURO_HOME	~/.neuro-mv-edit	Biblioteca e memória do neuro-mv-edit: perfis, temas, estilos, prévias e o motor Remotion

O neuro-mv-edit e o neuro-ads-manager também usam NEURO_HARNESS_HOME e NEURO_HARNESS_PROFILE para achar o Harness da distribuição.

Definir uma variável

Para um comando só:

macOS

Terminal

NEURO_HARNESS_PORT=3090 neuro-harness restart

Windows

PowerShell

$env:NEURO_HARNESS_PORT = "3090"; neuro-harness restart

Linux

Terminal

NEURO_HARNESS_PORT=3090 neuro-harness restart

Use os mesmos valores em todos os comandos

Se você mudar NEURO_HARNESS_HOME ou NEURO_HARNESS_PROFILE, defina a variável no perfil do seu shell (ou nas variáveis de usuário do Windows). Um comando rodado sem ela procura a instalação na pasta padrão.

Variáveis do instalador

Variável	Sistemas	O que muda
NEURO_HARNESS_HOME	todos	Pasta onde o instalador põe a distribuição. Padrão: ~/.neuro-harness (%USERPROFILE%\.neuro-harness no Windows)
NEURO_HARNESS_NO_RC	macOS e Linux	Com 1, o instalador não acrescenta a linha do PATH ao ~/.zshrc, ao ~/.bashrc e ao ~/.profile
NEURO_HARNESS_REF	macOS e Linux	Para testes: instala de uma branch do repositório em vez de uma Release

Terminal

curl -fsSL https://harness.neuros.my/install.sh | NEURO_HARNESS_NO_RC=1 bash

As opções de linha de comando do instalador estão em Instalação.

O que as sessões recebem

O Harness passa às sessões o ambiente do processo que o subiu, com estes ajustes:

Variável	Valor nas sessões
PATH	~/.neuro-harness/bin na frente. Pastas do Claude Code (com /.claude/ no caminho) saem
DSH_HOME	~/.neuro-harness/dsh
npm_config_cache	neuro-harness-npm-cache, dentro da pasta temporária do sistema. A sandbox do Harness 0.2.1 só deixa gravar na pasta de trabalho, em /tmp e no TMPDIR
NEURO_HOME	A biblioteca do neuro-mv-edit

Estas variáveis são removidas, para que nenhuma chave de provedor venha do ambiente:

ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL, ANTHROPIC_MODEL, ANTHROPIC_SMALL_FAST_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, CLAUDE_CODE_SUBAGENT_MODEL, OPENAI_API_KEY, OPENAI_BASE_URL, CLAUDE_PLUGIN_ROOT, CLAUDECODE e CLAUDE_CODE_ENTRYPOINT.

As chaves de provedor vêm do cofre do Harness. Veja Provedores e chaves.

Variáveis dos plugins

Variável	Plugin	Para quê
NEURO_ENGINE	neuro-mv-edit	Motor padrão dos projetos novos: remotion ou hyperframes
REMOTION_LICENSE_KEY	neuro-mv-edit	Chave da Company License do Remotion
HYPERFRAMES_NO_TELEMETRY	neuro-mv-edit	Com 1, desliga a telemetria do HyperFrames
META_ACCESS_TOKEN	neuro-ads-manager	Token da Graph API da Meta
META_AD_ACCOUNT_ID	neuro-ads-manager	Conta de anúncio (act_…)

As outras variáveis do neuro-ads-manager estão em Plugins. Para que uma variável chegue às sessões, defina-a no terminal antes de neuro-harness start ou restart.

Variável interna

Variável	Quem define	Para quê
NEURO_HARNESS_PLUGINS	App desktop	Pasta dos plugins empacotados com o app. Não defina à mão