Codex は OpenAI 公式のコマンドライン AI コーディングアシスタントです。4AICode API 経由で接続すると、キー、チームのクォータ、利用状況を一つのコンソールで管理でき、実際のトークン使用量に基づいて課金されます。

💡 初心者向け：まず [方法 1：接続アシスタント（GUI）] から始めることをおすすめします。コマンド入力は不要で、数クリックで設定できます。

前提条件：トークンの取得

どの設定方法でも、まず 4AICode トークンが必要です。

4AICode にサインインし、ダッシュボード → トークン管理へ移動。
「新規トークン」 をクリック。
生成された文字列（sk-4ai-<your-token> 形式）をコピー。

⚠️ 重要な注意：

トークンは作成時に一度だけ表示されます。パスワードマネージャーまたはメモアプリに保存してください。

本ガイドの sk-4ai-<your-token> はプレースホルダーです。実際のトークンに置き換えてください。

コマンドライン例では、角括弧とその中のプレースホルダーを実際のトークンに置き換えてください。

トークンはパスワードと同様に扱い、共有したり GitHub にコミットしたりしないでください。

方法 1：接続アシスタント（初心者向け）

4AICode 接続アシスタントは MyGo でネイティブデスクトップ UI を構築しており、ターミナルコマンドは不要です。

1. 接続アシスタントのダウンロード

OS	ダウンロードリンク	備考
Windows 10 / 11（64 ビット）	📥 Windows 用接続アシスタント (.exe)	インストーラーを直接実行
macOS 12+（Apple Silicon / M シリーズ）	📥 Apple Silicon 用接続アシスタント (.dmg)	DMG を開き Applications にドラッグ
macOS 12+（Intel）	📥 Intel 用接続アシスタント (.dmg)	DMG を開き Applications にドラッグ

Windows 版は現在パブリッシャー署名がなく、初回起動時に SmartScreen プロンプトが出る場合があります。Defender 検証は保留中です。ダウンロードディレクトリから certutil -hashfile 4aicode-assistant-windows-amd64.exe SHA256（Windows）を実行し、SHA256SUMS.txt の該当ファイル行先頭のハッシュと比較してください。

macOS の両アーキテクチャは Developer ID 署名と Apple 公証済みです。DMG を開きアプリを Applications にドラッグしてインストールします。

（チェックサム検証：SHA-256 チェックサム · バージョン情報）

ダウンロードリンクにリリースバージョンが表示されます。更新前に、アシスタントのシステムトレイ／メニューバーから終了を選択してください。ウィンドウを閉じるだけではバックグラウンドで動作し続けます。アプリを置き換えて再度開き、ウィンドウ右上のバージョンとビルド ID をダウンロードページと比較してください。

2. 3 ステップで設定

アカウント接続：アシスタントを開き、sk-4ai-<your-token> を貼り付け、Mainland China (国内线路) または International (国际线路) を選択し、選択した経路の API から自動読み込みされたドロップダウンでモデルを選び 「Connect」 をクリック。トークンまたは経路を変更するとモデルが再読み込みされます。Refresh Models (刷新模型) で再試行できます。
インストールと起動：「Select Project & Launch Codex」 をクリック。初回で Codex CLI がない場合、アシスタントがダウンロード・インストールしてから選択ディレクトリで起動します。ダウンロード中はステータスメッセージが表示されるので完了まで待ってください。
常時利用可能に：ウィンドウを閉じてもアシスタントはシステムトレイ（Windows）またはメニューバー（macOS）に残り、すぐアクセスできます。

トークンはシステム資格情報マネージャーに安全に保存されます。入力横の目アイコンで表示／非表示を切り替えられます。接続すると再び非表示になります。

3. 公式 Windows デスクトップアプリに接続

ローカル Codex は APIキーサインインをサポートし、4AICode 残高を直接利用できます。

アシスタントでモデルを選択して接続。モデル一覧はマウスホイールスクロールとキーボード選択に対応。
Copy Desktop Login Key (复制桌面登录密钥) をクリック。アシスタントがデスクトッププロバイダー設定を準備し、ローカル接続キーをコピーします。
公式 ChatGPT / Codex デスクトップアプリを 完全終了してから再起動。Sign in another way → API key を選び、OpenAI API key に貼り付けて続行。
アシスタントを起動したまま新しいローカルタスクを開始。モデルまたは経路変更後はデスクトップアプリを再起動してください。

