ワンクリック設定スクリプト
コマンド 1 行で Claude Code / Codex の接続設定を完了：レイテンシ計測によるエンドポイント選択、設定書き込み、CLI インストール、疎通確認 — sudo / 管理者権限不要
ワンクリック設定スクリプト¶
コマンド 1 行で、ゼロから使える状態まで完了します。スクリプトが自動でレイテンシを計測して最速の接続エンドポイントを選び、キーの入力をガイドし、設定を書き込み、必要に応じて Node.js と CLI をインストールし、最後に最小限のリクエストを 1 回送信して疎通を確認します。まずお使いの OS を選んでください：
📖 実行前に QCode.cc ダッシュボード で
cr_から始まる API キーをご用意ください。スクリプトの実行中に貼り付けを求められます（入力は画面に表示されません）。
🍎 macOS / 🐧 Linux¶
ターミナルを開き、貼り付けて実行します（sudo は不要です）：
Claude Code¶
curl -fsSL https://qcode.cc/install/claude-code.sh | bash
Codex¶
curl -fsSL https://qcode.cc/install/codex.sh | bash
設定は shell の設定ファイル（~/.zshrc / ~/.bashrc 内の管理ブロック）または ~/.codex/ に書き込まれます。Node.js がない場合は nvm を使ってユーザーディレクトリにインストールされます。
🪟 Windows¶
ネイティブの PowerShell だけで動作します — WSL も管理者権限も不要です。「Windows ターミナル」または PowerShell を開き、貼り付けて実行します：
Claude Code¶
irm https://qcode.cc/install/claude-code.ps1 | iex
Codex¶
irm https://qcode.cc/install/codex.ps1 | iex
Windows 版に関する注意：
- 設定はユーザーレベルの環境変数に書き込まれます（Codex は
%USERPROFILE%\.codex\に書き込み）。旧値は自動的に%USERPROFILE%\.qcode\へバックアップされます - Node.js がない場合は winget で LTS をインストールします。winget がない場合は nodejs.org での手動インストール手順を案内します
- 設定完了後、新しく開いた PowerShell / ターミナルでは自動的に反映されます。VS Code などのエディタは一度再起動が必要です
- スクリプトが実行ポリシーにブロックされる場合は、先に
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserを実行してから再試行してください
スクリプトが行うこと¶
- レイテンシ計測によるエンドポイント選択 — api / asia / us / eu の 4 つの接続エンドポイントにそれぞれ軽量リクエストを 1 回送信し、最速のものを推奨します（手動での変更も可能です）
- 設定の書き込み — Claude Code：macOS/Linux では shell の管理ブロック、Windows ではユーザーレベルの環境変数に書き込み。Codex：
~/.codex/config.toml+auth.jsonに書き込み（デフォルトモデルはその場で選択でき、推奨はgpt-5.6-terra） - 環境のインストール（スキップ可）— Node.js ≥ 20 を検出し、ない場合は nvm（macOS/Linux）または winget（Windows）で LTS をインストールした後、
npm install -gで CLI をインストールします。すべてユーザーディレクトリ内で完結します - 疎通確認 — お手持ちのキーで最小限のリクエストを 1 回送信し、失敗した場合は HTTP ステータスコードに応じたトラブルシューティングのヒントを表示します
- 書き込み前バックアップ — 変更されるファイルはすべて事前に
.bak.タイムスタンプとしてバックアップされます。Windows の旧環境変数は%USERPROFILE%\.qcode\にバックアップされます
非対話モード（CI / 確認省略）¶
macOS / Linux：
curl -fsSL https://qcode.cc/install/claude-code.sh | bash -s -- --key cr_xxx --yes
| パラメータ | 説明 |
|---|---|
--key <cr_...> |
API キー。指定すると対話入力をスキップします |
--domain <api\|asia\|us\|eu> |
接続エンドポイントを指定し、レイテンシ計測をスキップします |
--model <id> |
（codex.sh のみ）デフォルトモデルを指定し、選択メニューをスキップします |
--yes / -y |
すべての確認にデフォルト値を使用します |
--no-install |
設定の書き込みのみ行い、Node / CLI をインストールしません |
--no-verify |
疎通確認をスキップします |
--help |
すべてのパラメータを表示します |
Windows でのパラメータ付き呼び出し（上表に対応するパラメータ：-Key、-Domain、-Model、-Yes、-NoInstall、-NoVerify）：
& ([scriptblock]::Create((irm https://qcode.cc/install/claude-code.ps1))) -Key cr_xxx -Yes
（codex.ps1 も同様です）
書き込まれるファイル / ロールバック方法¶
| ツール / プラットフォーム | 書き込み先 | ロールバック方法 |
|---|---|---|
| Claude Code（macOS/Linux） | ~/.zshrc または ~/.bashrc 内の # >>> qcode.cc claude-code >>> 管理ブロック |
管理ブロック全体を削除するか、同じディレクトリの .bak.タイムスタンプ バックアップから復元します |
| Claude Code（Windows） | ユーザーレベルの環境変数 ×3 | %USERPROFILE%\.qcode\backup-*.json 内の旧値から復元します |
| Codex（全プラットフォーム） | ~/.codex/config.toml + ~/.codex/auth.json |
同じディレクトリの .bak.タイムスタンプ バックアップから復元します |
スクリプトの再実行は常に安全です。管理ブロックはその場で更新され、設定ファイルはバックアップを取ってから上書きされます。
よくある質問¶
- 確認で 401 が返る — キーが無効か期限切れです。ダッシュボード で確認し（
cr_プレフィックスまで完全にコピーされているかご確認ください）、スクリプトを再実行してください - 確認で 404 が返る — 接続先アドレスが間違っています。Claude Code の BASE_URL は
https://{域}/api、Codex はhttps://{域}/openaiで、末尾にスラッシュは付けません - ネットワークタイムアウト — スクリプトを再実行して別の接続エンドポイントに切り替えてください（例：
--domain asia）。各エンドポイントのリアルタイムの状態は probe.qcode.cc で確認できます - Windows でインストール後に claude / codex コマンドが見つからない — 新しい PowerShell ウィンドウを開き直してください（PATH は新しいセッションで初めて更新されます）
- スクリプトに Node をインストールさせたくない —
--no-install（Windows：-NoInstall）を付けると、設定の書き込みのみ行います - 先にスクリプトの内容を確認したい — https://qcode.cc/install/claude-code.sh を直接開いてソースコードをお読みください。スクリプトは sudo / 管理者権限を必要とせず、システムディレクトリには一切書き込みません