Codex CLIのバックグラウンドデーモンを無効化する方法｜止め方4つと止める前の注意点

Codex CLIのバックグラウンドデーモンを止めるには、codex features disable daemon_auto_start でこれからの自動起動を切り、codex app-server daemon stop でいま動いているものを止めます。自動起動を切っただけでは動いているデーモンは止まらないので、2つともやるのが基本です。

デーモンを使う機能（/agents、Remote Control、デスクトップアプリとの連携）を使っていないなら、止めて困ることはほとんどありません。手順は「自動起動を切る → 動いているものを止める → 残った更新ループがあれば止める」の3つです。反対にデーモンの機能を使っている人は、止めずに自動更新を切る（autoUpdateEnabled: false）か、停止までの猶予を延ばす（shutdownGraceSeconds）という選び方もあります。

「勝手に常駐するのが気持ち悪い」「作業中に再起動された」「環境変数が別のターミナルに漏れていないか不安」という個人の開発者と、チームでCodex CLIを配っている管理者に向けて、止め方をmacOS・Linux・Windows別にまとめました。内容は2026年10月19日時点、最新の正式版である0.163.0（10月15日公開）を前提にしています。

Codex そのものの全体像はOpenAI Codexとはで、使用量の上限はCodexの使用量制限で整理しています。

Codex CLIのバックグラウンドデーモンとは

出典: OpenAI Codex App Server 公式ドキュメント

Codex CLIのバックグラウンドデーモンは、codex app-server というサーバーを起動したり、更新したり、止めたりする裏方のプロセスです。公式の説明では「バックグラウンドサーバー」（shared background server）と呼ばれています。

もともとはデスクトップアプリやスマホなど、離れた場所から Codex を操作する仕組み（Remote Control）のために作られた部品です。複数のターミナルや外部のクライアントが、1つのサーバーを共有して使えるようにする役割を持っています。

0.157.0で何が変わったか

0.157.0から、ターミナルで対話型の codex を起動すると、このデーモンが自動で立ち上がるようになりました。それまでは実験的な機能で、自分でオンにしない限り動きませんでした。

出典は Release 0.157.0、Release 0.163.0、PR #47179 です。

デーモンが手元でやっていること

公式のREADME（app-server-daemon/README.md）によると、デーモンは次のように動きます。

• ~/.codex/packages/app-server-daemon/ に、CLIとは別に自分用の codex 本体を置いて動かす
• 起動の5分後に1回、その後は既定で1時間ごとに新しい版がないか確かめ、あれば入れ替えて再起動する
• 状態を ~/.codex/app-server-daemon/ に保存する（settings.json、app-server.pid、app-server-updater.pid、daemon.lock）
• PCを再起動すると更新のループは消えるが、次に codex を起動するとまた動き出す

~/.codex は CODEX_HOME の既定の場所です。CODEX_HOME を変えている人は、そちらに読み替えてください。

なお、READMEにはいまも「このデーモンは実験的で、仕様は変わることがある」と書かれています。既定でオンになった機能ですが、中身はまだ変わっている途中だと考えたほうがよいでしょう。

なぜ止めたいという声が多いのか

GitHubのIssueやHacker Newsで出ている不満は、主に次のようなものです。

• 知らないうちに常駐して自動更新される: 0.157.0のリリースノートには1行の記載しかなく、気づかないまま使っている人が多い
• 作業中に再起動される: 更新のときに実行中のターンが60秒待ってから止められる（Issue #40969）
• パッケージマネージャーで入れた版とずれる: npmやHomebrewで入れたCLIとは別に、デーモンが自分で最新版を落としてくる（Issue #51961）
• ディスクを使う: 1つの版で約374MBのファイルを ~/.codex/packages/ にコピーし、古い版が残って1GBを超えたという報告もある（どちらも利用者の報告）

既定でオフに戻してほしいという要望（Issue #48195）は、2026年10月19日時点でもオープンのままで、OpenAIからの返信はありません。

止める前に確かめること

出典: OpenAI Codex CLI 公式ドキュメント

止める前に、デーモンがいま動いているか、CLIとデーモンの版がずれていないかを確かめておくと、あとで「止めたはずなのに動いている」と迷わずに済みます。

デーモンが動いているかを見る

いちばん手軽なのは、対話型の codex の中で /daemon を打つ方法です。公式のCLIリファレンスでは「バックグラウンドサーバーの操作画面を開く」コマンドとされていて、つながっているサーバーの状態を見られます。

プロセスから確かめる場合は、次のようにします（OS標準のコマンドで、Codexの公式手順ではありません）。

macOS・Linux

ps aux | grep -i "app-server" | grep -v grep

app-server daemon pid-update-loop という行があれば、更新ループが動いています。

Windows（PowerShell）

Get-Process codex -ErrorAction SilentlyContinue | Select-Object Id, Path

