Claude Overlay

claude-overlay

[](https://github.com/mzmmoazam/claude-overlay/actions?query=workflow:CI) [](LICENSE) [](https://github.com/mzmmoazam/claude-overlay/releases) [](https://github.com/mzmmoazam/claude-overlay) [](https://github.com/mzmmoazam/claude-overlay) [](https://github.com/mzmmoazam/homebrew-claude-overlay)

Manage project-level [Claude Code](https://docs.anthropic.com/en/docs/claude-code) configuration for custom model providers.

When using Claude Code through a proxy or third-party endpoint — **Databricks**, **Amazon Bedrock**, **OpenRouter**, **LiteLLM**, or others — Anthropic's native WebSearch and WebFetch tools may not work because they rely on Anthropic's own infrastructure. `claude-overlay` solves this by creating a project-level configuration overlay that:

• Routes Claude Code to your custom endpoint
• Replaces native web search with MCP-based alternatives (Tavily + DuckDuckGo)
• Preserves all your existing project settings and MCP servers
• Toggles cleanly between custom provider and native Anthropic modes

Install

Homebrew (macOS / Linux)

brew tap mzmmoazam/claude-overlay
brew install claude-overlay

curl

curl -fsSL https://raw.githubusercontent.com/mzmmoazam/claude-overlay/main/install.sh | bash

From source

git clone https://github.com/mzmmoazam/claude-overlay.git
cd claude-overlay && make install

**Requirements:** bash, python3 >= 3.7, npx (Node.js)

Quick Start

# 1. Configure your provider creden