両アプリは同じ Windows ユーザーと Codex 設定ディレクトリを使用してください（通常 %USERPROFILE%\.codex）。CODEX_HOME を設定している場合、両方がそのディレクトリを使う必要があります。

config.toml にはローカル接続キーが含まれるため機密として扱ってください。トラブルシューティング情報を共有する前に認証情報をマスクしてください。Restore Original Configuration はアシスタントのデスクトップサインインモードを終了します。

コピーしたキーはローカルアシスタントに接続します。4AICode トークンはシステム資格情報ボルトに残ります。ChatGPT で既にサインインしているユーザーは、このボタンをクリックしてアプリを再起動できます。APIキーモードはローカル Codex 作業をサポートします。ChatGPT Web チャット、ワークスペース、クラウド機能はそれぞれ公式アカウント権限を使用します。公式認証ドキュメント

デスクトップエラー：Model provider `fouraicode_assistant` not found

デスクトップアプリが読み込んだ設定にアシスタントのプロバイダー定義がありません。

システムトレイから旧アシスタントを終了し、最新版をダウンロードして Connect (连接) をクリック。接続済み表示の場合は Disconnect (断开) してから再接続。v0.1.2 以降、アシスタントは設定を定期確認し、バックアップが所有を確認できれば再接続時に欠落定義を復元できます。
公式 ChatGPT / Codex デスクトップアプリを 完全終了して再起動 し、該当会話を開く。
エラーが続く場合、両アプリが同じ Windows ユーザーと設定ディレクトリ（CODEX_HOME 設定時を含む）を使っているか確認。アシスタントバージョン、手順、設定ディレクトリをサポートと共有してください。

Restore Original Configuration 使用後、アシスタント会話を続ける前に再接続してください。元のプロバイダーを使う場合はデスクトップアプリを再起動し新しいタスクを開始してください。

接続設定が変更された

Reconfigure and Connect (重新配置并连接) をクリックし、Back Up and Connect (备份并连接) を確認。アシスタントは切り替え前に現在の設定と以前のバックアップを保存し、4AICode に切り替えます。プロジェクト信頼、MCP、その他プロバイダーは保持されます。復元するとこの切り替え前の設定に戻ります。完了後はデスクトップアプリを再起動してください。

接続失敗

表示メッセージに従ってください：タイムアウトは再試行、プロキシ失敗はローカルプロキシアプリとポートを確認、証明書失敗は PC の日時を確認、無効なモデル一覧は更新。継続するサービスエラーはサポートに連絡。トークン、残高、利用上限メッセージはダッシュボードで対処。アシスタントバージョンとエラーメッセージをサポートと共有；設定ファイル共有前に認証情報をマスクしてください。

方法 2：コマンドライン設定（開発者向け）

ターミナルに慣れている場合は、インストールコマンドとワンクリックセットアップスクリプトを実行してください。約 2 分で完了します。

1. ターミナルを開く

⌘ + Space を押し、「Terminal」と入力して Enter。

2. Codex CLI をインストール

Node.js または Homebrew がインストールされていることを確認し、いずれかを実行：

# Option A: via npm (recommended, requires Node.js 16+)
npm install -g @openai/codex

# Option B: via Homebrew (macOS only)
brew install --cask codex

codex --version を実行。バージョン番号が表示されればインストール成功です。

3. ワンクリックセットアップスクリプトを実行

sk-4ai-<your-token> を実際のトークンに置き換えて実行：

# International route (recommended)
export RELAY4AI_BASE_URL=https://relay.4aicode.com/v1
curl -fsSL https://4aicode.com/codex-setup.sh | bash -s install 'sk-4ai-<your-token>'

# Mainland China direct route (.net)
curl -fsSL https://4aicode.net/codex-setup.sh | bash -s install 'sk-4ai-<your-token>'

✓ Written ... が表示されれば設定完了です。

4. 設定の確認

新しいターミナルウィンドウを開き、任意のプロジェクトフォルダで実行：

codex

Explain the file structure of this directory と聞いてみてください。応答があれば接続成功です。

