MCP 서버 연결 Claude/Cursor에 Codex CLI. @] 파일 참조, 멀티턴 대화, sandboxed 편집 및 구조화 된 변경 모드를 통해 코드 분석이 가능합니다.

특징

• File Analysis - @src/, @package.json 구문 파일
• Multi-Turn Sessions - 워크스페이스 고립과 대화 연속성
• Native Resume - context 보전용 codex resume 사용 (CLI v0.36.0+)
• **Local OSS 모델 ** - [T4]를 통해 Ollama 또는 LM Studio와 함께 실행
• **웹 검색 ** - search: true와 연구 기능
• 샌드박스 모드 - 명시된 샌드박스 및 승인 정책으로 안전한 자동화 -Change Mode — Refactoring를 위한 Structured OLD/NEW 패치 출력 -Brainstorming — SCAMPER, 디자인 두께, 측면 생각 프레임 워크
• ** 건강 진단 ** - CLI 버전, 기능 및 세션 모니터링
• Cross-Platform — Windows, macOS, Linux는 완전히 지원

빠른 시작

** 필수품:** Node.js 18+, Codex CLI 설치 및 인증.

윤곽

** 구성 위치: ** macOS: ~/Library/Application Support/Claude/claude_desktop_config.json | Windows: %APPDATA%\Claude\claude_desktop_config.json]

사용 예제

도구

Codex MCP Server

MCP server connecting Claude/Cursor to Codex CLI. Enables code analysis via @ file references, multi-turn conversations, sandboxed edits, and structured change mode.

Features

• File Analysis — Reference files with @src/, @package.json syntax
• Multi-Turn Sessions — Conversation continuity with workspace isolation
• Native Resume — Uses codex resume for context preservation (CLI v0.36.0+)
• Local OSS Models — Run with Ollama or LM Studio via localProvider
• Web Search — Research capabilities with search: true
• Sandbox Mode — Safe automation with explicit sandbox and approval policies
• Change Mode — Structured OLD/NEW patch output for refactoring
• Brainstorming — SCAMPER, design-thinking, lateral thinking frameworks
• Health Diagnostics — CLI version, features, and session monitoring
• Cross-Platform — Windows, macOS, Linux fully supported

Quick Start

claude mcp add codex-cli -- npx -y @trishchuk/codex-mcp-tool

Prerequisites: Node.js 18+, Codex CLI installed and authenticated.

Configuration

{
  "mcpServers": {
    "codex-cli": {
      "command": "npx",
      "args": ["-y", "@trishchuk/codex-mcp-tool"]
    }
  }
}

Config locations: macOS: ~/Library/Application Support/Claude/claude_desktop_config.json | Windows: %APPDATA%\Claude\claude_desktop_config.json

Usage Examples

// File analysis
'explain the architecture of @src/';
'analyze @package.json and list dependencies';

// With specific model
'use codex with model gpt-5.6-sol to analyze @algorithm.py';

// Multi-turn conversations (v1.4.0+)
'ask codex sessionId:"my-project" prompt:"explain @src/"';
'ask codex sessionId:"my-project" prompt:"now add error handling"';

// Brainstorming
'brainstorm ways to optimize CI/CD using SCAMPER method';

// Sandbox mode
'use codex sandbox:true to create and run a Python script';

// Web search
'ask codex search:true prompt:"latest TypeScript 5.7 features"';

// Local OSS model (Ollama)
'ask codex localProvider:"ollama" model:"qwen3:8b" prompt:"explain @src/"';

Tools