MIT ライセンス・Apple 公証済みの macOS ユーティリティ（ユニバーサルバイナリ）。Codex を公式 OpenAI とカスタム / サードパーティ API の間でワンクリックで切り替え。DeepSeek など中国系 LLM のクイックプリセットと Chat Completions → Responses 変換のローカルアダプターを内蔵し、会話履歴を失いません。
DSH 統合
エコシステム関連
作者による申告
安全性監査
未監査
最終検証日
2026-08-28
ライセンス
MIT
01どんなタスクに使えるのか？
Codex を公式 OpenAI と自作 / サードパーティ API の間でワンクリックで切り替える
保存後も両方のプロバイダーが `~/.codex/auth.json` と `config.toml` に保持され、切り替えはデフォルトルートの変更のみ。保存済み会話の provider/model 帰属は変わりません
公式 OpenAI ログインを残しつつ、Codex を DeepSeek など中国系 LLM プロバイダーへ安定して接続したい Codex デスクトップ / CLI ユーザー
Chat Completions 専用エンドポイントを Codex が話す Responses プロトコルに橋渡しする
Codex の Responses リクエストを Chat Completions に自動変換するローカルアダプター（CLI の説明では `127.0.0.1:17638`）。`/responses` をネイティブ対応しているエンドポイントは直接接続
`/chat/completions` のみを公開する DeepSeek / Kimi / Qwen などのプロバイダー利用者
02DeepSeek Harness への導入方法
前提条件
- macOS — ユニバーサルバイナリ（Intel + Apple シリコン）
- GitHub Releases から `Codex-Switch-vX.Y.Z.dmg` をダウンロード
インストール手順
- 01
GitHub Releases から `Codex-Switch-vX.Y.Z.dmg` をダウンロードする
- 02
DMG をダブルクリックし、`Codex Switch.app` を「アプリケーション」にドラッグしてからそこから起動する（DMG ウィンドウや「ダウンロード」フォルダから直接実行しない）
- 03
アプリで「API プロバイダー」（公式 OpenAI またはカスタム / サードパーティ）を選び、API キーを貼り付けて保存する——保存前にエンドポイントのプローブが自動実行される
導入成功の確認
- アプリが「アプリケーション」から問題なく起動し、「開発元を確認できない」警告が出ないこと——Developer ID 署名済みで Apple 公証済みのため
03DSH 統合と能力の範囲
エコシステムレベル：README に DeepSeek Harness インターフェースの記述はありません。この独立した macOS ユーティリティは Codex の `~/.codex/auth.json` と `config.toml` を編集して、公式 OpenAI とカスタム / サードパーティプロバイダーを切り替えます——DeepSeek を含む中国系 LLM のワンクリックプリセットとローカル Chat Completions → Responses アダプターを備えます。
プロバイダー並行切り替え（公式 / カスタム）
アプリで「API プロバイダー」を選んで保存する→トップレベルの `model_provider` が `custom` と `openai` の間で切り替わる。両方のプロバイダーセクションと CLI プロファイルは `config.toml` に保持されたまま
`~/.codex/auth.json` と `config.toml` のみ書き換え。保存済み会話の帰属は変更しないChat アダプター（Responses → Chat Completions 変換）
`/chat/completions` のみをサポートするエンドポイント（例：DeepSeek / Kimi / Qwen）→Codex の Responses リクエストを Chat Completions に自動変換するローカルプロキシ。`/responses` 対応エンドポイントは直接接続
ローカルプロキシサービスを起動する中国系 LLM プロバイダーのクイックプリセット
内蔵プリセットのいずれか（DeepSeek、Kimi、智譜 GLM、通義千問、豆包、百度文心、MiniMax、階躍星辰 StepFun）、または手動入力のサードパーティ / 中継 API→ベース URL とモデルが自動入力され、API キーを貼り付けるだけ
公式モードのプロキシ修復
HTTP / mixed プロキシ URL（例：`http://127.0.0.1:7897`）→プロキシを Codex のシェル環境・現在の macOS `launchd` 環境・ログイン復元用 LaunchAgent に書き込み、公式モードの新タスク Reconnecting を修復
プロキシは公式 OpenAI モードのみで有効——カスタム API に切り替えると自動で無効化され、公式に戻すと設定に応じて自動復元
04誰に向いているのか？使うべきでない場面は？
向いている用途
- 公式 OpenAI ログインを残しつつ、Codex を DeepSeek など中国系 LLM プロバイダーへ安定して接続したい Codex デスクトップ / CLI ユーザー
- `/chat/completions` のみを公開する DeepSeek / Kimi / Qwen などのプロバイダー利用者
不向きな用途
- アプリは必ず「アプリケーション」フォルダから起動します。DMG ウィンドウや「ダウンロード」フォルダから直接実行すると macOS App Translocation が発動し、内蔵プロキシサービスの接続が異常になります。
05互換性・メンテナンス・セキュリティ上の注意
- Codex Switch は macOS アプリです（ユニバーサルバイナリ：Intel + Apple シリコン）。
- アプリは必ず「アプリケーション」フォルダから起動します。DMG ウィンドウや「ダウンロード」フォルダから直接実行すると macOS App Translocation が発動し、内蔵プロキシサービスの接続が異常になります。
- チャットで Codex 自身にプロバイダー設定を変更させないでください（README が不安定だと警告）。切り替えには本ツールを使ってください。
- デスクトップのモデルセレクターは Codex 自身（バックエンド / 内蔵）が駆動します。カスタムプロバイダーのモデルは「カスタム」ラベルで表示されるという Codex の制限があります。実際のリクエストは選択したプロバイダーへ正しくルーティングされ、CLI ではモデル ID を完全に制御できます。
MIT · 活発にメンテナンス中（最新リリース v0.7.21、2026-08-27）
06よくある質問
Codex Switch は DeepSeek Harness のネイティブプラグインですか？
README には DeepSeek Harness（dsh）のネイティブインターフェースに関する記述はありません。Codex Switch は Codex の `~/.codex/auth.json` と `config.toml` を書き換える独立した macOS ユーティリティです。DeepSeek エコシステムとの関連は、DeepSeek などの中国系 LLM プロバイダーへのワンクリックプリセットを通じてです。
Codex を DeepSeek の API に接続するには？
アプリで DeepSeek のクイックプリセットを選びます（Kimi、智譜 GLM、通義千問、豆包、百度文心、MiniMax、階躍星辰 StepFun も収録）。ベース URL とモデルが自動入力されるので、API キーを貼り付けるだけです。保存時に `/responses` → `/chat/completions` の順で接続をプローブし、通じなければ即座にエラーを返します。
プロバイダーを切り替えると会話履歴は失われますか？
いいえ。通常の切り替えは `~/.codex/auth.json` と `config.toml` のみを書き換え、保存済み会話の provider/model 帰属は変更しません。旧アダプターが残した不正な message ID を検出した場合はバックアップ後に `item_...` → `msg_...` プレフィックスを一度だけ修復し、履歴とセッション帰属を維持します。
使っている API が Chat Completions のみで Responses プロトコル未対応でも使えますか？
使えます。Chat アダプターを有効にすると Codex Switch がローカルプロキシ（CLI の説明では `127.0.0.1:17638`）を起動し、Codex の Responses リクエストを Chat Completions に自動変換します。`/responses` をネイティブ対応しているエンドポイントは直接接続されます。`NO_PROXY` は既定で `localhost,127.0.0.1,::1` を保持するため、ローカルアダプターがプロキシに送られることはありません。
公式 OpenAI ログインに影響しますか？
いいえ。公式 OpenAI とカスタムプロバイダーは並行して設定されたままになり、切り替えはデフォルトルートの変更だけです。ChatGPT OAuth をスキップして API キーモードを使うこともできます。
07関連する DSH ワークフロー
dsh-purge
by yujunzhixue
すべてのモデルを「破甲」する DeepSeek Harness プラグイン。モデルごとに異なるプロンプトを切り替えられ、デフォルトは国産モデル「小码酱」向けです。Star をお願いします。
deepwiki-rs
by sopaco
コードから正確な技術ドキュメントと、AIエージェントが扱いやすいコンテキストを生成するツール。人とエージェント向けに構造化された資料作成を支援します。
dsh-plugin-radar
by adamplatin123
DSH プラグイン生態系のオープンソース・レーダー。1.5 万件超の候補を自動発見し、k8s ランタイムで 1 万件超を実測、15 分ごとのスナップショット処理を実行。プラグイン目録は自動生成される成果物です。
picgo-core
by picgo
CLI と API の両方で使える画像アップロードエンジン
08データと出典
It turns hand‑editing `~/.codex/auth.json` and `config.toml` into one save: Official OpenAI and your custom provider bot…
It ships quick presets for popular Chinese LLM providers and can run a local adapter that bridges Chat‑Completions‑only…
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日：2026-08-28。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。