よく使う操作

1. モデルと推論 effort の切り替え

アシスタントでは Disconnect をクリックし、ドロップダウンで別モデルを選んで再接続し、Codex を再起動してください。

コマンドライン設定ではローカル設定ファイルを編集：

macOS / Linux：~/.codex/config.toml
Windows：%USERPROFILE%\.codex\config.toml

次の 2 行を更新（他フィールドはそのまま）：

model = "gpt-5.6-terra"
model_reasoning_effort = "xhigh"

モデル	推奨用途
`gpt-5.6-terra`	日常コーディング（デフォルト）：速度とコード品質のバランスが最良
`gpt-6-astra`	次世代フラッグシップ：最高性能；公式定価の 15% で課金
`gpt-5.6-sol`	複雑なエンジニアリング：最強の推論（`max` effort レベルをサポート）
`gpt-5.6-luna`	高速・経済的：軽量タスク、予算重視
`gpt-5.5` / `gpt-5.4`	既存ワークフロー互換

推論 effort オプション：low、medium、high、xhigh。変更は Codex 再起動後に反映。

2. ステータス確認または設定のロールバック

# Check current provider and model status
curl -fsSL https://4aicode.com/codex-setup.sh | bash -s status

# Uninstall and restore pre-setup config
curl -fsSL https://4aicode.com/codex-setup.sh | bash -s uninstall

トラブルシューティングと FAQ

Q1: `codex: command not found` または認識されない？

原因：Codex CLI が未インストール、またはターミナル環境パスが更新されていない。
対処：現在のターミナルを閉じて新しく開く。続く場合は Node.js をインストールし npm install -g @openai/codex を再実行。

Q2: `401 Unauthorized` が出た？

原因：無効または失効したトークン、プレースホルダー未置換。
対処：sk-4ai-<your-token> が実際のトークンに置き換わっているか確認。ダッシュボードで新しいトークンを生成しセットアップコマンドを再実行。

Q3: PowerShell が実行ポリシーでスクリプトをブロック？

対処：上記の & ([scriptblock]::Create(...)) コマンドを使用するか、PowerShell で Set-ExecutionPolicy -Scope CurrentUser RemoteSigned を実行してローカルスクリプトを許可。

Q4: 設定やモデル変更が反映されない？

対処：Codex は起動時に設定をキャッシュします。Codex CLI を完全終了するか Codex App を閉じ、新しいターミナルで codex を再実行。

Q5: 公式 Codex デスクトップアプリ（Codex App）の使い方は？

アシスタントで接続し、Copy Desktop Login Key (复制桌面登录密钥) をクリック、デスクトップアプリを完全終了して再起動、APIキーサインインを選んで貼り付け。Windows デスクトップ手順は上記を参照。
公式プロバイダーに戻す場合はアシスタントで元の設定を復元。ローカルキーでサインインした場合はデスクトップアプリでサインアウトし、独自の公式サインイン方法を選択。

Q6: Windows PowerShell で中国語が文字化け？

Windows PowerShell 5.1 はダウンロード応答の charset でスクリプトをデコードします。ダウンロードサーバーは UTF-8 を宣言しています。古いキャッシュやプロキシで文字化けする場合は Ctrl+C でスクリプトを停止し、明示的に UTF-8 でダウンロード：

$setupClient = New-Object System.Net.WebClient
$setupClient.Encoding = [System.Text.Encoding]::UTF8
try {
  $setupScript = $setupClient.DownloadString('https://4aicode.com/codex-setup.ps1')
} finally {
  $setupClient.Dispose()
}
& ([scriptblock]::Create($setupScript))

プロンプトに従いトークンを入力しモデルを選択してください。

Q7: 起動時に `plan type is required for chatgpt authentication`？

古いセットアップスクリプトがログイン資格情報欠落の ChatGPT 認証状態を作成した場合があります。更新されたスクリプトと 4AICode トークンで install を再実行。スクリプトはデフォルトで APIキー認証を使用。初回インストールバックアップはアンインストール時の復元に利用可能。

status は設定ファイルを確認します。Codex でテストメッセージを送って接続を確認してください。.com と .net の中継 URL の両方をサポートしています。

