Skip to content
CC Switch WikiUnofficial Community Wiki

Invalid pages parameter: "" Claude Code

Quick fix

Switch the API format to anthropic, or upgrade cc-switch to fix the empty pages field from Responses conversion.

Symptom

Section titled “Symptom”
Error output
<tool_use_error>Invalid pages parameter: "". Use formats like "1-5", "3", or "10-20". Pages are 1-indexed.</tool_use_error>

Cause

Section titled “Cause”

When using OpenAI Responses API or chat completions format in cc-switch (for example with NVIDIA, Deepseek, or Bailian models), the conversion to Anthropic format incorrectly adds an empty `pages: ""` field to Read tool parameters. The `pages` parameter is only meaningful for PDF reading. For normal file reads, Claude Code validates the empty `pages` field and raises the `Invalid pages parameter` error. Using the `anthropic` API format directly bypasses this conversion logic, so tool calls work normally.

Fix

Section titled “Fix”

  1. In the cc-switch configuration, change the current model's API format from "OpenAI Responses API" or "chat completions" to "anthropic".

  2. Upgrade cc-switch to the latest version containing this fix, or rebuild from source that includes merged PR #2471.

Affected Versions

Section titled “Affected Versions”
ToolClaude Code
Version3.14.1 - 3.15.0
PlatformsWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 2 real issues

FAQ

Section titled “FAQ”
Why does normal chat work, but tool calls fail?
Normal chat does not involve tool calls. Only when the AI tries to use the Read tool to read a file does cc-switch format conversion generate invalid parameters containing `pages: ""`, causing Claude Code to raise the error.
Does this issue affect only specific models?
It is not a model-specific issue; it is an API format issue. Any model using `chat completions` or Responses API format, such as NVIDIA, Deepseek, or Bailian, can hit this issue. Switching to `anthropic` format resolves it.
Section titled “Related problems”
api 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.7 issues mergedThis model is not supported when usingComment out model_provider = custom in config.yaml to go back to the official OpenAI provider.2 issues mergedConsole Go: Upstream request failedThis 400 comes from the OpenCode Go gateway rejecting an incompatible payload. Restart the proxy to restore session mapping, or avoid WebSearch and images.3 issues merged

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.