Routescope APIRoutescope API
Client Tool Setup

Connect Cursor to Routescope

Use Routescope in Cursor by installing the Claude Code extension after configuring Claude Code with CC Switch.

Use your Routescope quota inside Cursor. The setup is graphical and does not require editing configuration files.

Last updated: 2026-07-13

The One-Sentence Idea

The Claude Code extension inside Cursor calls the Claude Code installation on your computer.

So you do not enter an endpoint or secret inside Cursor itself. Instead, configure Claude Code to use Routescope through CC Switch, and the Cursor extension will follow that same Routescope configuration.

What You Need to Do

  1. Use CC Switch to connect Claude Code to Routescope.
  2. Install the Claude Code extension in Cursor.
  3. Open the panel and verify it works.

Step 1: Configure Claude Code with CC Switch

This step is exactly the same as the "Configure Claude Code" section in Connect CC Switch to Routescope. Complete that guide until both of these are true:

  • The Routescope card in CC Switch shows the active/current state.
  • Running claude in a terminal works, and Routescope Operation Records show that request.

If Claude Code itself is not installed yet, the CC Switch guide also explains how to check and install it.

In short: first make Claude Code in the terminal work with Routescope, then return to this page.

Step 2: Install the Claude Code Extension in Cursor

  1. Open Cursor and click the Extensions icon in the left activity bar, or press Ctrl + Shift + X (Cmd + Shift + X on macOS).
  2. Search for Claude Code.
  3. Find the extension published by Anthropic and click Install.

Check the publisher

Make sure the publisher is Anthropic. Avoid installing lookalike extensions.

Step 3: Open the Panel and Use It

  1. After installation, a Claude Code icon appears in Cursor's left activity bar. Click it to open the panel.
  2. Because Claude Code was already configured through CC Switch, the panel automatically uses Routescope.
  3. You do not need to enter an endpoint or secret again. Ask a normal question in the panel.

If the panel asks you to sign in, do not rush through the login flow. Check the troubleshooting section below first.

How to Confirm It Works

Asking the AI to say "connected" is not enough. Confirm the request really went through Routescope:

  1. Send a normal message in the panel, such as hello.
  2. Open the Routescope console and go to Operation Records or Call Records.
  3. Look for a new record from the same time. Confirm the status is successful and the model is correct.
  4. If the record appears, the connection is working.

Troubleshooting

The Panel Asks Me to Sign In, or Routescope Has No Record

The extension has not picked up the Routescope configuration from CC Switch. Do this in order:

  1. Open CC Switch, confirm the selected tool is Claude Code, and confirm the Routescope card is active/current.
  2. Click Enable again if needed.
  3. Fully close Cursor and reopen it. The extension reads configuration at startup, so restarting matters.
  4. Open the panel and test again.

Unauthorized / 401 / 403

This is a key or permission issue. Check whether the secret is complete, the token is disabled or expired, quota is exhausted, the model is allowed by the token, or IP restrictions are blocking the request. These are all checked in the Routescope provider configured in CC Switch.

Model Unavailable

The selected model is not enabled for your account. Go back to the Claude Code provider in CC Switch and change the model to an available Routescope model ID.

Still Not Working

Do not keep guessing. Send support a screenshot of the step where you are stuck, with the secret masked.

References

Last updated on