Skip to content

Claude

@ask-llm/claude-mcp default opus → fallback sonnet

Bridge Codex CLI, Cursor, OpenCode, or another MCP client with Anthropic's Claude Code CLI. This is the reverse collaboration path of the hero pair: Codex asks Claude here, and Claude asks Codex back through @ask-llm/codex-mcp.

Best for: getting an independent Claude review while Codex or another model is your primary agent. Not for: use from inside Claude Code itself. Claude Code rejects nested Claude sessions, so the unified orchestrator suppresses this provider when Claude Code is the MCP host.

Installation

1. Provider CLI

npm install -g @anthropic-ai/claude-code

2. Register the MCP server (Codex CLI shown; Claude Code cannot host this provider)

codex mcp add claude -- npx -y @ask-llm/claude-mcp

Or install globally: npm install -g @ask-llm/claude-mcp

Prerequisites

  1. Node.js v20.0.0 or higher
  2. Claude Code CLI installed, on PATH, and authenticated

Tools

ToolPurpose
ask-claudeSend a review or analysis prompt to Claude. Supports model, native sessionId, and validated relative includeDirs
get-usage-statsPer-session token totals, durations, and model breakdowns. In-memory
pingVerify the MCP server and Claude Code CLI installation

ask-claude returns human-readable text plus a structured AskResponse containing the response, actual model, native Claude session ID, and token usage when reported by the CLI.

Models

opusquota / rate limitsonnet
When the default model hits quota, the executor retries once on the fallback and reports the actual model used in the response.
  • Default: opus, a stable Claude Code alias for the latest Opus model
  • Fallback: sonnet, passed through Claude Code's native --fallback-model behavior
  • Overrides: ASK_CLAUDE_MODEL, ASK_CLAUDE_FALLBACK_MODEL, or the optional per-call model parameter

Read-only boundary

The provider invokes Claude with:

  • --safe-mode, disabling project customizations, hooks, plugins, MCP servers, and auto-memory
  • --tools Read,Glob,Grep, excluding Bash, Edit, Write, and external tools
  • --permission-mode dontAsk, preventing a headless permission prompt from hanging the MCP call
  • stdin prompt delivery, avoiding command-line length limits and keeping prompt content out of process arguments

Claude can inspect the current workspace and validated relative includeDirs, but the calling MCP client remains responsible for edits.

Native sessions

The JSON response includes Claude's session_id. Pass it back as sessionId on a later call to continue the same conversation through claude --resume without replaying the transcript.

Configuration

VariableDefaultPurpose
ASK_CLAUDE_MODELopusDefault Claude alias or full model name
ASK_CLAUDE_FALLBACK_MODELsonnetNative fallback model
ASK_CLAUDE_TIMEOUT_MS600000Provider process timeout in milliseconds
GMCPT_TIMEOUT_MS(none)Global timeout fallback
ASK_CLAUDE_ALLOW_NESTED(unset)Set to 1/true to override the nested-session guard in IDE integrated terminals that set CLAUDECODE without being an actual Claude Code session

npm

Released under the MIT License.