Path が .codex\packages\app-server-daemon\ の下を指しているものがデーモンです。なお公式READMEによると、Windowsでは管理者として開いたターミナルからはデーモンが起動しません。管理者権限のターミナルだけで使っている人は、そもそも動いていない場合があります。

CLIとデーモンの版を見る

CLIとデーモンは別々に更新されるので、版がずれていることがあります。

codex --version                    # CLIの版
codex app-server daemon version    # デーモンの版

起動時に「Background server has incompatible feature settings」という警告が出る人は、この版ずれが原因のことがあります。この警告が出る条件は0.162.1で絞られたので、CLIを新しくするだけで消える場合もあります。

デーモンを使う機能を使っていないか

次の機能を使っている人は、止めると困ります。止め方を決める前に、自分が使っているか確かめてください。

• /agents、codex agents（エージェントの一覧と管理）
• Remote Control（スマホやデスクトップアプリから、手元のCodexを操作する）
• --remote でほかのサーバーにつなぐ使い方

どれも使っていなければ、止めて問題ありません。

Codex CLIのバックグラウンドデーモンを無効化する4つの方法

出典: OpenAI Codex 設定リファレンス 公式

止め方は、効く範囲によって4つに分かれます。目的に合わせて組み合わせてください。

方法1: 今回だけデーモンなしで起動する（--no-daemon）

その回だけデーモンを使わずに起動するなら、--no-daemon を付けます。

codex --no-daemon

公式のCLIリファレンスでは「共有のバックグラウンドサーバーを使わずに対話型CLIを動かす」オプションです。すでに動いているデーモンは止めません。また、--remote や codex agents とは一緒に使えません。

毎回付けるのが面倒なら、シェルにエイリアスを登録する方法があります。ただ、ずっと止めたいならエイリアスより daemon_auto_start を切るほうが確実です。エイリアスはそのシェルからの起動にしか効かず、IDEの拡張やスクリプトから呼ばれた codex には付きません。

# ~/.zshrc や ~/.bashrc に追記
alias codex='codex --no-daemon'

方法2: これから先の自動起動を止める（daemon_auto_start）

以後の起動でデーモンを立ち上げないようにするには、daemon_auto_start という機能フラグを切ります。

codex features disable daemon_auto_start

codex features disable は、指定した機能フラグを ~/.codex/config.toml に書き込んで、ずっと切っておく公式のコマンドです。設定ファイルを直接書く場合は、次の形になります。

# ~/.codex/config.toml（Windowsは %USERPROFILE%\.codex\config.toml）
[features]
daemon_auto_start = false

注意点が2つあります。

• daemon_auto_start というキー名は、2026年10月19日時点で公式の設定リファレンスに載っていません。0.157.0の変更（PR #47179）と、利用者の報告（Windows 10を含む）で確かめた名前です。将来の版で名前や扱いが変わる可能性はあります
• この設定は新しく起動するのを止めるだけです。いま動いているデーモンは止まらないので、続けて codex app-server daemon stop で止めます

設定が反映されたかは、codex features list で確かめられるはずです。正式な機能に上がったフラグなので一覧に出る見込みですが、表示のされ方は版によって違うことがあります。

方法3: いま動いているデーモンを止める（daemon stop）

動いているデーモンを止めるには、次のコマンドを使います。

codex app-server daemon stop

公式READMEに載っているデーモン用のコマンドで、実行中の作業があれば少し待ってから止めます。止めたあとに codex を起動すると、daemon_auto_start を切っていなければまた立ち上がります。先に自動起動を切り、それからこのコマンドで止める、という順番にしてください。

更新ループが残ったときは

0.157.0と0.160.0では、daemon stop のあとも更新ループ（pid-update-loop）が残るという報告があります（Issue #48195、Issue #51961）。0.163.0で直ったかどうかは、公式には書かれていません。プロセスを確かめて残っていたら、手で止めます。

# macOS・Linux
pkill -f 'app-server daemon pid-update-loop'

# Windows（PowerShell）。デーモン用の場所から動いている codex だけを止める
Get-Process codex -ErrorAction SilentlyContinue |
  Where-Object { $_.Path -like "*\.codex\packages\app-server-daemon\*" } |
  Stop-Process

Windowsの手順はOS標準のコマンドを組み合わせたもので、公式の手順ではありません。

コピーされたファイルを消す場合

ディスクを空けたいなら、デーモンが置いたファイルを消せます。

rm -rf ~/.codex/packages/app-server-daemon

消すのは、自動起動を切ってデーモンを止めたあとにしてください。自動起動が有効なままだと、次の起動でまた作られます。古い型のデーモンを使っていた人は、~/.codex/packages/standalone/ にも古い版が残っていることがあります。

方法4: デーモンは使い、自動更新だけ止める（autoUpdateEnabled）

