--mocks
A Claude Code CLI flag, read out of the shipped bundle. It has been in the build since v2.1.242, including the newest one read.
Plugin evals can swap a plugin's MCP servers for fakes defined in a mocks folder.
Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.242.
In the changelogs
5Releases whose published page names --mocks.
-
v2.1.269
New CLI flags for the plugin-eval command: --trust-plugin and --allow-real-servers
claude plugin evaladds--trust-pluginfor CI and--allow-real-serversto run real MCP servers without mocksfound in this entry's text
-
v2.1.242
plugin evalcan mock a plugin's MCP servers, with docs to matchPlugin evals can swap a plugin's MCP servers for fakes defined in a mocks folder.
named in this entry, found in this entry's text
-
v2.1.242
Eval graders can inspect calls made to mock tools
Eval graders can inspect the calls that hit mock tools during a run.
named in this entry, found in this entry's text
-
v2.1.242
Eval runs fail loudly when managed policy blocks the mock servers
Eval runs stop with a clear policy error when your org's MCP rules block the mock servers.
named in this entry, found in this entry's text
-
v2.1.242
Mocked MCP servers register under the real server name and deny everything else
Mock servers replace real ones by name, allow mocked tools and deny the rest; a mock_calls grader is added.
found in this entry's text
First cited
3The earliest release whose published evidence quoted --mocks was v2.1.242, 24 Aug 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.
Presence across releases
1Build by build
56One row per release since the first build this name was read out of. Absent means the build was read and the name was not in it, never mined means no bundle for that release was ever archived, and a declared type or a default is only ever what that release's own bundle stated.
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the CLI flag does. All CLI flags.