diff --git a/codex-rs/core/src/spawn.rs b/codex-rs/core/src/spawn.rs
index a2c4ebe597..e8fbe41275 100644
--- a/codex-rs/core/src/spawn.rs
+++ b/codex-rs/core/src/spawn.rs
@@ -30,7 +30,7 @@ pub enum StdioPolicy {
     Inherit,
 }
 
-/// Spawns the appropriate child process for the ExecParams and SandboxPolicy,
+/// Spawns the appropriate child process for the prepared exec request,
 /// ensuring the args and environment variables used to create the `Command`
 /// (and `Child`) honor the configuration.
 ///
diff --git a/codex-rs/utils/cli/src/sandbox_mode_cli_arg.rs b/codex-rs/utils/cli/src/sandbox_mode_cli_arg.rs
index b7d1a248b8..239c9133f6 100644
--- a/codex-rs/utils/cli/src/sandbox_mode_cli_arg.rs
+++ b/codex-rs/utils/cli/src/sandbox_mode_cli_arg.rs
@@ -1,10 +1,9 @@
 //! Standard type to use with the `--sandbox` (`-s`) CLI option.
 //!
-//! This mirrors the variants of [`codex_protocol::protocol::SandboxPolicy`], but
-//! without any of the associated data so it can be expressed as a simple flag
-//! on the command-line. Users that need to tweak the advanced options for
-//! `workspace-write` can continue to do so via `-c` overrides or their
-//! `config.toml`.
+//! This mirrors the legacy sandbox mode names, but without any associated data
+//! so it can be expressed as a simple flag on the command-line. Users that need
+//! to tweak the advanced options for `workspace-write` can continue to do so
+//! via `-c` overrides or their `config.toml`.
 
 use clap::ValueEnum;
 use codex_protocol::config_types::SandboxMode;