CodexをVS Codeで使い始める：Windows環境での基本操作と文字化け対策
作成日:2026.08.02
Windows 11のVisual Studio CodeにCodex拡張を導入し、ファイルの説明や小さな修正を依頼する基本的な使い方を紹介します。PowerShell 7のターミナル経由で日本語ファイルを扱う際の文字コード問題や、文字化けを防ぐための確認方法についても解説します。
目次
最近、AIにコードを書いてもらったり、既存のコードを説明してもらったりする機会が増えています。というか、もうAIなしでの開発には戻れないですよね。
OpenAIのCodexは、コードの理解や編集を支援してくれるコーディングエージェントです。今回は、Windows 11のVisual Studio CodeにCodexの拡張機能をインストールして、基本的な使い方を確認してみます。
また、Windowsのターミナルから日本語を含むファイルを扱う場合に、文字コードの違いでファイルを壊してしまうことがあります。実際に遭遇した文字化けの例と、PowerShell 7でファイルを扱う際の注意点もまとめます。
前提
今回の環境は以下の通りです。
- Windows 11
- Visual Studio Code 1.131.0
- PowerShell 7
Codexの利用にはChatGPTのアカウントが必要です。利用条件や対応するプランは変更される可能性があるため、現在の条件はVisual Studio MarketplaceのCodex拡張で確認してください。
Codexとは
Codexは、ソースコードを読んで内容を説明したり、指定した変更を加えたり、問題の調査を手伝ったりするコーディングエージェントです。
Visual Studio Codeでは、エディターの横にCodexのパネルを表示して利用できます。開いているファイルや選択範囲を会話のコンテキストとして渡せるため、対象のファイルを説明する手間を減らせます。
詳しい機能や最新の操作方法については、Codex IDE拡張の公式ドキュメントを参照してください。
VS CodeにCodex拡張をインストールする
まず、Visual Studio Codeを起動して、拡張機能の画面を開きます。
- 左側のアクティビティバーから、拡張機能のアイコンをクリックする
- 検索欄に「Codex」と入力する
- Codex - OpenAI's coding agentを選択する
- 拡張機能の発行元がOpenAIであることを確認して、インストールする
拡張機能は、上記のVisual Studio Marketplaceのページから確認することもできます。
Codexを開く
拡張機能をインストールすると、アクティビティバーにCodexのアイコンが表示されます。
アイコンが見つからない場合は、コマンドパレットを開いて、以下のコマンドを実行します。
Codex: Open Codex Sidebar初回利用時は、画面の案内に従ってChatGPTのアカウントでサインインします。
最初に試す操作
いきなり大きな機能の実装を依頼するのではなく、まずは読み取りだけの依頼から始めると安心です。
ファイルの内容を説明してもらう
VS Codeで対象のファイルを開き、次のように依頼します。
このファイルの処理内容を、初めて読む人にも分かるように説明してください。
まだファイルは変更しないでください。特定の範囲だけを説明してほしい場合は、エディターでコードを選択してから依頼します。現在開いているファイルや選択範囲をコンテキストとして渡せることが、IDE拡張を使う利点の一つです。
小さな修正を依頼する
内容を確認したら、影響範囲の小さい修正を依頼してみます。
この関数に、引数が空の場合の入力チェックを追加してください。
変更するファイルと、変更内容を先に説明してから編集してください。このように、変更対象と確認してほしい内容を具体的に書くと、意図しない範囲まで変更される可能性を下げられます。
Codexが変更した内容を確認する
Codexがファイルを変更した場合でも、内容を確認せずにそのまま利用するのは避けます。
最低限、以下の点を確認します。
- 変更されたファイルが依頼した範囲に収まっているか
- 変更前後の差分に、意図しない修正が含まれていないか
- 既存の処理や設定を壊していないか
- 必要なテストや動作確認を実行したか
- 日本語を含むファイルに文字化けがないか
Gitで管理しているプロジェクトであれば、作業前後の差分を確認しやすくなります。大きな作業を依頼する前には、コミットやブランチを作成して、変更前の状態へ戻せるようにしておくと安心です。
Windowsのターミナルで日本語ファイルを扱う場合
Windows環境でCodexを使う場合、ファイルの読み書きがターミナル経由で行われることがあります。
ここで注意したいのが、ファイルそのものの文字コードと、読み書きするコマンドが想定している文字コードが一致している必要があるという点です。
実際に起きた文字化け
今回の環境では、日本語を含むファイルをターミナル経由でCodexに読み取らせた際、文字コードを明示していませんでした。
その結果、Codexがファイル全体を文字化けしていると判断し、その後、ファイルの内容が別の文字コードで上書きされた可能性があります。結果として、ファイル全体が文字化けした状態になりました。
上書き時に実際に使われた文字コードは確認できていないため、Shift_JISと断定はできません。ただし、文字コードが不明なままファイルを書き換えると、このような復旧が難しい状態になることがあります。
PowerShell 7の文字コード
PowerShell 7では、テキスト出力の既定値はUTF-8（BOMなし）です。ただし、ファイルの元の文字コードがUTF-8とは限りません。また、コマンドやPowerShellのバージョンによって既定の扱いが異なるため、重要なファイルでは既定値に任せない方が安全です。
特に、Shift_JISなど別の文字コードで保存されたファイルをUTF-8として読み取ると、日本語が正しく解釈できず、文字化けした内容として扱われる可能性があります。
PowerShellの文字コードについては、Microsoftのabout_Character_Encodingと、VS CodeとPowerShellのファイルエンコーディングに関する説明も参照してください。
読み取り時にUTF-8を指定する
対象ファイルがUTF-8であることが分かっている場合は、読み取り時にエンコーディングを指定します。
$path = '.\sample.md'
$text = Get-Content `
-LiteralPath $path `
-Encoding utf8 `
-Raw
$text-Rawを付けると、ファイル全体を一つの文字列として読み取れます。行単位ではなく、元の文章全体を確認したい場合に使いやすいオプションです。
書き込み時にUTF-8を指定する
ファイルへ書き戻す場合も、エンコーディングを明示します。以下の例では、UTF-8のBOMなしで保存しています。
$path = '.\sample.md'
$text = Get-Content `
-LiteralPath $path `
-Encoding utf8 `
-Raw
# $textを確認してから書き込む
$text | Set-Content `
-LiteralPath $path `
-Encoding utf8NoBOMSet-Contentは既存ファイルの内容を置き換えます。文字化けした内容を読み取った状態でこのコマンドを実行すると、文字化けしたまま上書きされる可能性があります。書き込む前に、ターミナルの表示とVS Codeのエディターで内容を確認してください。
Out-Fileとリダイレクトにも注意する
コマンドの出力をファイルへ保存する場合は、Out-Fileやリダイレクト演算子を使うことがあります。これらも、保存先ファイルの文字コードを意識して使います。
Get-ChildItem | Out-File `
-LiteralPath '.\files.txt' `
-Encoding utf8NoBOM
Get-ChildItem | Out-File '.\files.txt' -Encoding utf8NoBOM>や>>によるリダイレクトは便利ですが、既存ファイルのエンコーディングを確認してから使うようにします。PowerShellのバージョンやコマンドによる既定値の違いを避けるため、記事で扱う例では-Encodingを明示します。
文字コードに関するルールをファイルに書いておく
毎回同じ注意点を伝える必要がある場合は、プロジェクト内にルールを書いたMarkdownファイルを置いておく方法があります。
例えば、以下のような内容です。
# 日本語ファイルを扱うときの注意
- 既存ファイルの文字コードを確認してから読み書きする
- 日本語を含むファイルは、原則としてUTF-8として扱う
- PowerShellで書き込むときは、エンコーディングを明示する
- 編集後はファイルを読み直し、文字化けがないことを確認する
- 文字化けしているファイルへ、そのまま上書きしないこれは、今回参照した文字コード対策用のSKILL.mdを、公開記事用に一般化した例です。実際のプロジェクトへ置く場合は、利用しているツールが参照するルールファイルの形式に合わせてください。
文字化けしたときの対処
ファイルを開いたときに日本語が文字化けしていた場合は、まず書き込み操作を止めます。
- 文字化けした状態でファイルを上書きしない
- Gitの差分やバックアップから、変更前の状態を確認する
- VS Codeのステータスバーから、現在認識されているエンコーディングを確認する
- 元のエンコーディングが分かっている場合だけ、そのエンコーディングを指定して読み直す
- 読み直した内容が正しいことを確認してから、必要な形式で保存する
元の文字コードが分からない場合に、UTF-8やShift_JISを順番に試して、そのまま保存するのは危険です。まずはバックアップやGitの履歴から元のファイルを復元できる状態にしておきます。
APIキーや秘密情報を含むファイルを渡さない
Codexにプロジェクトを読み取らせる場合でも、APIキー、パスワード、秘密鍵、個人情報などを含むファイルを不用意に渡さないようにします。
特に、.envや設定ファイルを開いた状態で、そのままプロジェクト全体の解析を依頼する場合は注意が必要です。必要な範囲だけを選択し、秘密情報をマスクしたサンプルを使う方が安全です。
まとめ
今回は、Windows 11のVisual Studio CodeにCodexの拡張機能をインストールして、基本的な使い方を確認しました。
最初はファイルの説明や小さな修正から始め、Codexが変更した内容を差分とファイルの表示で確認してから利用するのがよいかと思います。
また、Windowsのターミナル経由で日本語ファイルを扱う場合は、文字コードを明示せずに読み書きしないことが重要です。特に、文字化けした内容をそのまま保存すると、ファイル全体を壊してしまう可能性があります。
ファイルの文字コードが分からない場合は、まず書き込みを止め、Gitやバックアップから復元できる状態を確保してから原因を確認してください。
奈良市を拠点に、27年以上の経験を持つフリーランスWebエンジニア、阿部辰也です。
これまで、ECサイトのバックエンド開発や業務効率化システム、公共施設の予約システムなど、多彩なプロジェクトを手がけ、企業様や制作会社様のパートナーとして信頼を築いてまいりました。
【制作会社・企業様向けサポート】
Webシステムの開発やサイト改善でお困りの際は、どうぞお気軽にご相談ください。小さな疑問から大規模プロジェクトまで、最適なご提案を心を込めてさせていただきます。
ぜひ、プロフィールやWeb制作会社様向け業務案内、一般企業様向け業務案内もご覧くださいね。