{"version":"2.1.224","anchor":"create-a-cloud-session-without-a-terminal","canonical_anchor":"create-a-cloud-session-without-a-terminal","heading":"Create a cloud session without a terminal","tier":"use","area":"Cloud Sessions","scope":null,"heads_up":null,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.224\/e\/create-a-cloud-session-without-a-terminal","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.224","markdown":"### Create a cloud session without a terminal\n\nCreate a cloud session straight from the command line with --environment and a prompt, optionally as JSON.\n\n**What**\n\nRunning Claude Code non-interactively with `--environment` now creates a cloud session straight from the command line. It prints the title, session id, view URL and a resume hint, or with `--output-format json` emits an object with `ok`, `session_id`, `url` and `pool_id`. A prompt is required, as a positional argument or on stdin, and its absence is a hard error.\n\n**Details**\n\n- previously this path needed an interactive terminal\n- new counters `tengu_remote_create_session`, `tengu_remote_create_session_success` and `tengu_remote_create_session_error` are tagged with `entry_point: pool_headless`\n\n**Usage**\n\n`claude --environment my-pool -p \"fix the failing test\" --output-format json` **Evidence** `Error: non-interactive --environment requires a prompt (positional or stdin). Run from a TTY for an interactive cloud session.`\n\n- Area: Cloud Sessions\n- Names: `--environment`\n- Tier: Use it now\n- Useful: 4\/5\n- Signal: 4\/5"}