{"name":"CCR_AGENT_PROXY_TOKEN_FILE_DESCRIPTOR","slug":"ccr-agent-proxy-token-file-descriptor","family":"env","title":"Environment variables","noun":"environment variable","description":"Claude Code now recognises CCR_AGENT_PROXY_TOKEN_FILE_DESCRIPTOR as a way to receive the agent proxy credential","description_source":"entry","described_by":{"version":"2.1.290","anchor":"new-file-descriptor-env-var-for-ccr-agent-proxy-token"},"presence":{"first_seen":"2.1.295","removed_in":null,"in_current_build":true,"newest_mined":"2.1.295","builds":1,"mined_builds":138,"first_cited":{"version":"2.1.290","released_at":"2026-10-05 18:12:44","spans":2}},"aliases":[],"entries":[{"version":"2.1.295","anchor":"session-tunnel-session-tunnel-reads-oauth-and-agent-proxy","heading":"Session tunnel startup reads sign-in and proxy tokens from a file descriptor","line":"Started with `--session-tunnel`, Claude Code can read its sign-in token and an agent proxy token from a launcher-supplied channel","released_at":"2026-10-08 18:22:58","reason":"found in this entry's text"},{"version":"2.1.290","anchor":"new-file-descriptor-env-var-for-ccr-agent-proxy-token","heading":"New environment variable for passing the remote agent proxy token","line":"Claude Code now recognises CCR_AGENT_PROXY_TOKEN_FILE_DESCRIPTOR as a way to receive the agent proxy credential","released_at":"2026-10-05 18:12:44","reason":"found in this entry's text"}],"entries_total":2,"docs":[],"docs_total":0,"gates":[],"related":[{"name":"CCR_AGENT_PROXY_CA_CERT_B64","slug":"ccr-agent-proxy-ca-cert-b64","description":"In hosted remote sessions, the agent proxy can read its certificate authority from `CCR_AGENT_PROXY_CA_CERT_B64` instead of always downloading it"},{"name":"CCR_AGENT_PROXY_CA_WATCH_ENABLED","slug":"ccr-agent-proxy-ca-watch-enabled","description":"In remote sessions using the agent proxy, certificate checks accept swapped order and the gh stand-in now lives in each session's own folder"},{"name":"CCR_AGENT_PROXY_ENABLED","slug":"ccr-agent-proxy-enabled","description":"The remote agent proxy now caps stalled uploads and reads, with two env vars to disable each."},{"name":"CCR_AGENT_PROXY_FRAME_HOSTS","slug":"ccr-agent-proxy-frame-hosts","description":"Artifact traffic can take a direct tunnel when the runner environment names hosts; local runs keep the old route."},{"name":"CCR_AGENT_PROXY_INCLUDE_HOSTS","slug":"ccr-agent-proxy-include-hosts","description":"Read by the agent proxy setup in a remote session (`CLAUDE_CODE_REMOTE` truthy and `CCR_AGENT_PROXY_ENABLED` set), which removes it from the environment before those checks. With `CCR_AGENT_PROXY_RELAY_MODE=selective` and no `AGENT_PROXY_URL`, it is a comma-separated host list: those hosts go through the proxy relay and unlisted hosts use normal networking. An empty or unparsable list logs a warning and falls back to tunnelling all traffic."},{"name":"CCR_AGENT_PROXY_NO_PROXY_LOCAL_ONLY","slug":"ccr-agent-proxy-no-proxy-local-only","description":"New CCR_AGENT_PROXY_NO_PROXY_LOCAL_ONLY environment variable narrows the agent proxy's no-proxy list to local addresses"},{"name":"CCR_AGENT_PROXY_RECEIVE_GATE_DISABLED","slug":"ccr-agent-proxy-receive-gate-disabled","description":"The remote agent proxy now caps stalled uploads and reads, with two env vars to disable each."},{"name":"CCR_AGENT_PROXY_RELAY_MODE","slug":"ccr-agent-proxy-relay-mode","description":"Read once, then removed from the environment, when the agent proxy starts in a remote session (`CLAUDE_CODE_REMOTE` and `CCR_AGENT_PROXY_ENABLED` both set). The value `selective` relays only the hosts listed in `CCR_AGENT_PROXY_INCLUDE_HOSTS` (comma-separated) and lets other hosts use normal networking; if that list is empty or unparsable, all traffic is relayed. Any other value relays all traffic, and `selective` is ignored when `AGENT_PROXY_URL` is set."},{"name":"CCR_AGENT_PROXY_UPLOAD_GATE_DISABLED","slug":"ccr-agent-proxy-upload-gate-disabled","description":"The remote agent proxy now caps stalled uploads and reads, with two env vars to disable each."}],"url":"https:\/\/changelogs.core-directive.com\/reference\/env\/ccr-agent-proxy-token-file-descriptor","family_url":"https:\/\/changelogs.core-directive.com\/reference\/env.json"}