Remote Controlなどでデーモンを使っている人は、止めるのではなく自動更新だけを切る方法があります。~/.codex/app-server-daemon/settings.json に次のように書きます。

{
  "updater": { "autoUpdateEnabled": false }
}

公式READMEに載っている設定で、2026年9月7日の変更（PR #43542）から使えます。すでにほかの項目が書かれている場合は、updater の部分だけ足してください。

自動更新を切っても、codex app-server daemon update を自分で実行すれば最新の安定版に更新されます。自動で再起動されるのが困るだけなら、自分の都合のよいときに手で更新するのが現実的です。

「Codex CLIの自動更新は止められない」と書いているニュース記事もありますが、現在の公式READMEでは、この設定で止められることになっています。

止めるとできなくなること

止めて使えなくなるのは、複数のクライアントで1つのサーバーを共有する機能だけです。ターミナルで1つずつ codex を使う普段の使い方は、止めても変わりません。

/import は、0.157.0のリリースノートと現在のCLIリファレンスで書かれ方が違うため、ここでは断定していません。

デスクトップ側から Codex を操作する使い方については、ChatGPT Workの記事も参考になります。

止めずに使うなら設定しておきたいこと

デーモンの機能を使い続ける人は、作業中の再起動に備えて settings.json を調整しておくと、困る場面が減ります。

{
  "shutdownGraceSeconds": 300,
  "updater": { "autoUpdateEnabled": true, "updateIntervalMinutes": 720 }
}

• shutdownGraceSeconds: 更新や再起動のとき、実行中の作業を待つ秒数です。既定は60秒で、0〜300秒の範囲で決められます。長いタスクを流すことが多いなら300にしておきます
• updateIntervalMinutes: 自動更新を確かめる間隔（分）です。既定は60分です。例では12時間にしていますが、上限は決められていません

OpenAIの担当者はIssue #51201で、60秒で作業が止まるのは想定どおりの動きで、shutdownGraceSeconds を300まで延ばせること、止まったターンはサーバーの更新後に自動で再開されることを説明しています（2026年10月11日）。

同じIssueでは、自動更新の再起動のあと、Full accessにしていたスレッドが権限の狭い状態で読み込まれる（.git に書き込めない）という問題も報告されました。担当者はバグと認め、0.163.0か0.164.0で直る見込みと答えています。どちらで直ったかは確かめられていないので、再起動のあとは権限の表示を一度見ておくと安心です。

セキュリティ上の注意点

出典: OpenAI Codex Security 公式ドキュメント

共有サーバーという仕組みには、止めるかどうかを決める前に知っておきたい弱点があります。デーモンを使い続ける人ほど関係します。

1つ目のターミナルの環境変数が引き継がれる

共有のサーバーは、最初に起動したセッションの環境変数と作業ディレクトリを持ち続けます。あとから別のターミナルで codex を起動しても、サーバー側の環境は更新されません（Issue #53547、0.162.1のmacOSで報告。2026年10月19日時点でオープン）。

たとえば、プロジェクトAのターミナルで GH_TOKEN やAPIキーを export してから codex を起動すると、そのあとプロジェクトBのターミナルから起動したセッションにも、Aの値が見えることがあります。プロジェクトごとに認証情報を分けている人ほど影響を受けます。

対策としては、次のようなものが考えられます（公式が勧めている手順ではありません）。

• 機密を扱うリポジトリでは、デーモンを止めるか --no-daemon で起動する
• 認証情報は、シェルの起動時にまとめて読み込まず、必要なコマンドを実行するときだけ渡す
• 環境を切り替えたあとは codex app-server daemon restart で共有サーバーを作り直す

パッケージマネージャーの管理から外れる

npm・Homebrew・pacmanなどで入れたCLIとは別に、デーモンは自分で最新版をダウンロードして動きます。「npmで版を固定したのに、実際に動いているのは別の版だった」ということが起こります（Issue #46468、#51961 の報告）。

ダウンロードしたファイルをどう検証しているかについて、公式の説明はまだありません。0.163.0からは、デーモンの更新にもアプリのネットワーク制限の設定が効くようになりました。

なお、「OpenAIが既定でオフに戻すコミットを入れた」という話が出回っていますが、これはnix向けのパッケージ側の変更で、openai/codex 本体の変更ではありません。nixpkgsなど一部の配布元は、この機能を既定で切っていると報告されています。

チームで配っている場合

社内でCodex CLIを配っているなら、版の管理と更新の経路を1つにそろえておくのが基本です。たとえば、配布する config.toml に daemon_auto_start = false を入れておけば、各自の端末でデーモンが勝手に別の版を落とすのを防げます。

# 配布用 config.toml の例
check_for_update_on_startup = false   # 更新を管理者側でまとめている場合だけ

[features]
daemon_auto_start = false

