# Codex デスクトップ版を QCode に接続：Windows 11 を 1 ステップ 1 枚で


**一言で言うと**：Windows の「Windows PowerShell」に `irm https://qcode.cc/install/codex.ps1 | iex` を貼り付けて実行し、表示に従って `cr_` キーを貼り付け、`1) Codex 桌面版 App`（Codex デスクトップ版アプリ）を選ぶだけです。スクリプトが `base_url = "https://api.qcode.cc/openai"` とキーを `%USERPROFILE%\.codex\` に書き込むので、タスクトレイから完全に終了して開き直し、左上を `Codex` に切り替えれば使えます。

| 項目 | 入力内容 |
|---|---|
| 接続先（`base_url`） | `https://api.qcode.cc/openai` |
| API プロトコル（`wire_api`） | `responses` |
| 既定のモデル | `gpt-6.2-sol` |
| 設定ファイル | `%USERPROFILE%\.codex\config.toml` |
| キーファイル | `%USERPROFILE%\.codex\auth.json` |

2026-11-22 時点で確認 · ChatGPT（Codex デスクトップ版）26.1117.4957.0 · Windows 11


以下のスクリーンショットのとおりに進めれば、10 分ほどで Windows PC に Codex デスクトップ版が入り、QCode に接続された状態になります。アプリを開いて左上を `Codex` モードに切り替えれば、そのまま会話できます。

QCode 経由で Codex デスクトップ版を使うのに必要なのは QCode の API キー 1 本だけで、ChatGPT アカウントは不要です。アプリのサインイン画面は入力不要で、ワンクリックスクリプトが書いた `auth.json` によって自動的に表示されなくなります。デスクトップ版と Codex CLI は同じ `%USERPROFILE%\.codex\config.toml` を共有するため、設定を変えたら必ずタスクトレイから**完全に終了**してから開き直してください。


- **対象環境**：Windows 11（64 ビット）· Windows 10（64 ビット）でも同様。Microsoft Store を開ける必要があります
- **ソフトウェアのバージョン**：ChatGPT（Codex デスクトップ版）26.1117.4957.0 · ワンクリックスクリプト v2026.11.21.1
- **スクリーンショット更新**：2026-11
- **所要時間**：約 10 分（インストーラーは約 759 MB。回線が遅いときはもう少し待ちます）
- **用意するもの**：`cr_` で始まる QCode の API キー 1 本と、インターネットに接続できる Windows PC



