Linux／WSL の CLI とファイルの場所

Codex 学習目次に戻る

目標と二つの入口

Linux PC ならその端末を開いて手順2へ進みます。Windows では Linux ツールが必要か判断します。ネイティブ PowerShell でも使えるため WSL は必須ではありません。Linux の開発環境や依存関係がある場合に WSL2 を選びます。Windows CLIと並ぶ選択肢で、Windows のエラーすべてを移行で解決するわけではありません。

図の 1 は入力環境の識別、2 は導入と Linux プロジェクトへの移動、3 は同じ環境での検証です。Linux のホーム、ツール、認証情報は既定では別です。Windows の codex --version が成功しても Ubuntu 内の導入確認にはならず、WSL の認証だけで Windows デスクトップ側のログインも確認したとはいえません。

手順1：Windows で WSL2 を確認する

Windows PowerShell で次を実行し、ディストリビューションと VERSION が 2 かを確認します。Linux シェルのコマンドではありません。既存の WSL2 は保ち、再導入や削除はしません。現行 Codex の Linux サンドボックスは WSL1 非対応です。WSL1 の作業は先にバックアップし、Microsoft 資料で変換を計画します。唯一のコピーで試さないでください。

wsl --list --verbose

まず winver で確認します。Microsoft の wsl --install による簡易導入は Windows 11、または Windows 10 2004（ビルド19041）以降が必要です。古い版は次のコマンドを流用せず、公式の手動導入手順を確認してください。 未導入なら仮想化と WSL が許可されているか確認し、Microsoft の案内で管理者 PowerShell から wsl --install を実行します。必要な再起動と Linux ユーザー作成を終えます。npm パッケージだけでなく OS 環境を追加するので、他の作業を中断する時間も確保します。管理端末では規則に従います。

wsl --install

複数のディストリビューションがある場合は、PowerShell で wsl --distribution の後に一覧にある完全な名前を必要に応じて引用符付きで指定します。導入前に対象を選んでください。A で codex が見つかっても B で利用できる証拠にはなりません。後で PowerShell に戻ったらコマンドの解決先を確認し直し、Linux の導入やハッシュ記録を Windows に当てはめないでください。

導入後は Terminal で対象を選ぶか、通常の PowerShell で wsl を実行して既定の環境を開きます。複数ある場合は一覧の実名を選び、Ubuntu があると決めつけません。入るとプロンプトとパスが Linux 形式になります。以降はすべてこの Linux シェルで行います。

手順2：シェル、CLI、ホームを識別する

uname -s
pwd
printf '%s\n' "$WSL_DISTRO_NAME"
command -v codex
type -a codex

uname は Linux を示します。WSL_DISTRO_NAME は WSL のディストリビューションを示し、通常 Linux では空でも正常です。command -v と type -a で目的の Linux 導入元か調べます。/mnt/c の Windows ラッパーは Linux ネイティブ導入の証拠ではありません。元を記録し、Linux 内で導入して選択されるコマンドを確認します。

新規導入は公式の独立コマンドを照合して実行し、PATH の案内を読んで新しい Linux 端末を開きます。npm 利用者は同じ Linux 内の node / npm を確認して npm install -g @openai/codex を使えます。Windows の Node.js は代わりになりません。一つの経路を選んで更新も統一します。

curl -fsSL https://chatgpt.com/codex/install.sh | sh

command -v codex
codex --version
codex --help

導入出力、実行パス、版を一致させます。curl、sh、基本ツールがなければ自分のディストリビューションの資料で準備し、別のパッケージ管理命令を流用しません。起動だけでは依存関係やサンドボックスの動作確認にならないため、次の読み取りで確認します。

手順3：Linux ホームに課題を作る

Linux ツールで動かす WSL 作業は ~/code など Linux ホームを優先します。/mnt/c は Windows のマウント先で、/home と同じプロジェクトの別名ではありません。この課題のために本番を移動しません。次は既存なら上書きせず停止する新規フォルダー作成です。必要なら別名を選びます。サブシェルなので終了後に明示的に移動します。

(
  set -e
  cd ~
  mkdir 'codex linux lab'
  cd 'codex linux lab'
  printf '%s\n' 'LINUX-CLI-01' > note.txt
  cp note.txt note.original.txt
  pwd
  ls
)

作成成功後だけ次へ進みます。mkdir の File exists は既存データを保護した結果で、sudo を付ける理由ではありません。新しい名前を選びます。移動後は二つのファイル、LINUX-CLI-01、一致する SHA-256 を確認します。ローカルのバイト比較であり、Windows のハッシュとの一致は要求しません。

cd ~/"codex linux lab"
pwd
cat note.txt
sha256sum note.txt note.original.txt

手順4：同じ Linux 環境で認証して読む

codex login
codex login status
codex --sandbox read-only

各コマンドの完了を待ち、実際の認証案内に従います。WSL でホストのブラウザーを使っても、Linux 端末へ戻って完了を確認します。ブラウザーやローカルのコールバックが使えなければ login --help と公式認証ページを確認します。アカウントと組織が許可する場合だけ --device-auth を使い、Windows の認証ファイルをプロジェクトへコピーして解決しません。

Read note.txt and note.original.txt in the current Linux practice directory. Report the current directory and the exact marker, and check whether both files match. Do not edit, create files, or use external services. Stop and report any missing file or access error.

これは bash ではなく Codex の依頼です。Linux 練習フォルダー、LINUX-CLI-01、実際の読み取り記録を確認します。次に同じ Codex セッションで存在しない note-missing.txt を要求し、作成せず欠落を示すことを確認します。その後 /exit でシェルに戻り、sha256sum、cat、ls で不変を確かめます。二種類の結果で導入、認証、場所、読み取りの流れを検証します。

ファイルの場所、更新、問題解決

/mnt/c の Linux 作業が遅ければ、唯一の原稿を移動や削除する前に Linux ホームの新しい練習コピーで比較します。エクスプローラーからは公式資料の \\wsl$ 入口で実際の環境を選びます。Linux ファイルへのアクセスであって二つのコピーの同期ではありません。同名だけで判断せず、印と pwd を照合します。

更新前に CLI を終了して要約を残します。独立版は Linux の公式インストーラー、npm 版は同じ Linux の npm を使い、新しいシェルでパスと版を確認します。wsl --update は WSL の更新で Codex の代用ではありません。wsl --shutdown は動作中の WSL 作業を止めるため、毎回の Codex 導入手順にはしません。

シェルでは読めて Codex では読めなければ起動や権限のエラーを記録し、WSL2 と環境を確認して権限を調べます。一律にサンドボックスを無効にしません。古いセッションがなければ環境、Linux ユーザー、CODEX_HOME の違いを確認します。本記事では認証ディレクトリを共有しません。CLI 基礎で変更と復元、その後引き継ぎへ進みます。

Codex 学習目次に戻る

詳しい説明を読む

Three numbered stages: identify the starting point, perform the exercise, and verify the result. Original illustration, not a product screenshot.

• AIツール
• チュートリアル
• Codex