Error index

Match the key fragment from your error output — a status code, an error code, an exception name. Every topic page merges several duplicate issues; the count on each card is how many.

776 topic pages, distilled from 2266 real issuesHow this is counted

4008anthropic_base_url84044anthropic_auth_token4anthropic_model44013anthropic_api_key3openai_api_key340325022ark_api_key2claude_code_attribution_header2codex_sqlite_home2webkit_disable_compositing_mode2webkit_disable_dmabuf_renderer24291anthropic_default_haiku_model1anthropic_default_opus_model1anthropic_default_sonnet_model1authentication_error1autherror1claude_code_auto_compact_window1claude_code_effort_level1claude_code_max_context_tokens1claude_code_use_bedrock1claude_config_dir1codex_home1deepseek_api_key1disable_autoupdater1drm_ioctl_mode_create_dumb1egl_bad_parameter1enoent1err_bad_request1gemini_api_key1gtk_is_widget1hermes_home1home_url1invalid_argument1invalid_authentication_error1model_not_supported1node_repl_native_pipe_connect_timeout_ms1rate_limit_error1response.created1responses_feature_not_supported1skill_dir_not_found1win-error-1831win-error-25031win-error-4001Proxy and local routing263Import and sync97UI and interaction75Terminal and environment variables37Environment variables21Usage and balance41Config not applied18Model list26Update and upgrade7Provider management8thinking field6Skills12Network and timeout6Context window4Launch crash / blank screen5Install and packaging1Login and auth2Other63

4008

schema must be a JSON Schema of 'typeThis is a conversion defect in older versions of CC Switch. Upgrade to v3.18.0 or later to fix it; no manual changes to config.toml are needed.40016 issues mergedCodex Kimi HTTP 400 moonshot flavored json schemaUpgrade CC Switch to the latest version; the proxy automatically cleans Kimi-incompatible `$ref` sibling keywords and tool schemas missing root-level `type`.4008 issues mergedHTTP 400 Codex /responses Request FailureCheck whether the provider supports Codex’s request format. If it natively supports the Responses API, set apiFormat to openai_responses to avoid conversion.4004 issues mergedFunction call is missingUse the community cc-switch-gemini-fixer patch, or inject skip_thought_signature_validator into history messages, to bypass the signature validation.4003 issues mergedAPI Error: 400 invalid_parameter_errorCheck the base url and model config, enable the rectifier, or ignore the false 400 from Stream Check.4003 issues mergedCodex image requests return 400 through proxy: base64 inflation or invalid detailIf image history causes context overflow, upgrade to v3.19.0; if detail original is invalid, disable supports_image_detail_original for the affected model.4003 issues mergedThe API returns a 400 error - Claude CodeUpgrade CC Switch to v3.16.1 for the 400 caused by MiMo missing reasoning_content; on Github Copilot, check the API format and proxy config.4002 issues mergedHTTP 400 context length exceeded, CodexUpgrade to cc-switch 4.0. If the issue still recurs, provide the version and reproduction steps, then report it again.4002 issues merged

anthropic_base_url8

DeepSeek Claude Code Configuration and Switching IssuesFirst confirm the issue type: new terminals or sessions reload configuration. For abnormal DeepSeek cache hit rates, try v3.16.3; other variants remain…anthropic_base_url15 issues mergedClaude still asks to log in after configuration - Claude CodeAdd hasCompletedOnboarding: true to ~/.claude.json to skip the login prompt.anthropic_base_url4 issues mergedkimi k2 reports 404 - CC SwitchA 404 from the connection test does not mean Kimi is unavailable. Set ANTHROPIC_BASE_URL to https://api.kimi.com/coding/ and verify by running Claude Code.anthropic_base_url4 issues mergedMissing API key · Run /login - Claude CodeClear the conflicting ANTHROPIC_BASE_URL environment variable, or upgrade CC Switch to use its built-in environment variable conflict detection.anthropic_base_url3 issues mergedNot logged in ? Please run /loginEnable local proxy takeover for Claude Code, point ANTHROPIC_BASE_URL to http://127.0.0.1:15721, and set proxy-managed authentication placeholders.anthropic_base_url3 issues mergedThere's an issue with the selected modelRemove the trailing /v1 from ANTHROPIC_BASE_URL, launch from the CLI instead of the cc-switch button to use local routing, and check model support.anthropic_base_url2 issues mergedThere's an issue with the selected modelFor NVIDIA NIM / MiniMax, enable the local proxy and rectifier, or export ANTHROPIC_BASE_URL to the local proxy port.anthropic_base_url2 issues mergedNot logged in · Please run /loginWith the Codex provider, do not start Claude Code from the cc-switch built-in terminal. Open a global terminal so local routing handles OAuth.anthropic_base_url1 issues merged

4044

Upstream HTTP 404 - DeepSeekResolve based on the scenario: if the endpoint path is the issue, complete the API address with the full API root (such as `.../v1`); if the model… (cc-switch)4046 issues mergedAPI Error: 404 - Claude Code path assembly or unregistered routeCheck whether the API address was assembled wrongly, or upgrade cc-switch for the 404 from OpenAI-compatible mode and the missing local route.4044 issues mergedNot found (404)Upgrade cc-switch to v3.16.3 for the 404 from /v1/ appended wrongly to a Base URL, and enable the media fallback so images cannot trip the breaker.4043 issues mergedUpstream HTTP 404 cc-switchUpgrade cc-switch to remove ?beta=true from NVIDIA requests. Kimi does not support Codex's Responses API; use Claude Code or a local adapter.4042 issues merged

anthropic_auth_token4

Claude Code Auth conflict errorRemove primaryApiKey from ~/.claude.json or add "auth_mode": "bearer_only". Restore overwritten settings via default or manage shared settings with Common…anthropic_auth_token7 issues mergedAuth conflictLog out of the official Claude login, clear conflicting ANTHROPIC_* variables, set hasCompletedOnboarding to true in ~/.claude.json, and restart the terminal.anthropic_auth_token6 issues mergedThe user sent an empty message (Claude Code connected to Kimi — repeated empty messages)No official fix: /export the session and continue in a new one; bypass cc-switch so Claude Code connects directly to Kimi to find which layer sends empty…anthropic_auth_token3 issues mergedhttp://127.0.0.1:15721 proxy configuration stuckUpgrade to CC Switch v3.16.2 to fix proxy hangs from corrupted backups, or use "Replace Config" mode to manually set env vars.anthropic_auth_token2 issues merged

anthropic_model4

deepseek接入 模型勾选了1m: no 1M context option in Claude Code model pickerUpgrade cc-switch to v3.17.0+, leave the DeepSeek provider's ANTHROPIC_MODEL empty or check 1M there too, fill only Haiku/Sonnet/Opus mappings… (Claude Code)anthropic_model7 issues merged"There's an issue with the selected model"Upgrade cc-switch to v3.13.0+ for the environment variable sync fix, and use the alias mapping variables to override the default model.anthropic_model5 issues mergedModelScope reports 401 token invalid - Claude CodeAdd ANTHROPIC_MODEL to the provider environment variables in cc-switch to resolve the 401. It is not synced to settings.json by design.anthropic_model2 issues mergedsettings.json env not taking effect - Claude CodeClaude Code reads settings.json only at startup. After switching providers, restart Claude Code or set env vars manually.anthropic_model1 issues merged

4013

HTTP 401 Unauthorized - CC Switch AnthropicUpgrade cc-switch to a fixed build so it sends the x-api-key and anthropic-version headers Anthropic requires.4012 issues mergedunexpected status 401 UnauthorizedIn Codex config.toml, set the AUTO COMPACT threshold below Kimi's 256K limit, verify model mapping, and reduce unnecessary MCP usage.4012 issues mergedunexpected status 401 UnauthorizedUpgrade to CC Switch 4.0. On 3.x, declare a custom model_provider in config.toml so Codex does not ignore the proxy and connect directly to OpenAI.4012 issues merged

anthropic_api_key3

"Not logged in · Please run /login" - Claude CodeUpgrade cc-switch to v3.19.2+, or change ANTHROPIC_API_KEY to ANTHROPIC_AUTH_TOKEN in settings.json by hand to skip the approval prompt.anthropic_api_key5 issues mergedBash failed due to the following issueSet the local GLM provider to OpenAI Chat format and enable routing so CC Switch converts and forwards Claude Code requests.anthropic_api_key2 issues merged“ANTHROPIC_API_KEY or another auth sourceUpgrade CC Switch from 3.16.4 to the refactored 4.0 or later, then retest.anthropic_api_key1 issues merged

openai_api_key3

Cannot use Google-email Codex account after opening cc switch - CodexA third-party key in ~/.codex/auth.json overrode ChatGPT login: add the official provider in CC Switch and switch back to restore login, and upgrade to…openai_api_key7 issues mergedMissing environment variableDelete the env_key entry from config.toml, or set OPENAI_API_KEY in Windows environment variables, and confirm the provider supports the native response format.openai_api_key3 issues mergedauth.json does not change with the channel; editing overwrites the third-party channel key (cc-switch)cc-switch 3.20.0 writes the official key from auth.json back into a Codex relay channel when editing it. Upgrade to the version with the #6534 fix and re-save…openai_api_key2 issues merged

4032

Automatic approval review failedThe CC Switch local proxy received an upstream 403 while handling the Codex /responses endpoint, causing automatic review to fail; no official fix is available.4032 issues mergedImage generation is not enabled for thisManually filter image generation requests or configure a local bridge process to read response headers to work around the 403 block.4032 issues merged

5022

