Harden Windows service Codex home handling

Author: Codex

README.ko.md

@@ -77,7 +77,7 @@ codex -m "ollama-cloud/glm-5.2"      "Write a SQL migration"
 - **OAuth, API 키, 또는 ChatGPT forward.** xAI / Anthropic / Kimi 계정으로 로그인하거나(토큰은
   자동 갱신됩니다), `codex login`을 forward 하거나, 키를 붙여넣으세요(`${ENV_VARS}` 지원). 18개 프로바이더의
   API 키 카탈로그(**Ollama Cloud** 포함)가 기본 내장되어 있습니다.
-- **Codex에 바로 통합.** `~/.codex/config.toml`에 `[model_providers.opencodex]` 테이블을 주입하고
+- **Codex에 바로 통합.** `$CODEX_HOME/config.toml`(기본값 `~/.codex/config.toml`)에 `[model_providers.opencodex]` 테이블을 주입하고
   라우팅된 모델을 Codex의 카탈로그와 서브에이전트 선택기에 병합합니다 — 완전히 되돌릴 수 있습니다.
 - **Sidecar.** OpenAI가 아닌 모델에도 ChatGPT 로그인을 통한 `gpt-5.4-mini`를 사용해 실제 **웹 검색**과
   **이미지 이해** 기능을 제공합니다.

README.md

@@ -87,8 +87,9 @@ codex -m "ollama-cloud/glm-5.2"      "Write a SQL migration"
 - **OAuth, API key, or ChatGPT forward.** Log in with your xAI / Anthropic / Kimi account (tokens
   auto-refresh), forward your `codex login`, or paste a key (`${ENV_VARS}` supported). An 18-provider
   API-key catalog (incl. **Ollama Cloud**) is built in.
-- **Drops into Codex.** Injects a `[model_providers.opencodex]` table into `~/.codex/config.toml` and
-  merges routed models into Codex's catalog and subagent picker — fully reversible.
+- **Drops into Codex.** Injects a `[model_providers.opencodex]` table into
+  `$CODEX_HOME/config.toml` (default `~/.codex/config.toml`) and merges routed models into Codex's
+  catalog and subagent picker — fully reversible.
 - **Sidecars.** Give non-OpenAI models real **web search** and **image understanding** via a
   `gpt-5.4-mini` over your ChatGPT login.
 - **Web dashboard** for providers, OAuth login, model selection, and request logs.

README.zh-CN.md

@@ -77,7 +77,7 @@ codex -m "ollama-cloud/glm-5.2"      "Write a SQL migration"
 - **OAuth、API key 或 ChatGPT 转发（forward）。** 用你的 xAI / Anthropic / Kimi 账户登录（token
   自动刷新）、转发你的 `codex login`，或直接粘贴一个 key（支持 `${ENV_VARS}`）。内置一份 18 家 provider 的
   API-key 目录（含 **Ollama Cloud**）。
-- **无缝接入 Codex。** 向 `~/.codex/config.toml` 注入一个 `[model_providers.opencodex]` 表，并
+- **无缝接入 Codex。** 向 `$CODEX_HOME/config.toml`（默认 `~/.codex/config.toml`）注入一个 `[model_providers.opencodex]` 表，并
   将已路由的模型合并进 Codex 的目录和 subagent 选择器 —— 完全可逆。
 - **Sidecars。** 通过基于你 ChatGPT 登录的 `gpt-5.4-mini`，为非 OpenAI 模型提供真正的**网页搜索**和**图像理解**能力。
 - **Web 仪表盘**，用于管理 provider、OAuth 登录、模型选择和请求日志。

docs-site/src/content/docs/getting-started/installation.md

