Tutorial

How to Bridge Claude Code and Codex via MCP

Connect Claude Code and OpenAI Codex as dual coding agents using MCP. Share search tools between both runtimes.

An r/ClaudeCode user runs Codex as orchestrator and Claude Code as performer. The bridge: MCP servers that both agents can call. This tutorial walks the setup for shared search tools.

Prerequisites

  • Claude Code installed
  • OpenAI Codex CLI installed
  • Scavio API key

Walkthrough

Step 1: Install Claude Code MCP server in Codex

Tell Codex to set up the official Claude Code MCP server.

Bash
# In Codex session:
# 'Set up the official Claude Code MCP server'
# Codex will configure the MCP bridge automatically

Step 2: Add Scavio MCP to Claude Code

Both agents can now call the same search tools.

Bash
claude mcp add scavio https://mcp.scavio.dev/mcp --header 'x-api-key: YOUR_SCAVIO_KEY'

Step 3: Add Scavio MCP to Codex settings

Add the same MCP config to Codex.

Text
# In Codex personalization or agents.md:
# MCP server: scavio at https://mcp.scavio.dev/mcp
# Header: x-api-key: YOUR_SCAVIO_KEY

Step 4: Define roles in system prompt

Codex orchestrates, Claude Code executes. Both can search.

Text
# Codex orchestrator prompt:
# 'Use Claude Code for implementation. Use scavio.search for web research.
# When Claude Code needs live data, it has the same search tools.'

Step 5: Test the dual-agent workflow

Ask Codex to research and implement with Claude Code.

Text
# 'Research the current pricing of Helium 10 via scavio.search,
# then have Claude Code implement a price comparison table.'

Python Example

Python
# This is a config-based setup, not Python code.
# Codex orchestrates; Claude Code implements.
# Both call scavio.search for live web data.

JavaScript Example

JavaScript
// Config-based setup across two agent runtimes.
// Both share the same Scavio MCP server.

Expected Output

JSON
Dual coding agent setup where Codex orchestrates and Claude Code implements, with shared Scavio search tools via MCP.

Related Tutorials

Frequently Asked Questions

Most developers complete this tutorial in 15 to 30 minutes. You will need a Scavio API key (free tier works) and a working Python or JavaScript environment.

Claude Code installed. OpenAI Codex CLI installed. Scavio API key. A Scavio API key gives you 500 free credits per month.

Yes. The free tier includes 500 credits per month, which is more than enough to complete this tutorial and prototype a working solution.

Scavio has a native LangChain package (langchain-scavio), an MCP server, and a plain REST API that works with any HTTP client. This tutorial uses the raw REST API, but you can adapt to your framework of choice.

Start Building

Connect Claude Code and OpenAI Codex as dual coding agents using MCP. Share search tools between both runtimes.