ワンクリック設定スクリプト
コマンド 1 行で Claude Code / Codex の接続設定を完了:レイテンシ計測によるエンドポイント選択、設定書き込み、CLI インストール、疎通確認 — sudo / 管理者権限不要
API キーが必要ですか? 登録する →エンドポイントと Base URL →
目次
コマンド 1 行で、ゼロから使える状態まで完了します。スクリプトが自動でレイテンシを計測して最速の接続エンドポイントを選び、キーの入力をガイドし、設定を書き込み、必要に応じて Node.js と CLI をインストールし、最後に最小限のリクエストを 1 回送信して疎通を確認します。まずお使いの OS を選んでください:
📖 実行前に QCode.cc ダッシュボード で
cr_から始まる API キーをご用意ください。スクリプトの実行中に貼り付けを求められます(入力は画面に表示されません)。 どの選択肢でも Key の使い方は同じです。まだ選んでいない場合はプランの選び方をご覧のうえ、ダッシュボードで Key を取得してください。
クラウドサーバーでエージェントを動かす場合、サーバーページに載っているのも同じコマンドです。その後のキー設定、切断後もタスクを動かし続ける方法はクラウドサーバー上でエージェントを実行を参照してください。
🍎 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
Interface language / 表示言語¶
# macOS / Linux
curl -fsSL https://qcode.cc/install/claude-code.sh | bash -s -- --lang en
# Windows PowerShell
$env:QCODE_LANG='en'; irm https://qcode.cc/install/claude-code.ps1 | iex
--lang zh / --lang en. Same for codex.
設定は 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
No irm / blocked by execution policy¶
In CMD (Command Prompt):
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://qcode.cc/install/claude-code.ps1 | iex"
Double-click, or iex blocked by policy:
curl -fsSL https://qcode.cc/install/claude-code.cmd -o "%TEMP%\qcode.cmd" && "%TEMP%\qcode.cmd"
For future PowerShell sessions (no admin rights needed):
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
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 の 3 つの接続エンドポイントにそれぞれ軽量リクエストを 1 回送信し、最速のものを推奨します(手動での変更も可能です)
- 設定の書き込み — Claude Code:macOS/Linux では shell の管理ブロック、Windows ではユーザーレベルの環境変数に書き込み。Codex:
~/.codex/config.toml+auth.jsonに書き込み(デフォルトモデルはその場で選択でき、推奨はgpt-6.1-sol) - 環境のインストール(スキップ可)— Node.js のバージョンを確認し(Claude Code 用スクリプトは ≥ 22、Codex 用スクリプトは ≥ 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> |
接続エンドポイントを指定し、レイテンシ計測をスキップします |
--model <id> |
Codex:デフォルトモデルを指定し、選択メニューをスキップします。Claude Code:デフォルトモデルを固定します(ANTHROPIC_MODEL に書き込み)。省略すると Claude Code 標準のデフォルトモデルを使い、そのアップグレードにも追従します |
--lang <zh\|en> |
Interface language (default: system locale) |
--target <app\|cli> |
(codex only) Config only / also install the CLI |
--yes / -y |
すべての確認にデフォルト値を使用します |
--no-install |
設定の書き込みのみ行い、Node / CLI をインストールしません |
--no-verify |
疎通確認をスキップします |
--dry-run |
書き込み・インストール・確認の内容を表示するだけで、ファイルは書かず、何もインストールせず、確認リクエストも送りません |
--uninstall |
このスクリプトが書き込んだ設定を削除します(Node / CLI はアンインストールしません)。--yes で確認を省略 |
--help |
すべてのパラメータを表示します |
Windows でのパラメータ付き呼び出し(上表に対応するパラメータ:-Key、-Domain、-Model、-Yes、-NoInstall、-NoVerify、-DryRun、-Uninstall):
& ([scriptblock]::Create((irm https://qcode.cc/install/claude-code.ps1))) -Key cr_xxx -Yes
(codex.ps1 も同様です)
先に計画を確認:--dry-run¶
--dry-run(Windows:-DryRun)を付けると、スクリプトは計画を表示するだけです。設定の書き込み先ファイル、管理ブロックの全文(キーは cr_**** と末尾 4 文字に伏せ字)、~/.claude/settings.json で同期するキー、Codex の config.toml と auth.json、インストールするソフトウェア、送信する確認リクエストを表示します。ファイルは書かず、何もインストールせず、確認リクエストも送りません。行うのは速度測定だけです(--domain を指定した場合は測定しません)。キーがなければプレースホルダーで説明を続け、入力を求めて止まることはありません。
アンインストール:--uninstall¶
--uninstall(Windows:-Uninstall)は、このスクリプトが書き込み、値がいまも書き込んだときのままの設定を削除します。Node と CLI はアンインストールしません。最後に対応する npm uninstall -g … コマンドを表示するので、必要なら実行してください。まず変更するファイルを一覧して確認を求めます。--yes(Windows:-Yes)で確認を省略でき、--dry-run と組み合わせると一覧を表示するだけで何も変更しません。
curl -fsSL https://qcode.cc/install/claude-code.sh | bash -s -- --dry-run
curl -fsSL https://qcode.cc/install/claude-code.sh | bash -s -- --uninstall
curl -fsSL https://qcode.cc/install/codex.sh | bash -s -- --uninstall --yes
& ([scriptblock]::Create((irm https://qcode.cc/install/claude-code.ps1))) -DryRun
& ([scriptblock]::Create((irm https://qcode.cc/install/claude-code.ps1))) -Uninstall
& ([scriptblock]::Create((irm https://qcode.cc/install/codex.ps1))) -Uninstall -Yes
- Claude Code(macOS / Linux):各シェル設定ファイルの
# >>> qcode.cc claude-code >>>管理ブロック(fish ではconf.d/qcode.fishの同名ブロック)。~/.claude/settings.jsonのenvにある、アドレスがqcode.ccのANTHROPIC_BASE_URLと、それと対になるANTHROPIC_AUTH_TOKEN。 - Claude Code(Windows):スクリプトが設定したユーザー環境変数のうち、値がいまも一致するもの。削除前に旧い値を
%USERPROFILE%\.qcode\にバックアップします。ANTHROPIC_MODELは残すので、必要なら自分で削除してください。 - Codex:
config.tomlの[model_providers.qcode]と、このスクリプトが書いたトップレベルの項目(値が一致しないものは残して表示します)、およびauth.jsonにこのスクリプトが書いたOPENAI_API_KEY。
他社サービスのアドレスとキー、ご自身のその他の設定、CLI の PATH 設定はすべて残ります。変更するファイルは先に .bak.タイムスタンプ としてバックアップします。削除するものがなければ「No settings written by this script were found.」と表示して正常終了します。すでに開いているターミナルの環境変数は、新しいターミナルを開くと反映されます。
書き込まれるファイル / ロールバック方法¶
| ツール / プラットフォーム | 書き込み先 | ロールバック方法 |
|---|---|---|
| Claude Code(macOS/Linux) | ~/.zshrc または ~/.bashrc 内の # >>> qcode.cc claude-code >>> 管理ブロック |
管理ブロック全体を削除するか、同じディレクトリの .bak.タイムスタンプ バックアップから復元します |
| Claude Code(Windows) | ユーザーレベルの環境変数 ×4(ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN / CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC / CLAUDE_CODE_AUTO_MODE_SERVER。-Model 指定時は ANTHROPIC_MODEL も追加) |
%USERPROFILE%\.qcode\backup-*.json 内の旧値から復元します |
| Codex(全プラットフォーム) | ~/.codex/config.toml + ~/.codex/auth.json |
同じディレクトリの .bak.タイムスタンプ バックアップから復元します |
Claude Code(~/.claude/settings.json の env が他社の接続先を指している場合のみ) |
その env の ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN(ANTHROPIC_API_KEY は ANTHROPIC_AUTH_TOKEN に置き換え)。確認後にのみ変更し、他の設定はそのまま |
同じディレクトリの .bak.タイムスタンプ バックアップから復元します |
スクリプトの再実行は常に安全です。管理ブロックはその場で更新され、設定ファイルはバックアップを取ってから更新されます。このスクリプトの設定をまとめて取り除くには、上の --uninstall を使ってください。
よくある質問¶
- 確認で 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 / 管理者権限を必要とせず、システムディレクトリには一切書き込みません
- "The API key contains invalid characters" — quotes / spaces / smart punctuation were pasted with the key. Copy it again from the dashboard
- "You are running this script with sudo" — sudo is not needed; it writes the config into root's home. Re-run without sudo
- "Config was written, but verification did not pass" — config files are in place, only the final connectivity check failed. Fix per the status code and re-run
- "The env block in settings.json points Claude Code at a different endpoint" —
~/.claude/settings.jsonのenvは環境変数より優先されるため、以前の他社リレー / CC Switch の設定が残っていると Claude Code はそちらに接続します。スクリプトの案内に従って QCode に切り替えてください(バックアップを取り、接続関連の項目だけを変更します) - Codex がだんだん遅くなり「Reconnecting… / stream disconnected」を繰り返す — 多くの場合、セッションにスクリーンショットや画像が溜まっています。Codex は毎ターン会話全体(すべての画像を含む)を再送信するため、数十枚のスクリーンショットで 1 回あたり数十 MB になり、回線が遅いと送り切れません。
/newで新しいセッションを始めてください(続けたい作業を数行で説明すれば十分です)。セッションがすでに大きい場合は/compactを使わないでください(圧縮リクエスト自体も履歴全体を一度送信します)。今後は 1 つのセッションに貼るスクリーンショットを減らすか、縮小してから貼ってください
Codex: desktop App or CLI¶
The script asks which client you use:
- Codex desktop App (default) — config files only, no Node.js / CLI install
- Codex CLI — also applies to the App; installs Node.js and the CLI as needed
Non-interactive: --target app / --target cli (Windows: -Target app / -Target cli).
ℹ️ If
~/.codex/config.tomlalready exists, the script only updatesmodel_provider/model/review_model/model_reasoning_effortand[model_providers.qcode]; MCP servers / profiles and other settings are kept (the original is backed up as.bak.<timestamp>first). Only a malformed file is overwritten as a whole, with an explicit notice. A top-levelprofile = …(rejected by current Codex) is commented out; move[profiles.<name>]into~/.codex/<name>.config.tomland runcodex --profile <name>. Acrstable written by an older version of the script is renamed toqcodeautomatically when you run the script again.
QCode を始める
API キーひとつで Claude Code・Codex などに対応。トークン単位の課金で、各モデルの単価は qcode.cc/models に掲載