- Windows 11 または Windows 10（いずれも 64 ビット）で、Microsoft Store と「Windows PowerShell」を開けること
- `cr_` で始まる QCode の API キーをコピー済みであること。アカウントがまだない場合は、先に[QCode に登録](https://qcode.cc/ja/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-codex-desktop-before)し、[料金ページ](https://qcode.cc/ja/pricing?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-codex-desktop-before)でプランを選び、[ダッシュボード](https://qcode.cc/ja/dashboard)でキーを作成してください。
- `qcode.cc`、`api.qcode.cc`、Microsoft Store を開けること。ダウンロードできないときは、下の「ダウンロードとインストール」にある地域ごとの説明を見てください
- 中断されない 10 分間を確保してください。アプリのインストール時だけ「ユーザーアカウント制御」が 1 回出るので、「是」（はい）をクリックします


## ダウンロードとインストール

Codex デスクトップ版に「Codex」という単独のインストーラーはありません。Microsoft Store では **ChatGPT**（発行者 `OpenAI`）という名前で、インストール後にアプリ内で `Codex` モードに切り替えると Codex になります。Node.js にも WSL にも依存しません。

地域ごとの違いは**どのダウンロード入口を開けるか**だけで、インストール後にアプリ内で行う接続手順はまったく同じです。まず自分の地域を選んでください：

**ヨーロッパ / 日本**

- Microsoft Store と公式の直接インストールパッケージのどちらも使えます。ストアで ChatGPT を検索するか、ブラウザで `https://apps.microsoft.com/detail/9plm9xgg6vks` を開いて「获取」（入手）をクリックします。
- ストアを使いたくない場合は、公式の直接インストールパッケージ `ChatGPT-x64.msix`（ARM のマシンは `ChatGPT-arm64.msix`）をダウンロードしてダブルクリックでインストールします。
- ワンクリックスクリプトは `qcode.cc` を使うので、通常はそのままアクセスできます。


**中国本土**

- Microsoft Store を優先してください。ブラウザで `https://apps.microsoft.com/detail/9plm9xgg6vks` を開くか、「ファイル名を指定して実行」に `ms-windows-store://pdp/?productid=9PLM9XGG6VKS` を入力し、「获取」（入手）をクリックすれば、Microsoft アカウントにサインインしなくても大丈夫です。
- ストアのページが開かない、または読み込みが終わらないときは、公式の直接インストールパッケージ <https://persistent.oaistatic.com/codex-app-prod/ChatGPT-x64.msix> を使ってください（ARM のマシンは `ChatGPT-arm64.msix`）。ダブルクリックすると「アプリインストーラー」が引き継ぎ、UAC が 1 回出る場合があります。
- ワンクリックスクリプトは `qcode.cc` を使うので、通常はそのままアクセスできます。


**アラブ諸国**

- ダウンロード経路は「ヨーロッパ / 日本」と同じです。Microsoft Store の ChatGPT 製品ページ、または公式の直接インストールパッケージ `ChatGPT-x64.msix` を使います。
- Microsoft Store が開かないときは、公式の直接インストールパッケージを使い、ダブルクリックすると「アプリインストーラー」が引き継ぎます。
- ワンクリックスクリプトは `qcode.cc` を使うので、通常はそのままアクセスできます。


**ロシア / イラン**

- Microsoft Store は通常使えます。ストアが開かないときは、公式の直接インストールパッケージ `ChatGPT-x64.msix`（ARM のマシンは `ChatGPT-arm64.msix`）をダブルクリックしてインストールします。
- ストアも直接インストールパッケージも開かないときは、別のネットワークでもう一度試してください。インストール後の接続方法は変わりません。
- ワンクリックスクリプトは `qcode.cc` を使うので、通常はそのままアクセスできます。


## スクリーンショットのとおりに進める：Windows を 1 ステップ 1 枚で

以下は 15 ステップで、1 ステップにつき 1 つだけ行います。スクリーンショット上のオレンジ色の番号（①、②、③）は本文の番号と対応しています。番号を見たら、画像の同じ位置を見てください。



### Microsoft Store で ChatGPT のページを開く

ブラウザで `https://apps.microsoft.com/detail/9plm9xgg6vks` を開きます。① の位置で確認します。アプリ名は `ChatGPT`、発行者は `OpenAI`、ボタンは「获取」（入手）と表示されています。

![Microsoft Store の ChatGPT 製品ページ。アイコン、名前、評価、紹介文の下に「获取」（入手）ボタンがあり（1）、これをクリックしてインストールを開始する](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/01-download-page.webp)


うまくいけば：ページ上部に ChatGPT のアイコンと名前があり、右側のボタンが「获取」（入手）になっています。「打开」（開く）と表示されている場合は、この PC にすでにインストール済みなので、ステップ 3 に進んでください。




### 「获取」（入手）をクリックしてインストールを開始

① の「获取」（入手）をクリックします。Windows が「ユーザーアカウント制御」を表示するので、発行者が `Microsoft Windows` であることを確認して「是」（はい）をクリックし、ダウンロードを待ちます。インストーラーは約 759 MB です。

![「获取」（入手）をクリックすると Microsoft Store がダウンロードの準備中、依存関係の確認中と表示し、ボタンの位置にインストールの進行状況が表示される（1）](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/02-install-store.webp)


うまくいけば：ボタンが「正在下载 / 正在安装」（ダウンロード中 / インストール中）に変わり、完了すると「打开」（開く）になります。スタートメニューでも `ChatGPT` を検索できます。


**困ったとき：「获取」（入手）を押しても反応しない、ストアがエラーになる**

まずストアのウィンドウを閉じて、製品ページを開き直してもう一度試してください。それでもだめなら、「ダウンロードとインストール」にある公式の直接インストールパッケージ `ChatGPT-x64.msix` を使い、ダブルクリックして「安装」（インストール）をクリックします。インストール後はスタートメニューで `ChatGPT` を検索すれば開けます。




### 初回起動。まずはサインインしない

スタートメニューから `ChatGPT` を開きます（初回は UAC でもう一度「是」（はい）をクリックする場合があります）。最初の画面は英語のサインインページ `Sign in to ChatGPT` です。① が `Continue to sign in`、② が `Sign in another way` です。

このページには `Skip` は**ありません**。また、どのサインインボタンもまだ押さないでください。次のステップでワンクリックスクリプトを使って設定を書き込むので、書き込み後にアプリを開き直せばこのページは出なくなります。

![ChatGPT の初回起動時の英語サインインページ Sign in to ChatGPT。上に Continue to sign in（1）、下に Sign in another way（2）があり、スキップボタンはない](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/03-first-launch.webp)


うまくいけば：サインインボタンだけのカードが表示され、タイトルは `Sign in to ChatGPT` で、ページ内に「スキップ」や `Skip` は見当たりません。




### 予備の入口を確認しておく（今回は使わない）

将来 `auth.json` が効かず、アプリがまたサインインを求めてきた場合は、サインインページで `Sign in another way` をクリックし、その中の ① が `OpenAI API Key` の入口です。ここに `cr_` キーを直接入力できます（下には `Amazon Bedrock` もあります）。

このチュートリアルではワンクリックスクリプトを使うので、ここは眺めるだけで、サインインはしません。

![Sign in another way のサブページ。最初の項目が OpenAI API Key の入口（1）で、下に Amazon Bedrock と戻るボタンがある](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/04-login-api-key.webp)


うまくいけば：ページの最初の項目が `OpenAI API Key` と表示され、一番下に `Back` があり、サインインページに戻れます。




### PowerShell を開いてワンクリックコマンドを貼り付ける

スタートメニューをクリックし、`Windows PowerShell`（または「ターミナル」）と入力して開き、次のコマンドを貼り付けて Enter を押します：

```powershell
irm https://qcode.cc/install/codex.ps1 | iex
```

① が Enter を押したコマンド、② がバナーの 2 行目にあるスクリプトのバージョン `v2026.11.21.1`（バージョン番号は更新で変わります）、③ が続けて表示される 3 つの接続ドメインの速度測定です。中国語以外のシステムでスクリプトを実行する場合や、先に `$env:QCODE_LANG="en"` を設定した場合は、プロンプトが英語で表示されます。キーを押す順番はまったく同じです。

![Windows PowerShell でワンクリックコマンドを貼り付けて Enter（1）。下に QCode スクリプトのバナーとバージョン番号 v2026.11.21.1（2）、さらに下に 3 つの接続ドメインの速度測定結果（3）](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/05-run-script.webp)


うまくいけば：`QCode.cc · Codex 一键配置`（QCode.cc · Codex ワンクリック設定）のバナー、バージョン行 `v2026.11.21.1`、続いて `[1/6]` と 3 行の速度測定結果が表示されます。


**困ったとき：irm が内部コマンドまたは外部コマンドとして認識されない**

開いたのは「コマンドプロンプト」（CMD）で、`irm` を認識しません。このウィンドウを閉じ、「Windows PowerShell」または「ターミナル」を開き直して、もう一度貼り付けてください。




### 接続ドメインを選ぶ：そのまま Enter

① のプロンプト行で Enter を押し、角括弧内で最も速いもの（今回は `api.qcode.cc`）をそのまま受け入れます。Enter を押すと ② に `base_url=https://api.qcode.cc/openai` と表示されます。`/openai` までで、末尾に `/v1` もスラッシュも付きません。

`asia.qcode.cc` と `us.qcode.cc` は別の 2 つの接続点で、3 つとも同じ QCode アカウントを指します。Enter で既定の最も速いものが選ばれるので、自分で選び分ける必要はありません。

![スクリプトがどの接続ドメインを使うか尋ね、Enter で 1 を選ぶ旨を表示（1）。Enter 後に接続ドメイン api.qcode.cc と base_url=https://api.qcode.cc/openai を表示（2）](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/06-choose-domain.webp)


うまくいけば：`接入域: api.qcode.cc  ->  base_url=https://api.qcode.cc/openai`（接続ドメイン: api.qcode.cc）という 1 行が表示され、続けて `[2/6]` のキー入力に進みます。




### QCode のキーを貼り付ける

[ダッシュボード](https://qcode.cc/ja/dashboard)で `cr_` から始まる文字列をコピーし、ウィンドウに戻って ① の `API 密钥:`（API キー:）の後ろに貼り付け、Enter を押します。

入力はエコーされず、画面に文字は表示されません。Enter を押すと ② に `已读取密钥: cr_****`（キーを読み取りました: cr_****）と下 4 桁だけが表示され、キーを受け取れて形式も正しいことがわかります。

![スクリプトが API キーの貼り付けを促し（1）、貼り付けてもエコーされず、Enter 後に読み取ったキー cr_**** と下 4 桁だけを表示する（2）](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/07-enter-key.webp)


うまくいけば：`已读取密钥: cr_****`（キーを読み取りました: cr_****）という 1 行が表示され、先頭が `cr_` で、続けて `[3/6]` に進みます。


**API キーが必要ですか？**

まだ QCode のアカウントがない場合は、先に[登録](https://qcode.cc/ja/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-codex-desktop-key)してください。使った分だけ支払う場合は、先に[クォータパック](https://qcode.cc/ja/pay-as-you-go?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-codex-desktop-key)を購入し、[ダッシュボード](https://qcode.cc/ja/dashboard)でキーを作成します。作成したら `cr_` で始まる文字列を丸ごとコピーして、上に戻って貼り付けてください。クレジットカード / デビットカード（Visa / Mastercard）、Apple Pay / Google Pay、暗号資産で支払えます。詳しくは[支払い方法](/docs/reference/payment-methods)をご覧ください。




### `1) Codex 桌面版 App` を選ぶ

① が質問行「你要在哪个 Codex 客户端里使用？」（どの Codex クライアントで使いますか？）です。② の `1) Codex 桌面版 App`（Codex デスクトップ版アプリ）でそのまま Enter を押します（既定が 1 です）。この項目は設定ファイルを書くだけで、Node.js も Codex CLI もインストールしません。

![スクリプトがどの Codex クライアントで使うか尋ね（1）、最初の項目が 1) Codex 桌面版 App で設定ファイルだけを書く（2）](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/08-choose-client.webp)


うまくいけば：`1) Codex 桌面版 App` と `2) Codex CLI` の 2 行が表示され、Enter 後に `[4/6]` のモデル一覧取得に進みます。




### 既定のモデル `gpt-6.2-sol` を選ぶ

① が `[4/6]` で利用可能なモデル一覧を取得しているところです。一覧の 1 行目 ② の `gpt-6.2-sol` の後ろに `<- 推荐`（おすすめ）とあるので、そのまま Enter でこれを使います。

![スクリプトが利用可能なモデル一覧を取得し（1）、1 行目の gpt-6.2-sol の後ろにおすすめの表示がある（2）。Enter でこれを選ぶ](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/09-choose-model.webp)


うまくいけば：`1)` `2)` で始まるモデルの行がいくつか並び、1 行目が `gpt-6.2-sol` で、後ろに `<- 推荐`（おすすめ）と書かれています。


**困ったとき：一覧に gpt-6.2-sol がない**

モデル一覧は、そのキーで使えるモデルを取得して表示します。貼り付けたのが QCode の `cr_` キーか、余分な空白をコピーしていないかを確認し、スクリプトをもう一度実行して取り直してください。1 行目に `<- 推荐`（おすすめ）があれば、そのまま Enter で問題ありません。




### 設定が書き込まれたことを確認する

① が `[OK] 已写入 config.toml + auth.json`（config.toml と auth.json を書き込みました）、② が、デスクトップアプリと CLI がこの設定を共有するため**完全に終了して再起動**しないと反映されないという注意、③ がスクリプトが自動で送る最小のリクエストで、`接入验证通过`（接続検証に合格）と出ればアドレス、キー、ネットワークの経路全体が通っています。

![スクリプトが config.toml と auth.json を書き込んだこと（1）、デスクトップアプリと CLI が設定を共有し完全終了後に再起動が必要なこと（2）、接続検証に合格したこと（3）を表示している](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/10-write-config.webp)


うまくいけば：`已写入 config.toml + auth.json`（config.toml と auth.json を書き込みました）、「完全に終了して再起動すると反映されます」という 1 行の案内、そして `接入验证通过! 模型 gpt-6.2-sol 响应正常`（接続検証に合格! モデル gpt-6.2-sol は正常に応答）が表示されます。




### 最後のサマリーを確認する

サマリーは 3 行です。① 接続ドメイン（今回は `api.qcode.cc`）、② 既定のモデル `gpt-6.2-sol`、③ 接続性 `[OK] 已验证`（検証済み）。設定ファイルのパスは真ん中にあり、`C:\Users\ユーザー名\.codex` を指しています。

![スクリプトの最後のサマリー。接続ドメイン api.qcode.cc（1）、既定のモデル gpt-6.2-sol（2）、設定ファイル config.toml と auth.json、接続性 OK 検証済み（3）](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/11-config-ok.webp)


うまくいけば：3 行とも `[OK]` が付き、接続ドメインは `api.qcode.cc`、モデルは `gpt-6.2-sol` です。




### アプリを完全に終了する

ウィンドウを閉じただけではプロセスが残り、設定が読み直されません。次のように終了します：

1. タスクバー右下の `^` をクリックし、隠れているトレイアイコンを展開します。
2. 中の `ChatGPT` アイコンを右クリックします。
3. `Exit` をクリックします。

サインインページには `File` メニューがないため、このとき `Ctrl+Q` を押しても効きません。トレイの `Exit` だけがプロセスを本当に終了させます。


うまくいけば：トレイの ChatGPT アイコンが消え、タスクマネージャーを開いても `ChatGPT` というプロセスが見つかりません。


**困ったとき：トレイに ChatGPT のアイコンがない**

アイコンが折りたたまれている可能性があります。まずタスクバー右下の `^` をクリックして展開し、それから右クリックしてください。右クリックメニューに `New Chat` / `Send Feedback` しかない場合は、タスクバー上のアプリボタンを右クリックしていて、トレイアイコンではありません。`^` の中の小さいアイコンで試し直してください。




### 開き直してアンケートをスキップする

スタートメニューからもう一度 `ChatGPT` を開きます。今回はサインインページは出ず、そのままアンケート `What type of work do you do?` に入ります。① が選択肢 `Engineering`、② が `Skip` です。どれかを選んでも、② の `Skip` をそのままクリックしてもかまいません。表示のおすすめが変わるだけで、接続には影響しません。

![開き直すとすぐにパーソナライズのアンケートが表示され、Engineering の選択肢が強調されている（1）。右下が Skip ボタン（2）](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/13-onboarding.webp)


うまくいけば：`Sign in to ChatGPT` のないアンケートカードが表示され、`Skip` をクリックするとメイン画面に入ります。


**困ったとき：開き直しても Sign in to ChatGPT のまま**

アプリがキーファイルを読めていない状態です。まず `%USERPROFILE%\.codex\auth.json` が存在し、中のキー名が `OPENAI_API_KEY` であることを確認してください。そのうえでトレイからもう一度 `Exit` し、開き直します。それでもサインインページが出る場合は、サインインページで `Sign in another way` → `OpenAI API Key` を開き、`cr_` キーを直接入力してください。




### モードを `Codex` に切り替える

メイン画面の既定は `ChatGPT Work` です。左上 ① のモードボタンをクリックし、メニューから `Codex` を選びます。切り替えると、右下 ② のモデルカプセルが `6.2 Sol High` と表示されます。これは `config.toml` の `gpt-6.2-sol` に推論強度 `high` を組み合わせたものです。

![ChatGPT のメイン画面。左上のモードボタンで Codex に切り替えられ（1）、右下のモデルカプセルが 6.2 Sol High と表示されている（2）](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/14-main-model.webp)


うまくいけば：左上のモードが `Codex`、中央のタイトルが `What should we build?`、入力欄のプレースホルダーが `Do anything`、右下のカプセルが `6.2 Sol High` になります。


**困ったとき：右下が 6.2 Sol High にならない**

`config.toml` が反映されていません。メモ帳で `%USERPROFILE%\.codex\config.toml` を開き、最上位に `model = "gpt-6.2-sol"`、`model_provider = "qcode"` があり、`[model_providers.qcode]` のセクションがあることを確認してください。保存したら、トレイから `Exit` して開き直します。




### 最初の一言を送って返信を受け取る

③ の入力欄（プレースホルダーは `Do anything`）に `Say hello in one short sentence` と入力し、Enter を押します。数秒後、① が送った文、その下の ② がモデルの返信です。

![入力欄から英語のあいさつを送信（1 が送ったメッセージ）。数秒後にモデルの返信を受け取り（2）、下が入力欄 Do anything（3）](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/15-first-reply.webp)


うまくいけば：自分のメッセージが会話エリアの右側に表示され、数秒後に左側に完全な返信が現れます。読み込みが続いたり、401 になったりしません。




## 動作を確認する

次の 3 つがすべて当てはまれば、インストールと接続は完了です：

- アプリを開き直しても `Sign in to ChatGPT` が出ず、左上のモードを `Codex` に切り替えられる。
- 右下のモデルカプセルが `6.2 Sol High` で、一言送れば正常な返信が返る。
- リクエストが本当に QCode を通っているかもう一度確かめたいときは、[probe.qcode.cc](https://probe.qcode.cc/) を開いてキーを入力すると、先ほどのリクエストが見られ、モデル名は `gpt-6.2-sol` です。


### すべて完了

この Windows PC に Codex デスクトップ版がインストールされ、QCode に接続されました。今後は `ChatGPT` を開いて `Codex` モードに切り替えれば、そのままコードを書かせたりファイルを編集させたりできます。次はこちらへ：

- [Codex CLI の完全チュートリアル](/docs/ide/codex)
- [Claude Code の完全チュートリアル](/docs/getting-started/claude-code-tutorial)
- [Codex と Claude Code の比較](/docs/getting-started/codex-vs-claude-code)
- [接続ポイントと API 形式](/docs/getting-started/endpoints-and-api-paths)
- 次に：[料金ページ](https://qcode.cc/ja/pricing?utm_source=docs.qcode.cc&utm_medium=tut_done&utm_campaign=knowledge_base&src=docs-ide-codex-desktop-done)で各プランを比較し、長く使うのに合うものを選ぶ
- [ダッシュボード](https://qcode.cc/ja/dashboard)に戻って使用量と残高を確認する


## よくあるエラー

| エラーメッセージ | 原因 | 対処 |
|---|---|---|
| `Sign in to ChatGPT` | アプリの起動時に `auth.json` を読めていない。ワンクリックスクリプトをまだ実行していない、または設定変更後にウィンドウを閉じただけでトレイから完全に終了していない | トレイの `ChatGPT` アイコンを右クリックして `Exit` し、開き直してください。それでも出る場合は `%USERPROFILE%\.codex\auth.json` の `OPENAI_API_KEY` が `cr_` で始まるキーになっているか確認してください |
| `ERROR: unexpected status 401 Unauthorized: {"error":"Missing API key"}, url: https://xxx/v1/responses` | `config.toml` に `requires_openai_auth = true` がない、または `auth.json` に `OPENAI_API_KEY` がないため、リクエストにキーが付いていない | `config.toml` の `[model_providers.qcode]` に `requires_openai_auth = true` を補い、`auth.json` を `{"OPENAI_API_KEY": "cr_xxxxxxxx"}` にしてください。保存後にトレイから `Exit` して開き直します |
| `404 route not supported: POST /chatgpt/v1/responses` | `base_url` が ChatGPT のサインイン用ドメインになっている、または `/openai` の後ろに `/v1` やスラッシュを余分に付けている | `base_url` を `https://api.qcode.cc/openai` に戻し、保存後にトレイから `Exit` して開き直してください |
| `Error loading config.toml: wire_api = "chat" is no longer supported.` | `wire_api` がまだ `chat` になっていて、Codex は Responses プロトコルしかサポートしていない | `wire_api` を `"responses"` に変え、保存してアプリを開き直してください |
| `Missing environment variable: OPENAI_API_KEY` | `env_key` の書き方を使っているが、アプリを起動したプロセスにその変数がない。または `requires_openai_auth` と `env_key` の 2 通りを同時に残している | デスクトップ版では `requires_openai_auth = true` と `auth.json` を使い、`env_key` の行を削除してください。2 通りのうち 1 つだけを使います |
| `模型提供商不匹配` | 会話履歴に結び付いた provider と `config.toml` の内容が一致していない。アプリで公式アカウントにサインインした後で API キー方式に変えた場合によく起きる | 新しい会話を作成してください。`model_provider = "qcode"` と `[model_providers.qcode]` のテーブル名が一致することを確認し、変更後はトレイから `Exit` して開き直します |

## よくある質問

### 使うのに ChatGPT アカウントは必要ですか？

いいえ。アプリの初回起動時は `Sign in to ChatGPT` で止まりますが、上記の手順でワンクリックスクリプトを実行していれば、`%USERPROFILE%\.codex\auth.json` に `cr_` キーが入っているため、開き直すとサインインページを飛ばしてアンケートとメイン画面に進みます。この手順のどこでも、ベンダーのアカウントにはサインインしません。

### デスクトップ版と Codex CLI はどんな関係ですか？

どちらも同じ `%USERPROFILE%\.codex\config.toml` と `auth.json` を共有します。デスクトップ版が読むモデル、接続先、キーは Codex CLI とまったく同じです。ワンクリックスクリプトのステップ 3 で `1) Codex 桌面版 App`（Codex デスクトップ版アプリ）を選ぶと設定を書くだけで、Node.js も CLI もインストールしません。後でコマンドラインを使いたくなったら、もう一度スクリプトを実行して `2) Codex CLI` を選べばよく、キーを入れ直す必要はありません。コマンドラインの使い方は [Codex CLI の完全チュートリアル](/docs/ide/codex) をご覧ください。

### 設定を変えても反映されないときは？

アプリは起動時に 1 回だけ設定を読みます。`config.toml` や `auth.json` を変更したら、タスクバー右下のトレイアイコンで `ChatGPT` を右クリック → `Exit` し、プロセスが終了したことを確認してから開き直してください。ウィンドウを閉じただけや `Ctrl+Q` では終了になりません。

### デスクトップ版に Node.js や WSL は必要ですか？

どちらも不要です。デスクトップ版は Microsoft Store で配布されるネイティブな Windows アプリで、ワンクリックスクリプトで `1) Codex 桌面版 App`（Codex デスクトップ版アプリ）を選んでも Node.js には触れず、WSL を有効にする必要もありません。Node.js が必要になるのは Codex CLI をインストールするときだけです。

### モデルはどう選びますか？

| 用途 | おすすめモデル | 理由 |
|---|---|---|
| 日常的なコーディングと複雑なコーディングの主力 | `gpt-6.2-sol` | 1.05M コンテキスト / 128K 出力で、総合力のバランスが良い |
| 最も難しいマルチステップ Agent の攻略 | `gpt-6.2-astra` | 1 つ上のフラッグシップ。モジュールをまたぐ設計や長いタスクに向く |
| 軽い日常用途 / バッチ処理 | `gpt-6.1-terra` / `gpt-5.6-terra` | コストが低く、コード向けに最適化されている |
| 前世代のハイエンドモデル | `gpt-6-astra` | 引き続き使えるが、新しいタスクは `gpt-6.2-astra` への切り替えを推奨 |

既定のモデルを変えるには `config.toml` の `model` の行を書き換え、保存後にトレイから `Exit` して開き直します。`gpt-6.2-*` は `model_reasoning_effort = "none"` に対応していない点に注意してください。

### キーの有効期限が切れたらどうなりますか？

2 つの場合があります：

- **個人プラン**のキーは、期限が切れると更新できません。新しく契約し直して、新しいキーに切り替える必要があります。
- **クォータパック**のキーは、期限が切れた後にもう一度パックを購入すると、同じキーがそのまま使えるようになります。

キーを替えた後は `auth.json` の `OPENAI_API_KEY` も忘れずに更新し、トレイから `Exit` してアプリを開き直してください。

### 費用はどう計算されますか？

デスクトップ版は Codex CLI や Claude Code と同じ QCode の API キーを共有でき、費用は実際のトークン消費量で計算されます。ツールごとの区別はありません。Codex に何度も自律的に反復させると、1 回のタスクの消費が多くなることがあります。使用量と残高は[ダッシュボード](https://qcode.cc/ja/dashboard)で確認できます。

## 手動で設定を書く（ワンクリックスクリプトを使わない）

ワンクリックスクリプトが 2 つのファイルをすでに書いてくれています。自分で書きたい場合や、macOS で設定を見比べたい場合は、次のようにします。デスクトップ版と Codex CLI が読むのは同じ設定です。

### config.toml を作成する

Windows（PowerShell）ではまずディレクトリを作ります：

```powershell
mkdir $HOME\.codex
```

次に `%USERPROFILE%\.codex\config.toml` に書き込みます：

```toml
model_provider = "qcode"
model = "gpt-6.2-sol"
model_reasoning_effort = "high"

[model_providers.qcode]
name = "qcode"
base_url = "https://api.qcode.cc/openai"
wire_api = "responses"
requires_openai_auth = true
```

### auth.json を作成する

同じディレクトリの `auth.json` に 3 行を書き込みます。キー名は必ず `OPENAI_API_KEY` で、引用符とコロンはすべて半角にします：

```json
{
  "OPENAI_API_KEY": "cr_xxxxxxxx"
}
```

`cr_xxxxxxxx` は自分のキーに置き換えてください。メモ帳で保存するときは「ファイルの種類」を「すべてのファイル」にし、ファイル名を `auth.json` にしてください。そうしないと `auth.json.txt` になり、アプリが読めません。

### 環境変数で渡す書き方（どちらか一方）

キーを環境変数で渡したい場合は、`requires_openai_auth = true` を `env_key = "QCODE_API_KEY"` に置き換え、この変数を設定します。**2 つの書き方のうち 1 つだけ**を使ってください。`requires_openai_auth = true` を書いた場合、Codex は `env_key` を無視します。

```toml
model_provider = "qcode"
model = "gpt-6.2-sol"
model_reasoning_effort = "high"

[model_providers.qcode]
name = "qcode"
base_url = "https://api.qcode.cc/openai"
wire_api = "responses"
env_key = "QCODE_API_KEY"
```

```powershell
# 一時的に設定（現在のセッションのみ）
$env:QCODE_API_KEY = "cr_xxxxxxxx"

# 永続的に設定（ユーザー環境変数に書き込み。設定後はアプリを開き直す）
[System.Environment]::SetEnvironmentVariable("QCODE_API_KEY", "cr_xxxxxxxx", [System.EnvironmentVariableTarget]::User)
```

### config.toml のフィールド説明

| フィールド | 説明 |
|---|---|
| `model_provider` | 使用するモデルプロバイダーの名前。ここでは独自の `qcode` にしています。名前は自由に決められますが、`[model_providers.<名字>]` と一致させてください |
| `model` | 既定のモデル。`gpt-6.2-sol` を推奨。最も難しいタスクなら `gpt-6.2-astra` |
| `model_reasoning_effort` | 推論強度。`low`、`medium`、`high`、`xhigh` に対応。`gpt-6.2-*` は `none` を受け付けないため、`high` か `xhigh` のままを推奨 |
| `base_url` | QCode の接続ポイント。デスクトップ版では `https://api.qcode.cc/openai` と書き、末尾に `/v1` もスラッシュも付けません |
| `wire_api` | API プロトコルの種類。Codex は現在 `responses` のみをサポートします |
| `requires_openai_auth` | OpenAI 形式の認証を使い、キーを `auth.json` の `OPENAI_API_KEY` から読みます。`true` にすると Codex は `env_key` を無視します |

ワンクリックスクリプトは `review_model = "gpt-6.2-sol"`、`windows_wsl_setup_acknowledged = true` といった実行時の設定も書き込みます。デスクトップ版では気にする必要はなく、手動で変更もしないでください。

### 利用できるモデル

QCode 経由では次の Codex / GPT モデルを選べます：

| モデル | 説明 | おすすめの場面 |
|---|---|---|
| **`gpt-6.2-sol`** | 主力のフラッグシップ。1.05M コンテキスト / 最大 128K 出力。`model_reasoning_effort = "none"` を拒否 | 日常的なコーディングから複雑なコーディングまで第一選択（推奨） |
| **`gpt-6.2-astra`** | 最上位のフラッグシップ。1.05M コンテキスト / 最大 128K 出力。同じく `none` を拒否 | 最も難しいマルチステップ Agent とモジュールをまたぐ設計の攻略 |
| `gpt-6.1-terra` | GPT-6.1 の中位モデル。1.05M コンテキスト | 日常的なコーディング / バッチ処理 |
| `gpt-5.6-terra` | GPT-5.6 のフラッグシップ。コード向けに最適化 | プログラミング / Codex の用途 |
| `gpt-6-astra` | 前世代の最強クラス | ハイエンドな能力。新しいタスクは `gpt-6.2-astra` への切り替えを推奨 |

## 接続の概要

| 項目 | 説明 |
|---|---|
| 利用できるモデル | GPT ✅（Responses プロトコル）· Claude ❌ · 中国系モデル ❌（Responses プロトコルでは中国系モデルを提供しない）· Gemini ❌（QCode では未提供） |
| プロトコルと Base URL | Codex は OpenAI Responses を使います。`config.toml` に `base_url = "https://api.qcode.cc/openai"` + `wire_api = "responses"` を書きます |
| 設定の場所 | Windows は `%USERPROFILE%\.codex\`（`config.toml` + `auth.json`）。デスクトップ版と CLI が共有します |
| その他の接続ポイント | `https://asia.qcode.cc/openai`、`https://us.qcode.cc/openai`。`api.qcode.cc` と同じアカウントとキーです |
| 公式ドキュメント | [openai/codex](https://github.com/openai/codex) |