dsh-codex-mcp

DeepSeek Harness의 Codex 모델을 OpenAI 공식 CLI를 통해 사용합니다 — 타사 코드에 ChatGPT 자격 증명을 넘겨주지 않습니다.

설치

npm i -g @openai/codex   # if you don't already have it
codex login              # sign in with your ChatGPT account
dsh plugin --profile web add dsh-codex-mcp
dsh web

그게 전부입니다. Codex는 에이전트 도구에 mcp__codex__codex로 나타납니다. API 키도, 하네스 내부의 OAuth 흐름도, 붙여넣을 것도 없습니다.

왜 이런 것이 필요한가

ChatGPT 구독을 하네스에 넣는 다른 플러그인은 자체 OAuth 흐름을 실행하고, 요금제에 범위가 지정된 토큰을 얻어 저장합니다. OpenAI 입장에서는 해당 요청이 Codex CLI에서 온 것처럼 보입니다. 실제로는 타사 패키지가 사용자가 비용을 지불하는 서비스에 대한 자격 증명을 보유하고 있는 것입니다.

이 플러그인은 전혀 인증하지 않습니다. Codex 실행 파일을 찾아 MCP 서버로 실행하고, 하네스가 stdio를 통해 통신하도록 합니다. 인증은 OpenAI 자체 서명 바이너리 내부에서, 자체 ~/.codex/auth.json을 대상으로 발생합니다. 유출될 토큰이 없으며, 제거해도 취소할 것이 남지 않습니다.

DeepSeek Harness  ──MCP/stdio──▶  codex mcp-server  ──HTTPS──▶  OpenAI
                                  (official binary,
                                   own credentials)

호출마다 셸을 실행하는 대신 MCP를 사용하는 이유

동일한 프롬프트와 모델로 측정:

모든 codex exec 호출은 답변 전에 바이너리를 콜드 스타트하고 스킬 컨텍스트를 다시 로드합니다. MCP 서버는 그 비용을 한 번만 지불합니다. 또한 스레드 상태를 유지하므로 codex-reply가 대화를 계속할 수 있습니다.

비용은 상주 프로세스입니다 — 관찰된 사용에서 약 140MB.

구성

모든 옵션은 선택 사항이며, 기본값이 원하는 값입니다.

DSH_CODEX_BINARY는 구성을 편집하지 않고 감지를 재정의합니다.

실행 파일을 찾는 방법

1. 명시적 command 또는 DSH_CODEX_BINARY

2. 전역 @openai/codex 설치 내부의 네이티브 바이너리 — 하드코딩이 아닌 디스크에서 열거하므로 새 플랫폼이나 아키텍처에서 변경이 필요 없음

3. PATH의 codex 실행 파일

Windows에서는 npm .cmd 및 .ps1 셰임을 의도적으로 건너뜁니다: MCP stdio 전송은 셸 없이 프로세스를 생성하며, 셰임은 그렇게 실행할 수 없습니다.

Codex가 없을 때

플러그인은 수정 방법을 명명하는 경고 하나를 기록하고 아무것도 마운트하지 않습니다. 하네스는 Codex 도구 없이 정상적으로 시작됩니다. 조용히 실행하는 대신 크게 부팅하고 싶다면 failOnStartupError: true를 설정하세요.

요구 사항

• @deepseek-ai/dsh-mcp-client 0.1.0-rc.6–0.1.0-rc.8이 포함된 DeepSeek Harness

• Node ^22.19.0 || >=24

• 로그인된 Codex CLI

• Codex를 포함하는 ChatGPT 요금제

하네스 0.1.0-rc.8 및 codex-cli 0.144.5에서 검증됨.

제거

dsh plugin --profile web remove dsh-codex-mcp

저장된 자격 증명이 없으므로 정리할 것이 없습니다. Codex CLI 로그인은 그대로 유지됩니다.

개발

npm install
npm test

테스트는 임시 디렉터리에 합성 npm 레이아웃을 구축하므로 Codex가 설치되지 않은 머신에서도 스위트가 통과합니다. CI는 Linux, macOS, Windows에서 두 지원 Node 버전 모두로 실행하며, 패킹된 tarball의 깨끗한 설치가 작동하는지 별도로 확인합니다.

라이선스

MIT