Codex の出力に出るファイル参照を VS Code や Cursor で直接開く file_opener の設定

Codex が「src/auth/session.ts:42 を修正しました」のように場所を示してくれても、そのたびにエディタでファイルを探すのは手間です。Codex CLI には、こうしたファイル参照を エディタで直接開けるリンク に変換する file_opener 設定があります。

結論として、~/.codex/config.toml に file_opener = "cursor" のようにエディタ名を書くだけで、出力中のファイル参照がそのエディタの URI スキームのリンクになります。既定は vscode です。

file_opener の値

file_opener = "cursor"

値	開くエディタ
vscode(既定)	Visual Studio Code
vscode-insiders	VS Code Insiders
windsurf	Windsurf
cursor	Cursor
none	リンク化しない

公式ドキュメントは、この設定を「ファイルの引用を、対応エディタの URI スキームによるクリック可能なリンクに変換する」ものと説明しています。VS Code なら vscode://file/絶対パス:行:列 の形式で、クリックするとその行にジャンプします。

動く条件

リンクが機能するには、次の条件がそろっている必要があります。

1. ターミナルがハイパーリンク(OSC 8)に対応している。iTerm2、WezTerm、Windows Terminal、Kitty、最近の GNOME Terminal などは対応しています
2. 指定したエディタがローカルにインストールされ、URI スキームが登録されている
3. Codex がローカルで動いている。SSH 先で動かしている場合、リンクは SSH 先のパスを指すためローカルのエディタでは開けません

VS Code の統合ターミナルで Codex を動かしている場合は、file_opener = "vscode" のままにしておくと、同じウィンドウでファイルが開きます。

無効化と関連設定

リンク化そのものを止めたい場合は none にします。

file_opener = "none"

同じ [tui] 周辺には、表示に関する設定がいくつかあります。用途に合わせて組み合わせてください。

キー	既定	意味
tui.theme	未設定	シンタックスハイライトのテーマ
tui.alternate_screen	auto	代替スクリーンを使うか(auto / always / never)
tui.animations	true	ターミナルのアニメーション
tui.raw_output_mode	false	スクロールバックを残す raw モードで開始する

推論(reasoning)の表示を減らして出力を読みやすくする設定は hide_agent_reasoning の設定 で扱っています。config.toml 全体の構造は親記事の config.toml でモデル・推論の深さ・プロファイルを切り替える を参照してください。

まとめ

• file_opener はファイル参照をエディタの URI リンクにする設定。値は vscode(既定)/ vscode-insiders / windsurf / cursor / none
• ターミナルの OSC 8 対応と、エディタの URI スキーム登録が必要
• SSH 先で動かしている Codex のリンクはローカルでは開けない
• IDE 拡張には別の仕組みがあるので、CLI 向けの設定と考える
• 表示まわりは [tui] のテーマ・代替スクリーン・アニメーションと組み合わせる