Codex の環境設定（MCP サーバー・skill 連携）

Datadog MCP Server の remote OAuth で token exchange が失敗する場合、Datadog 公式 docs は local binary authentication を代替手段として案内している。macOS/Linux では Datadog MCP CLI を公式インストーラまたは公式手順で導入し、datadog_mcp_cli login で Datadog にログインする。Codex の .codex/config.toml では [mcp_servers.datadog] に command として datadog_mcp_cli の実行ファイルパスを指定し、args = [] を設定して stdio MCP として起動する。

Codex で Streamable HTTP 型の MCP サーバーを追加する場合、~/.codex/config.toml または trusted project の .codex/config.toml に [mcp_servers.<name>] テーブルを作り、url = "https://..." を指定する。OAuth 対応サーバーは設定後に codex mcp login <name> で認証する。Datadog MCP の US1 endpoint は https://mcp.datadoghq.com/api/unstable/mcp-server/mcp で、EU など別 site では host を site に応じて差し替える。

Codex のプロジェクトローカル skills は .agents/skills/ 配下で検出される。Claude Code の .claude/skills/ を重複コピーせず共有したい場合は、プロジェクトルートに .agents/ を作り、.agents/skills を ../.claude/skills へのシンボリックリンクにできる。作成後は migrate-to-codex.py --validate-target . で skill frontmatter と Codex 設定を検証するとよい。

Codex の skills.config によるスキル無効化は、少なくとも確認した範囲では ~/.codex/config.toml 側に置くと有効で、プロジェクト配下の .codex/config.toml に置いても repo-local skill の無効化には効かなかった。

path は glob 非対応で、/path/to/worktree/*/.agents/skills/name/SKILL.md のような指定では一致しない。絶対 path はその worktree の実パスと一致する場合だけ効くため、Git worktree ごとに .agents/skills/.../SKILL.md の絶対 path が変わると、main worktree 用の無効化設定だけでは別 worktree で同じ skill が再び有効になる。

注意点として、CLI の -c 'skills.config=[{path=".agents/skills/foo/SKILL.md",enabled=false}]' では CWD 相対のように効いたが、~/.codex/config.toml に [[skills.config]] path = ".agents/skills/foo/SKILL.md" と書いた場合は、main/worktree の CWD 相対としては効かなかった。したがって、ユーザー設定ファイル内の相対 path で worktree 群をまとめて無効化する運用は期待しないほうがよい。

公開 issue でも近い問題が報告されている。openai/codex #20210 と #24237 は project-local .codex/config.toml の [[skills.config]] が skill filtering に効かず、~/.codex/config.toml や -c session flags では効くという内容。#23987 は skill disable が path-scoped で、同名 skill の別 source が残るとユーザー視点で無効化されたように見えても active な copy が残るという内容。#25324 でも workaround として user config に対象 skill の絶対 path を明示列挙している。

実務上の選択肢は、完全に無効化したいなら ~/.codex/config.toml に現在使う各 worktree の絶対 path を複数列挙すること。暗黙起動だけ止めればよいなら、skill 側に agents/openai.yaml を置いて policy.allow_implicit_invocation: false を設定すると、worktree path に依存せず repo 内容として効く。ただし $skill の明示起動は止まらない。