Codex CLI を初めて使う人向けの実践ガイド

npm install -g @openai/codex

# mise (https://mise.jdx.dev/)を使っている場合
mise install npm:@openai/codex
mise use -g npm:@openai/codex

# codex login か最初に対話セッションをはじめると「Sign in with ChatGPT」が表示
codex

codex resume # 対象のセッションを選択
codex resume --last  #　最新のセッションで起動
codex resume <SESSION_ID> # 指定したセッションで起動

/init — 初期化テンプレートや設定のブートストラップ

/new — 新しい会話に切り替え(セッション状態のクリア)

/model — AIモデルの切り替え

/compact - これまでの会話履歴のトークンを要約・圧縮

/help – ヘルプを表示

/quit — セッション(codex)を終了

/mode — セッション内の「承認モード」を切り替えるため

model = "gpt-5-codex"
model_verbosity = "medium" # 詳細な応答の冗長さ（情報量の多さ）
sandbox_mode = "read-only"  # 最も安全（必要時のみ緩める）

# コマンド実行を承認するかどうかをプロンプトで確認すべきタイミング
# - untrusted: 「信頼済み」でないコマンド（危険操作など）は実行前に都度承認を求め
# - on-request: モデル（Codex）が判断して承認を要求する場合
# - on-failure: コマンドが失敗した場合のみ承認にエスカレート
# - never: いかなる場合も承認を求めず、すべての操作を自動で実行
approval_policy = "untrusted"

file_opener = "cursor" # or vscode
notify = ["bash","-lc","afplay /System/Library/Sounds/Ping.aiff"]

# trueにすると、npmのインストールや外部APIへのリクエストが可能 (デフォルトは false)
network_access = false

[tui]
#　デスクトップ通知に関する設定
# - "agent-turn-complete": エージェントの１ターン処理が完了した際に通知
# - "approval-requested": ユーザーの操作や承認が必要な時に通知
notifications = ["agent-turn-complete","approval-requested"]

[shell_environment_policy]
inherit = "core"
include_only = ["PATH","HOME","USER"]
exclude = ["AWS_*","AZURE_*","*TOKEN*","*SECRET*","*KEY*"]

model_reasoning_effort = "medium" # モデルがどれだけ「考える」かの深さ

[tools]
web_search = true # Web 検索を許可 (デフォルトは false)

[mcp_servers.playwright]
command = "npx"
args    = ["-y", "@playwright/mcp"]

# 登録
codex mcp add <id> -- <command> <args...>

# 確認
codex mcp list

codex -c 'mcp_servers={"playwright"={command="npx",args=["-y","@playwright/mcp"]}}'

[mcp_servers.serena]
command = "uvx"
args = ["--from", "git+https://github.com/oraios/serena", "serena", "start-mcp-server", "--context", "codex", "--enable-web-dashboard=false", "--project", "$(pwd)"]

codex mcp add serena -- uvx --from git+https://github.com/oraios/serena \
serena start-mcp-server --context codex --enable-web-dashboard=false \
--project $(pwd)

codex -c 'mcp_servers={"serena"={command="uvx",args=["--from", "git+https://github.com/oraios/serena", "serena", "start-mcp-server", "--context", "codex", "--enable-web-dashboard=false", "--project", "$(pwd)"]}}'

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]

codex mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

codex -c 'mcp_servers={"context7"={command="npx",args=["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]}}'

[mcp_servers.notion]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.notion.com/mcp"]

codex mcp add notion -- npx -y mcp-remote https://mcp.notion.com/mcp

codex -c 'mcp_servers={"notion"={command="npx",args=["-y", "mcp-remote", "https://mcp.notion.com/mcp"]}}'

[mcp_servers.markitdown]
command = "uvx"
args = ["markitdown-mcp"]

codex mcp add markitdown -- uvx markitdown-mcp

codex mcp add markitdown -- uvx markitdown-mcp

codex -c 'mcp_servers={"markitdown"={command="uvx",args=["markitdown-mcp"]}}'

[mcp_servers.chrome-devtools]
command = "npx"
args = ["chrome-devtools-mcp"]

codex mcp add chrome-devtools -- npx chrome-devtools-mcp

codex -c 'mcp_servers={"chrome-devtools"={command="npx",args=["chrome-devtools-mcp"]}}'

[mcp_servers.playwright]
command = "npx"
args = ["-y", "@playwright/mcp"]

codex mcp add playwright -- npx -y @playwright/mcp

codex -c 'mcp_servers={"playwright"={command="npx",args=["-y","@playwright/mcp"]}}'

[mcp_servers.figma]
command = "npx"
args = ["-y", "mcp-proxy", "http://127.0.0.1:3845/mcp"]

codex mcp add figma -- npx -y mcp-remote "http://127.0.0.1:3845/mcp"

codex -c 'mcp_servers={"figma"={command="npx",args=["-y", "mcp-remote", "http://127.0.0.1:3845/mcp"]}}'

- name: Update changelog via Codex
  run: |
    npm install -g @openai/codex
    codex login --api-key "${{ secrets.OPENAI_KEY }}"
    codex exec --full-auto --model gpt-5-codex \
      --config sandbox_mode="workspace-write" \
      "update CHANGELOG for next release"

[mcp_servers.ultracite]
command = "npx"
args = ["-y", "mcp-remote", "https://www.ultracite.ai/api/mcp/mcp"]

codex mcp add ultracite -- npx -y mcp-remote "https://www.ultracite.ai/api/mcp/mcp"