{"version":"2.1.224","anchor":"start-a-cloud-session-on-a-self-hosted-environment-with-envi","canonical_anchor":"start-a-cloud-session-on-a-self-hosted-environment-with-envi","heading":"Start a cloud session on a self-hosted environment with --environment","tier":"use","area":"Cloud Sessions","scope":null,"heads_up":null,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.224\/e\/start-a-cloud-session-on-a-self-hosted-environment-with-envi","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.224","markdown":"### Start a cloud session on a self-hosted environment with `--environment`\n\nStart a cloud session on your own environment with claude --environment, plus hidden --ref and --on-branch companions.\n\n**What**\n\n`claude --environment <environment_id>` starts a cloud session on one of your own self-hosted environments (ids look like `ccpool_...`). An id that does not parse is rejected with an explicit error. Hidden companions `--pool` (a deprecated alias), `--correlation-id`, `--ref` and `--on-branch` also exist.\n\n**Details**\n\n- `--bg` cannot be combined with `--environment`; the two are separate backends and you get a dedicated message pointing at direct invocation.\n- The `--bg` argument filter strips `--environment` and `--pool`, including their `=value` forms, before forwarding the remaining arguments.\n\n**Usage**\n\n`claude -p \"fix the flaky test\" --environment ccpool_abc123` **Evidence** `Create a new cloud session that runs on the given self-hosted environment (ccpool_...).`\n\n- Area: Cloud Sessions\n- Names: `--environment`, `--pool`, `--correlation-id`, `--ref`, `--on-branch`\n- Tier: Use it now\n- Useful: 4\/5\n- Signal: 4\/5"}