作業フォルダの早見
Codexの作業フォルダを指定・変更する方法(CLI・アプリ)
Codexが読み書きの中心にするフォルダ(作業フォルダ)の決め方を、CLI・デスクトップアプリ・WSLの別に整理します。指定のオプション、追加で書き込めるフォルダ、変更したい時の考え方まで、OpenAI公式の文書(2026年11月16日確認)に沿って説明します。
最初に答え
Codexの作業フォルダは、起動した場所で決まります。
| 使い方 | 作業フォルダの決め方 |
|---|---|
| CLI | プロジェクトのフォルダに移動して codex を実行する。または --cd(短縮は -C)でフォルダを指定する |
| デスクトップアプリ(Windows) | Add new project をクリック、または Ctrl+O でフォルダを選ぶ |
| codex exec(スクリプト・自動実行) | --cd を付けると、作業前にそのフォルダがワークスペースのルートになる |
公式のCLI案内には「プロジェクトのフォルダを開いて codex を実行する。初回は Sign in with ChatGPT などのサインイン方法を選ぶ」という手順があります。起動の最初に表示される directory: の行が、いま作業しているフォルダです。
CLIでフォルダを指定する
いちばん素直なのは、ターミナルでプロジェクトのフォルダに移動してから起動する方法です。
cd ~/code/my-app
codex移動せずに指定したい時は、公式のオプション一覧にある --cd を使います。説明は「エージェントの作業フォルダを設定する」で、-C と書いても同じです。
codex --cd ~/code/my-app公式の説明では、ベースの codex コマンドでは「依頼の処理を始める前に」作業フォルダを設定します。codex exec では、作業の前にワークスペースのルートを設定します。codex agents では、新しいリモート作業のフォルダを設定します。
書き込めるフォルダを増やす:--add-dir
作業フォルダとは別のフォルダにも書き込ませたい時は、--add-dir を使います。公式の説明は「メインのワークスペースに加えて、追加のフォルダへの書き込み権限を与える」です。複数あるときは、オプションを繰り返します。
codex --cd ~/code/web --add-dir ~/code/shared-docs --add-dir ~/code/assetsたとえば、サイトのフォルダと共通の画像フォルダを別々に管理している時に便利です。ただし、書き込める範囲を広げるほど、誤って直される範囲も広がります。必要なフォルダだけを足してください。
サンドボックスと承認との関係
作業フォルダの中で何ができるかは、サンドボックスと承認の設定で決まります。公式のオプションは次のとおりです。
| オプション | 意味 |
|---|---|
--sandbox(-s) | read-only(読み取りだけ)、workspace-write(作業フォルダに書き込める)、danger-full-access(制限なし)から選ぶ |
--ask-for-approval(-a) | コマンドを実行する前に人間の承認を求めるタイミング。on-request または never |
公式は、日常のローカル作業では workspace-write と on-request の組み合わせを低い手間の設定として挙げています。--yolo(正式名は --dangerously-bypass-approvals-and-sandbox)は、承認もサンドボックスもなしで実行するため、大事なデータのあるフォルダでは使わない方が安全です。詳しい違いはフルアクセスの危険性のページにまとめています。
デスクトップアプリで追加・選ぶ
Windows版のChatGPTデスクトップアプリ(Codexを選んで使う)では、Add new project をクリックするか、Ctrl+O を押してフォルダを選びます。WSLの中にあるフォルダを選ぶ時は、ファイル選択のウィンドウで \\wsl$\ と入力し、Linuxのディストリビューションとフォルダを選びます。
公式は、\\wsl$ から開いたプロジェクトではGitが検出されないと説明しています。回避策として、プロジェクトをWindowsのドライブに置き、WSLからは /mnt/<ドライブ>/... でアクセスする方法が案内されています。WSLの使い方全体はWindowsのCodex(アプリとWSL)で整理しています。
1つのリポジトリに複数のプロジェクトが入っている時は、共有する .codex フォルダがあるプロジェクトのフォルダを開く、と公式のローカル環境の説明にあります。
フォルダごとの設定と信頼
作業フォルダの中に .codex/config.toml を置くと、そのプロジェクトだけの設定になります。公式によると、プロジェクトのルートから現在のフォルダまで順に読み込まれ、いちばん近いファイルが優先されます。ただし、読み込まれるのは信頼したプロジェクトだけです。信頼していないプロジェクトでは、プロジェクト内の設定・フック・ルールは読まれず、自分用の設定とシステムの設定だけが使われます。
設定が効く順番(高い順)は、CLIのオプションと --config、プロジェクトの設定、--profile で選んだプロファイル、自分用の ~/.codex/config.toml、クラウドで配られる設定、システムの設定、組み込みの既定です。自分用の置き場所は.codexフォルダの場所、設定の書き方はconfig.toml の書き方ツールにあります。
前の会話に戻る・別フォルダの会話を探す
公式のCLI案内では、codex resume は「いまのリポジトリの最近の会話」を開き、古い作業に戻る時はローカルの会話全体から探せるとされています。codex exec resume --last は、いまのフォルダの直近の会話を再開し、--all を付けると別のフォルダの会話も対象になります。
codex resume
codex exec resume --last
codex exec resume --last --allフォルダを変えて作業を続けたい時は、作業の引き継ぎ文を作ってから別のフォルダで新しく始める方法もあります。スレッドの引き継ぎを参照してください。
Gitのワークツリーで別の場所に隔離する
--worktree を付けると、新しく管理されたGitのワークツリーの中で作業が始まります。いまのフォルダを直接触らせず、並行して別の変更を進めたい時に向いています。公式によると、ローカルの実行が必要で、exec では resume・review・--ephemeral・--ignore-user-config とは同時に使えません。アプリでも、ローカルの変更と分けたい時はワークツリーで作業を始められます。
よくある質問
作業フォルダを途中で変えられますか。
公式の文書には、実行中の会話の作業フォルダをその場で切り替える操作の説明は見当たりません。CLIは別のフォルダで codex を起動し直すか --cd を付けて起動し、アプリは別のプロジェクトを追加して開きます。
作業フォルダの外のファイルも直してもらえますか。
--add-dir で追加したフォルダには書き込みを許可できます。それ以外のフォルダは、サンドボックスの設定と承認の設定に従います。
Gitのリポジトリでないフォルダでも使えますか。
codex exec には --skip-git-repo-check があり、Gitのリポジトリの外でも実行できます。通常の使い方では、変更を戻せるようにGitで管理されたフォルダを選ぶのが安全です。
関連ページ
出典と確認日
- OpenAI Learn: コマンドラインのオプション(--cd・--add-dir・--sandbox・--worktree・resume)
- OpenAI Learn: Codex CLI
- OpenAI Learn: Windowsのデスクトップアプリ
- OpenAI Learn: 設定の基本
- OpenAI Learn: ローカル環境
- 確認日: 2026年11月16日
出典は公式の文書です。オプション名や画面の表示は更新されることがあるため、迷ったら出典を優先してください。