@@ -11,7 +11,7 @@ sends your traffic anywhere except the provider you configure.
 | Requirement | Why |
 | --- | --- |
 | **[Bun](https://bun.sh) ≥ 1.1** (recommended) or **Node ≥ 20** | `ocx` runs on the Bun runtime; the service runner invokes `bun`. |
-| **[OpenAI Codex](https://openai.com/codex)** (CLI, App, or SDK) | The client opencodex sits in front of. opencodex writes to `~/.codex/config.toml`. |
+| **[OpenAI Codex](https://openai.com/codex)** (CLI, App, or SDK) | The client opencodex sits in front of. opencodex writes to `$CODEX_HOME/config.toml` (default `~/.codex/config.toml`). |
 | A provider account or API key | Anthropic, xAI, Kimi, Ollama Cloud, OpenRouter, an OpenAI-compatible endpoint, or your ChatGPT login. |
 
 ## Install
@@ -55,7 +55,7 @@ cd gui && bun install && bun dev
 | `~/.opencodex/ocx.pid` | PID of the running proxy (single-instance guard). |
 | `~/.opencodex/auth.json` | Stored OAuth credentials (when you `ocx login`). |
 | `~/.opencodex/catalog-backup.json` | Pristine Codex model catalog, backed up before any edit. |
-| `~/.codex/config.toml` | opencodex appends a `[model_providers.opencodex]` table here on `ocx init`. |
+| `$CODEX_HOME/config.toml` | opencodex appends a `[model_providers.opencodex]` table here on `ocx init` (defaults to `~/.codex/config.toml`). |
 
 :::note
 opencodex never deletes your Codex config. Every injection is reversible — `ocx stop`, `ocx restore`,

docs-site/src/content/docs/getting-started/quickstart.md

@@ -19,7 +19,8 @@ ocx init
 3. **Default model** — the model used when a request doesn't match another provider.
 4. **Proxy port** — defaults to `10100`.
 5. **Inject into Codex?** — when you accept, opencodex writes the `[model_providers.opencodex]` table
-   into `~/.codex/config.toml` and sets `model_provider = "opencodex"` so Codex routes through the proxy.
+   into `$CODEX_HOME/config.toml` (default `~/.codex/config.toml`) and sets
+   `model_provider = "opencodex"` so Codex routes through the proxy.
 
 The result is saved to `~/.opencodex/config.json`.
 

docs-site/src/content/docs/guides/codex-integration.md

@@ -4,7 +4,8 @@ description: How opencodex injects itself into Codex, syncs the model catalog, d
 ---
 
 opencodex makes Codex route through the proxy by editing two things Codex reads: its config
-(`~/.codex/config.toml`) and its model catalog. Every edit is idempotent and reversible.
+(`$CODEX_HOME/config.toml`, default `~/.codex/config.toml`) and its model catalog. Every edit is
+idempotent and reversible.
 
 ## Config injection
 
@@ -21,7 +22,7 @@ base_url = "http://localhost:10100/v1"
 wire_api = "responses"
 ```
 
-It also writes an optional profile at `~/.codex/opencodex.config.toml` so you can opt in explicitly:
+It also writes an optional profile at `$CODEX_HOME/opencodex.config.toml` so you can opt in explicitly:
 
 ```bash
 codex --profile opencodex "…"
@@ -35,8 +36,8 @@ duplicate copies before re-writing — so re-running `ocx init` / `ocx sync` nev
 
 ## Model catalog sync
 
-Codex shows models from an on-disk catalog (`~/.codex/opencodex-catalog.json` by default). On start
-and on `ocx sync`, opencodex:
+Codex shows models from an on-disk catalog (`$CODEX_HOME/opencodex-catalog.json` by default). On
+start and on `ocx sync`, opencodex:
 
 1. **Backs up** the pristine catalog once to `~/.opencodex/catalog-backup.json` (so featuring is
    reversible).

docs-site/src/content/docs/index.mdx

@@ -44,8 +44,9 @@ Codex CLI / App / SDK ──/v1/responses──▶ opencodex ──▶ Any provi
     login, or paste an API key. Keys can be `${ENV_VARS}`.
   </Card>
   <Card title="Drops into Codex" icon="rocket">
-    `ocx init` injects a provider into `~/.codex/config.toml` and merges routed models into Codex's
-    catalog and subagent picker. `ocx stop` restores native Codex cleanly.
+    `ocx init` injects a provider into `$CODEX_HOME/config.toml` (default
+    `~/.codex/config.toml`) and merges routed models into Codex's catalog and subagent picker.
+    `ocx stop` restores native Codex cleanly.
   </Card>
   <Card title="Sidecars" icon="magnifier">
     Give non-OpenAI models real **web search** and **image understanding** by routing those

docs-site/src/content/docs/ko/getting-started/installation.md

@@ -11,7 +11,7 @@ opencodex는 단일 CLI인 `ocx`로 제공됩니다. 작은 로컬 HTTP 서버(B
 | 요구 사항 | 이유 |
 | --- | --- |
 | **[Bun](https://bun.sh) ≥ 1.1**(권장) 또는 **Node ≥ 20** | `ocx`는 Bun 런타임에서 실행되며, 서비스 러너가 `bun`을 호출합니다. |
-| **[OpenAI Codex](https://openai.com/codex)**(CLI, App, 또는 SDK) | opencodex가 앞단에 위치하는 클라이언트입니다. opencodex는 `~/.codex/config.toml`에 기록합니다. |
+| **[OpenAI Codex](https://openai.com/codex)**(CLI, App, 또는 SDK) | opencodex가 앞단에 위치하는 클라이언트입니다. opencodex는 `$CODEX_HOME/config.toml`(기본값 `~/.codex/config.toml`)에 기록합니다. |
 | 프로바이더 계정 또는 API 키 | Anthropic, xAI, Kimi, Ollama Cloud, OpenRouter, OpenAI 호환 엔드포인트, 또는 ChatGPT 로그인. |
 
 ## 설치
@@ -55,7 +55,7 @@ cd gui && bun install && bun dev
 | `~/.opencodex/ocx.pid` | 실행 중인 프록시의 PID(단일 인스턴스 가드). |
 | `~/.opencodex/auth.json` | 저장된 OAuth 자격 증명(`ocx login` 시). |
 | `~/.opencodex/catalog-backup.json` | 변경 전에 백업해 둔 원본 Codex 모델 카탈로그. |
-| `~/.codex/config.toml` | opencodex가 `ocx init` 시 여기에 `[model_providers.opencodex]` 테이블을 추가합니다. |
+| `$CODEX_HOME/config.toml` | opencodex가 `ocx init` 시 여기에 `[model_providers.opencodex]` 테이블을 추가합니다(기본값 `~/.codex/config.toml`). |
 
 :::note
 opencodex는 절대 Codex 설정을 삭제하지 않습니다. 모든 주입은 되돌릴 수 있습니다 — `ocx stop`, `ocx restore`,

docs-site/src/content/docs/ko/getting-started/quickstart.md

@@ -19,7 +19,7 @@ ocx init
 3. **기본 모델** — 요청이 다른 프로바이더와 매칭되지 않을 때 사용되는 모델입니다.
 4. **프록시 포트** — 기본값은 `10100`입니다.
 5. **Codex에 주입할까요?** — 동의하면 opencodex가 `[model_providers.opencodex]` 테이블을
-   `~/.codex/config.toml`에 기록하고, `model_provider = "opencodex"`로 설정해 Codex가 프록시를 통해 라우팅하도록 합니다.
+   `$CODEX_HOME/config.toml`(기본값 `~/.codex/config.toml`)에 기록하고, `model_provider = "opencodex"`로 설정해 Codex가 프록시를 통해 라우팅하도록 합니다.
 
 결과는 `~/.opencodex/config.json`에 저장됩니다.
 

docs-site/src/content/docs/ko/guides/codex-integration.md

@@ -3,7 +3,7 @@ title: Codex 통합
 description: opencodex가 Codex에 자신을 주입하고, 모델 카탈로그를 동기화하고, 서브에이전트 선택기를 구동하며, 깔끔하게 복원하는 방식.
 ---
 
-opencodex는 Codex가 읽는 두 가지, 즉 설정(`~/.codex/config.toml`)과 모델 카탈로그를 편집하여 Codex가
+opencodex는 Codex가 읽는 두 가지, 즉 설정(`$CODEX_HOME/config.toml`, 기본값 `~/.codex/config.toml`)과 모델 카탈로그를 편집하여 Codex가
 프록시를 경유하도록 만듭니다. 모든 편집은 멱등적이며 되돌릴 수 있습니다.
 
 ## 설정 주입
@@ -21,7 +21,7 @@ base_url = "http://localhost:10100/v1"
 wire_api = "responses"
 ```
 
-또한 `~/.codex/opencodex.config.toml`에 선택적 프로파일을 작성하여 명시적으로 옵트인할 수 있게 합니다:
+또한 `$CODEX_HOME/opencodex.config.toml`에 선택적 프로파일을 작성하여 명시적으로 옵트인할 수 있게 합니다:
 
 ```bash
 codex --profile opencodex "…"
@@ -35,7 +35,7 @@ codex --profile opencodex "…"
 
 ## 모델 카탈로그 동기화
 
-Codex는 디스크의 카탈로그(기본값 `~/.codex/opencodex-catalog.json`)에 있는 모델을 표시합니다. 시작 시와
+Codex는 디스크의 카탈로그(기본값 `$CODEX_HOME/opencodex-catalog.json`)에 있는 모델을 표시합니다. 시작 시와
 `ocx sync` 시, opencodex는:
 
 1. 원본 카탈로그를 `~/.opencodex/catalog-backup.json`에 한 번 **백업**합니다(featuring을 되돌릴 수 있도록).