remote-connections.md Codex Docs, 2026-04-21 06:45 UTC → 2026-04-22 00:42 UTC

1# Remote connections1# Remote connections

2 2 

3SSH remote connections are currently in alpha. To enable them today, set3SSH remote connections are currently in alpha. To enable them today, set

4`remote_connections = true` in the `[features]` table in4`remote_control = true` in the `[features]` table in `~/.codex/config.toml`.

5`~/.codex/config.toml`. Availability, setup flows, and supported environments5Availability, setup flows, and supported environments may change as the

6may change as the feature improves.6feature improves.

7 7 

8Remote connections let Codex work with projects that live on another8Remote connections let Codex work with projects that live on another

9SSH-accessible machine. Use them when the codebase, credentials, services, or9SSH-accessible machine. Use them when the codebase, credentials, services, or

48 48 

49```toml49```toml

50[features]50[features]

51remote_connections = true51remote_control = true

52```52```

53 53 

54Remote project threads run commands, read files, and write changes on the54Remote project threads run commands, read files, and write changes on the