How to use Agent routing?

[techwebsolucao]

Hi everyone, I'm trying to configure the suggestions in my .claude/settings.json file.

However, when I open OpenClaude, it doesn't appear.

{
"agentModels": {
"deepseek-chat": {

"base_url": "https://api.deepseek.com/v1",
"api_key": "sk-your-key"

},

"gpt-4o": {

"base_url": "https://api.openai.com/v1",

"api_key": "sk-your-key"

}

},

"agentRouting": {

"Explore": "deepseek-chat",

"Plan": "gpt-4o",

"general-purpose": "gpt-4o",

"frontend-dev": "deepseek-chat",
"default": "gpt-4o"

}
}

Here's an example, but I don't know how to make it work.

[Vasanthdev2004]

Agent routing is supported, but there are two common gotchas here:

1. the routing config has to live in the settings file OpenClaude is actually reading
2. the model aliases you reference in agentRouting must exactly match keys defined in agentModels

Your example structure looks broadly correct:

{
  "agentModels": {
    "deepseek-chat": {
      "base_url": "https://api.deepseek.com/v1",
      "api_key": "sk-your-key"
    },
    "gpt-4o": {
      "base_url": "https://api.openai.com/v1",
      "api_key": "sk-your-key"
    }
  },
  "agentRouting": {
    "Explore": "deepseek-chat",
    "Plan": "gpt-4o",
    "general-purpose": "gpt-4o",
    "frontend-dev": "deepseek-chat",
    "default": "gpt-4o"
  }
}

What I would check next:

• make sure the file path is exactly the one OpenClaude expects on your machine
• make sure the agent names you route (Explore, Plan, etc.) are the actual agent names available in your build
• restart OpenClaude after editing the settings
• verify your base URLs and API keys are valid for those model aliases

Also, agentRouting only affects agent/model selection once those agents are actually available in the current build and config.

If you want, paste:

• your OS
• where you saved the settings file
• the startup/provider status
• whether you are on latest release or latest main

and we can narrow down why the routing is not being picked up.

[orickmaxx]

Hey man, could you help me out?

I’m having the same issue and I’ve already opened a few chats about it (chat1, chat2, chat3). I know you work hard and have to deal with a lot of people, but if you have some time, I’d really appreciate the help.

Currently, my settings.json looks like this:

{
  "agentModels": {
    "google/gemma-4-31b-it:free": {
      "base_url": "https://openrouter.ai/api/v1",
      "api_key": "key"
    },
    "google/gemini-3.1-pro-preview-customtools": {
      "base_url": "https://openrouter.ai/api/v1",
      "api_key": "key"
    },
    "qwen/qwen3.6-plus": {
      "base_url": "https://openrouter.ai/api/v1",
      "api_key": "key"
    },
    "nvidia/nemotron-3-super-120b-a12b:free": {
      "base_url": "https://openrouter.ai/api/v1",
      "api_key": "key"
    }
  },
  "agentRouting": {
    "Explore": "nvidia/nemotron-3-super-120b-a12b:free",
    "Plan": "google/gemini-3.1-pro-preview-customtools",
    "Write": "qwen/qwen3.6-plus",
    "Review": "google/gemma-4-31b-it:free",
    "default": "qwen/qwen3.6-plus"
  },
  "skipDangerousModePermissionPrompt": true,
  "extraKnownMarketplaces": {
    "obsidian-skills": {
      "source": {
        "source": "github",
        "repo": "kepano/obsidian-skills"
      }
    }
  }
}

Honestly, I have no idea what’s wrong!