---
title: 環境変数
description: 環境変数で OpenChamber と OpenCode 連携を設定します。
---

# 環境変数

OpenChamber は起動時にこれらの環境変数を読み取ります。スタートアップサービスでは、`openchamber startup enable` がデフォルトで現在の環境をスナップショットするため、サービスに使わせたい変数を変更した後は再実行してください。

## OpenChamber サーバー

### `OPENCHAMBER_HOST`

OpenChamber Web サーバーのバインドアドレスです。他のマシンからアクセスできるようにするには `0.0.0.0` を使います。

### `OPENCHAMBER_UI_PASSWORD`

ブラウザ UI のパスワードです。localhost 以外にバインドする場合、トンネルを使う場合、またはリバースプロキシの背後で実行する場合に使います。

### `OPENCHAMBER_API_ONLY`

`true` または `1` に設定すると、OpenChamber をヘッドレスモードで起動します。デスクトップおよびモバイルクライアント向けの API ルートは利用できますが、ブラウザ UI は配信されません。

### `OPENCHAMBER_DATA_DIR`

OpenChamber のデータディレクトリを上書きします。デフォルトは `~/.config/openchamber` です。

### `OPENCHAMBER_COMPRESS_API`

API レスポンス圧縮を制御します。`true` または `1` で強制的に有効化し、`false` または `0` で強制的に無効化します。

### `OPENCHAMBER_SKIP_API_COMPRESSION`

`true` または `1` に設定すると API レスポンス圧縮を無効化します。これは `OPENCHAMBER_COMPRESS_API` より優先されます。

### `OPENCHAMBER_VERBOSE_REQUEST_LOGS`

`true` または `1` に設定すると詳細な HTTP リクエストログを有効にします。

### `OPENCHAMBER_UPDATE_API_URL`

更新確認 API エンドポイントを上書きします。ほとんどのユーザーは未設定のままでかまいません。

### `OPENCHAMBER_PACKAGE_MANAGER`

自動検出が間違っている場合に、更新操作で使うパッケージマネージャーを強制します。

## OpenCode サーバー

### `OPENCODE_HOST`

OpenChamber を既存の OpenCode サーバーに接続します。値は明示的なポートを含み、パス、クエリ、ハッシュを含まない `http` または `https` の origin である必要があります。`OPENCODE_HOST` は `OPENCODE_PORT` より優先されます。

### `OPENCODE_PORT`

OpenCode サーバーのポートを設定します。管理対象 OpenCode では管理対象ポートの要求になり、`OPENCODE_SKIP_START=true` ではそのポートの外部サーバーに接続します。

### `OPENCODE_SKIP_START`

`true` に設定すると、OpenChamber が独自の OpenCode サーバーを起動しません。

### `OPENCHAMBER_OPENCODE_HOSTNAME`

OpenChamber が管理する OpenCode サーバーのバインドホスト名です。デフォルトは `127.0.0.1` です。

### `OPENCODE_BINARY`

OpenChamber が実行する `opencode` 実行ファイルへのパスです。

### `OPENCODE_CONFIG`

特定の OpenCode 設定ファイルへのパスです。

### `OPENCODE_CONFIG_DIR`

エージェント、スキル、スニペット、設定検出に使う特定の OpenCode 設定ディレクトリへのパスです。

### `OPENCODE_DATA_DIR`

管理対象 OpenCode サーバーのカスタムデータディレクトリです。

### `OPENCODE_WSL_DISTRO`

Windows 上の OpenCode 連携に使う WSL ディストリビューションを選びます。

### `OPENCHAMBER_OPENCODE_WSL_DISTRO`

WSL ディストリビューション選択用の OpenChamber 固有エイリアスです。両方が設定されている場合は `OPENCODE_WSL_DISTRO` が優先されます。

### `OPENCODE_JWT_SECRET`

UI 認証トークンの署名に使うシークレットです。永続的なサービス配置では長いランダム値を使ってください。

## ターミナルと Git

### `OPENCHAMBER_TERMINAL_SHELL`

OpenChamber のターミナルセッションで使うシェル実行ファイルです。

### `OPENCHAMBER_GIT_BINARY`

OpenChamber の Git 機能で使う Git 実行ファイルです。

### `GIT_BINARY`

代替の Git 実行ファイル上書きです。OpenChamber 固有の設定には `OPENCHAMBER_GIT_BINARY` を推奨します。

### `OPENCHAMBER_GIT_READ_CACHE_TTL_MS`

Git に基づくファイル読み取りキャッシュの有効期間（ミリ秒）です。デバッグ中にこのキャッシュを無効化するには `0` を設定します。

## 音声とトンネル

### `OPENAI_API_KEY`

OpenAI 互換サービスを呼び出す OpenChamber の音声機能で使う API キーです。

### `OPENCHAMBER_ALLOW_REMOTE_OPENAI_COMPAT_URLS`

`true` または `1` に設定すると、音声機能でリモートの OpenAI 互換 base URL を許可します。

### `NGROK_AUTHTOKEN`

OpenChamber のトンネルコマンドで使う ngrok 認証トークンです。`ngrok config add-authtoken <token>` で ngrok 側に設定することもできます。

## ランタイムヘルパー

### `BUN_BINARY`

デーモンプロセスを起動するときに OpenChamber が使う Bun 実行ファイルです。

### `BUN_INSTALL`

Bun のインストールルートです。OpenChamber はデーモン起動と更新のために `bin/bun` を探す際に使います。

### `VITE_OPENCODE_URL`

Vite でビルドされた Web アプリ向けのビルド時 API base URL です。通常の CLI またはデスクトップ利用では、ほとんどのユーザーは設定する必要がありません。
