Gaslamp
a9lim/gaslamp
Ponte MCP bidirecional entre Claude e Codex
Ver no GitHubMCP server minimalista que estabelece ponte bidirecional entre Claude e Codex, permitindo que ambos os CLIs se comuniquem e consultem um ao outro. Funciona como camada de integração para ampliar capacidades de ambas as ferramentas através do protocolo MCP.
Instalação
npx convez-ai a9lim/gaslamp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Consultar Claude a partir do fluxo do Codex
- Estender capacidades do Codex com acesso às ferramentas do Claude
- Automação de workflows que requerem ambos os agentes
Veredito

Projeto técnico sofisticado para usuários avançados que dominam ambos CLIs. Resolve um problema específico (comunicação Claude-Codex) de forma elegante, mas requer setup manual e compreensão profunda da arquitetura MCP.
README
A tradução para o português deste README ainda está na fila.
gaslamp
Minimal MCP server that lets Claude and Codex talk to each other.
Gaslamp wires the two CLIs to each other as plain MCP servers:
| direction | server | tools |
|---|---|---|
| Claude → Codex | codex mcp-server registered in Claude as gaslamp | gaslamp/codex, gaslamp/codex-reply |
| Codex → Claude | this package, registered in Codex as gaslamp | gaslamp, gaslamp-reply |
claude mcp serve only exposes Claude's
tools and a one-shot Agent, not a persistent
conversation, so we need a shim in src/server.mjs.
Requirements
Both CLIs installed and logged in: Claude Code and Codex. Node ≥ 18.
Install
npm install -g gaslamp
gaslamp setup # register both directions
gaslamp doctor # verify binaries + registrations
Zero-install also works:
npx gaslamp setup
From source
git clone https://github.com/a9lim/gaslamp
cd gaslamp
./setup.sh # === node bin/gaslamp.mjs setup --local
CLI
gaslamp [serve] Run the MCP server on stdio (what Codex spawns).
gaslamp setup Register both directions (add --local for this checkout).
gaslamp doctor Check binaries + registrations.
gaslamp --version Print version.
gaslamp --help Print help.
Permissions
A Codex→Claude consult with no sandbox arg runs with your own Claude config
(permission mode, allow/deny rules, model, MCP) — just as your interactive Claude
would. Per-call overrides: read-only (advisory, no edits) or danger-full-access
(full read/write). Claude has no filesystem sandbox, so there's no workspace-write.
Recursion
A consult is one hop by default: a Claude reached through gaslamp can't turn
around and consult Codex, and a Codex reached through gaslamp can't consult Claude
back. (The Claude→Codex registration tags the consulted Codex with
GASLAMP_NESTED=1, and the spawned Claude is denied the bridge with
--disallowedTools mcp__gaslamp.) Only the top-level agent you drive can open a
consult. Set GASLAMP_ALLOW_RECURSION=1 to restore unbounded, symmetric handoffs.
Env knobs
| var | default | meaning |
|---|---|---|
GASLAMP_ALLOWED_TOOLS | Read Grep Glob WebFetch WebSearch | tools the read-only override permits |
GASLAMP_ALLOW_RECURSION | unset | allow a consulted agent to consult back (off = one hop) |
GASLAMP_LOGFILE | ~/.codex/gaslamp.log | transcript path; off to disable |
GASLAMP_DEBUG | unset | verbose stderr (raw JSON-RPC) |
CLAUDE_BIN | autodetected | path to the claude binary |
Development
npm test # node --test against a stub claude binary
npm run check # node -c syntax check on every source file
See CONTRIBUTING.md before opening a PR.
License
AGPL-3.0-or-later. See LICENSE.