最新アップデート

ニュースに収録済みの直近3件です。全件はニュースから確認できます。

2026-10-29Codex CLI 0.165.0〜0.166.0 — Vertex AI プロバイダーを内蔵、新規プロファイルで Memory v2 が既定に

0.165.0 で組み込みの Google Cloud Vertex AI プロバイダー(model_provider = "gcp")を追加。新規プロファイルでは Memory v2 が既定に。0.166.0 でトランスクリプトのキーボード選択・検索、codex queue --resume、codex doctor --network-only を追加。

セキュリティ: チェックしたホストと別のホストへ Git が接続できたマーケットプレイス URL 検証の抜け穴を修正。ニュースを読む

2026-10-26GPT-6.1 Terra — 中位モデルが Codex でも利用可能に(報道ベース)

報道によると、GPT-5.6 Terra の後継となる中位モデル GPT-6.1 Terra(API 名 gpt-6.1-terra)がリリースされ、ChatGPT Work と Codex で利用可能に。Codex CLI は 0.165.0 でモデルカタログに、0.166.0 で Vertex AI・Amazon Bedrock のカタログにも追加。ニュースを読む

2026-10-23Codex CLI 0.164.0 — プロンプトを10スロットに保存する /presets、/model・/permissions のインライン引数

/presets でプロンプトやスラッシュコマンドを番号付きの10スロットに保存し、キーボードメニューから呼び出せるように。/model・/permissions に引数でモデル・推論 effort・権限プロファイルを直接指定できるように。

セキュリティ: リモート Bash コマンドと Zsh スナップショットのセッションで認証情報をマスク。macOS のサンドボックスチェックを強化。ニュースを読む

概要

  • OpenAI 製。CLI・IDE 拡張・デスクトップアプリ(Codex app)・Web で動作
  • 設定は TOML 形式の config.toml(ユーザー単位とプロジェクト単位)
  • AGENTS.md でプロジェクトの指示を渡す
  • Hooks は設定スキーマ上で14種類のイベント
  • カスタムエージェントを TOML ファイルで定義してサブエージェントとして使える
  • Skills(SKILL.md)で手順を再利用
  • /goal で目標とトークン予算を決めて継続的に作業させる
  • 定期実行はデスクトップアプリの Automations で設定

ベストプラクティス 10

  1. プロンプトには目的・前提・制約・完了条件をまとめて書く
  2. 実装の前に Plan mode などでリポジトリを調べさせ、方針を確認する
  3. AGENTS.md には build / test / lint のコマンドと完了条件を書く
  4. 危険なコマンドの拒否は指示文ではなく PreToolUse hook と承認ポリシーで行う
  5. 組織では requirements.toml で管理者の Hook だけを許可する設定を検討する
  6. サブエージェントは1つに1つの役割を持たせ、developer_instructions で振る舞いを明確にする
  7. Skill の description は「何をするか」と「いつ使うか」を具体的に書く(暗黙的な起動の精度が上がる)
  8. 長い作業は /goal にトークン予算を付けて任せ、途中で状態を確認する
  9. Automations はまず通常のスレッドで手順を安定させてから登録する
  10. フルアクセスのサンドボックスで Automations を動かさない(確認なしでファイル変更やネットワークアクセスが起きる)

設定(config.toml)

ユーザー単位の ~/.codex/config.toml と、プロジェクト単位の .codex/config.toml があります。組織の制約は requirements.toml で管理者が配布します。

以前の記載からの訂正: このページでは以前、[approval_policy]・[automations]・[goal]・[provider] テーブルや hooks.managed_dir を使った設定例を載せていましたが、いずれも Codex の設定スキーマに存在しないキーでした。また、プロファイルの例も 0.134.0 で廃止された [profiles.<name>] 形式のままでした。下の例に差し替えています。
01config.toml の例(承認・サンドボックス・プロバイダー・Hook)
# ~/.codex/config.toml
approval_policy = "on-request"      # "on-request" / "never"、細かく決めるなら { granular = { ... } } のテーブル
sandbox_mode    = "workspace-write" # read-only / workspace-write / danger-full-access

# 独自のモデルプロバイダー(例: Azure OpenAI)
[model_providers.azure]
name     = "Azure"
base_url = "https://YOUR_RESOURCE.openai.azure.com/openai"
env_key  = "AZURE_OPENAI_API_KEY"
wire_api = "responses"

# Hook(PreToolUse で Bash を検査)
[[hooks.PreToolUse]]
matcher = "^Bash$"