Q8: 再インストール後も `workspace routing discovery unauthorized (401)` が続く？

公式サービスが Codex の ChatGPT セッション用ワークスペース情報読み取りを拒否しました。古いスクリプトはトークンフィールドとプラン情報に基づきログインを自動保持し、無効セッションにも存在し得ます。アンインストールでそのセッションが復元され、再インストールで再選択されることがあります。

Windows PowerShell で次を実行し、現在のスクリプトをダウンロードして APIキー認証を明示選択：

$setup = irm ("https://4aicode.com/codex-setup.ps1?v=" + [DateTimeOffset]::UtcNow.ToUnixTimeSeconds())
& ([scriptblock]::Create($setup)) install -AuthMode apikey
codex login status
codex

プロンプトで 4AICode トークンを入力。codex login status は APIキー認証を報告するはずです。中継 APIキーモードは公式 ChatGPT ワークスペースセッションとは独立して動作します。明示的 chatgpt モードは有効な公式ログインとワークスペースアクセスが依然必要です。

その他のツールと SDK 連携

他のエディタや SDK を使う場合、標準 OpenAI 互換パラメータで 4AICode の ChatGPT プールに接続：

ツール / 環境	ガイド
CC Switch（GUI プロバイダー切替）	CC Switch ガイド
VS Code / Cursor / Windsurf	VS Code / Cursor ガイド
GPT モデルを使う Claude Code	Claude 設定ガイド
Droid / Pi	Droid / Pi ガイド
公式 OpenAI Python / Node SDK	Base URL と APIキーを設定（下記コード例）

API パラメータ

Base URL：https://relay.4aicode.com/v1（中国本土では https://relay.4aicode.net/v1）
API Key：4AICode トークン（sk-4ai-<your-token>）

Python SDK 例

from openai import OpenAI

client = OpenAI(
    base_url="https://relay.4aicode.com/v1",
    api_key="sk-4ai-<your-token>",  # Replace with your actual token
)

response = client.chat.completions.create(
    model="gpt-5.6-terra",
    messages=[{"role": "user", "content": "Hello! Please write a quicksort algorithm."}],
)

print(response.choices[0].message.content)

cURL 例

curl https://relay.4aicode.com/v1/chat/completions \
  -H "Authorization: Bearer sk-4ai-<your-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "messages": [{"role": "user", "content": "ping"}]
  }'

付録：手動上級設定（参考）

💡 一般ユーザーはこのセクションを無視して構いません。設定を確認または手動マージする必要がある開発者向けです。

設定ファイルの場所：

macOS / Linux：~/.codex/
Windows：%USERPROFILE%\.codex\

1. `auth.json`

両方の認証方式をサポート。セットアップスクリプトはデフォルトで中継 APIキー：

デフォルト apikey：下記のとおり auth_mode = "apikey" と 4AICode トークンを記述。既存 ChatGPT 資格情報は初回インストールバックアップに残る。
明示的 chatgpt：Windows インストールコマンドに -AuthMode chatgpt を追加、または macOS/Linux で install <Token> <model> <reasoning_effort> chatgpt。スクリプトは元のログインファイルを保持し構造を確認。公式サービスがセッションとワークスペースアクセスを検証；無効セッションは codex login で更新。

両モードとも config.toml の experimental_bearer_token 経由で 4AICode 中継に認証。スクリプトは先に元ファイルをバックアップ。auth.json、config.toml とそのバックアップはパスワード同等；平文資格情報を含みます。トラブルシューティング共有前にキーをマスクし、バージョン管理外に保管：

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-4ai-<your-token>"
}

2. `config.toml`

4AICode をモデルプロバイダーに設定。cli_auth_credentials_store = "file" で Codex がセットアップスクリプトが書いた auth.json を使用：

model_provider = "OpenAI"
openai_base_url = "https://relay.4aicode.com/v1"
model = "gpt-5.6-terra"
model_reasoning_effort = "xhigh"
cli_auth_credentials_store = "file"

[model_providers.OpenAI]
name = "4aicode"
base_url = "https://relay.4aicode.com/v1"
wire_api = "responses"
experimental_bearer_token = "sk-4ai-<your-token>"
requires_openai_auth = true

ChatGPT / Codex 設定