codex-claude-design-bridge

codex-claude-design-bridge는 Codex의 /fd를 Claude 선행 디자인 패스에 연결하는 얇은 설치기입니다.

목표는 단순합니다.

• Codex에 fd 스킬을 넣는다.
• 로컬 claude CLI를 호출하는 claude-design-bridge 바이너리를 설치한다.
• /fd가 "Claude first, Codex finish" 흐름을 쓰도록 맞춘다.

이 패키지는 Claude Code 자체를 설치하지는 않습니다. 이미 로컬에 claude CLI가 있고 로그인되어 있다는 전제에서, Codex 쪽 연결 고리만 설치합니다.

설치

npx codex-claude-design-bridge@latest

먼저 변경 예정만 보고 싶다면:

npx codex-claude-design-bridge@latest --dry-run

이미 legacy skill root를 쓰고 있다면:

npx codex-claude-design-bridge@latest --skills-dir legacy

설치되는 것

• ~/.local/bin/claude-design-bridge
• fd 스킬 (~/.agents/skills/fd 또는 ~/.codex/skills/fd)

동작 방식

설치 후 fd 스킬은 아래 흐름을 사용합니다.

1. Codex가 프런트엔드 작업을 claude-design-bridge fd --apply로 먼저 위임
2. Claude가 첫 디자인 패스를 구현
3. Codex가 diff를 검사하고 반응형, 접근성, 로직, 테스트를 마감

claude-design-bridge는 Claude에 다음 성향을 강하게 줍니다.

• design quality over safe defaults
• Apple HIG style clarity and restraint
• preserve existing components, tokens, and product coherence

사전조건

• Node.js 18+
• Codex CLI
• Claude Code CLI (claude)가 PATH에 있어야 함
• Claude Code가 이미 로그인되어 있어야 함

설치 후 확인

claude-design-bridge --help

그리고 Codex에서 프런트엔드 작업에 /fd를 쓰면 됩니다.

같이 쓰는 추천 조합

npx dgk-gpt@latest
npx codex-claude-design-bridge@latest

• dgk-gpt: Codex 기본 셋업
• codex-claude-design-bridge: Claude 선행 디자인 브리지