[[hooks.PreToolUse.hooks]]
type          = "command"
command       = "python3 ~/.codex/hooks/policy.py"
timeout       = 30
statusMessage = "Checking Bash command policy"
  • プロバイダーを使うときは、ユーザー設定(~/.codex/config.toml)に model_provider = "azure" と model(Azure 側のデプロイ名)を合わせて書きます
  • プロジェクトの .codex/config.toml では model_provider・model_providers・openai_base_url・chatgpt_base_url・notify・otel・profile・profiles などが無視され、起動時に警告が出ます
02設定ファイルの種類
ファイル場所対象
ユーザー設定~/.codex/config.toml自分・全プロジェクト
プロジェクト設定.codex/config.tomlリポジトリ(Git 管理できる)
組織の制約requirements.toml管理者が配布。例: allow_managed_hooks_only = true でユーザー・プロジェクト・セッションの Hook を無視し、管理者の Hook だけを有効にする
03プロファイル(--profile)

プロファイルは、プロファイルごとの別ファイル ~/.codex/<name>.config.toml にトップレベルのキーで書き、codex --profile <name> で切り替えます。

# ~/.codex/review.config.toml
model_reasoning_effort = "high"
sandbox_mode           = "read-only"

# 実行例
codex --profile review "このブランチの差分をレビューして"

0.134.0 以降、config.toml の [profiles.<name>] テーブルとトップレベルの profile = "..." は読み込まれません。古い設定は新しい形式のファイルに移し、config.toml から削除します。

出典: Config reference · config.schema.json(openai/codex) · docs/config.md

AGENTS.md

セッション開始時に読み込まれるプロジェクトの指示ファイルです。

01AGENTS.md の例
# AGENTS.md
## Project
TypeScript monorepo (pnpm workspaces)
Node 22 / React 19 / PostgreSQL 16

## Build & Test
build: pnpm build | test: pnpm test | lint: pnpm lint

## Rules
- Never commit to main directly
- All API endpoints require Zod validation

## Done when
- pnpm test passes
- pnpm lint is clean
- pnpm tsc --noEmit succeeds
  • 信頼していないプロジェクトの AGENTS.md の指示は読み込まれません(0.150.0 から)
  • Codex は各ディレクトリで AGENTS.override.md → AGENTS.md の順に探し、1ディレクトリにつき1ファイルだけを読みます。project_doc_fallback_filenames に CLAUDE.md などを追加すると、AGENTS.md がないディレクトリではそのファイルが代わりに読まれます(AGENTS.md があれば読まれません)

出典: AGENTS.md guide · 0.150.0 のニュース

Hooks

ライフサイクルの決まった時点でコマンドや MCP ツールを実行する仕組みです。既定で有効で、[features] hooks = false で無効にできます。

01イベント(設定スキーマ上の14種類)
イベントタイミング
SessionStart / SessionEndセッションの開始・終了
UserPromptSubmitプロンプト送信時
PreToolUse / PostToolUseツール実行の前後(matcher はツール名の正規表現)
PermissionRequest承認を求める時
PreModelRequest / PostModelRequestモデルへのリクエストの前後
PreCompact / PostCompactコンテキスト圧縮の前後
SubagentStart / SubagentStopサブエージェントの開始・終了
Stopターンの終了時
Interruptトップレベルのターンを中断した時(0.150.0 で追加)

一覧は安定版 0.166.0 の設定スキーマで確認したものです。各イベントの対象ツールや入出力の形式は公式ドキュメントで確認してください。

02書き方と注意点
  • Hook は hooks.json か、config.toml の [hooks] テーブルに書きます。ユーザー(~/.codex/)とリポジトリ(.codex/)の両方にある場合はすべて読み込まれます。ただしリポジトリ側の設定は、そのプロジェクトを信頼した場合にだけ読み込まれます
  • ハンドラーには type = "command"(command・timeout・statusMessage・commandWindows など)と、MCP サーバーのツールを呼ぶ type = "mcp_tool"(必須: server・tool、任意: input)があります
  • timeout を省略すると600秒です
  • PreToolUse で Bash を止めても、モデルがスクリプトをファイルに書いて実行するなど抜け道はあり得ます。完全な強制ではなく安全策の一つとして使い、サンドボックスと承認ポリシーを併用します

出典: Hooks · config.schema.json(HooksToml)

サブエージェント

