発生事象
- VSCodeの拡張機能で Codex を使おうとしてインストールするも、
Error starting conversationというエラーが出た - 拡張機能の再起動や、Codexのアンインストール→再インストールをするとそもそもCodexが起動すらしなくなった
- 同様の事象はWindowsで発生していることがIssueとして報告されているが、Macbookでも起こった
開発環境
- VSCodeのバージョン
- バージョン: 1.103.2 (Universal)
- Electron: 37.2.3
- Node.js: 22.17.0
- OS: Darwin arm64 24.5.0
- Codexのバージョン
- 0.4.6
原因
- CodexのMCP設定ファイルである
config.tomlにおいて、他コーディングエージェントで使っていた.mcp.jsonをそのままコピーして放置していたため - これが原因で拡張機能そのものに影響を与えていた
対処法
- CodexのMCP設定を正しくtoml形式で行う
- 参考ドキュメントは以下
今回なぜこんなことになったかというと、config.tomlにMCP設定のjsonを置いておき、それをCodex自身に編集させようと思ったんですよね。
そうするとCodexへリクエストが投げられなくなり、挙句の果てにはCodexが起動すらしなくなって途方に暮れていました。
そんな時にGPT-5 Thinkingが解決案の1つとして教えてくれたのが、config.tomlにjsonが入っているとエラーになるケースが有るということでした。
ということでtoml形式に直して設定すると、問題なく使えるようになりましたとさ。
CodexがjsonでMCP設定できるようにしてくれてたらこんなことにはなってねーんだぞ！！
ちなみに当然Issueは上がってるものの、「jsonからtomlには簡単に変えられるよ^^」みたいなリプライがついてたので対応する気無いのかもしれない。しらんけど。
tips: config.tomlの編集を行う
ちなみにconfig.tomlをVSCode上で開きたいけどCodexがそもそも立ち上がってこない場合、以下コマンドでいけます。
ターミナル
$ code ~/.codex/config.toml
Macbookでcodeコマンドが使えない場合は以下記事参照。