Variáveis de ambiente
O OpenChamber lê estas variáveis na inicialização. Para serviços de inicialização, openchamber startup enable salva por padrão um snapshot do ambiente atual, então execute de novo após mudar variáveis que o serviço deve usar.
Variáveis para o OpenCode, o Git e o terminal
Para passar variáveis suas ao OpenCode, ao Git, ao terminal e às ações de projeto, como um token de API ou o endereço de um banco de dados, adicione-as em Configurações → Geral → Variáveis de ambiente em vez de exportá-las antes de iniciar o OpenChamber. Os valores ficam na máquina que roda o OpenChamber, em environment.json no diretório de dados, e só o seu usuário consegue lê-los. As Configurações nunca mostram um valor de novo: você pode substituí-lo ou removê-lo, mas não lê-lo de volta.
- O OpenCode recebe as variáveis quando inicia, então reinicie-o depois de uma mudança. As Configurações oferecem o botão para isso.
- Variáveis definidas com
opencode service set envtambém chegam ao OpenCode. As das Configurações têm prioridade. - O Git, o terminal e as ações de projeto recebem as variáveis na próxima execução.
- Variáveis que o OpenChamber define para o próprio OpenCode, como a senha e a configuração dele, têm prioridade sobre as suas.
Um projeto pode adicionar variáveis próprias, ou um comando que as imprime, como direnv export json, em Configurações → Projetos. Veja Projetos.
As variáveis não chegam a um servidor OpenCode que você iniciou por conta própria, e a extensão do VS Code não tem essa configuração. Tudo o que vem abaixo é lido pelo próprio OpenChamber na inicialização.
Servidor OpenChamber
OPENCHAMBER_HOST
Endereço onde o servidor web do OpenChamber escuta. Use 0.0.0.0 para permitir acesso de outras máquinas.
OPENCHAMBER_LAN_URL
O endereço que outros dispositivos da sua rede usam para acessar o OpenChamber, por exemplo http://192.168.1.20:3000. Links e QR codes de pareamento oferecem esse endereço em vez do que o OpenChamber detecta sozinho. Defina quando essa detecção errar, por exemplo no Docker, onde o OpenChamber só vê o endereço interno do contêiner.
OPENCHAMBER_UI_PASSWORD
Senha da interface no navegador. Use quando expor fora do localhost, por túnel ou por proxy reverso.
OPENCHAMBER_UI_SESSION_TTL_HOURS
Quanto tempo dura o login no navegador, em horas, quando “confiar neste dispositivo” está desligado. O padrão é 12.
OPENCHAMBER_UI_TRUSTED_SESSION_TTL_DAYS
Quanto tempo dura o login, em dias, num dispositivo marcado como confiável. O padrão é 7.
OPENCHAMBER_API_ONLY
Inicia o OpenChamber em modo headless quando definido como true ou 1. As rotas de API continuam disponíveis para clientes desktop e mobile, mas a UI do navegador não é servida.
OPENCHAMBER_FRAME_ANCESTORS
Origens que podem mostrar o OpenChamber dentro de um frame na própria página, separadas por espaços, por exemplo https://dash.example.com. * permite qualquer site. Por padrão só o próprio OpenChamber e seus apps desktop e mobile podem incorporá-lo, o que impede outros sites de sobrepor os botões dele.
OPENCHAMBER_DATA_DIR
Altera o diretório de dados do OpenChamber. O padrão é ~/.config/openchamber.
OPENCHAMBER_CHATS_DIR
Move os diretórios de chat gerenciados que o OpenChamber cria para chats sem projeto. O padrão é ~/.config/openchamber/chats. Defina um diretório que o servidor OpenCode consiga ler quando o OpenChamber e o OpenCode rodam com usuários diferentes. Os chats existentes não são movidos.
OPENCHAMBER_COMPRESS_API
Controla a compressão das respostas da API. true ou 1 ativa; false ou 0 desativa.
OPENCHAMBER_SKIP_API_COMPRESSION
Desativa a compressão das respostas da API quando definido como true ou 1. Tem prioridade sobre OPENCHAMBER_COMPRESS_API.
OPENCHAMBER_VERBOSE_REQUEST_LOGS
Ativa logs HTTP detalhados quando definido como true ou 1.
OPENCHAMBER_UPDATE_API_URL
Altera o endpoint de verificação de atualizações. A maioria dos usuários deve deixar isso sem definir.
OPENCHAMBER_PACKAGE_MANAGER
Força o gerenciador de pacotes usado em atualizações quando a detecção automática estiver errada.
Proxy
HTTP_PROXY, HTTPS_PROXY, NO_PROXY
Envia por um proxy as requisições de saída do próprio OpenChamber, como limites de uso e catálogos de skills. Nomes em minúsculas também funcionam. Hosts em NO_PROXY se conectam diretamente, e localhost, 127.0.0.1 e ::1 sempre se conectam, então os retornos de login e o servidor local do OpenCode continuam funcionando.
Servidor OpenCode
OPENCODE_HOST
Conecta o OpenChamber a um servidor OpenCode existente. O valor deve ser um origin http ou https com porta explícita e sem path, query ou hash. OPENCODE_HOST tem prioridade sobre OPENCODE_PORT.
OPENCODE_PORT
Define a porta do servidor OpenCode. Com OpenCode gerenciado, solicita essa porta; com OPENCODE_SKIP_START=true, conecta a um servidor externo nessa porta.
OPENCODE_SKIP_START
Impede o OpenChamber de iniciar seu próprio servidor OpenCode quando definido como true.
OPENCHAMBER_OPENCODE_HOSTNAME
Hostname do servidor OpenCode gerenciado pelo OpenChamber. O padrão é 127.0.0.1.
OPENCODE_BINARY
Caminho para o executável opencode que o OpenChamber deve usar.
OPENCODE_CONFIG
Caminho para um arquivo de configuração específico do OpenCode.
OPENCODE_CONFIG_DIR
Caminho para o diretório de configuração do OpenCode para agents, skills, snippets e descoberta de config.
OPENCODE_DATA_DIR
Diretório de dados personalizado para o servidor OpenCode gerenciado.
OPENCODE_WSL_DISTRO
Escolhe a distro WSL usada pela integração do OpenCode no Windows.
OPENCHAMBER_OPENCODE_WSL_DISTRO
Alias específico do OpenChamber para escolher a distro WSL. OPENCODE_WSL_DISTRO tem prioridade quando ambas estão definidas.
OPENCODE_JWT_SECRET
Segredo usado para assinar tokens de autenticação da UI. Em serviços persistentes, use um valor longo e aleatório.
Terminal e Git
OPENCHAMBER_TERMINAL_SHELL
Executável de shell usado nas sessões de terminal do OpenChamber.
OPENCHAMBER_GIT_BINARY
Executável do Git usado pelos recursos Git do OpenChamber.
GIT_BINARY
Override alternativo para o executável do Git. Para configuração específica do OpenChamber, prefira OPENCHAMBER_GIT_BINARY.
OPENCHAMBER_GIT_READ_CACHE_TTL_MS
TTL, em milissegundos, para leituras de arquivos em cache baseadas em Git. Use 0 para desativar o cache durante depuração.
Voz e túneis
OPENAI_API_KEY
API key usada pelos recursos de voz do OpenChamber quando chamam a própria OpenAI. Ela nunca é enviada a um servidor próprio compatível com OpenAI: dê a esse servidor uma chave própria nas Configurações.
OPENCHAMBER_ALLOW_REMOTE_OPENAI_COMPAT_URLS
Permite base URLs remotas compatíveis com OpenAI para recursos de voz quando definido como true ou 1.
NGROK_AUTHTOKEN
Token de autenticação do ngrok usado pelos comandos de túnel do OpenChamber. Você também pode configurar com ngrok config add-authtoken <token>.
Auxiliares de runtime
BUN_BINARY
Executável do Bun que o OpenChamber deve usar ao iniciar processos daemon.
BUN_INSTALL
Raiz da instalação do Bun. O OpenChamber usa isso para encontrar bin/bun ao iniciar daemons e atualizar.
VITE_OPENCODE_URL
API base URL de build-time para a web app criada com Vite. A maioria dos usuários não deve usar isso no CLI ou desktop normal.