カスタムエージェントを1ファイル1エージェントの TOML で定義し、サブエージェントとして並列に動かせます。

01カスタムエージェントの定義
# .codex/agents/security-reviewer.toml
name                   = "security-reviewer"
description            = "Reviews diffs for security issues."
developer_instructions = "You are a senior security reviewer. Report only specific, actionable findings."
sandbox_mode           = "read-only"
model_reasoning_effort = "high"
nickname_candidates    = ["Sherlock", "Inspector"]
  • 必須は name・description・developer_instructions
  • 保存先: 個人用 ~/.codex/agents/、プロジェクト用 .codex/agents/
  • model や sandbox_mode など省略した項目は親セッションから引き継ぎます
  • nickname_candidates は表示名だけで、起動には name が使われます
02並列数と深さの上限

config.toml の [agents] で上限を設定します。同時に動かせるスレッド数は、公式ドキュメントでは max_threads(既定6)、0.166.0 の設定スキーマでは max_concurrent_threads_per_session と書かれています。名前が変わった可能性があるため、使っているバージョンで確認してください。max_depth は入れ子の深さ(既定1)です。設定スキーマでは max_depth は旧方式(V1)のエージェントにだけ効き、Multi-agent V2 では無視されると説明されています。

03並列レビューと Remote Control
  • PR のレビューを、セキュリティ・バグ・テストなど観点ごとのサブエージェントに分けて並列で実行するのが効果的です
  • Remote Control(2026年6月 GA)を使うと、ChatGPT モバイルアプリから接続済みの Mac / Windows ホストで作業を始めたり続けたりできます。2026-07-18 のアップデートで、端末とホストを QR コードで1対1にペアリングする方式に変わりました。7/18 のニュースを読む

出典: Subagents · config.schema.json(AgentsToml) · Codex changelog(Remote Control GA)

Skills

SKILL.md に手順を書いたフォルダです。起動時には名前・説明・パスだけが読み込まれ、必要になったときに本文が読まれます。

01SKILL.md の例と保存場所
# .agents/skills/commit/SKILL.md
---
name: commit
description: Stage and commit changes in semantic groups.
  Use when the user wants to commit or organize commits.
---
1. Do not run `git add .`. Stage in logical groups.
2. Group: feat → test → docs → refactor → chore.
3. Write concise commit messages.
  • リポジトリ: 作業ディレクトリからリポジトリのルートまでの各階層の .agents/skills
  • 個人用: $HOME/.agents/skills
  • 組み込みの $skill-creator を使うと、対話しながら Skill を作れます
  • 同じ name の Skill が2つあっても統合はされず、両方が選択肢に出ます

出典: Agent Skills

Goal(/goal)

達成したい目標を設定すると、Codex がその目標に向けて作業を続けます。

以前の記載からの訂正: 以前は [goal] テーブルの timeout = "72h"・checkpoint = "8h" で設定し、チェックポイントごとに自動でコミットされると説明していましたが、設定スキーマにそのようなキーはなく、根拠を確認できませんでした。
01使い方
  • TUI で /goal を使って目標を設定・編集します。引数なしの /goal で現在の目標の概要を表示します
  • 目標は一時停止・再開でき(/goal resume)、トークン予算を付けられます
  • 新しい目標の既定の予算と上限は config.toml の [goals] max_goal_token_budget で指定します
  • ネストしたサブエージェントのトークン消費もルートの目標の予算に計上されます(0.151.0 で修正)

出典: goal_menu.rs(openai/codex) · config.schema.json(goals)

Automations(Codex app)

デスクトップアプリで、繰り返し実行するバックグラウンドの作業を登録する機能です。config.toml ではなくアプリから設定します。

012つの種類と設定方法
種類動き向いている用途
Standaloneスケジュールごとに新しい実行を始め、結果を Triage の受信箱に送る毎回独立した作業、複数プロジェクトにまたがる作業
Thread今のスレッドに定期的に戻ってくる同じ会話を続けながら定期的に確認する作業
  • 通常のスレッドで「この作業を毎朝実行して」のように頼むと、Codex がプロンプト・種類・スケジュールを設定します
  • 独自の間隔は cron 式で指定します
  • Git リポジトリでは、ローカルのプロジェクトか専用のバックグラウンド worktree のどちらで動かすかを選べます
  • プロジェクト単位の Automations は、アプリが起動していてプロジェクトがディスク上にあるときだけ動きます

出典: Automations

ホームに戻る 比較表を見る