502 Bad GatewayCodex/Claude Desktop reports 502 due to CLI proxy conflicts or app-server bypassing proxy. Remove proxy config or downgrade versions to fix.5024 issues mergedUpstream HTTP 502 - CC Switch (Claude CodeCheck your local network proxy (Clash/ZeroTier) config and make sure it does not interfere with direct requests.5022 issues merged

ark_api_key2

config conflicts with official documentation, and automatic model list retrieval fails - CodexUpdate config.toml to match the official specification and set ARK_API_KEY. Codex works again, but automatic model retrieval still needs CC Switch support.ark_api_key2 issues mergedVolcengine Agent Plan Auto-Identify Model List Failed 404Manually modify config.toml to match official docs and add models in modelCatalog to bypass 404.ark_api_key2 issues merged

claude_code_attribution_header2

Cache hit rate only 40% and extremely slow - Claude CodeDisable the dynamic attribution header in `.claude/settings.json`; if that fails, switch to a model with working caching and monitor the main issue.claude_code_attribution_header2 issues mergedCache stuck at 13824: Claude CodeUpdate Claude Code from v2.1.148 to v2.1.215 and retry; user testing confirmed the issue no longer occurred.claude_code_attribution_header2 issues merged

codex_sqlite_home2

Chat history under the original codex project disappears after connecting a third party - CodexUpgrade to cc-switch v3.16.4 or newer, turn on "unified Codex session history" in settings, and migrate the official sessions.codex_sqlite_home2 issues mergedCodex history disappears and it will not work - CodexUpgrade to cc-switch v3.16.4 to fix zstd decode failures and CODEX_SQLITE_HOME state database probing that lose or desync sessions.codex_sqlite_home2 issues merged

webkit_disable_compositing_mode2

cc-switch on Linux freezes when clicking input fields, UI does not refreshUpgrade to cc-switch v3.13.0 or later. It sets WEBKIT_DISABLE_COMPOSITING_MODE=1 at startup and applies a window focus fix.webkit_disable_compositing_mode3 issues mergedUI freezes after clicking any input field on LinuxSet WEBKIT_DISABLE_COMPOSITING_MODE=1 or upgrade to v3.14.1 and enable the native title bar to fix Linux UI freezes and unresponsive buttons.webkit_disable_compositing_mode2 issues merged

webkit_disable_dmabuf_renderer2

Could not create default EGL displayOn Linux, cc-switch forces WEBKIT_DISABLE_DMABUF_RENDERER=1, causing a blank window. Set it to 0 before launch to restore the UI.webkit_disable_dmabuf_renderer3 issues mergedThe interface is completely blank - cc-switchUpgrade cc-switch to the latest version, which disables DMABUF rendering by default, or use the CLI build to resolve the Tauri 2 white screen.webkit_disable_dmabuf_renderer2 issues merged

4291

exceeded retry limit, last status: 429 Too Many RequestsAn incorrect GLM preset URL can cause 429: delete the old GLM provider, create the official preset in cc-switch, confirm it uses a Coding Plan link, and check…4293 issues merged

anthropic_default_haiku_model1

Prompts /login and cannot use Codex API - Claude CodeDo not encode reasoning level in the model ID. Keep gpt-5.4; CC Switch maps it automatically.anthropic_default_haiku_model2 issues merged

anthropic_default_opus_model1

ccstatusline shows the wrong model name - Claude CodeConfigure a Custom Command script in ccstatusline that reads the environment variables from the cc-switch database to show the real model.anthropic_default_opus_model2 issues merged

anthropic_default_sonnet_model1

ANTHROPIC_DEFAULT_SONNET_MODEL not taking effectIn CC Switch local proxy mode, set the target model in ANTHROPIC_DEFAULT_SONNET_MODEL; the proxy maps this field, not *_MODEL_NAME.anthropic_default_sonnet_model2 issues merged

authentication_error1

401 Invalid Authentication - Claude CodeCheck the API key and authentication variables required by your provider, and confirm Claude Code's actual authentication field contains the correct key.authentication_error7 issues merged

autherror1

Missing API key.：Claude Desktop OpenCode GoChange the upstream authentication field from ANTHROPIC_AUTH_TOKEN to ANTHROPIC_API_KEY so requests are sent through x-api-key.autherror4 issues merged

claude_code_auto_compact_window1

exceeds model's maximum context length (Claude Code)Set CLAUDE_CODE_AUTO_COMPACT_WINDOW in the Claude Code provider’s advanced settings in cc-switch to a value below the model’s context limit.claude_code_auto_compact_window3 issues merged

claude_code_effort_level1

effortLevel: max is not supportedSet the CLAUDE_CODE_EFFORT_LEVEL environment variable to high, or to max on v3.14.1+, avoiding the invalid max value mapping.claude_code_effort_level2 issues merged

claude_code_max_context_tokens1

"deepseek-v4-flash" is not a modelMost related issues remain unresolved. Upgrade to CC Switch v4, enter the model's actual context window, and use [1m] only if it truly supports 1M.claude_code_max_context_tokens3 issues merged

claude_code_use_bedrock1

Save keeps failing and asks for the API endpointUpgrade to cc-switch v3.11.0 or later. It natively supports AWS Bedrock and no longer requires an API endpoint or API Key.claude_code_use_bedrock2 issues merged

claude_config_dir1

Claude Code cannot see a newly enabled MCP - cc-switchUpgrade cc-switch to the latest version, or copy the contents of the sibling .claude.json into the one inside CLAUDE_CONFIG_DIR by hand.claude_config_dir4 issues merged

codex_home1

Codex still loads skills from ~/.agents/skills after being disabledCheck the skill storage location. If a copy is in ~/.agents/skills, Codex will keep loading it; disable or remove that copy yourself.codex_home1 issues merged

deepseek_api_key1

codex never shows the ds model - CodexCodex desktop needs an official login state to show third-party models. Enable keep-official-login-when-switching in cc-switch and restart.deepseek_api_key3 issues merged

disable_autoupdater1

cc-switch routing mode overwrites Claude Code settings.jsonAdd custom env vars to CC-Switch Provider JSON, not directly to Claude Code settings.json.disable_autoupdater2 issues merged

drm_ioctl_mode_create_dumb1

KMS: DRM_IOCTL_MODE_CREATE_DUMB failed: Permission deniedResolve cc-switch white screen DRM permission errors on Linux by disabling WebKit hardware acceleration, specifying NVIDIA rendering, or using the CLI version.drm_ioctl_mode_create_dumb2 issues merged

egl_bad_parameter1

EGL_BAD_PARAMETER: CC Switch White Screen on LinuxFor affected Linux AppImage environments, preload the host libwayland-client first. If the white screen remains, try the .deb package.egl_bad_parameter8 issues merged

enoent1

ENOENT: no such file or directory, scandir Claude CodeIn VSCode Remote SSH, configure Claude Code authentication on the remote Linux server and create missing directories; local settings do not sync.enoent2 issues merged

err_bad_request1

ERR_BAD_REQUEST api.anthropic.com ClaudeTurn on "skip the first-install confirmation" in cc-switch and clear the conflicting environment variables to resolve the Claude Code ERR_BAD_REQUEST.err_bad_request2 issues merged

gemini_api_key1

cc-switch keeps saying there is an environment variable conflict and then deletes the variable Gemini CLIIgnore the environment variable conflict prompt to keep your system variables, or upgrade cc-switch to v3.12.3 to fix saving in Official mode.gemini_api_key2 issues merged

gtk_is_widget1

Gtk-CRITICAL: gtk_widget_get_scale_factor failedOn a GTK assertion failure running cc-switch under Linux or WSL2, edit settings.json to turn silent startup off, or clean the leftovers and reinstall.gtk_is_widget3 issues merged

hermes_home1

Hermes cannot see any of these Skills (HERMES_HOME not recognized)CC Switch writes Symlinks to ~/.hermes/skills/; copy them to $HERMES_HOME/skills/ so Hermes sees them. The CN-version session issue has no user-side fix.hermes_home2 issues merged

home_url1

Local proxy toggle UI component is truncated and cannot be fully displayedUpgrade cc-switch to the latest version to fix UI truncation caused by window scaling and tray menu overflow.home_url2 issues merged

invalid_argument1

Function call is missingUpgrade cc-switch. The Gemini API requires thought_signature in tool calls, which older versions did not add when forwarding requests.invalid_argument7 issues merged

invalid_authentication_error1

invalid_authentication_error Test Failure HTTP 401An unreplaced {{apiKey}} variable in the usage query script causes 401. Upgrade cc-switch to the latest version; temporarily enter the Key as a literal.invalid_authentication_error3 issues merged

model_not_supported1

API Error: 400 model_not_supportedRestart CC Switch to repair the proxy routing, or confirm whether the model ID requested became invalid after a Copilot policy change.model_not_supported2 issues merged

node_repl_native_pipe_connect_timeout_ms1

[mcp_servers.node_repl] written back automatically by CC SwitchTurn off or delete node_repl in MCP management at the top right of CC Switch to stop it being written back into the Codex config file.node_repl_native_pipe_connect_timeout_ms2 issues merged

rate_limit_error1

CC switch Does Not Support Multiple Claude Official Logins...CC-Switch cannot switch between multiple official Claude subscriptions. You must log in again; support for this remains under discussion.rate_limit_error2 issues merged

response.created1

expected value at line 1 column 1Upgrade to cc-switch v3.14.1 or newer to fix the JSON parse failure caused by Codex OAuth forcing an SSE stream.response.created2 issues merged

responses_feature_not_supported1

responses_feature_not_supported: web_searchUpgrade cc-switch to v3.16.5, which disables web_search in the config automatically to work around the Xiaomi MiMo gateway limitation.responses_feature_not_supported3 issues merged

skill_dir_not_found1

Installation failed: Skill directory does not exist cc-switchUpgrade to cc-switch v3.14.0 or use local ZIP installation to fix URL install failures for repos with SKILL.md in the root.skill_dir_not_found2 issues merged

win-error-1831

IO 错误: 当文件已存在时，无法创建该文件 (os error 183)A Junction/hard link configuration directory causes the error. Use a regular directory temporarily and wait for a cc-switch fix.win-error-1833 issues merged

win-error-25031

Error 2503: CC Switch MSI Installation Fails on Windows 11Open Command Prompt as an administrator and run msiexec /i with the MSI file path.win-error-25033 issues merged

win-error-4001

HTTP 400 / Error 400Upgrade cc-switch first and verify API format and auth fields per provider; if HTTP 400 persists, fix the request using the exact upstream field. Copilot fix…win-error-4004 issues merged

Proxy and local routing263

cc-switch Local Proxy FAQ: 502 Bad Gateway, Timeouts, Unable to Delete ConfigurationsProxy issues often stem from unsupported official providers, unapplied settings, or unsynchronized UI state;27 issues mergedcc-switch Usage Statistics Differ from DeepSeek Official Site / Stop UpdatingUpgrade to v3.19.2 or later, then run “Rebuild Codex Usage” once on the “Usage Statistics” page to correct historical overcounts or missing records.22 issues mergedSwitching Codex providers overwrites config.tomlUpgrade cc-switch to v3.17.0+ and sync the MCP and other settings you want to keep into “General Configuration”; if an old snapshot still writes them back…21 issues mergedcc-switch crashes on launch / white screen / black screen / background crashUpgrade to the latest. Windows white screen: install WebView2. Proxy crash: change port, upgrade to v3.9.1+. Old macOS/Linux: use the CLI or distro package.20 issues mergedcc-switch usage query fails / keeps showing failed / undefinedUpgrade to v3.16.2+. If it still fails, fill in base_url and the access token in NewAPI format, or turn off auto-refresh and the usage query.20 issues mergedCodex config.toml completely overwrittenMost related issues remain unresolved. Put custom sections in cc-switch’s common configuration or provider template, then upgrade to the latest version. (MCP)15 issues mergedInvalid schema for function — CodexUpgrade CC Switch to a version including the v3.18.0 fix for `parameters.type:null`; track the original issues for other `null` schema variants.13 issues mergedThe `content[].thinking` in thinking modeSome variants remain unresolved: upgrade to a version with the thinking history normalization fix; for Codex routed through DeepSeek, use a version with the…13 issues mergedUpstream Chat Completions Streaming Response Error, Claude CodeCheck whether the issue is caused by local proxy conversion or the upstream endpoint; adjust the endpoint or disable the local proxy for the verified scenario.13 issues mergedsettings.json gets reset - Claude CodeWrite shared fields like plugins and hooks into "Common Config" and check write-back on switching; if takeover mode misbehaves, disable it, switch provider…12 issues mergedCC Switch Proxy Fails or Requests Are Blocked by the System ProxySet CC Switch's global outbound proxy to your proxy application's address, or bypass local requests in the system proxy, then restart CC Switch.11 issues merged"Failed to upload "image.png"" screenshot upload failedThis is not a cc-switch error. GitHub failed to upload the screenshot. Re-upload it or paste the error as text so maintainers can see it.10 issues mergedCodex error after enabling local proxyAdd `/v1` to the end of the Codex provider request URL in CC Switch, save, and retry.9 issues mergedapi failed deserialize json body intoDepending on the error: roll Claude Code back, upgrade cc-switch, turn the local proxy off, or stop sending unsupported fields.8 issues mergedCodex usage statistics abnormally high or stopped updatingIdentify the problem type and upgrade to the corresponding fix version; fork double counting was fixed in v3.18.0, Windows file growth missed syncing in…8 issues mergedNot logged in · Run /login - Claude CodeTurn CC Switch local proxy takeover on, check the API address includes /v1, or launch the terminal from CC Switch so env vars are injected.8 issues mergedCodex Session history costs not recalculated, total cost severely understatedUsage costs are computed once at import, causing understated or duplicated costs: upgrade cc-switch to v3.18.0+ (first launch auto-rebuilds Codex history) and…8 issues mergedmissing information - cc-switchA roundup of documentation gaps. Each case needs its own clarification, or waiting for the official documentation to fill in.7 issues merged[SRV-006] connection errorUpgrade cc-switch to v3.16.4, which fixes proxy forwarding disconnects with a custom DeepSeek provider and billing falling back to the request model.7 issues mergedUnexpected status 502 Bad Gateway：CodexSet `NO_PROXY=127.0.0.1,localhost,::1` in `~/.codex/.env` so Codex connects directly to the local CC Switch port.7 issues mergedUsage Stats Missing and Disk Usage at 100%Most related issues remain unresolved. Updating to the latest version and disabling the local proxy may restore usage display and reduce disk I/O.7 issues mergedProvider API Key Overwritten: After Codex Restart or SwitchUpgrade to cc-switch v4.0.0 or later to prevent provider keys from overwriting each other and restore the official login state.6 issues mergedCodex desktop cannot see modelsSign in to official ChatGPT, enable “Keep official login when switching to third parties,” and enable local routing. Restart Codex.6 issues mergedIt says 1.6 billion used — usage statistics spiking - CodexUpgrade cc-switch to v3.18.0 to fix the sub-agent history replay double-count bug; it rebuilds the polluted Codex usage data automatically.6 issues mergedCheck failed Connection failedToggle or switch the system proxy, then fully restart cc-switch. If needed, upgrade macOS or update to v3.16.3+, preferably 4.x.6 issues mergedduplicate entry with key "mcp_servers" Hermes configuration errorUpgrade to cc-switch v3.16.3 or later, then switch providers to automatically clean up historical duplicate keys.6 issues mergedauto mode cannot determine the safety: Claude Code errorUpgrade CC Switch first. If the error persists, check thinking parameters, model mapping, stop support, and the response format when stream is omitted.6 issues mergedUnknown name "prompt_cache_key" - cc-switchUpgrade cc-switch to v3.16.2+ to fix prompt_cache_key injection, or use an OpenRouter endpoint that natively speaks the Claude Code format.6 issues mergedInvalid messages.content.type parameter; allowed value ['text']: CodexUpdate to v3.20.2 and re-import the Zhipu GLM preset; to send images in Codex, choose a vision-capable model.6 issues mergedAll plugins show disabled: Claude CodeUpgrade to CC Switch v4.0.0 or later; it replaces only routing fields and preserves plugin configuration.5 issues mergedINVALID_API_KEY after switching providers in CodexUpgrade to v3.20.1 or later; third-party switching no longer writes to `auth.json`, preventing provider key/authentication mismatches.5 issues mergedError from provider (Console Go): Upstream request failedCheck whether the model mapping was applied. If the target model is unavailable or the request body contains an unsupported tool_choice or image… (cc-switch)5 issues mergedDeepSeek Responses conversion causes low cache hit rate, CodexFor a low cache hit rate with Codex and DeepSeek, check request logs and the proxy conversion path; no confirmed fix is available.5 issues mergedRelay Link Speed Test Fails Without VPN - CC SwitchNo single confirmed fix is available. Provide a reproducible configuration, request target, and startup logs.5 issues mergedClaude Official check failed: could not extract base_url - CodexCC Switch proxying and load balancing do not support an official Claude subscription — use a third-party API key. Forcing it errors and risks a ban.4 issues mergedsettings.json overwritten by cc-switchWrite non-env custom settings to “General Configuration” and select “Write General Configuration”; field-level merging is not planned.4 issues mergedtools.function.parameters.type is requiredUpgrade cc-switch to v3.18.0 to fix Codex tool parameter schemas rejected by strict upstreams with HTTP 400.4 issues mergedCodex startup failure: missing supports_reasoning_summariesUpgrade cc-switch to v3.18.0 or later, then switch to the DeepSeek provider again to regenerate the model catalog. This automatically fills in the… (Codex)4 issues mergedThe 'gpt-6-sol' model is not supportedUpdate the Codex OAuth reported client version to one supported by the model and rebuild, or temporarily use gpt-5.6-sol / gpt-5.6-luna.4 issues mergedgot 0 from 0 output items: Codex remote compaction failedUpgrade CC Switch to v4.0.0 or later. If you cannot upgrade yet, disable Remote Compaction and use Codex local compaction.4 issues mergedunknown variant `image_url`, expected `text`Do not send images to models that do not support image input. Use text only, or wait for/use the merged automatic retry mechanism that removes images.4 issues mergedInvalid schema for functionCodex Desktop’s built-in automation_update tool schema lacks a top-level type, so DeepSeek rejects it. Upgrade CC Switch to a version that includes the fix.4 issues mergedInvalid type for 'messages'Upgrade cc-switch to the latest version for the conversion fix, or downgrade the Codex CLI to 0.80.0 and use wire_api="chat" to work around it.4 issues mergedinvalid type: sequenceBack up and delete the old config.toml so Codex regenerates a default config, fixing the incompatible hooks format.4 issues mergedAPI Error: 400 Param Incorrect Claude CodeUpgrade CC Switch to v3.16.2+ to fix 400 errors caused by missing reasoning_content in MiMo thinking mode.4 issues mergedThe 'glm-5.3' model is not supported - CodexUpgrade to the latest version and disable proxy takeover. In 4.0.5 aggregation mode, start a new chat if old chats still fail randomly.4 issues mergedtools.function.parameters is not a validUpgrade to a later version containing #6863; it converts `$ref` with sibling keywords into Moonshot-compatible `allOf`.4 issues mergedmissing field `call_id`: Codex automation HTTP 400No verified published fix is available. Normalize orphaned output without `call_id` during proxy forwarding and retain cross-task message content.4 issues mergedRequest body format invalid error - Claude CodeUpgrade cc-switch and enable the Rectifier, or add MAX_THINKING_TOKENS=0, for compatibility with third-party API formats.4 issues mergedselected model (kimi-k2.5) may not exist errorRemove the trailing /v1 from the API address and use the Anthropic-compatible interface. If an old session contains images, run /compact or switch models.4 issues mergedunexpected status 404 Not FoundUpgrade cc-switch to v3.16.4+ and set the upstream format explicitly to Chat Completions on the Codex provider form.4 issues mergedUnsupported content type: redacted_thinkingFor OpenRouter routes, use a proxy to filter redacted_thinking. Codex/GPT routes have no confirmed fix; upgrade to the latest version and retest.4 issues mergedCC Switch does not show the remaining quota (Codex free account, Grok Build usage undercount)Codex free accounts cannot query quota due to official API limits, with no direct fix yet; Grok Build usage undercounting requires a source change to streaming…4 issues mergedUsage query requires same-origin requests in cc-switchIn cc-switch, switch to the generic or custom template and enter the usage query URL directly in the request address to bypass the same-origin restriction.4 issues mergedChatGPT authentication fails with global proxy enabled - CodexUpgrade cc-switch to v3.16.4+ and enter a working proxy address under 「设置 → 路由 → 全局出站代理」, then retry Codex/ChatGPT authentication.3 issues mergedModel unavailable in this region (Claude Code)Enable “skip initial installation confirmation/do not re-verify login” in CC Switch and restart the terminal. If it still fails, check for an… (URL)3 issues mergedAPI Error: 400 invalid request: Claude Desktop model route is not configuredUpgrade cc-switch to v3.16.0+ and configure routing rules explicitly for sub-task models such as Haiku and Opus on the provider form.3 issues mergedConfig error: Claude Provider is missing base_url configurationTurn cc-switch local proxy takeover off and run /logout then /login in the terminal, or upgrade past v3.14.0.3 issues mergedSelect Model Menu Still Shows Pre-Switch Model List - CodexClose existing Codex sessions, run `codex app-server daemon restart`, and upgrade CC Switch to v4.0.7 or later for detection and restart prompts.3 issues mergedunexpected status 404 Not Found — CodexChange `requires_openai_auth` for the custom provider in `config.toml` to `false`, then start a new session to avoid sending `gpt-reserve`.3 issues mergedcc-switch overrides DNS cache and resolvesDisable proxy takeover in the affected application to restore network connectivity; cc-switch does not modify system DNS records.3 issues mergedTray menu does not show current Plan allowance when multiple ChatGPT accounts are linked - CodexUpgrade cc-switch: the tray menu failing to show allowance with multiple linked ChatGPT accounts is a confirmed bug, fixed in commit e53ab21 and released…3 issues mergedIt reports 401 in claude - Claude CodeTurn the cc-switch local proxy on to convert the API format, and make sure `ANTHROPIC_BASE_URL` is injected into the Claude Code process.3 issues mergedError running remote compact task error - CodexUpgrade cc-switch to v3.12.0 or later. It adds forwarding support for the Codex `/responses/compact` route in the local proxy and can resolve 404 or 502 errors.3 issues mergedFormat conversion error: Failed to parse upstream response - Claude CodeUpgrade cc-switch for the streaming response parse fix, or enable full request path and complete the URL for non-standard APIs such as iFlytek.3 issues mergedInputValidationErrorWhen long tool arguments are truncated during streaming SSE, temporarily disable Tool Search, maximum-effort thinking, and the 1M declaration, then restart and…3 issues mergedinvalid tool_call_id (HTTP 400) — CodexIf tool calls fail, use a native Responses-compatible GPT model; v3.16.5 can be rolled back to v3.16.4.3 issues mergedstatus=429 - Claude DesktopStreaming requests in CC Switch 3.15.0 skip the model rewrite and produce a 429. There is no official fix yet.3 issues merged401 UnauthorizedUpgrade to cc-switch 4.0.x, or clear the stale third-party OPENAI_API_KEY from ~/.codex/auth.json manually, restart Codex, and sign in again with ChatGPT OAuth.2 issues mergedRequest forwarding failed: error sending request for urlCheck your local network connection and proxy configuration so cc-switch can reach the Nvidia API endpoint, resolving the 502 timeout.2 issues mergedLogin required: Claude Code missing ANTHROPIC_AUTH_TOKENUpgrade to v3.16.3; on older versions add an ANTHROPIC_AUTH_TOKEN placeholder to Claude Code's env.2 issues mergedASProxy64.dll Access Violation Causes CrashAdd cc-switch.exe to Astrill’s Help → Hard excluded apps, then sign in to Astrill again.2 issues merged400 bad requestEnable local routing in CC Switch; other users recovered with the native API format, default authentication fields, and a VPN.2 issues merged[proxy::response_processor] [Claude] stream errorA stream decode error or timeout proxying Claude Code loses logs or records 0 tokens. Fix the model extraction fallback to show the right model.2 issues mergedcc-switch token count is 0An older database missing pricing for a new model makes token statistics read 0. Upgrade to a version containing the fix.2 issues mergedCC Switch online update freezes and becomes unresponsiveCC Switch online update can freeze under FlClash TUN mode. Switch to system proxy mode or manually download and reinstall.2 issues mergedNot logged in · Please run /login ClaudeEdit `~/.claude.json` to move `PROXY_MANAGED` into the `approved` list, or answer yes at the prompt.2 issues mergedUnable to Display Model Reasoning: Claude Code ProxyUpgrade to cc-switch 4.0.13 and retest. If the issue persists, ignore late reasoning deltas after the response body begins.2 issues mergedusage null - Claude Code Qwen DashScopeUpgrade to cc-switch v3.16.3+, which fixes null streaming usage on the OpenAI-compatible interface automatically.2 issues mergedThe proxy takeover claude switch cannot be ticked in Claude Desktop modeIn claude-desktop mode, the takeover section hard-codes the Claude Code (claude) switch instead of the Claude Desktop one, so clicking does nothing.2 issues mergedThe mcp I configured in .claude.json is reset as soon as the proxy startsCC Switch syncs by full overwrite. Import your MCP servers and manage them all inside CC Switch rather than editing .claude.json.2 issues mergedsession isn't eligibleFor a non-Anthropic upstream or format conversion, set CLAUDE_CODE_AUTO_MODE_SERVER=0 in the provider env.2 issues mergedInvalid schema: codex_app__automation_updateUpgrade CC Switch to v3.18.0 or newer to fix the 400 caused by type: null when Codex converts the DeepSeek protocol.2 issues mergedThe apply_patch tool is unavailable with the Codex proxy onUpgrade to cc-switch v3.16.2 or newer. On a relay, make sure the backend model matches what Codex expects or tool calls fail with routing on.2 issues mergedCodex reasoning levels reduced to none and highIn the Codex provider editor, select the supported and default reasoning levels in the model row; do not manually edit catalog files that will be regenerated.2 issues mergedSession expired - Codex OAuth multiple accountsComplete Codex OAuth authorization again in a separate browser session signed in only to the target account, then restart CC Switch to verify.2 issues mergedRouting and system proxy conflict makes Codex unusableSet IPv4 and IPv6 loopback addresses to DIRECT in proxy rule overrides, then retry CC Switch routing.2 issues mergedCodex Current Provider Does Not Exist, Cannot Take Over Live Configuration - CodexAdd a custom provider on the Codex page in CC Switch, then enable Codex local routing.2 issues mergedAll tool calls return errors: Codex tool call conversion failedUpdate CC Switch to v3.16.4 or later and retry to fix the reported Codex tool call conversion issue.2 issues merged“导入 0 条, deferred 27–31 个” — Codex Usage Is Not CountedIf it persists after upgrading, wait for the paginated rollout index fix. Disabling auto-sync stops repeated full reads but does not restore statistics.2 issues mergedThe `reasoning_content` in the thinking mode must be passed back to the APIConfigure DeepSeek as native mode instead of the default; if it still fails, set `model_reasoning_effort` to `none` in Codex.2 issues merged"Expecting property name enclosed in doubleUpgrade CC Switch to v3.16.4 or newer to fix the JSON parse error caused by a large request body not being decompressed.2 issues mergedFunction call is missing a thought_signatureUpgrade to the latest CC Switch 4.0 release and retry. If it persists, report the version, system, full reproduction steps, and logs.2 issues mergedKimi balance query unavailableUpdate cc-switch to the latest version; the backend has automatically fixed Kimi balance recognition.2 issues mergedNvidia check failed: Not found (404)Upgrade cc-switch to v3.16.3+; new version uses lightweight HTTP probing, fixing NVIDIA interface false 404 errors.2 issues mergedCC Switch flashes once when clicking any buttonOn Windows, use WebView2 152.0.4191.62 Fixed Version only for CC Switch to avoid click flashing with WebView2 153.0.4234.32.2 issues mergedUnable to Call Tools Normally with Claude CodeModel responses vary on the NVIDIA channel; try deepseek-ai/deepseek-v4-flash, which was tested as stable, or switch providers.2 issues mergedRequest still uses the old session model, CodexSet all relevant provider configurations in the failover queue to the required model; when continuing an old session, select the target model in the Codex…2 issues mergedReasoning effort dropped, Claude CodeWait for the next release containing the merged Responses proxy fix so reasoning.effort can be forwarded after model mapping.2 issues mergedstream disconnected before completion CodexUpgrade cc-switch to v3.14.0 or later to fix connection drops caused by proxy forwarding hop-by-hop response headers.2 issues mergedthinking enabled but reasoning_content missingDisable Thinking mode in Claude Code, or upgrade cc-switch to fix Kimi/Moonshot tool call errors.2 issues mergedthinking options type cannot be disabledUpgrade cc-switch to v3.16.4 or later; the agent automatically strips the reasoning_effort parameter conflicting with DeepSeek.2 issues mergedThe provided messages input is invalidIf a session keeps failing after triggering a built-in tool, start a new session; check whether the third-party backend rejects Anthropic internal content…2 issues mergedUnsupported parameter: 'max_tokens'The route forwards max_tokens to a model that only accepts max_completion_tokens. Verify parameter support or wait for a cc-switch fix.2 issues mergedUpstream request failed: Claude Code request failedFirst check the specific error returned by the upstream service. The provider must address regional unavailability;2 issues mergedAPI Error: Connection refusedIn Windows WSL2 NAT mode, use socat to forward WSL's 127.0.0.1:15721 to the host CC Switch routing port.2 issues mergedx-anthropic-billing-header breaks caching - CC SwitchUpgrade CC Switch to v3.15.0+, which fixes the dynamic billing header breaking prefix caching in openai_responses mode.2 issues mergedBoth ANTHROPIC_AUTH_TOKEN and ANTHROPIC_API_KEY setSwitching from DeepSeek or MiMo to Codex writes both authentication variables at once; this issue has no confirmed Codex fix.1 issues mergedANTHROPIC_BASE_URL locked to localhostAfter updating cc-switch to v3.12.3, the maintainer said this issue was fixed in v3.9.1.1 issues merged<thinking> tags output as body text in Claude CodeChanging the provider's apiFormat from openai_chat to anthropic, if supported upstream, can bypass inline <thinking> leakage.1 issues mergedBody discarded: Anthropic protocol conversion Claude CodeUpgrade to v3.20.3 or a v4 version containing the fix; the converter ignores trailing empty reasoning_content.1 issues mergedNo new usage record is createdMost related issues remain unresolved. Upgrade to a cc-switch version containing the #7740 fix for Gemini streaming usage parsing and model attribution.1 issues merged400 MissingParameter: input.typeNo verified fix is available. The reporter's direct tests returned 200 with "type": "message", but the proxy patch remains a proposal.1 issues mergedstream disconnected before completionUpdate CC Switch to 4.0 or the latest version and retry; the maintainer recommended this, but the original issue did not confirm a resolution.1 issues mergedProxy not working, constant reconnect after entering a question; CodexThe separate proxy feature in cc-switch was removed; set the proxy via $env:http_proxy in PowerShell, then run Codex.1 issues mergedRequest exceeds the context windowNo verified solution was provided in the original post; this issue was closed as a duplicate related to catalog configuration and automatic compression.1 issues mergedToggling proxy or switching third-party accounts invalidates official Codex sign-inNo verifiable solution was provided; the issue was suggested for further reporting to cc-switch-cli.1 issues mergedAll models mapped to reasoning model (Thinking) value Claude CodeUpgrade CC Switch to v3.13.0 or later to use the fixed proxy-mode model mapping logic.1 issues mergedError in .codex cc-switch.db causes cc-switch startup failureClose cc-switch, clean records with empty base_url in cc-switch.db, or delete the database file and restart.1 issues mergedIncorrect model displayed in Claude CodeConfigure a Custom Command for ccstatusline to read the model name from the current cc-switch provider configuration.1 issues mergedThe auto mode classifier is temporarily unavailableDisable the Anthropic Base URL proxy in CC Switch and restart Claude Code; one user in the issue reported that updating CLIProxyAPI resolved the problem.1 issues mergedInvalid messages.content.type Parameter Claude CodeMost related issues remain unresolved. Upgrade to a version containing the #7656 fix so Chinese image-rejection errors trigger image fallback retries.1 issues mergedTool calls in claude cli stream interrupted after configuring a local proxy Claude CodeNo verified solution is available; one user reported switching to claude-code-router as an alternative.1 issues mergedmessages[1]: missing field `content` (HTTP 400)Upgrade CC Switch to v3.20.4; the converter skips additional_tools carriers without content, preventing strict upstream services from returning 400.1 issues mergedUnable to apply reverse proxy to Claude Code VS Code pluginEnable “Apply to Claude Code plugin”; if the old provider is still active, check and remove the previous Zhipu relay settings in VS Code settings.json.1 issues mergedHowever, this session isn't eligibleUpdate to a version with the #7893 fix; it writes `CLAUDE_CODE_AUTO_MODE_SERVER` to settings.json when switching proxies.1 issues mergedConfiguration overwrites coworkEgressAllowedHosts, making remote Git unavailableUpgrade to CC Switch v3.16.1 or later; the maintainer said the issue was fixed or implemented.1 issues mergedCannot configure additional upstream request headers in Claude DesktopThis is an unimplemented feature request; the original post provides no verified solution.1 issues mergedClaude Provider Not Found, Unable to Take Over Live Configuration: Claude CodeUpgrade to v4.0 or later; routing logic has been rewritten. Claude Desktop uses model mapping mode, with no manual changes to settings.json needed.1 issues merged/v1/models returns {"models":[]}A user restored 1M with a Python proxy returning model IDs with the [1m] suffix and context_window: 1048576; no reusable code or official fix was provided.1 issues mergedI'm unable to call create_fileCheck and correctly set the upstream format in SWITCH; an incorrect format configuration made the tools unavailable.1 issues merged1-hour cache write cost undercounted by 37.5%: ClaudeUpdate Claude Code to a version containing this fix so 1-hour cache writes are billed at 1.6 times the 5-minute cache write rate.1 issues merged请求转发失败: 上游请求失败: client error (Connect)Temporarily bypass the CC Switch local proxy or switch networks to check whether DeepSeek is blocked. No final fix has been confirmed.1 issues mergedGateway /v1/models returned an unexpected body: Claude CodeNo verified solution is available; the local proxy must return an Anthropic `data` model-list format to Claude Code.1 issues mergedNot logged in · Please run /loginMove PROXY_MANAGED in ~/.claude.json from the rejected approval list to the approved list, then use routing again.1 issues mergedClaude Code preference changes are not synced back during proxy takeoverUpgrade to v4.0.0; when switching providers, Claude Code preferences remain in ~/.claude/settings.json.1 issues mergedLogin required: Claude Code login prompt after takeover with Codex OAuthUser-tested: after Claude takeover, keep ANTHROPIC_AUTH_TOKEN (even empty) in ~/.claude/settings.json env before starting Claude Code to avoid login prompts.1 issues mergedDoes Automatic Claude Subscription Balance Refresh Log Proxy IPs?This issue does not say whether automatic refresh records a proxy IP; do not use it to determine which IP the account used.1 issues mergedWebSearch returns 0 results: Claude CodeTemporarily disable built-in WebSearch. Use Brave Search MCP to find pages, then use WebFetch to read them.1 issues mergedFormat conversion error: No choices in response - CC SwitchClinePass wraps the response in a data envelope, breaking parsing. Upgrade CC Switch to a version with the fix, or use a local proxy to unwrap response.data.1 issues mergedRequests Keep Sending Continuously - Codex appFirst check proxy logs to confirm whether the ongoing requests are coming from Codex app; the original post does not provide a verifiable solution.1 issues mergedauth.json contamination in CodexIn Codex 3.16.0, the official login state remains in auth.json. Check provider, endpoint, and token for BYOK in config.toml.1 issues mergedCodex session import ignores cache_write_input_tokensUpgrade cc-switch or wait for an official fix: Codex session log import misses cache_write_input_tokens, so cache writes are counted as ordinary input and…1 issues mergedUnable to Generate Commit Messages - CodexNo verifiable solution was provided. The report describes an upstream streaming connection interruption while generating a commit message.1 issues mergedmissing field `call_id`DeepSeek Responses rejected a Codex delegated task entry missing `call_id`; the issue did not confirm a user-side fix.1 issues mergedOpenAI OAuth account/quota UI disappearsUpgrade to CC Switch 4.0 and confirm the official OAuth login is still stored on disk; local routing can still forward requests through a custom endpoint.1 issues mergedCodex desktop app has issues, but works without a routing proxyThe issue lacks verifiable resolution steps. Please provide the full error shown in the screenshot and the routing proxy configuration.1 issues merged404 Not Found: /v1/live, Codex Desktop VoiceDisable the Codex proxy takeover in CC Switch, restore the official Codex configuration, and fully restart the desktop app.1 issues mergedthinking too short CodexStart a new Codex conversation to temporarily avoid it. The original post suggests filtering empty or overly short thinking; an official fix is unverified.1 issues mergedCodex settings become the Claude valuesCodex failover settings are overwritten by Claude settings after a restart. No verified fix is available in the original report; follow the source issue.1 issues mergedkey '$defs' not found in schemaCodex hits tool schema reference validation failures with Grok. No verifiable fix is available in the original report; follow issue #7241 for updates.1 issues mergedmissing field `call_id`Clean up orphaned heartbeat output entries when enabling requests through a proxy; this issue did not confirm that CC Switch has a fix.1 issues mergedinvalid thinkingKimi's deepseek-v4-flash rejects the current thinking parameter; the original post provides no verified solution.1 issues mergedNo API key configured for provider: customUpgrade Codex CLI and CC Switch to the latest versions; CC Switch supports reading the Codex CLI version from config.toml.1 issues mergedunknown type: tool_search_call — Codex session continuation returns 400Do not resume a thread containing tool_search_call history; start a new Codex thread before using the Responses upstream.1 issues mergedMissing required parameterUpgrade cc-switch to v3.16.4 or later to fix missing function names in Codex native tool calls when routing is enabled.1 issues mergedCodex custom endpoint silently redirected to chatgpt.com (withdrawn)Report withdrawn: the redirect affected only an unmerged commit. Routing works in existing versions; no configuration changes are needed based on this report.1 issues mergedUnknown parameterUpdate to the replay allowlist fix so Claude Code filters the reasoning-envelope status field when resuming Codex OAuth sessions.1 issues mergedexceeded the 64000/128000 output tokenRemove or rewrite the rejected MCP tool JSON Schema `pattern` to prevent Codex OAuth from falsely reporting an output token limit.1 issues mergedDisable response strange: Codex configuration failureCheck `~/.codex/config.toml` for deprecated `disable_response_storage`, then share the configuration and startup error with maintainers.1 issues mergedChatGPT cannot load config.toml: Codex DesktopRemove residual API login preferences from the Codex configuration and CC Switch saved configuration, then reopen the old conversation.1 issues merged{"models":[]}: Codex OpenAI official proxy model catalog is emptyTemporarily place the Codex-format catalog file inside CODEX_HOME and reference it in config.toml; the official proxy forwarding fix is unconfirmed.1 issues mergedorphaned [model_providers.*] tableAfter switching to the official Codex OAuth card, no confirmed fix exists; only clean engine-generated provider tables with no remaining references.1 issues mergedNo tool output found for function callWait for a CC Switch fix release. Until then, avoid parallel image and other tool calls in one turn to prevent media messages interrupting tool results.1 issues mergedsupported API model names… passed Old Model Name: CodexAfter switching providers, the old session still sends the original model name. Start a new Codex session, or restart the old session.1 issues mergedProxy not taking effect; requests go through native codex requests - CodexThe original post has no verifiable solution yet; the issue remains open. Follow Issue #5941 for updates.1 issues mergedCommon Config disappears during Codex proxyUpgrade to cc-switch 4.0.0 or later; its redesigned routing mode preserves other config.toml content during takeover.1 issues mergedTool calls always hang: Codex function_call loses call_idA commenter confirmed non-empty id/name checks restore tool calls. The post also suggests bypassing CC Switch Responses translation to connect directly to…1 issues mergedCodex cannot display summarized session titles after proxy model useNo cc-switch changes are needed: Codex does not currently support automatic session-title summaries.1 issues mergedSettings Reset to Defaults After Restart, CodexUpgrade to CC Switch v4.0.0 or later; when switching providers or using local routing, it replaces only key fields and preserves other settings and plugins.1 issues mergedCodex sub-agent created in copy mode incorrectly counts full usage (Codex)Upgrade to v3.18.0; it fixes double-counted historical usage for copy-mode sub-agents and rebuilds session-sourced usage.1 issues mergedMessages with role 'tool' must be a response to a preceding message with 'tool_calls' (Codex)In cc-switch, toggle the "local routing" switch off and on again to temporarily recover; this is a proxy internal state bug that recurs.1 issues mergedunsupported call: - CodexUpgrade cc-switch to v3.16.4+ to fix tool call name/id overwritten by empty deltas during streaming conversion.1 issues merged[CODEX-SYNC] deferred 4 CodexUpgrade cc-switch to v3.20.3 to fix Windows session files permanently deferred when mtime does not change.1 issues mergedRequests show zero duration/no first-outputThis issue remains open, with no confirmed user-side fix; missing request timing should remain unknown rather than display as 0.1 issues mergedunexpected status 502 Bad GatewayThe original post shows CC Switch writes `wire_api = "responses"`; no verifiable fix is available.1 issues mergedExpected an ID that begins with 'msg'Create a new task and migrate the summary, or keep the old task on the Chat Completions conversion path; a permanent fix is still unverified.1 issues merged检测到无限空白 bug: Copilot incorrectly drops tool calls containing indented codeA comment reports a fix in commit 33eafbad5198d9fe64ff507ac673430ec334b4aa. Check whether your version includes it; no fixed release was specified.1 issues mergedPrompt files are never rebuiltPrompt, live configuration, and caches are not fully rebuilt after database restoration. No verifiable fix is available; follow the merged discussion.1 issues mergedANTHROPIC_CUSTOM_HEADERS not saved - Claude CodeUpdate to a version that includes PR #2929 and re-import; the Deep Link's config.env custom fields are preserved.1 issues mergedDeepSeek integration with cc-switch: Codex deep integration feature requestThis requests deep integration of DeepSeek with Codex. The original post has no verifiable solution; closure does not prove implementation.1 issues mergedFailed to deserialize the JSON bodyDeepSeek rejects conversation history after an image has been sent. Start a new conversation to recover.1 issues mergedIntermittent 502: Claude Code Using DeepSeekThe original post provides no verifiable solution. Provide the local network environment and related configuration to determine the cause.1 issues mergedTest failed Claude CodeCheck the actual proxy port and set the CC Switch outbound proxy to that port; in this case, changing it to 7897 restored connectivity.1 issues mergedSessions may stop responding (JSONL stops being written) — Claude CodeUpdate CC Switch to the latest 4.0 release and retry. If it still hangs, temporarily bypass CC Switch and submit complete reproduction details.1 issues mergedFailover Does Not Update API Base URL When Switching ProvidersUpgrade to 4.0 or the latest version and retry; failover forwards requests using the target provider's API URL and model mapping.1 issues mergedGLM configuration overwritten during use in cc-switchIncrease streaming and non-streaming failover timeout thresholds, then upgrade to the version the maintainer said was updated.1 issues mergedNot supported model gpt-5.5: Cline automatic failover failedUpgrade to the latest CC Switch 4.0 release and retry. If it still fails, provide the version, system, reproduction steps, and logs.1 issues mergedFastMCP tools not visible in tool list: Claude CodeThe issue was traced to the client or provider; no verified fix steps are available in this issue.1 issues merged`meta.isFullUrl` Cannot Be Saved: OpenClaw / OpenCodeNo confirmed fix exists. Reopen the issue with the current version, environment, and reproduction steps, and wait for full URL mode support.1 issues mergedGemini: 无效令牌 after enabling the local proxyTemporarily disable the cc-switch local proxy. Users confirmed Gemini works with it disabled; no verified fix is documented with the proxy enabled.1 issues mergedBilling failure: Gemini model costs recorded as 0 in cc-switchAdd the model name after the slash, such as gemini-3-flash-preview, to the pricing list. The reporter confirmed this restores cost tracking.1 issues mergedmessages.content.type invalid parameter; allowed values ['text']Remove the image capability flag for glm-5.3 and use a text-only model catalog configuration.1 issues merged“Bash tool is continuously searched for but cannot be loaded or invoked properly” - Claude CodeBypass CC Switch and configure GLM directly in Claude Code; or upgrade to CC Switch 4.0.13 and retest.1 issues mergedQuery Failed: cc-switch GLM (Zhipu) usage queryFor GLM, "Query Failed" may only mean usage query is unavailable; API forwarding can still work. Upgrade and retest, or use a custom template.1 issues mergedUnable to configure an API obtained from google ai studioFor Gemini, the thread recommends enabling the ccs proxy and testing in the CLI because model checks were unavailable. Claude Code has no verified fix.1 issues mergedlevel "max" not supported, Codex DesktopSelect max for gpt-5.6-sol in Codex Desktop; ultra is not a separate reasoning effort.1 issues mergedCost always 0: GPT-6 Sol usage statistics in CodexEnable “Model Price Sync” in Settings to synchronize pricing data for gpt-6-sol.1 issues mergedHow to adjust GPT reasoning effort? Claude CodeThe original post did not provide a verifiable adjustment method. Follow subsequent discussion in this issue.1 issues mergedNative Grok Build Usage Import Missing - CC Switch UsageMost related issues remain unresolved. Upgrade to v3.19.0 for automatic Grok Build usage import in official OAuth mode;1 issues mergedHermes is not detectedThe original report has no verifiable solution; the maintainer merged it into #4162 for tracking.1 issues mergedunknown model 'ark-code-latest' (2013)Change the MiniMax provider's model ID to `MiniMax-M3` or a model MiniMax actually supports, then save. Do not use Volcano Engine Ark's `ark-code-latest`.1 issues mergedConversation terminates without error: Codex generates images with route proxy enabledUpgrade cc-switch to v3.16.3 or the latest version to fix interrupted Codex image requests under local route mapping.1 issues mergedContextWindowExceededError: Codex image uploads exceed the context windowThis issue is unresolved and has no verified fix; it only confirms that Codex sends uploaded images as embedded base64.1 issues mergedLocal routing failure CodexUpgrade cc-switch from 3.16.1 to 3.16.4 and observe whether the issue recurs; this version includes hardening for Codex routing takeover.1 issues mergedClaude routing does not work on Ubuntu — Claude CodeUpgrade to CC Switch 4.0.13 and retry. If it persists, reopen the issue with the version, system, reproduction steps, and relevant logs.1 issues mergedCannot set terminal process group: ioctl operationThe original post has not provided a verified fix. Follow Issue #5635 for updates.1 issues mergedCORS MisconfigurationNo verifiable fix is provided. Restricting CORS, removing the CORS layer, and adding a local token are reporter suggestions; no fixed version is evidenced.1 issues mergedLocal routing mode only changes the Fable model: Claude CodeUpgrade to 4.0 or later; local routing writes Haiku, Sonnet, Opus, and Fable as routing aliases.1 issues mergedHow does the routing (proxy) feature work? Claude CodeThe post only states that routing is forwarded through local 127.0.0.1:15721/v1; no verifiable complete configuration solution is available.1 issues mergedAfter enabling proxy mode, model mappings are not written to Claude Code settings.jsonLocal Routing does not write model mappings to Claude Code settings.json. Configure them in the current CC Switch Provider and switch to enable them.1 issues mergedAutomatic approval review failed: Codex automatic approval with MiMo failedUse a model that supports json_schema for Codex automatic approval, or wait for CC Switch to provide a compatible fallback for MiMo.1 issues mergedunexpected end of dataNo verified fix is provided in the original post. Codex receives HTTP 400 and the conversation is interrupted after a MiMo tool call.1 issues mergedfailed to parse function argumentsNo verified fix is available. Check Codex session logs for truncated arguments JSON, then report it to the upstream provider or switch providers.1 issues mergedinvalid function arguments json string: CodexUpgrade cc-switch to 3.16.4 or later, then retest with MiniMax-M3.1 issues mergedMixed LF/CRLF SSE delimiters prevent ClaudeFix SSE delimiter parsing to recognize mixed LF/CRLF blank-line delimiters and preserve Claude Code tool-call events.1 issues mergedEffort is silently dropped for all muse-spark-* models in Claude CodeThe issue proposes adding muse-spark to an allowlist, but no verifiable fix is available yet.1 issues mergedmax_tokens must be at least 1, got -1712The original post only suggested a lower-bound check for `max_tokens`; no verified fix or user-usable configuration is available.1 issues mergedTasks cannot run continuously: cc-switch 英伟达 providerThe original post considered this a model issue; cc-switch only manages configuration, and no verifiable general solution is currently available.1 issues mergedauth.json Not Taking Effect, Codex Official Channel Cannot AuthenticateUpgrade to 4.0 or later, then retest authentication by switching Codex to the official channel.1 issues mergedCodex OpenAI Official cannot participate in failoverOfficial providers are intentionally excluded from failover to avoid account-ban risks because a local proxy cannot fully simulate official requests.1 issues mergedFailed to send request: Keep Official Features with a Third-Party Codex ModelNo proxy setup was verified. The maintainer recommends upgrading to cc-switch 4.0 and providing the version and reproduction steps if the problem persists.1 issues mergedAgent model changes revert after saving and reopening the configurationThe maintainer said this should be fixed in v3.17.0. Try upgrading, saving again, and checking the Agent model. No user confirmed success in the thread.1 issues mergedStill unable to use: opencodeThe original post provides no verifiable solution. Follow Issue #884 for the proxy type and no-request problem.1 issues mergedRequest timeout (504/502) - Codex local routing directly to OpenAIFirst resolve the local routing timeout to chatgpt.com; this issue provides no confirmed additional configuration fix.1 issues mergedThe statistics page does not show these Claude requests at allIf the upstream returns no parseable usage, converted Claude openai_chat/openai_responses requests may not appear in statistics; no verified fix is available.1 issues mergedSystem message must be at the beginning. in Claude CodeChange Claude Code's "model" from "opus" to "haiku" or another model family to avoid an OpenAI-compatible API 400 response.1 issues mergedInvalid request parameters - CodexOpenCode-Go's mimo-v2.6-flash fails when it does not natively support `/responses`; this issue provides no verified fix.1 issues mergedInput should be a valid string: Codex image history 422Most related issues remain unresolved. Upgrade to cc-switch v3.20.4 and retry. If 422 persists, start a new session or roll back before the image.1 issues mergedOpenCode usage rows never pruned: OpenCodeFix sync logic so the OpenCode session cursor advances despite incomplete messages, preventing historical records from being reinserted after pruning.1 issues mergedSubagent call error: Claude Code PackyAPIRetest after upgrading to 4.0.1 or later; this version fixed a parameter issue when Claude Code calls subagents through Responses conversion.1 issues mergedmaximum context length is 1048565 tokens.Reduce PDF or message input. If the DeepSeek-compatible endpoint does not support PDF, stop uploading it, update CC Switch, and retry.1 issues merged[DISCUSS] Support for pi coding agentThis is a feature request merged into tracking issue #1855; the original post provides no verifiable solution.1 issues mergedDuplicate usage records double consumption - PiWhen Pi uses the cc-switch local proxy, the same request may be charged twice; a verified deduplication fix is still pending.1 issues mergedCC Switch is currently a black box; users cannot customize processing logicThis is a feature request for programmable routing transformation scripts in CC Switch; the original post has no verifiable official solution.1 issues merged401 Unauthorized caused by PROXY_MANAGEDUpgrade to 4.0 or the latest version; use the real API key from the provider configuration for routing.1 issues mergedmodel field is still overridden — Claude Code proxy takeoverUpdate to the latest CC Switch 4.0 release and retry. If it persists, temporarily remove the model fields from settings.json and report the result.1 issues mergedProxy Mode Model Mapping Has No Effect - Claude CodeRetry after upgrading to cc-switch 4.0. The maintainer says the refactor fixed the old model-mapping issue, but this thread has no user verification.1 issues mergedOld Provider API Key Overwrites Current Configuration During Proxy RecoveryUpgrade to v4.0.0 or later; the redesigned local routing no longer restores keys from old backups.1 issues mergedUsage not tracked Claude CodeAfter enabling the proxy in cc-switch, Claude Code usage is tracked.1 issues mergedcontent_block_start events fragmented hundreds of timesUpgrade to the next cc-switch version with b78192e8f; it ignores empty reasoning_content and merges consecutive text deltas.1 issues mergedCannot remove all providers — CodexDisable Codex in cc-switch settings. To keep using it, enable OpenAI Official and sign in to Codex again.1 issues mergedUsing a Codex proxy causes multiple Codex requests for one questionUpgrade cc-switch to v3.16.2 or later; the maintainer said it addresses repeated parsing failures and retries.1 issues mergedunsupported call: — Codex tool call failedNo confirmed fix yet; CC Switch must preserve function_call name and call_id in streaming events.1 issues mergedNo tool output found for tool callNo official fix is confirmed. The reporter describes a local workaround that reorders tool calls and outputs. Follow the main issue for progress.1 issues mergedOptional isolation forced output Claude CodeSet `strict: false` on ordinary function tools during Responses conversion and preserve the existing required fields in `required`.1 issues merged422 format conversion error: Responses upstreamUpgrade CC Switch to a version containing the #7787 fix: upstream unavailability will be reported as 502 (UpstreamError), rather than wrapped as 422.1 issues mergedmodel xxx not found: Codex API Key overwrittenUpgrade to a later version containing the #6534 fix to prevent other providers' keys from overwriting the current provider during editing.1 issues mergedimage_detail is invalid: Codex StepFun Screenshot Request FailureUpgrade CC Switch to v3.20.4; it changes tool screenshot detail: "original" to the StepFun-accepted "auto".1 issues mergedInvalid parameterUpgrade to CC Switch 4.0 or the latest version and retry. If it still fails, submit complete reproduction details and logs.1 issues mergedbaseurl error or 401: Codex's base_url is overridden by the routing addressThe configuration write behavior changed in CC Switch 4.0. If the issue persists after upgrading to 4.0, provide the version and reproduction steps.1 issues merged429too many requests, CodexA 429 occurs when using a third-party Responses API, but the original post does not provide a verifiable solution.1 issues mergedCannot start normally: window unresponsive, system requires force quitUpdate CC Switch to 4.0 or the latest version and retry. If it persists, provide the full version, steps, logs, and screenshots.1 issues mergedModel does not support text/event-stream, CodexUpgrade to cc-switch v3.16.4 and override the Accept request header in Codex advanced settings with a value accepted by the upstream.1 issues mergedNormal requests and Sessions are all counted as CodexUpgrade to v3.15.0 for the confirmed duplicate-counting fix; occasional Codex(Session) entries may still occur.1 issues merged[USG-001] 记录使用量失败: {e}：cc-switchMove the full usage calculation and SQLite write to spawn_blocking, and use a bounded retry queue for failed writes.1 issues mergedInput should be a valid string: Codex image requestUpgrade CC Switch to v3.20.4; it converts image `detail: "original"` to a value accepted upstream.1 issues mergedEnvironment variables not written: VS Code Claude pluginCheck VS Code `settings.json` for Claude environment variables; if present, comment them out and reopen Claude.1 issues mergedvscode Claude Code plugin cannot switch configuration immediately - Claude CodeThe VS Code Claude Code plugin cannot use a proxy or hot-switch; start cc from the terminal CLI for changes to take effect immediately.1 issues mergedWarmup request downgraded to modelSet the Copilot optimizer's `warmupDowngrade` to `false` to prevent warmup requests from being rewritten to the unavailable `gpt-5-mini`.1 issues mergedLocal proxy port failure: Codex routing errorAfter upgrading to 4.0, sync the configuration and switch to routing mode so CC Switch generates a Codex address using the local listening port.1 issues mergedcmd.exe console window flashesUpdate to 4.0 or the latest version and retry. If it persists, submit the version, system details, reproduction steps, and logs or screenshots.1 issues mergedUpstream 404: Claude Code-hosted xAI OAuth Grok billing queryUpgrade to a version containing commit `15d5dbe` to fix the Grok billing query for the hosted xAI OAuth Provider.1 issues merged

Import and sync97

cc-switch import / cloud sync failures: foreign keys, read-only database, overwritesUpgrade cc-switch and avoid syncing provider_health or a read-only db; after picking a file, click 导入 (Import) rather than 保存 (Save).34 issues mergedNo MCP servers configured. Claude CodeEnable MCP servers one at a time to find the unusable configuration, then disable or remove it and reload Claude Code.20 issues mergedcc-switch Skills management problems (duplicates, not detected, deleted repos returning, inconsistent state)Most Skills problems are fixed in later versions: v3.18.0 stops deleted default repos returning; v3.13.0 improves installed-Skill detection and dedup.18 issues mergedcc-switch update check fails / update install failsUsually insufficient permissions or GitHub network trouble. Install as administrator or use the portable build, or download manually from GitHub Releases.17 issues mergedsettings.json config lost after switching providersUse the "Shared Config Snippet" feature to extract and preserve custom fields like hooks/statusLine so they are carried over automatically on switch.15 issues mergedcc-switch Skills Import/Sync Issues (Invalid, Unrecognized, Out of Sync)Most issues stem from Skills directory changes or a DB/filesystem mismatch. Manage Skills through the cc-switch UI, upgrade, and check nested and plugin…11 issues mergedSwitching providers resets claude settings.json - Claude CodeBefore switching, extract the current provider’s configuration in “General Configuration” and select “Write to General Configuration” for the new provider.11 issues mergedMCP stdio connection failure: cmd /c wrapper prevents Claude Code from connectingOn Windows, if editing MCP configuration introduces a cmd /c wrapper and causes connection failure, check the generated command and args, then upgrade to a…10 issues mergedtruncation_policy.limit hardcoded to 10000 limits CodexIn cc-switch, manually set truncation_policy.limit in cc-switch-model-catalog.json to the model's actual context length as a temporary fix.9 issues mergedcc-switch: two of the five default MCPs fail to addInstall missing `uvx` and `mcp-server-time` dependencies (`pipx install uv`, `pipx install mcp-server-time`), then re-add the MCP.8 issues mergedskills installed to the wrong path - cc-switchOlder cc-switch installs skills into ~/.claude/skills/skills, which Claude Code ignores. Upgrade, or move the contents up to ~/.claude/skills/.8 issues mergedCodex conversations with third-party models frequently stop automaticallycc-switch loses function call name/call_id during Responses API conversion. Connect DeepSeek directly to Codex, or upgrade cc-switch and retest.7 issues mergedCodex provider writeback resets live UI settings from configUpgrade to cc-switch v4.0 or later. Provider switching updates only key fields and preserves the rest of ~/.codex/config.toml.7 issues mergedCodex config.toml Overwritten by CC Switch, Plugins and Settings LostUpgrade to cc-switch v4.0.0; it removes full backup restoration and replaces only key fields when switching, preserving other Codex settings.7 issues mergedCodex shows no model list and will not switch modelsTurn on keeping the official login when switching to a third party in cc-switch, and make sure you signed in to official ChatGPT in Codex once.6 issues mergedGemini CLI session history will not display - Gemini CLIGemini CLI 0.39.1 changed the history path. With the consumer service being retired, the old path will not be fixed — wait for Antigravity CLI support.5 issues mergedManually edited MCP configuration files are overwritten by cc-switchEdit MCP settings in cc-switch and upgrade to v3.13.0+; use “Common Configuration” to share settings.json plugins/hooks across providers.5 issues mergedCommon Issues After Upgrading cc-switchUpgrade to v4.0 or later; most sync, switching, and display issues from older versions are fixed.5 issues mergedSystem folder picker opens on every click cc-switchRemove the pickDirectory() call from handleOpenTerminal in src/App.tsx to stop the folder picker from opening whenever you click to open a terminal.4 issues mergedCodex Desktop project list disappears or reasoning levels are reduced - CC Switch configuration issueMost related issues remain unresolved. After upgrading CC Switch or switching providers, changes to Codex’s model_provider field can make project history…4 issues mergedThe cc-switch Claude config is overwritten - Claude CodeSign out of the official account in cc-switch and clear the login state to restore your developer mode proxy config.4 issues mergedCannot import providers, cannot manage sessions - cc-switchUpgrade cc-switch for jsonc config support. Under WSL2, clone the database to a local Windows path on a schedule to work around SQLite locking.4 issues mergedskills synced to apps I did not select - OpenCodeUpgrade cc-switch to v3.12.3 for the implicit inference bug fix, and turn off reading skills from the .claude directory in OpenCode settings.4 issues mergedSkill not loaded correctly - cc-switchcc-switch only recognizes directories containing SKILL.md; manually extract the skills subdirectory from marketplace structures for loading.4 issues mergedSkill source directory missing SKILL.md; Claude Code skill installation failsIf installation reports missing SKILL.md, check the repository structure and confirm SKILL.md is in the resolved skill directory.4 issues mergedFailed to authenticate: Claude Desktop gateway token invalid — ClaudeSign out of the stale official account session in Claude Desktop and restart the app. If the error persists, switch to the default provider and then switch…3 issues mergedConversations gone after switching to another provider in CodexSwitch back to the provider used when the sessions were created to view their history; there is no confirmed fix for syncing sessions across providers.3 issues mergedSymlink creation failed: cc-switch skill sync error or target app cannot see skillOn Windows, symlink creation requires administrator privileges or Developer Mode; run cc-switch as administrator. Hermes/Pi have separate path and scanning…3 issues mergedMCP configured and Claude code selected, but not configured in ClaudeCodeUpgrade to the latest CC Switch 4.0 and sync again. If it still fails, save the MCP configuration once and provide logs.3 issues mergedopenclaw.json is not valid JSON - OpenClawAdd double quotes around the models key in ~/.openclaw/openclaw.json by hand to fix the strict JSON parse failure.3 issues mergedprotocol handler not registeredOn Linux, change Exec to cc-switch %U in the CC Switch.desktop file so Chromium browsers recognise the import protocol. For WSL sync, check admin rights.3 issues mergedAgents panel still retains the session entry (status shown as stale) - Claude CodeUpdate to the latest CC Switch, delete the session again, and check. If the ghost entry remains, add the version, reproduction steps, and logs, then reopen…2 issues mergedConfig file sync delay: CC Switch cloud sync directoryAfter upgrading to 4.0, try built-in WebDAV / S3 cloud sync. If you still use a third-party cloud drive directory, retest and report the drive, version, and…2 issues mergedCannot restore from existing provider auth: Codex auth.json missingUpgrade to v3.13.0 if local auth.json is missing but provider auth exists. Empty auth in sync or SQL exports has no verified fix.2 issues mergedurl is not supported for stdio, CodexUpgrade to v4.0.0 or later, then resync the servers on the MCP page to clear the old type field.2 issues mergedunknown configuration fieldRemove the `type` field from the Codex MCP configuration; an unfixed cc-switch will write it back during the next sync.2 issues mergedX-OpenAI-Internal-Codex-Responses-LiteComment out the custom provider model_provider setting and return to the built-in openai provider; alternatively, temporarily switch to gpt-5.4.2 issues mergedSession expired: Codex OAuth session expiredUpgrade to cc-switch v4.0.0 or later to prevent old snapshots from overwriting new login credentials.2 issues merged[GEMINI-SYNC] Never Appears in the Log: Gemini CLIUpgrade to cc-switch v4.0.1; this version fixes Gemini CLI `.jsonl` session file detection and incremental record parsing.2 issues mergedAbsolutePathBuf deserialized without a basemacOS Codex Desktop users can set model_catalog_json in config.toml to the absolute path of the model catalog file.2 issues mergedS3 HEAD bucket failure: 404 Not Found (CC Switch)Upgrade to 4.0 or the latest version and retry; older versions append the bucket again when the endpoint already contains it, causing an incorrect request path.2 issues mergedCannot re-import: Claude Code local skillUpgrade to cc-switch 4.0 and retry. If it still fails, provide the version and error details, then reopen the issue.2 issues mergedWebDAV MKCOL failed: 400 Bad RequestNo verified fix is available; NAS suggests using PROPFIND to check whether the directory exists after an MKCOL 400.2 issues mergeduv trampoline failed to spawn Python childIf this Hermes detection error persists after upgrading to v3.16.1, provide reproduction details; the issue has no verified fix yet.1 issues mergedCC-Switch Cannot Recognize Antigravity Sessions, Token Statistics Are 0This is an unresolved feature request; no merged and verifiable solution is available yet.1 issues mergedCrash on Launch: CC Switch Windows Startup CrashReproduce on the latest version and provide the CC Switch, Windows, and WebView2 versions, along with the latest logs and Event Viewer error details.1 issues mergedSome historical sessions disappeared in CodexIncrease Claude Code's cleanupPeriodDays and use claude --resume to check whether .jsonl sessions remain on disk.1 issues mergedVery many 500 requests in Claude CodeThe original post has no verified solution. Restore the previous Claude Desktop configuration and follow the source discussion.1 issues mergedtotal_cost_usd = 0: Claude CodeAdd pricing for claude-opus-5-5 to the model_pricing seed data to prevent imported request costs from being recorded as $0.1 issues mergedCloud Sync Runs Automatically the First Time the App Opens Each DayUpgrade to 4.0 or the latest version and retest. If it persists, reopen the issue with complete steps, logs, or screenshots.1 issues mergedauth.json Is Force-Replaced, Making Codex UnusableUpgrade to a later version that includes the fix. Before upgrading, disable Codex takeover, sign in to official ChatGPT, then re-enable takeover.1 issues mergedCodex config import missing auth_modeUpgrade to cc-switch v4.0 or later; when switching to a third-party provider, the Key is written to config.toml, so there is no need to add auth_mode manually.1 issues mergedCodex Provider switching fails: unable to resolve account IDCopying codex_oauth_auth.json from device A to device B restored switching for the user. This is a temporary workaround; no official fix is recorded.1 issues mergeddrops non-provider Codex settings: Codex deep-link import drops fieldsUpdate CC Switch to v4.0.13, then re-import the Codex deep link to preserve safe general settings while link parameters manage the connection and key.1 issues mergedAfter saving, the Codex config file still shows flashUpgrade to v3.17.0 or later and explicitly select deepseek-v4-pro in the “Default model” field.1 issues mergedStill includes `disable_response_storage = true`No verified fix is available. A PR proposes removing disable_response_storage from generation paths, but its merge or release is unconfirmed.1 issues mergedconfig.toml and auth.json not switching together — CodexUpgrade to CC Switch v3.16.1 or later; reports indicate the v3.16.1 pre-release resolved this issue.1 issues mergedConfigured models not visible - CodexSign in to Codex with an official OpenAI account, retain the official login when switching providers, resave, and restart. Some API Key users report no fix.1 issues mergedCustom configuration overwritten before extraction: Claude CodeIn 4.0, switching providers after upgrading preserves plugins, hooks, permissions, and other content in settings.json.1 issues mergedprovider_endpoints.url Still Requests the Old AddressAfter changing the Codex provider’s base_url, set provider_endpoints.url to the same new address to restore the model list.1 issues mergedProvider card and config.toml out of sync CodexMost related issues remain unresolved. Upgrade CC Switch from affected 3.20.4 and retry switching; if it persists, retain logs and configuration evidence.1 issues mergedCodex history list can become completelyKeeping `sqlite_home` and migrating the provider bucket in the active SQLite database can restore visible Codex history.1 issues mergedCodex CLI startup error: Codex cross-platform sync of Windows MCP pathsUpdate CC Switch to the latest version and retest. If the error persists, add logs and resubmit; the original issue did not confirm a fix.1 issues mergedUnable to import deep link ccswitchClaude Code on Windows v3.16.1 reported being unable to import this deep link; the original post provides no verifiable solution.1 issues mergedCustom fields lost after saving: configuration rebuilt to default template CodexNo verifiable solution is available. This duplicate report should be followed through the main issue's fix progress.1 issues mergedpermissions.deny Overwritten Entirely Claude CodeUpgrade to cc-switch v4.0.0 or later; when switching providers, other settings.json content is preserved as is.1 issues mergedDeleted provider remains in tray and switching silently failsNo verified solution is available. Residual tray entries and env in ~/.claude.json can make provider switching appear successful but have no effect.1 issues mergedUnable to switch providers through CC Switch in Claude DesktopThe issue appears to be on the Claude Desktop client or provider side; CC Switch cannot fix it at its root.1 issues mergedNo gpt-5.6 Price in CC Switchgpt-5.6 had not been released at the time, so CC Switch had no price available to enter or display.1 issues mergedDeep-link import drops multi-model configuration — Grok BuildTo keep multiple relay models in `/model`, manually add the extra `[model.*]` tables to `~/.grok/config.toml`.1 issues mergedTop-level model.provider not updated for Hermes DesktopThis report was closed as a duplicate. No verifiable solution was provided; track root-cause issue #5142.1 issues mergedHermes Provider Not Synced to config.yaml - Claude CodeAfter enabling Hermes, copy its provider configuration from the CC Switch database to config.yaml and add the API key and base_url.1 issues mergedHang When Switching Lightweight Mode, CC SwitchUpgrade to 4.0 or a newer version and check whether the hang still occurs. If it does, provide the triggering action, version, and relevant logs.1 issues mergedLocal custom skills do not update Claude Code after updatesThe original post reports that cc-switch-managed local custom skill updates do not sync to WebDAV; no verifiable solution is provided.1 issues mergedmcode session usage import: model stays unknown, latency stays 0, and pricing failsNo confirmed user-side fix is available; update the importer to backfill model and latency from telemetry or session data.1 issues mergedhaiku and sonnet model IDs not synced in Claude CodeUpgrade CC Switch to `3.14.1`; it fixes one-click setup not syncing haiku and sonnet model IDs.1 issues mergedDirect models must use Sonnet / Opus recognized by Claude DesktopThis is an unresolved feature request: direct-connection validation does not allow the `mythos-` prefix, with no verified solution provided.1 issues mergedexperimental_bearer_token = "PROXY_MANAGED"Upgrade to CC-Switch v3.16.2 or later. If it persists, sign in to Codex OAuth again and reopen the report as requested.1 issues mergedMultiple cc-switch.db Files When Syncing OneDrive Across DevicesSimultaneous database writes from multiple devices during OneDrive sync can create conflict copies; no verified fix was provided.1 issues mergedtoggling Send User-Agent silently removes every unrelated custom headerDo not toggle Send User-Agent in the OpenClaw provider editor; upgrade and wait for a fix, as the switch replaces or deletes the entire headers object.1 issues mergedBlank or missing model names in /models — OpenCode v2Remove empty name fields from the OpenCode configuration to restore names. Saving again in CC Switch brings the issue back; no official fix is documented.1 issues mergedOMO Configuration Cannot Add Custom subagents - OpenCodeAs a temporary workaround, write all configuration in “Other fields”, but this overwrites the UI configuration above.1 issues mergedinvalid config structure - OpenCodeFix the update order: save the database row only after the OpenCode live configuration is written successfully; keep the original record if writing fails.1 issues mergedOpenCode V2 Usage Collection Stops UpdatingUpgrade CC Switch to a version containing the PR #7541 fix so the collector reads OpenCode V2 tables.1 issues mergedPi provider list omits channels configured through /loginThe Pi /login channels report remains open. No verified solution is available; read-only display in CC Switch is only a proposal.1 issues mergedCannot run cc-switch after renaming the user folderThe maintainer attributed this issue to the client or provider; no verifiable fix steps were provided.1 issues mergedClaude Code missing from installed plugin configurationThis report has no verifiable solution. Follow the fix progress in primary issue #3631.1 issues mergedUI freeze in Sessions ManagementUpdate CC Switch to v3.14.0, which uses session-list virtualization and collapses long messages by default.1 issues mergedSkill description still shows old content in Claude CodeAfter manually editing SKILL.md, Claude Code reads the new content, but cc-switch does not refresh the installation-time metadata snapshot in its skill list.1 issues mergedSkill updates silently overwrite local changesBack up local changes before updating; the proposed fix will exclude locally modified Skills from “Update All.”1 issues mergedSkills remain as copies after automatic import, CC SwitchAutomatic import copies Skills to `~/.cc-switch/skills/` and does not delete the source directory in `~/.agents/skills/`.1 issues mergedInstalled Count Mismatch, Missing Skill Directories, Claude Code SkillsOn the Skills page, check whether the directories for installed entries still exist; remove stale records or rescan the directories before syncing.1 issues mergedskills.zip has too many entriesUpgrade the device responsible for downloading or restoring to v3.20.4 and try again; the skills.zip entry limit is now 30,000.1 issues mergedImport Stuck for About 30 MinutesUpgrade to CC Switch 4.0.13 and retry the same SQL. If it still hangs, record the file size, wait time, and logs, then report back.1 issues mergedUsage configuration disappears after a while (cc-switch)Upgrade to v3.16.3; this version retries transient query failures and retains the last successful result.1 issues merged400 model provider error Claude Code pluginAdd the environment variables required by the current provider to VS Code’s claudeCode.environmentVariables setting so the plugin can read them.1 issues mergeddl1-v6.aliyundrive.cloud Claude Code WebDAVNo verifiable fix was provided. The maintainer is tracking this issue under issue #1856.1 issues merged

UI and interaction75

Opening cc on Windows 11 gives a process but no window - cc-switchOn Windows 11, try Windows 7 compatibility in the exe properties. If that fails, use cc-switch-cli to bypass the Tauri 2 GUI white screen.31 issues mergedcc-switch installation failure: dependency conflict, insufficient permissions, and antivirus false positivesOn older Linux, use a community build for missing dependencies; on Windows, install to AppData if permissions are insufficient;11 issues mergedProvider switch not taking effect / Codex request failed (cc-switch)After switching providers such as DeepSeek in cc-switch, upgrade cc-switch and use its enable/save action as the sole way to write live configuration; do not…7 issues mergedMiniMax usage not showing; test script reports “no result returned” (cc-switch)MiniMax changed its balance endpoint, breaking the old parser. Upgrade to cc-switch v3.16.2 or later; older versions can temporarily use a custom query…6 issues mergedKaspersky virus detection deletes ccswitch — Gemini CLIAdd CC Switch to the security allow list in Windows security software, then use Gemini CLI.6 issues mergedeither event handler is re-entrantOn Windows, try WebView2 parameters if enterprise security software conflicts; the reports provide no generally verified fix.5 issues mergedModel list is empty; Codex cannot select the DeepSeek modelUpgrade to CC Switch 4.0 and reapply the DeepSeek preset; model list display in the Codex desktop app also depends on its version support.5 issues mergedweb_search field deleted: cc-switch rewrites Codex config and manual changes are lostcc-switch rewrites Codex config.toml/auth.json from its database on switch or launch, wiping unmanaged manual fields; upgrade and use "Common Config"… (AGENTS)5 issues mergedClaude Code /context Shows 200K Instead of 1MIn Claude Code, run /model claude-opus-4-8[1m], or set ANTHROPIC_DEFAULT_OPUS_MODEL to claude-opus-4-8[1m] in ~/.claude/settings.json.5 issues mergedTroubleshooting cc-switch Upgrade Failures, Freezes, and Display CorruptionUpgrade cc-switch: v3.16.3+ fixes update freezes, v3.20.0+ detects winget-installed Claude Code, and v4.0 refactors upgrades. Upgrade winget installs manually.5 issues mergedMain Window Not Visible; Process Appears Only in Task ManagerUpgrade to 4.0 or the latest version. If no interface appears, report it with the system version, reproduction steps, logs, and screenshots.4 issues mergedauth.json not updated after switching channelCodex authentication mechanism refactor causes switching to fail. Check auth.json path and configuration per the official authentication retention guide.4 issues mergedJSON parse error: expected value at line 1Upgrade cc-switch to fix JSON corruption from concurrent writes, and add custom fields to general config so a switch cannot overwrite them.4 issues merged401 Unauthorized: Incorrect API key providedCodex via CC Switch to DeepSeek returns 401; manually add http_headers auth headers (Authorization: Bearer or x-api-key) in the config file.3 issues mergedOnly 258k context in codex - CodexOnce cc-switch maps a minimax model onto gpt-5.5, the hard-coded Codex and Claude Code context limits apply and the 1M context is lost.3 issues mergedOfficial account balance information suddenly missing in CodexUpgrade to the latest version, which reworked quota display in 4.0, and check again. If it is still missing, provide the version, login method, plan type…3 issues mergedending with a leaked `</t` close-tagCaused by the cc-switch streaming converter not deduplicating and not filtering think tags. Update to a version containing the PR #6319 fix.3 issues mergedThe Add Provider button disappeared in cc-switchMaximize or widen the window. If the button remains obscured in an older version, upgrade to v3.19.2 or v4.0.6.3 issues mergedWhen the key is `limit`, the input field clears automatically in OpenCodeBecause the cc-switch interface treats `limit` as reserved, edit opencode.json directly to configure model context and output limits.3 issues mergedConfiguration UI FlickeringUpgrade cc-switch to fix flickering from async form loading; read SQLite DB to fix env vars not updating with providers.3 issues mergedNo skill found in the ZIP file (it must contain a SKILL.md)Upgrade cc-switch to v3.16.2 or newer, and delete the old directory by hand before importing a Skill of the same name.3 issues mergedSymlink target not found: .DirIcon broken symlink causes - CC SwitchAppImage install fails due to broken .DirIcon symlink. Fix by converting it to a relative path.2 issues mergedCodex CLI failure: CC SwitchUpgrade cc-switch to v3.16.3 or later to fix blockers in local environment detection and the upgrade flow.2 issues mergedRouting State Switch Failed: Claude Configuration File Does Not ExistIf .claude is missing, run Claude Code once to generate the configuration before enabling routing. Upgrade to v3.16.2 if the message only shows {{detail}}.2 issues mergedClaude Code ignores the model switch in an old windowA Claude Code session already open does not pick up a model switch in cc-switch. Close and reopen the window, or use the new model in a new window.2 issues mergedOpening a terminal does not use the complete configurationExtract through the "shared configuration" panel and tick write, so a full overwrite does not lose plugins and other shared config.2 issues mergedauth.json reuses the previous provider’s key, CodexUpgrade to cc-switch v4.0.6 or later. Codex switching logic will prevent the new provider from reusing the previous provider’s key.2 issues mergedYour input exceeds the context window errorThe session context is too long for the model limit. Compact the context by hand or set an auto compact window.2 issues mergedGateway rejected model "claude-haiku-4-5"Enable routing based on the API type; for 火山方舟 Responses API, use the full URL and set `isFullUrl=true` to prevent the path from being appended again.2 issues mergedThe Gemini CLI reading the project .env breaks cc-switchWrap the gemini command in PowerShell to load the ~/.gemini/.env environment variables by hand.2 issues mergedNo Plans Displayed (Parsing Returns Empty) - Claude CodeUpgrade to cc-switch 4.0; the 3.19.1 usage template may no longer apply.2 issues mergederror code is 2503: CC Switch installation failureWhen error code 2503 occurs, try the NSIS -setup.exe installer; this issue thread does not confirm that the method works.2 issues merged503, Connection Failure, or Timeout - Codex Local RoutingUpgrade to CC Switch 4.0 or the latest version, then re-enable local routing or “Keep Official Login.” If it persists, submit versions, logs, and screenshots.2 issues mergedClaude Code opens a folder selection dialogThis is by design for selecting the Claude Code terminal working directory; select the relevant project folder, then open the CLI.2 issues merged'/d' is not recognized as an internal or external command: Claude CodeOn Windows, first avoid choosing a Chinese working directory; the issue is not confirmed fixed, so verify the actual directory after startup.2 issues mergedMain Window Never Appears; CC Switch Fails to Start on WindowsCheck Windows updates and WebView2 arguments first; the issues do not confirm a general fix for all cases.2 issues merged“Homepage Not Responding” — Codex Fails to Add a Blank Configuration FileUpdate CC Switch to the latest version and retry; reproduction details are insufficient, and no fix has been confirmed.1 issues mergedWhy is the value of ANTHROPIC_BASE_URL empty? Claude CodeThis is expected behavior: CC Switch does not inject variables into the shell; check the current configuration in `~/.claude/settings.json` directly.1 issues mergedfinish_reason: "stop" and no tool_calls, CodexThe original post provides no verifiable solution; the issue was reported only in the cc-switch and Codex Chat Completions conversion chain.1 issues mergedRoute classifier requests to another provider in Claude CodeThis is an unresolved feature request; the original post provides no verifiable user-side configuration solution.1 issues mergedCannot Read the Model List Correctly in Claude CodeThis issue concerns an older configuration that changed with cc-switch 4.0. If it still occurs after upgrading, report the version and reproduction steps.1 issues mergedBash(...) Waiting... Claude CodeDowngrade Claude Code to v2.1.104 or v2.0.64 (admin required), or switch to a compatible provider such as Alibaba Cloud Bailian.1 issues mergedClaude Code no longer hot-reloads settings.json after switching providersRestart Claude Code after switching so it reads settings.json again; clash-for-ai can avoid this limitation.1 issues mergedModel switching does not take effect, Claude CodeBack up important information, then click `reset` in CC Switch. The maintainer recommends upgrading and trying again after the 4.0 configuration-writing…1 issues mergedClaude Code exits whenever the window size changesUpdating the relevant upstream component restored window resizing; the reporter confirmed the upstream update resolved the issue.1 issues mergedShared MCP not working? CodexUpdate to the latest CC Switch and share Claude MCP again. If Codex still cannot see it, provide the version number and the mcp_servers section from…1 issues mergedYour access token could not be refreshedLog out and restart the computer, or end the Codex process and sign in again so Codex uses the latest authorization.1 issues mergedUnable to switch Codex App to API access modeUpgrade to CC Switch 4.0 or the latest version, then switch to a third-party provider and sign out of Codex App.1 issues mergedCodex desktop app asks to log in again after restart - CodexUpgrade CC Switch from 3.16.0 to v3.16.2 or later to avoid overwriting Codex OAuth authentication when switching providers.1 issues mergedDefault 1M Context Causes 422, CodexUpgrade to v4.0; context window and other model parameters are filled in automatically when adding or pulling a model.1 issues mergedConfigured service tier `priority`Temporarily editing the model catalog can restore Priority requests, but regeneration overwrites it; no verified permanent solution is available.1 issues mergedIcons are too small, driving perfectionists crazy. CodexThis issue has no confirmed solution; a comment suggests enlarging the icon locally.1 issues mergedContext Window Information Missing When Enabling Routing in CodexCodex loses context window information after routing is enabled; the issue provides no verified fix.1 issues mergedClicking “Add” has no response, CodexEnter a non-empty `OPENAI_API_KEY` in `auth.json (JSON)` before adding, then change it back to `{}` afterward; the maintainer plans to remove this validation.1 issues mergedEnvironment variable conflict dialog cannot be closed - Claude CodeNo verified solution is documented for this issue; the report concerns cc-switch v3.17.0.1 issues mergedDetected System Environment Variable Conflict; CC Switch Interface ObscuredUpgrade to 4.0 or later. The environment variable conflict notice becomes a page banner with options to dismiss it and view conflicting variables.1 issues mergedEmpty display, no sessions. Gemini CLIUpgrade to a CC Switch version that includes .jsonl session-reading support to display sessions from the newer Gemini CLI.1 issues mergedWindow icon displays the generic “wayland” placeholder icon (orange W)On KDE Wayland, name the installed desktop file cc-switch.desktop so it matches the window app id.1 issues merged“About” page hangs: Linux cc-switch tool detectionUpgrade to cc-switch 4.0; the maintainer says it substantially changed configuration switching and the interface, and many related problems no longer occur.1 issues mergedClicking “Edit” freezes Claude CodeOn Linux, switch to the deb package, or fix the GTK input-method cache in AppImage to prevent fallback to XIM.1 issues mergedInput field cannot gain focus / cannot enter OpenCodeThere is currently no confirmed fix. In Linux Wayland and NVIDIA environments, the app freezes after entering an edit page.1 issues mergedTop-right close, maximize, and minimize buttons do not work: cc-switch LinuxOn Wayland, open “Settings → General → Enable app-level window buttons” to use window buttons drawn by the app.1 issues mergedWebView2 GPU process GPU usage rises abnormally after enabling local routing CodexThis issue was fixed in #5767. Wait for a later release; if it still occurs, reopen the issue and report it.1 issues mergedClosing to tray saves main window state as 1×1, then reopens tinyDelete or rewrite the abnormal window state file, then restart; PR #7604 fixes hidden windows being saved as 1×1.1 issues mergedCannot open the app after Loading, cc-switch PortableThe original post does not provide a verifiable solution; see the issue's follow-up discussion.1 issues mergedModel does not respond, Claude CodeDelete all providers, then set the same model for the same provider to restore Claude Code conversations.1 issues mergedSearch clears, preset list reopens when adding a provider in cc-switchUpgrade to cc-switch 4.0; search for and select a preset before opening the form.1 issues mergedClaude Code context full before 256kNo verifiable solution is available. The report shows an error at about 117.9k context and inability to /compact.1 issues mergedSession expired: still appears after logging in again — CodexThe original post has no verified solution yet; follow the issue discussion if the session still appears expired after logging in again.1 issues mergedCodex history becomes blank after switching configurationRetry after upgrading to CC Switch 4.0 or later; if the issue persists, provide the version and before-and-after model_provider values.1 issues mergedWhite flash when switching tabs, CC SwitchThe issue may be related to a WebView2 153.x update. If it continues after upgrading to CC Switch v4.0, provide the version and reproduction steps.1 issues mergedError 2147942402 (0x80070002) — Claude CodeRecheck after upgrading to CC Switch v3.16.1 or later on Windows; temporarily set PowerShell as the preferred terminal.1 issues mergedcc-switch keeps opening detection windows when checking local codexWindows CLI detection causes windows and processes to pile up. The issue provides no verifiable fix; a timeout is only a user request.1 issues mergedWindow Size Overflows to 65535×53251, CC Switch Main Window InvisibleFully exit CC Switch, delete the window state file, and restart to clear the persisted invalid window size.1 issues merged3.15.0 hangs on startup under WSLg: CC SwitchRolling back to 3.14.1 restores normal startup; alternatively, reproduce on the latest version and submit WSL, graphics environment, and startup output details.1 issues merged

Terminal and environment variables37

'claude' is not recognized as an internal or external commandConfigure the full claude.exe path in CC Switch settings, or ensure claude is on the system PATH.31 issues merged'claude' is not an internal or external command, nor a runnable programUpgrade to v3.16.2+ to fix WSL/Windows path detection, or manually configure install directory override.18 issues mergedenv: node: No such file or directoryWhen CC Switch is launched from the Dock/Finder, the GUI PATH lacks the Homebrew directory; upgrading to v3.18.0+ fixes it.7 issues mergedAtomic replace failed — request not supported, os error 50 - cc-switchUpgrade cc-switch to v3.20.0 or newer, which fixes the regression where atomic config file replacement failed on WSL paths.6 issues mergedmodel does not support thinkingTurn the Proxy Rectifier off in cc-switch advanced settings, or upgrade to a fixed version. Qwen tool call loops and empty thinking blocks remain unresolved.6 issues mergedCodex/OpenCode shows not installedAdd the npm prefix or fnm alias directory to the user PATH environment variable, then restart CC Switch.6 issues mergedRestarting the terminal and running gemini asks for an api-key - Gemini CLIUpdate cc-switch for the save-clears-config bug. If it still fails, that is a Gemini CLI read bug — put the environment variables in bash_profile.5 issues mergedWSL path configured but skills are not read - cc-switchWindows cc-switch cannot read or install WSL ~/.agents/skills. Install and run the Linux build of cc-switch inside WSL instead.5 issues mergedNot installed / not installed or not executable - CC SwitchUpgrade CC Switch to v3.20.0+ for custom npm prefix and macOS detection failures; the false "several installations" on Windows needs v3.16.5+.4 issues mergedzsh:1: command not found: claudeUpgrade cc-switch to v3.16.4 or newer, fixing PATH not loading when the terminal launches, or switch to the system default terminal for now.4 issues mergedenv: node: No such file or directoryUpgrading cc-switch to v3.18.0 or newer fixes the environment variable resolution failure caused by a stripped PATH in the GUI.4 issues mergednot installed or not executable - OpenCodeUpgrade CC Switch to v3.11.0+ for the path detection fix, or symlink opencode into ~/.local/bin by hand.4 issues mergedUnkonw coding plan provider - cc-switch VolcengineUpgrade cc-switch to v3.20.0 or newer, then recreate the Volcengine Agent Plan provider or fix its Base URL.4 issues merged`GLIBC_2.35' not foundNo confirmed compatible release exists from v3.10.1–v3.16.1. Try v4; if it still fails, report the version and reproduction steps.3 issues merged<tool_use_error>InputValidationErrorAn SSE parsing bug in the cc-switch conversion layer loses tool calls. Connect to the API directly, or switch to an official node, for now.3 issues mergedLocal Claude CLI installed but Settings says it isn'tUpgrade CC Switch to v3.16.5 or later to fix false installation conflicts and garbled paths on Windows.3 issues mergedWhy is the model the claude command uses in a plain terminal different from the one in cc-switch?Set the MiniMax you want as the primary model and run claude from a cc-switch terminal. Without takeover on, the mapped name is not a substitution.2 issues mergedNo such file or directory (os error 2)Change the model_catalog_json absolute path in config.toml to the relative cc-switch-model-catalog.json, or upgrade cc-switch.2 issues mergeddoes not run on macOS versions other than Monterey: CC Switch installation failureRun `brew update` and retry. If the cask is still locked to Monterey, change the macOS condition to `>= :monterey`.2 issues mergedinvalid_request_error Kimi For CodingSet ENABLE_TOOL_SEARCH=false in the Kimi configuration in cc-switch.2 issues mergedNo endpoints available that support Anthropic - Claude CodeUpgrade Claude Code to v2.1.92+ and update cc-switch to fix OpenRouter parameter errors, or disable the local proxy.2 issues mergednot found(404) adding Claude Code desktop model APIUpgrade to v3.16.3+ to fix connectivity detection false positives, or ignore the 404 and test actual calls directly.2 issues mergedWindows Explorer opens to the "Documents"On Windows, Open Terminal opens Documents instead of a terminal. A suspected cause and suggested fix exist, but no solution has been verified.2 issues mergedANTHROPIC_AUTH_TOKEN and ANTHROPIC_API_KEYRun `claude daemon stop --any` to stop lingering Claude background processes, then restart and resume the session.1 issues mergedModel automatically switched to haiku cc-switchBuilt-in Claude Code behavior: haiku reads files. cc-switch only manages environment variables and does not change model selection.1 issues merged/branch sessions: parent session hard to find in Session ManagerTry claude --resume or claude -r <sessionId> as the proposed workaround. The original post provides no verifiable Session Manager fix.1 issues mergedOpen sessions continue using a third-party ANTHROPIC_BASE_URLSet legacy ANTHROPIC_* keys to empty strings in the official provider configuration's env, then switch back to the official provider.1 issues mergedAfter switching, opening codex still uses the old account — CodexAfter switching OAuth accounts, fully restart the Codex background service. For CLI, run `codex app-server daemon stop`, then reopen Codex.1 issues mergedDisabled MCP takes effect again in CodexThis issue currently has no confirmed fix; if the problem persists, reopen the issue to continue tracking.1 issues mergedThere Should Not Be Such a Huge Number of unknown Model Requests — CodexRetest on CC Switch 4.0.13. If many unknown requests remain, reopen the issue with the version, system, reproduction steps, and logs.1 issues mergedCopilot subscription model mapping not applied, still calls Claude modelsThis is a known bug in cc-switch v3.14.1. Upgrading to v3.15.0 fixes the issue where Copilot subscription model mapping is not applied.1 issues mergedMCP Configuration Differences Across CLI Tools, CodexThe same MCP service uses different configuration formats and parameters in Codex and Claude; no verified solution has been provided.1 issues mergedConfiguration Not Applied: Claude Code WSL Routing Config Not UpdatedSet the configuration directory to the file path used inside WSL in CC Switch Settings > Advanced. If the issue persists after upgrading to 4.0, provide…1 issues mergedNo models displayed after opening pi - piPoint CC Switch’s Pi configuration directory to the WSL `~/.pi/agent` path. The reporter confirmed that models appeared again.1 issues mergedClaude Code verification required when entering ClaudeIn Windows WSL, write the rule that skips Claude Code’s initial confirmation to the corresponding JSON; the maintainer confirmed the issue was fixed.1 issues mergedCannot start cc-switch; cc-switch --version produces no outputThe maintainer recommends reinstalling first; if it still cannot start, try the CLI version. Recovery was not confirmed in the original post.1 issues mergedCannot detect conversation history and usage statistics? Claude CodePoint the Claude configuration directory to the WSL path; route Claude Code in WSL through the cc-switch gateway for usage statistics.1 issues merged

Environment variables21

Config not applied: MCP not imported and environment variables overwrittencc-switch overwrites wholesale. Extract hand-edited config into 通用配置 (general config), import MCP by hand, and tick the write-general-config option.11 issues mergedbuilt-in provider IDs: openai - CodexUpgrade CC Switch to v3.16.4+, delete the old config and save again. Enable unified Codex session history and use openai_base_url.3 issues mergedAfter setting CODEX_HOME, Codex saves configuration to the wrong locationNo verified universal fix was provided. Set the Codex configuration path manually; direct ${xxx} environment-variable reading is unsupported.2 issues mergedLocal Environment Check Fails: Claude Code / Codex / OpenCodeOn Windows, upgrade to CC Switch v3.16.1 or later. The Ubuntu report linked only a fix PR and provided no verification result.2 issues mergedauth becomes {}, API Key lost - cc-switch CodexIf ~/.codex/auth.json is missing, saving the active Codex provider clears auth.OPENAI_API_KEY in the DB. Restore the key before saving or avoid saving.1 issues mergedProvider add failed: Claude Desktop direct provider missing ANTHROPIC_BASE_URLThe original post only reports this error. A comment suggests proxy environment variables, but this is unverified; continue monitoring the source Issue.1 issues mergedRemote Control requires claude.aiUpgrade to cc-switch v4.0 or later; switching to Claude Official clears leftover ANTHROPIC_* credentials from settings.json.1 issues mergedOfficial account not displaying normally in the codex lower-left corner - CodexThe original post provides no verifiable solution; follow the main issue #3566 referenced by the maintainer.1 issues mergedAPI key is empty: cc-switch DeepSeek balance queryUpgrade to v3.16.1 or later and verify again. The original issue did not confirm the fix.1 issues mergedStill an api-injected key, CodexAdd and switch to the official provider in preset providers, then sign out of Codex and sign back in with the official account.1 issues mergedLocal environment check displays the jDK version, cc-switchThe original post does not yet provide a verifiable solution; this report was marked as a duplicate. Follow the main issue for fix progress.1 issues mergedcc-switch keeps auto-deleting my environment variables OpenClawWhen an environment variable conflict prompt appears, close the window directly; the maintainer states that closing the window does not delete environment…1 issues mergedBad request (400) Claude CodeUpgrade CC Switch to v3.16.3; the new health check treats HTTP 400 as provider reachability.1 issues mergedHermes environment variables cannot be deleted - Claude CodeCheck Hermes's config.yaml and remove the relevant configuration; this user-comment suggestion was not verified in the original post.1 issues mergedLocal qwen3-coder model connection fails with 502 errorClaude Code requires Anthropic Messages; use a format-conversion proxy such as LiteLLM between cc-switch and the local model.1 issues mergedOpenAI Responses streaming text is duplicated in terminal events Claude CodeTemporarily avoid duplicate output by changing the provider API Format to OpenAI Chat Completions (`openai_chat`).1 issues mergedModel api configuration mix-up CodexThe original post provides no verifiable solution; follow #4108 for fix progress.1 issues mergedThe editor does not clearly distinguish the “local routing address” from the “third-party provider upstream address”.Configure Claude Code's local routing address separately from the upstream OpenAI-compatible provider address to avoid saving the local address as upstream.1 issues mergedConfigured environment variables seem ineffective, Claude CodeAfter removing cc-switch, manually clean up local configuration as needed; session records in `~/.codex` are unrelated to cc-switch.1 issues mergedenvironment variable cleanup fails - CodexThe original post recommends parsing the line number from the final colon to preserve complete shell configuration file paths containing colons.1 issues mergedSelf-update check fails and latest model versions show as unknown - Claude CodeUpdate CC Switch to the latest version and retry; related functionality was refactored in 4.0, but the fix was not confirmed.1 issues merged

Usage and balance41

cc-switch Usage Query Not Showing / Query FailedUpgrade to the latest version; enable official account usage manually, check supplier script endpoints and HTTPS. Balance display issues have been fixed since…22 issues mergedCodex Subscription and API Quotas Used SimultaneouslyUpdate CC Switch and Codex to the latest versions; version 4.0 rewrote Codex provider switching to prevent official login credentials from being sent in…2 issues mergedcodex(session) usage statistics exceed my actual usage - CodexUpgrade CC Switch to v3.19.2, then run “Rebuild Codex Usage” once on the “Usage Statistics” page.2 issues mergedThird-party codex api connected, but the official plan is exhausted—CodexUpdate to CC Switch 4.0 or the latest version. If the balance warning remains, provide reproduction details and logs, then reopen the issue.2 issues mergedUsage statistics are massively inflated, CodexUpgrade to cc-switch v3.18.0 or later, then rebuild Codex usage on the usage page to fix double counting.2 issues mergedUnable to resolve apiKey and baseUrl variablesUse `{{ apiKey }}` or `{{baseUrl}}` in the custom usage query template and verify that `isValid: false` is treated as a failure.2 issues mergedWhen current usage is 0 and weekly usage is not 0This is a confirmed GLM usage-display bug. The original post said it was fixed, but no verifiable fixed version was provided.2 issues mergedInvalid schema for function 'web_search'Upgrade cc-switch to v3.17.0 or later. If upgrading is not possible, use the native DeepSeek Anthropic-compatible API.2 issues mergedCodex usage anomaly: tokens consumed during Claude conversationsClosing Codex App reportedly restored normal usage statistics as a temporary workaround. The root cause and an official fix remain unconfirmed.1 issues mergedClaude Desktop keeps timing outThe original post has no verified solution; users reported the settings.json suggestion in comments was ineffective.1 issues mergedNo Usage Data After Archiving a Task in CodexUpgrade to 4.0 or later, which imports and counts archived Codex session logs.1 issues merged会话已过期: Codex authorization refresh fails in Claude CodeUpgrade cc-switch: a Windows user confirmed a fix in 3.15.0. If it persists in v3.16.2 or later, reopen the original issue with details.1 issues mergedUsage statistics fail to record forked child-session usage - CodexNo confirmed fix exists for 3.20.3; wait for cc-switch to fix usage tracking between forked child sessions and the parent rollout.1 issues mergedCodex keeps consuming tokens even with no sessions or tasksThe Codex idle-usage thread suggests disabling an unnamed feature shown in a screenshot, but provides no verified solution.1 issues mergedUsage Limit reached — Codex third-party provider quota exhaustedThis issue report says setting `requires_openai_auth` to `false` for a third-party provider may prevent Codex from checking official account quota and… (API)1 issues mergedcodex usage statistics still seem incorrect: local usage far below CPANo verifiable fix is available in the original report. The user reports local Codex usage still far below CPA after updating to v3.18.0.1 issues mergedThe free quota has been exhausted. CodexThe report of Codex still using the old model after switching has no verified fix in the original thread. Follow the source discussion for updates.1 issues mergedUnable to Change Models After Switching Relay When Quota Runs Out - CodexMost related issues remain unresolved. Retest after upgrading to the latest version. If the problem persists, provide the Codex version, a redacted config.toml…1 issues mergedOpenAI Official shows blocked and cannot switch to official quota — CodexTurn off Codex proxy mode in the upper-left corner of cc-switch. The reporter confirmed this resolved the official provider's blocked status.1 issues mergedOpenAI Official usage displayed incorrectlyOpenAI Official usage is zero while Codex (Session) shows a value. No verified solution is available in the issue yet; follow further discussion.1 issues mergedCodex database routing metadata lost during backfillUpgrade to cc-switch v4.0.0; backfill was removed, and switching now replaces only key fields.1 issues mergedButtons All Grayed Out and Cannot Send: Codex DesktopNo confirmed fix. Verify the request path and protocol, enable local routing, and test a new session; official quota status may still limit Desktop.1 issues mergedSwitching between multiple codex accounts shows incorrect quota - CodexThe maintainer confirmed v3.16.5 fixes quota queries using the previous account after switching providers. Upgrade to that version or later and verify again.1 issues mergedUsage query shows two results: CodexAfter upgrading to 4.0 or later, check the Codex subscription quota again; if the issue persists, provide a text description, version number, and screenshot.1 issues mergedCodex Session Usage Not Applying the Default Cost Multiplierv4.0.0 removed the default cost multiplier; after upgrading, adjust the corresponding model price directly in the usage statistics pricing table.1 issues mergedCodex usage statistics failureAfter Codex updated to 26.917.51856, GPT-6 Sol usage statistics may remain at 0; the issue provides no confirmed fix.1 issues mergedAll queries fail: reproducible Claude Code Coding Plan balance queryUpgrade cc-switch from 3.16.1 to v3.16.2 or later, then query the GLM Coding Plan balance again.1 issues mergedHow to check Coding Plan usage? GLM Coding PlanEnter the URL and Authorization from a browser request in cc-switch usage queries, then parse the quota percentage as shown.1 issues mergedGLM 5-hour and 7-day remaining quotas are displayed in reversev3.15.0 reports swapped quota displays; the original post provides no verifiable fix.1 issues mergedGLM Team Plan usage query fails in Claude CodeUpgrade to v3.17.0 or later, then enter the organization ID and project ID in the 「Zhipu GLM Team」 template.1 issues mergedOnly the Last Logged-in Codex Account Is RetainedAuthentication for multiple official accounts in the same ChatGPT Team overwrites each other. No verifiable fix was provided; follow main issue #2245.1 issues mergedOnly under the OpenCode agentUpdate to v3.16.4 or later to use OpenCode Go presets with API Key-only configuration in Claude Code, Claude Desktop, Codex, and OpenCode.1 issues mergedStill counted toward GPT official account quota; Codex keeps official loginWith official login retained, official plugins and remote features still run through the official account; the official side counts their usage.1 issues mergedgetTimezoneOffset() returns -8 instead of -480Avoid local-time API on Windows; use timestamp differences or toISOString()/getUTC*, and wait for cc-switch to fix it.1 issues mergedCache hit rate for the current request of an individual queryUpgrade to v4.0.14, then select the request log “Hit Rate” column under “Settings” on the Usage page.1 issues mergedCodex key abuse after opening CodexThe original report only describes suspected abnormal calls; no verifiable fix or virus file location was provided.1 issues mergedSwitch back to your official CodeX account and use its quotaAfter adding the official provider, sign out in the Visual Studio Code Codex extension settings and sign in again.1 issues mergedUsage query failed cc-switchThird-party APIs require you to adapt the query script yourself; Claude officially does not support usage queries.1 issues mergedForm content is overwritten by the last entry when editing, cc-switchThis was a fixed cc-switch frontend issue; the original post did not state the specific version containing the fix.1 issues mergedUnknown coding plan provider - Claude CodeUpgrade to v3.20.0 so the Agent Plan `/api/plan` endpoint is recognized correctly.1 issues mergedUnkonw coding plan provider Claude CodeUpgrade to v3.20.0+ and recreate the old Agent Plan provider, or change its Base URL to /api/plan.1 issues merged

Config not applied18

Configuration overwritten, Claude Code manual settings lostRead “Why did my plugin configuration disappear?” in the cc-switch README. If using v4.0, upgrade and provide the version and reproduction steps if the issue…2 issues mergedProvider configuration issue, CodexAfter switching providers, restart Codex, then try opening the original session; the configuration writing method changed significantly in v4.0.2 issues mergedUnified Codex Session History Not Working: Sessions Do Not MergeUpgrade to cc-switch v4.0.0 or later and enable “Unified Codex Session History” so official and third-party routes share a history group.2 issues mergedHermes does not take effect; configuration must be copied manuallyOn Windows, upgrade to v3.16.5 or later. This version makes CC Switch write to the configuration directory actually read by Hermes.2 issues mergedMinimax configuration overwrittenUpdate cc-switch to the fixed version to resolve the issue where Minimax configuration is incorrectly overwritten during switching.2 issues merged1M Context Configuration Not Taking Effect Claude CodeRevert the Opus route in the cc-switch database from claude-opus-4-8 to claude-opus-4-6, then restart Claude Desktop.1 issues mergedOpenAI Chat Completions model not working, Claude CodeRetry after upgrading to 4.0. If the issue persists, provide the provider API format, local routing status, and relevant logs.1 issues mergedsettings.json Is Fully RewrittenPut retained Claude Code project settings in `.claude/settings.local.json` to avoid loss when cc-switch overwrites user-level `settings.json`.1 issues mergedSwitching Claude relay sites loses previous setting configuration — Claude CodeNo verifiable solution was provided; this request is tracked in main issue #3631.1 issues mergedSwitching Does Not Take Effect for Claude Code for VS CodeTry enabling “Apply to Claude plugin,” but users in the issue reported that it still did not work. No verifiable solution is available.1 issues mergedKeep official login has no effect; Codex shows API loginUpgrade to cc-switch v4.0.0 or later; this version changes how Codex configuration is written to prevent third-party provider keys from replacing official…1 issues mergedcodex startup_timeout_sec cannot be set manually (Codex)Do not use CC Switch to manage Codex MCP instances that require a custom startup_timeout_sec for now.1 issues merged5.6sol 1m context change does not take effect - CodexThere is no maintainer-confirmed cause or fix, so it is unclear whether gpt-5.6-sol supports a 1m context.1 issues mergedEvery Click Causes an Error in Claude CodeWhen a duplicate key is reported, the original post provides no verifiable fix; check the duplicate key indicated by the message.1 issues mergedSwitching to Grok Official clears config.tomlUpgrade to 4.0. The maintainer said the new version preserves other settings in config.toml.1 issues mergedhooks configuration lost: cc-switch switches providersWrite hooks required by all providers into “General configuration”, and select it when editing configurations.1 issues mergedPreviously selected item remains selected after switching - cc-switch PiAfter switching cc-switch Pi configurations, the previous selection remains retained; the original post provides no verifiable solution.1 issues mergedbaseUrl: Required Claude Desktop configuration not appliedWindows MSIX Claude Desktop must read 3P configuration from its Packages virtualization directory; the compatibility fix is currently only an submitted PR.1 issues merged

Model list26

apikey无权限或失效 - Claude Code Model List RetrievalUse curl to verify `/v1/models` access. Remove spaces or a `Bearer ` prefix from the Key; if the endpoint is unavailable, enter the model name manually.5 issues mergedGLM 未找到可用模型 - Codex / CC SwitchUpgrade to cc-switch v3.20.4 and re-add the GLM provider from the preset with https://open.bigmodel.cn/api/v1 for Codex.4 issues mergedCodex Desktop model list is empty and cannot be selectedFollow the official login-state instructions in #4420; a user reported that models became selectable again.2 issues mergedConfiguration panel jitter, model list flickering wildly: CC SwitchRetest after upgrading to 4.0; if flickering persists, record the affected area, version, and system details, and attach a screen recording.2 issues mergedCannot read the model list when adding a providerThis is a feature request for automatically fetching the model list; the original posts do not provide a verifiable solution.2 issues mergedClaude Desktop model selector cannot display the model listThe Claude Desktop model list is controlled by the client. cc-switch local routing cannot make the developer-mode dropdown display models.1 issues mergedSettings reset to CC Switch values in Claude DesktopMost related issues remain unresolved. Upgrade to the current main build containing 81df5a08 or a later release, then retry switching providers.1 issues mergedCodex CLI 0.156.0 does not refresh custom provider model listThe issue is caused by the Codex client or provider and cannot be fixed by CC Switch; try upgrading to 4.0 and, if it persists, submit the version and…1 issues mergedModel Does Not Support Image Input and Blocks Image Reading - CodexUpgrade CC-Switch to v3.17.0 and resave the provider configuration. If an alias remains text-only, temporarily edit the catalog and report it.1 issues mergedEditing a provider does not show model ClaudeThis is a known BUG. The maintainer is working on a fix; no verifiable workaround was provided in the original post.1 issues merged“获取模型列表失败” Claude CodeUpdate to 4.0 or the latest version and retry. If it still fails, provide the version, system, full reproduction steps, and logs or screenshots.1 issues mergedWhy doesn’t the fetched model list appear after fetching succeeds? CodexClick “Add model” to create a row first, then click “Fetch model list” and select a model from that row’s dropdown.1 issues mergedVendor name displayed as model name, Grok buildConfigure multiple independent models as shown in the issue example, and set the default model and reasoning level in `[models]`.1 issues mergedJieKou AI users currently need to configureThis is a feature request to add JieKou AI provider presets; the original issue does not yet provide a verifiable user-side solution.1 issues mergedLocal routing uses a hardcoded default model (Claude Code)Upgrade to cc-switch 4.0; the maintainer said many related issues may no longer exist after major configuration changes.1 issues mergedUnable to fetch modelsAfter upgrading to v3.16.4, fetch models again. If it still fails, add the provider, error text, or logs to the original issue.1 issues mergedNo auto-detect model option in latest Ubuntu version? cc-switchUpdate cc-switch to v3.12.0 or later; Stream Check is restored and model auto-detection should work on Ubuntu.1 issues mergedinput_modalities contains only text: Codex cannot read imagesManually adding image to input_modalities reportedly enables image recognition, but switching models resets it. No verifiable lasting solution is available.1 issues mergedModel list error: Codex model list does not match the providerMost related issues remain unresolved. Retest after upgrading to the latest Codex configuration-writing logic. If it persists, provide… (/.codex/config.toml)1 issues mergedModel test always returns 404: CodexUpdate to the latest version and test again. If it still returns 404, record the version, provider, API address, and request path from the logs for…1 issues mergedThis provider does not support fetching the model list CodexMake `models` entries compatible with `slug` and `id` so they do not affect valid `data` field parsing.1 issues mergedMulti-model switching for provider code plans in Claude Code and CodexAfter starting cc, use `/model model-name` to select the model.1 issues mergedFailed to fetch models after changing key; connectivity speed test failed - CodexAfter switching internal networks, restart cc-switch to restore the model list and connectivity test; also update to the latest version and retry.1 issues mergedCodex model not displayed, CodexThis is a personal reflection on living with BUG; the original post provides no verifiable solution.1 issues mergedRequests keep failing after configuring a relay — Claude CodeEnable routing from the top bar, then apply it to Claude. “Enable full URL” does not enable routing. The reporter confirmed this fixed the issue.1 issues mergedChanged files cannot show diff below. CodexDo not automatically fetch 火山方舟 Coding Plan models. Manually use deepseek-v4-flash, then restart Codex and CC Switch.1 issues merged

Update and upgrade7

macOS cc-switch version detection error / freezeModify the fastfetch call in .zshrc to add a [[ -t 1 ]] check for non-interactive output.16 issues mergedConfig changes in the GUI have no effect at allOMO v4.19.3 moved config to ~/.omo/omo.jsonc, so cc-switch writes to a dead path. Edit the new config file by hand, or upgrade cc-switch.4 issues mergedAutomatic upgrade fails; reinstalling still shows old Codex versionNo verified solution yet. #3156 suggests uninstalling and reinstalling; #7080's version-detection issue remains unconfirmed.2 issues mergedunexpected status 403 ForbiddenDisable 'Keep Official Login' in CC Switch and restart to stop Codex from sending image gen requests causing 403 errors.2 issues mergedLocal Codex is up to date, but CC Switch detects an older versionUpgrade to the latest CC Switch, then check the version, install location, and source shown for Codex on the “Applications” page.1 issues mergedFill in the API Key for an unofficial provider - Claude CodeUpgrade to cc-switch 4.0 or later. If the API Key field is still missing, provide the version, provider type, and a screenshot.1 issues mergedClaude Code crashes on launchThe original post has not provided a verifiable fix. Follow the subsequent handling in Issue #2923.1 issues merged

Provider management8

All app page elements disappear when adding a provider in cc-switchOn macOS 12.2, cc-switch 3.16.x goes blank when adding a provider; upgrade to macOS 12.7.6 or use cc-switch 4.0+.13 issues mergedAdd CoderPlan provider preset for Claude CodeFeature request: add a CoderPlan provider preset to cc-switch. A Claude Code preset PR exists, but merge status is unconfirmed.4 issues mergedAdding a provider fails: crypto.randomUUID is not a functionUpgrade to cc-switch v3.9 or newer, which adds a crypto.randomUUID fallback for older macOS; or upgrade macOS past 12.3 Monterey / 11.6.5 Big Sur.4 issues mergedThe model cannot discover any tools - CodexUpgrade cc-switch past 3.16.1 and edit cc-switch-model-catalog.json to set supports_search_tool to false for the DeepSeek models.3 issues mergedReasoning Level Not AdaptedRe-add the OpenCode Go preset after upgrading to get the correct reasoning_effort config.2 issues mergedapi.tbox.cn is inaccessible - Claude CodeAfter upgrading to v3.20.4, change an existing BaiLing base URL to api.ant-ling.com, or add it again from the preset.1 issues mergedModel does not support image input CodexAdd an image-input modality declaration for GLM-5.3-Flash to avoid inheriting a model configuration containing only ["text"].1 issues mergedBlank screen when adding a providerUpgrade to CC Switch 4.0.13. If it persists, report it again with the version, system environment, reproduction steps, and logs.1 issues merged

thinking field6

thinking type should be enabled or disabledThird-party APIs require thinking param as enabled/disabled. Fix via env var CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1 or alt+t toggle.2 issues mergedunexpected status 404 Not Found: Unknown error - CodexChange the DeepSeek official API request URL to one that includes `/v1`, then send the request through Codex again.2 issues mergedcontent[].thinking must be passed backTemporarily disable automatic updates and downgrade Claude Code to 2.1.150; the original post did not confirm a cc-switch fix.1 issues mergedUnable to switch reasoning effort and image input in Codexv3.16.5 resets model catalog capabilities to defaults; editing the catalog is temporary and may be overwritten after switching.1 issues mergedUnsupported content type: redacted_thinkingWhen Claude Code is routed through Codex/GPT, this error has been marked as a duplicate issue; the issue provides no confirmed local fix steps.1 issues mergedAllow multiple Codex global promptsThis is an unresolved feature request: concatenate multiple enabled Codex global prompts in a stable order.1 issues merged

Skills12

All installed skills lost - Claude CodeUpgrade to v3.13.0 or later and verify; if skills are still lost after restarting Claude Code, reopen the issue with version and reproduction info.2 issues mergedClaude Code Skills not detected: plugins directory structure not supportedAdd scanning for unmanaged Skills installed through Claude Code plugins and parse their manifests; this issue remains open, and the fix is unconfirmed.1 issues mergedDeleted preconfigured repository reappears: cc-switch Skill repositoryComments say the issue was fixed by #5356 and merged into `main`; follow the release status of that fix.1 issues mergedHermes Agent cannot discover skills in subdirectoriesThis is an unresolved feature request. The original report suggests recursive scanning, but no verified solution is available.1 issues mergedHermes Agent still reads its own skillsThe original post provides no verifiable solution. Upgrade and re-project; if it persists, report the actual directories, system, and Hermes version.1 issues mergedUnable to pull complete skill - Claude CodeThe maintainer said the relevant capability had been added, but no version or verifiable steps were provided.1 issues mergedSkills cannot be foundThe original post does not yet provide a verified solution; follow the later discussion in Issue #4221.1 issues mergedcc-switch: Skill installation says the skill directory does not existWhen installing a Skill on Windows reports that the directory does not exist, no verified fix is available; v3.16.2 did not resolve later reports.1 issues mergedSkill does not exist in SSOT: autoplan - Claude CodeRetest after upgrading to 4.0. If the message still appears, provide autoplan's source, version, and relevant logs.1 issues mergedSkillClaw as a shared skill lifecycle layerNot a fault; this integration proposal was closed after prolonged inactivity. If still relevant, add current details and reopen the issue.1 issues mergedskill.sh gstack installation fails - Claude CodeReported on Windows with cc-switch 3.13.0; the maintainer said it was fixed, but gave no verifiable steps or fixed version.1 issues mergedSkill does not appear: Claude CodeUpgrade to cc-switch 4.0 and reinstall the skill. If it still fails, add system details and reproduction steps, then reopen the issue.1 issues merged

Network and timeout6

Wrong model called / stop: cancel task, CodexAfter upgrading to 4.0 or the latest version, try again. Version 4.0 rewrote how Codex configuration is written to prevent the wrong model from being called…2 issues mergedtimeout error with the API linkThe maintainer suggested trying cc-switch v4.0; if the issue persists after upgrading, provide the version and reproduction steps.1 issues mergedPrivate dir leaf redirectsNo verified fix is available in the original report. The error screen suggests restarting from an earlier message, but no success has been reported.1 issues mergedUnable to connect: Codex connection issues on macOSNo verifiable solution is available. Specific errors and reproduction steps are needed; the issue's closed status does not prove it was fixed.1 issues mergedUnable to Establish Connection (DNS / Connection / TLS / Timeout) Codex LinkfoxRetry configuring Linkfox API after upgrading to cc-switch v4.0. If it still fails, provide the version and reproduction steps when reporting it again.1 issues mergedOpenCode extra-option edits change untouched string values into JSON valuesIn cc-switch 3.20.4, saving an OpenCode provider converts unmodified strings in Extra SDK Options to JSON values. Upgrade to a version with the fix.1 issues merged

Context window4

Still shows 1M after switching to a non-1M model, Claude CodeRetest on the latest CC Switch; if it still shows 1M and cannot auto-compact, submit the model configuration and actual model ID.1 issues mergedContext compression keeps failing — CodexUpdate CC Switch from 3.17.0 to the latest version and retry. If it still fails, provide system details, reproduction steps, and logs or screenshots.1 issues mergedcache_read=0/128 - Claude CodeNo verified fix exists for cache-read drops under concurrent requests. Keep concurrency at 1 for now and follow the original issue.1 issues mergedThe generated catalog falls back to `128000`Explicitly set a context window for GPT-5.6 models to avoid falling back to `128000` when none is configured.1 issues merged

Launch crash / blank screen5

assertion failedUpgrade cc-switch to the latest version for the underlying GUI framework crash fix, or try closing proxy software and resetting the network.3 issues mergedFailed to initialize gtk backend cc-switchRunning cc-switch in a headless environment (a server or container) errors for lack of GTK. Use the cc-switch-cli command-line build instead.2 issues mergedClaude Code shows a white screencc-switch may not start on older systems. On Windows, update to 24H2; on macOS, try the maintainer-recommended CC Switch CLI.2 issues mergedCannot Open Codex or Claude Code After DEB Install on deepin23No verifiable solution is available in the original post. Follow the main discussion in #3133 for repair progress.1 issues mergedCC Switch Windows opens to a black screen and crashes after a few secondsWait for a later version that disables Overlay on Windows; the original issue provides no verifiable current fix.1 issues merged

Install and packaging1

Installation reports missing libwebkit2gtk-4.1.so.0 cc-switchOn Rocky 9, the RPM installation fails because a webkit dependency is missing. Upgrade the system to Rocky 10.1 to resolve it.5 issues merged

Login and auth2

Still requires login to chatgpt: CodexRetest after upgrading to CC Switch 4.0; third-party provider configuration should be written to Codex's config.toml.2 issues mergedCodex account still appears logged in after signing outThe cc-switch 4.0 interface and configuration writing behavior have changed. If the issue still recurs after upgrading, provide the version and reproduction…1 issues merged

Other63

cc-switch installation, update, and startup issue collectionThis issue cluster mixes installation, update, startup, and other failures. The available evidence cannot confirm a single fix for the whole page.53 issues mergedThere's an issue with the selected modelUpgrade CC Switch, restart the target tool, and start a new session so local routing strips the [1m] suffix and rematches the mapping.42 issues mergedCodex auth.json overwritten, KEY mix-up, or official login lostUpgrade cc-switch to the latest version (v3.16.1 fixes the v3.16.0 KEY mix-up regression; v3.20.1/4.0 fix logout overwriting auth.json and losing… (Codex)30 issues mergedsettings.json configuration lost after switching providers (cc-switch)Extract shared fields into “Common Configuration” and enable writing them for each provider; v3.12.2 fixes the proxy-related BUG.29 issues mergedConfiguration Not Applied or Lost After Switching ProvidersUpgrade cc-switch to v3.16.2+ (v3.18.0 fixes nvm path detection). Put custom settings in “通用配置” to prevent overwrites; Linux save failures require v3.11.1+.28 issues mergedCodex switching DeepSeek model error or only showing customEnable local routing and ensure Codex is logged into the official account to generate models_cache.json, restoring the model list.24 issues mergedconfig.toml content was reset in Codex (cc-switch)Upgrade to v4.0.0+: older versions overwrote the entire config.toml, losing MCP and projects settings. Newer versions replace only key fields and preserve the…17 issues mergedWork browser access requires an authenticated accountLog in to the official account in the Codex/ChatGPT app with auth_mode=chatgpt, then use cc-switch routing mode (or keep official login in direct mode) to…13 issues mergedcc-switch provider management: cannot delete, or adding failsMostly UI limits or version bugs. The last provider cannot be deleted; for input and delete failures, upgrade or turn the feature off.10 issues mergedCodex model catalog template `gpt-5.5`Run `codex debug models --bundled > ~/.codex/models_cache.json` to generate the missing model cache, then switch the Codex route again.10 issues mergedcc-switch usage statistics anomalies: 0/200K, double billing, pricing that will not deleteUpgrade to v3.16.3 for zero tokens, v3.17.0 for better Codex derived-session dedup, and v3.19.0 for deleted built-in pricing returning.9 issues mergedThere's an issue with the selected modelCheck the model name and provider config in cc-switch. The model test is unreliable — go by an actual request.8 issues mergedcc-switch Codex session history missingDisable Codex routing or unified history in cc-switch, make model_provider match old sessions, then restart Codex to restore history.7 issues mergedQwen model errors or truncation - CC SwitchUpgrade to CC Switch v3.16.4 and use the matching new Qwen / OpenCode Go presets.5 issues mergedcc-switch login and auth config cannot be entered or deletedUpgrade to v3.17.0 or newer: the Google OAuth misdetection and the legacy-provider gating that hid the API key field are both fixed.4 issues mergednot installed or not executableUpgrade CC Switch to v3.16.2+, or set the CLI install directory by hand in settings, and clear noise printed by your shell at startup.4 issues mergedcc-switch window display anomalies - UI rendering problemsUpgrade to a version with the UI fixes. Address bar overflow and rendering problems are fixed; the title bar background colour awaits a later fix.4 issues mergedGeneral config ignored - cc-switchUpgrade to cc-switch v3.12.2+, where general config fragments persist across a restart. As a stopgap, turn general config off and write the JSON directly.4 issues mergedCodex unavailable: reconnect failed 5 timesAfter switching providers, verify and re-enter the current provider's API Key; API Key overwrite reports continued in v3.16.3.4 issues mergedDeepSeek usage statistics show the wrong cost / cache hit rateUpgrade to v3.16.3+, fixing input double-counting on the chat→message conversion path, streaming without usage, and wrong model billing attribution.4 issues mergedA default Gemini config appears and cannot be deleted - CC Switchdefault is the expected provider CC Switch creates by importing your existing live config. Switch the current provider in settings first, then delete it.4 issues mergedUnknown parameterTurn the cc-switch unified session history switch off and move sessions tagged custom back to openai, fixing the namespace parameter error.4 issues mergedI clicked both the msi and the exe and nothing happensLaunch the installer as administrator from PowerShell. If it still fails, uninstall the old version first, or use the portable build.4 issues mergedClaude code does not support gemini - CC Switchcc-switch cannot currently use Gemini as a Claude Code provider — wait for the local proxy feature, or use a third-party proxy project.3 issues mergedskills will not fetch / plugins rolled back - cc-switchUpgrade cc-switch to v3.9.0 for the skills fetch fix. If plugin config is overwritten, back enablePlugins up into a general config fragment.3 issues mergedThe 'deepseek-v4-flash' modelEnable the keep-official-login option in cc-switch, confirm local route takeover is on, then restart Codex desktop.3 issues mergedCalling GLM-5 reports error 1311 - cc-switchA provider permissions problem: enable GLM-5 / MiniMax / Kimi access with your provider, or ask them to confirm your subscription entitlements.3 issues mergedUnsupported parameter(s): prompt_cache_keyUpgrade cc-switch to the latest version, fixing prompt_cache_key not being stripped automatically when forwarding to the Nvidia API.3 issues mergedAPI Error: 400 Invalid request ErrorRoll the Claude Code CLI or VSCode plugin back to an older version (2.1.150 or 145) and disable auto-update to resolve the 400.2 issues mergedConfiguring DeepSeek in Codex errors about gpt-5.5Install the Codex CLI and run codex debug models --bundled to regenerate models_cache.json.2 issues merged没有这个模型: Codex calls the wrong model after route switchingUpgrade CC Switch to v3.16.1 or later, then verify the Codex route and configuration switching again.2 issues mergedAPI Error: 422 format conversion errorThe upstream NVIDIA NIM GLM-5.2 model intermittently returns an empty choices array. Turn on failover in cc-switch or retry the request.2 issues mergedInvalid pages parameter: "" Claude CodeSwitch the API format to anthropic, or upgrade cc-switch to fix the empty pages field from Responses conversion.2 issues mergedUnexpected status 503 Service UnavailableWhen using v2ray, configure its routing to bypass LAN and mainland China domains, then access through CC Switch local routing again.2 issues mergedConstant 429 errors: Claude Code AnyRouter errorConfirm the model mapping is blank and set "model": "opus[1m]"; if 429 errors continue, the issue may be with AnyRouter upstream, so try another network.1 issues mergedUnable to switch between different API: Claude CodeUpgrade to cc-switch 4.0; the maintainer said the new version reworks the interface and configuration writing.1 issues mergedclaude 3.20.4 cache remains 0 - Claude CodeIn Claude Code on Windows, cc-switch 3.20.4 shows cache usage and billing as 0; the issue has no verified fix yet.1 issues mergedsession isn't eligible because yourSet `CLAUDE_CODE_AUTO_MODE_SERVER` to `0` in the `env` of the CC Switch DeepSeek provider configuration, then confirm the key remains after switching providers.1 issues mergedOpus Always Shows opus4.8: Claude Code Local RoutingUpgrade to cc-switch 4.0; the maintainer said this version changed how configuration is written but did not confirm that it fixed the issue.1 issues mergedAPI 400 error when using xiaomimimo token with Claude CodeUpgrade to cc-switch v4.0 and retry. If the error persists, provide the version and reproduction steps when reporting it again.1 issues mergedWebFetch fails to access external URL - Claude DesktopAdd `"coworkEgressAllowedHosts": ["*"]` to the Claude Desktop 3P gateway profile generated by CC Switch.1 issues mergedCannot Find the Authorization Login Entry - Claude DesktopOn first run of CC Switch, migrate the provider from Claude Code, then select the official provider automatically added at the bottom of the list.1 issues mergedLocal environment check shows “not installed” for Codex and HermesUpgrade to 4.0. The maintainer said many related issues no longer occur after major changes to configuration switching and the interface.1 issues mergedCCS cannot detect installed CodexUpgrade to the latest version and check Codex on the “Applications” page. If it is still not detected, provide the versions, which codex, codex --version…1 issues mergedconfig.toml mcp_servers configuration save failure in cc-switchThe original report provides no verified solution. Follow up on or reopen the issue.1 issues mergedAdded model still shows only Astra: CodexMost related issues remain unresolved. Upgrade to the latest cc-switch and save the model mapping again. If only Astra is shown, provide the version… (Codex)1 issues mergedYour access token could not be refreshedUpgrade CC Switch to v3.17.0 or later to fix official ChatGPT OAuth credential issues caused by the takeover route writing a placeholder.1 issues mergedCannot directly use /v1/responses - CodexExtract `access_token` and `account_id` from `.codex/auth.json`, add them to the request headers, then call the API.1 issues mergedAccount does not exist: old UUID CodexUpgrade to v3.20.4, then reselect and save the currently signed-in ChatGPT account in the Codex official provider card.1 issues mergedInvalid schema for functionThe Codex client reports a tool schema validation error. No verifiable fix is available in the original issue yet; follow it for troubleshooting updates.1 issues mergedAPI still connects to OpenAI - CodexDelete the existing configuration, then re-add and fully configure the provider in cc-switch to generate a new configuration.1 issues mergedCannot disable glm-5.2 thinking - CodexSelecting glm-5.2 none thinking mode in Codex still enables thinking; this issue has no confirmed fix yet.1 issues mergedOrigin Returns 502: Claude Code Large-Context Routing ErrorNo fix is confirmed; provide reproducible conditions for the large context to locate the routing error.1 issues mergedMacOS Memory Leak: cc-switchRestarting cc-switch after prolonged use can temporarily restore WebKit.WebContent memory usage; no complete fix has been merged.1 issues mergedText-only: MiMo-V2.5-Pro in Gemini CLIMiMo-V2.5-Pro is text-only. Use mimo-v2.5 instead, or a V2.6 model that supports images.1 issues mergedNew-format conversations are invisible in OpenCodeUpgrade CC Switch to 4.0 to read OpenCode 2.x new-format sessions and V1/V2 sessions in the same database.1 issues mergedv4.1 flash's input doesn't have ["image"]: PiUpgrade to v4.0.0 and add DeepSeek again from the preset, or manually set the model input to ["text", "image"].1 issues mergedCodex delete button disabled and greyThis issue has no confirmed fix; in cc-switch 3.20.4, a disabled delete button can keep an incorrect provider configuration active.1 issues mergedSession Management Page Narrows When There Are No Records, CC SwitchUpgrade to 4.0; the maintainer says the new session management interface no longer narrows when there are no records.1 issues mergedSave Button Disappears and Directory Is Saved UnexpectedlyMake autosave submit only persisted directory values and preserve unsaved directory drafts during settings refreshes and concurrent saves.1 issues mergedSSH disconnects after network manager removal during installation; Ubuntu fails to bootNo verifiable fix is available. The maintainer said there was insufficient information to reproduce the problem and suggested upgrading to 4.0 and adding the…1 issues mergedPlease check WebDAV username/passwordcc-switch masks and clears WebDAV password on write-back. Upgrade to fix; temporarily re-enter password.1 issues mergedApp Won't Open: cc-switch for WindowsTry installing WebView2 Runtime; an issue comment suggested it, but the original reporter did not confirm whether it worked.1 issues merged