check_for_update_on_startup は、CLIの起動時に更新を確かめるかどうかの設定です。公式の設定リファレンスでは「更新を一元管理している場合に限り false にする」とされています。デーモンの自動更新（settings.json の updater）とは別の設定なので、混同しないようにしてください。

Codex CLIで作った試作のツールを、社内の実データや既存のシステムにつないで業務で使う段階に入ると、認証情報の持たせ方や、誰がどの版を保守するかを決めておく必要があります。その段階の進め方はAIで作ったアプリを開発会社へ引き継ぐにはにまとめています。

Codex 全体のセキュリティ機能はCodex Securityとはで、ほかのCLIエージェントの安全な使い方はClaude Codeのセキュリティと安全な使い方で扱っています。

出回っているけれど確認できない止め方

出典: openai/codex 公式GitHub

ブログやSNSで紹介されている止め方の中には、公式のドキュメント・ソースコード・Issueのどこにも裏付けが見つからないものがあります。2026年10月19日時点で確認できなかったのは次の4つです。

設定しても効かず、止めたつもりでデーモンが動き続けることになるので、使わないほうが安全です。

こんな人は止めるのがおすすめ／止めなくてよい人

止めるかどうかは、デーモンを使う機能を使っているかと、作業を途中で止められると困るかで決めるとわかりやすいです。

止めるのがおすすめの人

• ターミナルで codex を1つずつ使うだけで、/agents もRemote Controlも使っていない
• npmやHomebrewで版を固定していて、勝手に別の版が動くのは困る
• プロジェクトごとに違うAPIキーやトークンを export して使っている
• 会社の端末で、更新を情報システム部門がまとめて管理している
• ディスクの空きが少ない

止めなくてよい人（設定で調整する人）

• スマホやデスクトップアプリから、手元のCodexを操作している
• /agents で複数のエージェントをまとめて管理している
• 新しい版をすぐ使いたく、自動更新があるほうがよい

止めなくてよい人も、長いタスクを流すなら shutdownGraceSeconds を延ばしておく、機密を扱うリポジトリだけは --no-daemon で起動する、といった使い分けをしておくと安心です。

よくある質問

PCを再起動すればデーモンは止まりますか？

更新ループは再起動で消えますが、次に codex を起動するとデーモンも更新ループもまた動き出します。再起動だけでは止めたことになりません。daemon_auto_start を切っておく必要があります。

Codex CLIをアンインストールすればデーモンも消えますか？

npm uninstall や brew uninstall で消えるのはCLI本体だけです。デーモンのファイルは ~/.codex/packages/app-server-daemon/ に残るので、先に codex app-server daemon stop を実行してから、そのフォルダを消してください。設定や履歴も消したいなら ~/.codex ごと削除しますが、ログイン情報も消えるので注意が必要です。

Homebrew版やnpm版でもデーモンは起動しますか？

基本的には起動します。入れ方に関係なく、0.157.0以降のCLIで対話型の codex を起動すれば立ち上がります。nixpkgsのように配布元が機能を切っている場合は起動しないことがあります。

codex exec のような非対話の実行でも起動しますか？

リリースノートで自動起動の対象とされているのは「条件に合う対話型のセッション」です。非対話の実行がどう扱われるかは公式に詳しい説明がないため、気になる場合はプロセスを見て確かめるのが確実です。

将来、既定でオフに戻る見込みはありますか？

2026年10月19日時点で、OpenAIから既定でオフに戻すという発表はありません。オフにしてほしいという要望の Issue #48195 も返信がないままです。新しい版に上げたら、codex features list で daemon_auto_start の状態が変わっていないかを確かめてください。

Claude Codeにも同じような仕組みはありますか？

Hacker Newsでは、Claude Codeにもバックグラウンドで動く仕組みがあるという指摘が出ています。ただし作りや目的は同じではないので、Claude Code側の設定はそちらの公式ドキュメントで確かめてください。

まとめ

Codex CLIのバックグラウンドデーモンは、0.157.0から既定で起動するようになった、共有サーバーの管理役です。2026年10月19日時点（0.163.0）で、止め方はこう整理できます。

• ずっと止める: codex features disable daemon_auto_start → codex app-server daemon stop → 更新ループが残っていれば手で止める
• 今回だけ止める: codex --no-daemon
• 使い続けて自動更新だけ止める: ~/.codex/app-server-daemon/settings.json に "updater": { "autoUpdateEnabled": false }
• 使い続けて作業の中断を減らす: shutdownGraceSeconds を300まで延ばす

/agents やRemote Controlを使っていないなら、止めても普段の使い方は変わりません。daemon_auto_start は公式の設定リファレンスにまだ載っていない名前なので、CLIを更新したときは効いているかを確かめるようにしてください。

Codexの機能やプランの全体像はOpenAI Codexとはで確認できます。