Skip to content

Use Claude Code with your ChatGPT, Kimi, Cursor or Grok subscription via a local Anthropic-compatible proxy

Rust

preserve live websocket behavior

Raine Virtaeb40ada14b01
diff --git a/README.md b/README.md
index 96ecea8..e7dccaf 100644
--- a/README.md
+++ b/README.md
@@ -713,7 +713,7 @@ Windows, and at
| `CCP_CODEX_REASONING_SUMMARY` | `codex.reasoningSummary` | unset | Request Codex reasoning summaries when reasoning effort is enabled; `off` and `none` suppress summaries |
| `CCP_CODEX_SERVICE_TIER` | `codex.serviceTier` | unset | Force all Codex requests to this service tier (`fast`/`priority`, `flex`; `fast` is sent upstream as `priority`) |
| `CCP_CODEX_BASE_URL` | `codex.baseUrl` | `https://chatgpt.com/backend-api/codex/responses` | Override the Codex Responses endpoint |
-| `CCP_CODEX_TRANSPORT` | `codex.transport` | `auto` | Codex transport: `websocket`, `http`, or `auto` |
+| `CCP_CODEX_TRANSPORT` | `codex.transport` | `websocket` | Codex transport: `websocket`, `http`, or `auto` |
| `CCP_CODEX_PREVIOUS_RESPONSE_ID` | `codex.previousResponseId` | `false` | Enable WebSocket continuation with `previous_response_id` when the request is append-only |
| `CCP_CODEX_ORIGINATOR` | `codex.originator` | `claude-code-proxy` | Override the `originator` header sent to Codex |
| `CCP_CODEX_USER_AGENT` | `codex.userAgent` | `claude-code-proxy/<version>` | Override the `User-Agent` header sent to Codex |
@@ -731,10 +731,10 @@ A malformed `config.json` is reported on stderr and ignored; defaults are used
in its place. Invalid types for individual keys are warned and skipped without
affecting other keys.
-Codex tries the WebSocket Responses transport by default and falls back to HTTP
-SSE when the WebSocket handshake fails before a request is sent upstream. Set
-`CCP_CODEX_TRANSPORT=http` to force HTTP for debugging or compatibility, or
-`CCP_CODEX_TRANSPORT=websocket` to require WebSocket without fallback.
+Codex uses the WebSocket Responses transport by default. Set
+`CCP_CODEX_TRANSPORT=http` to use the older HTTP SSE transport for debugging or
+compatibility, or `CCP_CODEX_TRANSPORT=auto` to try WebSocket with HTTP fallback
+only when setup fails before a request is sent upstream.
`CCP_CODEX_PREVIOUS_RESPONSE_ID=1` enables opt-in WebSocket continuation for
append-only turns. Continuation keeps in-memory state keyed by Claude Code
session id, reuses a session WebSocket while it remains open, and sends
diff --git a/src/config.rs b/src/config.rs
index 545ab2b..65023ab 100644
--- a/src/config.rs
+++ b/src/config.rs
@@ -504,7 +504,7 @@ pub fn codex_transport() -> CodexTransport {
{
return transport;
}
- CodexTransport::Auto
+ CodexTransport::WebSocket
}
// ---------------------------------------------------------------------------
@@ -601,11 +601,11 @@ mod tests {
}
#[test]
- fn codex_transport_defaults_to_auto() {
+ fn codex_transport_defaults_to_websocket() {
let _guard = ENV_LOCK.lock().unwrap();
clear_env();
let result = codex_transport();
- assert_eq!(result, CodexTransport::Auto);
+ assert_eq!(result, CodexTransport::WebSocket);
}
#[test]
@@ -629,23 +629,23 @@ mod tests {
}
#[test]
- fn codex_transport_invalid_env_falls_back_to_auto() {
+ fn codex_transport_invalid_env_falls_back_to_websocket() {
let _guard = ENV_LOCK.lock().unwrap();
clear_env();
unsafe {
std::env::set_var("CCP_CODEX_TRANSPORT", "invalid");
}
- assert_eq!(codex_transport(), CodexTransport::Auto);
+ assert_eq!(codex_transport(), CodexTransport::WebSocket);
}
#[test]
- fn codex_transport_empty_env_falls_back_to_auto() {
+ fn codex_transport_empty_env_falls_back_to_websocket() {
let _guard = ENV_LOCK.lock().unwrap();
clear_env();
unsafe {
std::env::set_var("CCP_CODEX_TRANSPORT", "");
}
- assert_eq!(codex_transport(), CodexTransport::Auto);
+ assert_eq!(codex_transport(), CodexTransport::WebSocket);
}
#[test]
diff --git a/src/providers/codex/mod.rs b/src/providers/codex/mod.rs
index 97afbc5..1506b21 100644
--- a/src/providers/codex/mod.rs
+++ b/src/providers/codex/mod.rs
@@ -660,10 +660,11 @@ fn is_codex_terminal_event(payload: &serde_json::Value) -> bool {
}
fn retryable_live_start_codex_error(err: &client::CodexError) -> bool {
+ if err.origin == client::CodexErrorOrigin::WebSocketHandshake {
+ return err.status == 0 || matches!(err.status, 429 | 500 | 502 | 503 | 504 | 529);
+ }
matches!(err.status, 429 | 500 | 502 | 503 | 504 | 529)
- || (err.status == 0
- && (err.detail.as_deref() == Some("websocket_pre_request")
- || retryable_live_message(codex_error_message(err))))
+ || (err.status == 0 && retryable_live_message(codex_error_message(err)))
}
fn retry_with_full_context_for_live_error(err: &client::CodexError) -> bool {
@@ -1069,13 +1070,13 @@ mod tests {
}
#[test]
- fn live_start_statusless_websocket_pre_request_error_is_retryable() {
+ fn live_start_statusless_websocket_handshake_error_is_retryable() {
let err = client::CodexError {
status: 0,
message: "WebSocket connect timeout after 15000ms".to_string(),
- detail: Some("websocket_pre_request".to_string()),
+ detail: None,
retry_after: None,
- origin: client::CodexErrorOrigin::WebSocket,
+ origin: client::CodexErrorOrigin::WebSocketHandshake,
};
assert!(retryable_live_start_codex_error(&err));