확인 범위: 제3자 브리지의 설치와 기동을 직접 확인했고, 공식 설치 경로는 프로젝트 문서로 검토했다. Codex에서 캔버스까지 이어지는 생성은 완료하지 못했고 데스크톱 앱도 실행하지 않았다.
오픈소스 디자인 도구가 Codex 안에서 “무료로, API 키만 연결하면” 돌아간다는 소개를 봤다면, 그 문장에서 두 부분을 뜯어봐야 설치 후에 당황하지 않는다.
첫째, 검색하면 이름이 비슷한 것들이 섞여 나오는데 그중 제품은 하나뿐이다. 둘째, 무료가 무엇을 덮는지는 어느 실행 경로를 타느냐에 달려 있고, 공식 문서와 홍보 문장은 서로 다른 경로를 말하고 있다.
이 글은 코덱스 디자인 플러그인 설치를 기준으로, 무엇을 설치하고 어느 경로를 타며 각각이 비용에 어떤 의미인지를 정리한다. 확인한 것과 확인하지 못한 것을 나눠서 적었다.
코덱스 디자인 플러그인, 무엇을 설치하는 것인가
검색 결과에는 공식 저장소와 이름이 비슷한 사이트들, 그리고 별개의 제3자 MCP 브리지가 섞여 나온다. 이 글이 다루는 대상은 두 개뿐이다.
| 식별자 | |
|---|---|
| 제품 본체 | github.com/nexu-io/open-design — Apache-2.0, 로컬 우선 데스크톱 앱, BYOK |
| 내가 시험한 것 | open-design-mcp (npm) — 제3자 브리지, 저장소 nano-step/open-design-mcp |
둘 다 OpenAI가 배포한 Codex 플러그인이 아니다. Open Design은 Codex를 실행 런타임 중 하나로 지원하는 제3자 오픈소스 도구다.
내장 경로와 제3자 브리지의 차이
코덱스 디자인 플러그인을 붙일 때 이 구분을 놓치면 설치 대상 자체가 달라진다. 나도 처음엔 잘못 짚었다.
공식 README는 Open Design이 스킬, CLI, 그리고 MCP 서버로 배포되며, 설치 후 od mcp install <에이전트> 한 줄로 해당 에이전트 설정에 MCP 서버가 연결된다고 적고 있다. Codex의 경우 문서상 명령은 od mcp install codex다. 이건 공식 README에서 읽은 것이고, 내가 직접 성공시키지는 못했다.
npm의 별도 패키지는 성격이 다르다. 이미 돌고 있는 Open Design 데몬에 에디터를 연결해 주는 브리지다.
| 내장 경로 | 제3자 브리지 | |
|---|---|---|
| 저장소 | nexu-io/open-design | nano-step/open-design-mcp |
| 역할 | 제품 안에 포함된 MCP 기능 | 실행 중인 데몬에 연결 |
| 이번 시험 | 문서·코드 검토만 | 설치·초기화·도구 목록 확인 |
| Codex 종단 실행 | 미검증 | 미검증 |
| GUI 결과물 | 미검증 | 해당 없음 |
“무료”가 실제로 덮는 범위
라이선스는 Apache-2.0이라 소프트웨어 자체는 무료다. 비용 문제는 추론(inference)에서 생기고, 그건 실행 경로에 달려 있다. 공식 Quickstart는 두 가지 모드를 설명한다.
| 모드 | 언제 적용되나 | 누가 지불하나 |
|---|---|---|
| 로컬 CLI | 데몬이 PATH에서 에이전트 CLI를 감지했을 때의 기본값 | 감지된 에이전트 CLI의 인증·이용 약관을 따른다. 이번 시험에서 검증하지 못했다 |
| API 모드 | CLI를 찾지 못했을 때의 폴백 | 선택한 공급자·모델·사용량에 따라 내 BYOK 계정으로 공급자 API 요금이 발생할 수 있다 |
정확히 말하면 이렇다. 공식 문서에 따르면 로컬 CLI 모드는 이미 인증된 Codex CLI를 Open Design 안에서 별도 공급자 API 키 없이 호출할 수 있다. 다만 나는 Codex 종단 흐름과 과금 동작을 검증하지 못했다. 플랜 한도, 크레딧, 인증은 각자의 Codex 계정에 달려 있다.
그러니 “API 키만 연결하면 된다”는 문장은 폴백 경로를 설명한 것이지 기본 경로가 아니다. 의미 있는 차이지만, 어디까지나 요청이 어떻게 흐르느냐의 차이이고 실제로 얼마가 나가는지는 내가 말해줄 수 없다.
실무적으로는 하나만 지키면 된다. 무엇이든 생성하기 전에 지금 어느 실행 모드인지 확인하는 것이다. BYOK나 API 모드로 돌고 있으면 공급자 요금이 발생할 수 있다. 데몬은 PATH와 흔한 툴체인 디렉터리를 훑는데, npm install -g나 Homebrew로 설치했는데도 미설치로 표시된다면 데몬을 실행한 프로세스의 PATH에 실행 파일 경로가 들어가 있는지 확인하고 설정의 실행 모드에서 Rescan을 누르라고 문서는 안내한다.
실제로 실행한 것
$ npm i open-design-mcp
added 95 packages in 14s
# open-design-mcp 0.16.1, Apache-2.0
$ node node_modules/open-design-mcp/dist/src/server.js
[open-design-mcp] starting on stdio
[open-design-mcp] ready
initialize -> {"name":"open-design-mcp","version":"0.16.1"}
tools/list -> 10 tools환경은 리눅스, Node v22.22.3, npm 10.9.8이고 2026년 8월 8일에 돌렸다. 전송은 stdio이며 initialize 다음 tools/list를 보냈고 OD_DAEMON_URL에는 임의 값을 넣었다.
od_list_projects od_get_project od_create_project od_update_project
od_delete_project od_save_artifact od_lint_artifact od_compose_brief
od_generate_design od_save_project_file
실행으로 확인한 것은 설치, 초기화, 버전 보고, 도구 10개 목록까지다. 그 아래는 전부 소스와 문서를 읽고 정리한 것이지 도구를 실행해서 얻은 결과가 아니다.
소스 검토에서는 10개 중 9개가 OD_DAEMON_URL을 참조하는 것으로 나타났다. od_compose_brief는 네트워크 호출이 없는 순수 포맷 함수이고, od_generate_design은 BYOK 설정을 추가로 요구한다.
구조가 반대편에서 드러난다. 브리지는 연결 장치이지 디자인 엔진이 아니다. 프로젝트와 생성 관련 동작은 실행 중인 Open Design 데몬을 필요로 하며, od_compose_brief가 이번 검토에서 확인된 유일한 데몬 없이 동작하는 예외다.
에이전트를 여기에 붙이기 전에 하나만 주의하자. 소스 검토상 od_delete_project는 데이터베이스 레코드와 프로젝트 디렉터리를 함께 제거할 수 있다. 이 파괴적 동작은 실행하지 않았다.
시작 전에 필요한 세 가지
- Open Design 제품 본체. MCP 패키지만으로는 프로젝트와 디자인 생성 워크플로가 돌아가지 않는다. 그 동작들은 제품과 데몬에 의존한다.
- 실행 중인 데몬. 소스 검토상 브리지 도구 10개 중 9개가 데몬 URL을 요구한다.
- 실행 모드 결정. API 키 요구 조건과 비용 조건이 모드마다 다르기 때문이다.
코덱스 디자인 플러그인 설치에서 확인할 목록은 이 셋이 전부다. 나머지는 세부사항이다.
시스템 요구사항을 보면 공식 저장소는 소스 설치에 Node 24와 Corepack 기반 pnpm 10.33.2를 명시하고, macOS·리눅스·WSL2를 주 경로로, 윈도우 네이티브를 지원 대상으로 안내한다. 로컬 Node·pnpm 설치를 건너뛰는 Docker 경로도 문서에 있다.
내 시험 범위를 분명히 해두면, 제3자 브리지는 Node 22에서 정상 초기화됐지만 그 시험이 Open Design 제품 본체를 설치하거나 실행한 것은 아니다. Node 24 요구는 본체 쪽 조건이다.
같은 습관을 모델 출력 전반에 적용하고 있다. 홍보 문장과 공식 문서가 서로 다른 것을 말하고 있다고 일단 가정하는 것인데, 내가 실제로 쓰는 투자 프롬프트도 그 전제 위에 만들었다.
개인정보
프로젝트는 스스로를 로컬 우선이라고 설명하며, 문서에는 텔레메트리 동작도 함께 기술돼 있다. 동의를 받는 분석 설정이 있고 그렇지 않은 텔레메트리도 있다. 기밀 자료로 쓸 생각이라면 현재의 개인정보·텔레메트리 설정을 먼저 확인하는 편이 좋다. 나는 이번 시험에서 아웃바운드 네트워크 트래픽을 관찰하지 않았으므로 실제로 무엇이 전송되는지는 말할 수 없다.
확인하지 못한 것
- 데스크톱 GUI. 실행조차 하지 않았다. 캔버스도, 미리보기도, 내보내기도 확인 못 했다
- 결과물 품질. 덱이든 페이지든 이미지든 하나도 생성하지 않았다
od mcp install codex가 끝까지 동작하는지- 데몬이 Codex를 정상적으로 띄우고 인증하는지
- 실사용 비용, 플랜 한도, 크레딧 동작
- 생성 소요 시간과 토큰 한도. 브리지 README에 관련 주장이 있으나 내가 실행하지 않았으므로 이 글에 넣지 않았다
- 아웃바운드 네트워크 동작
GUI를 시험하면 이 글을 갱신한다. 그때 상단 날짜도 함께 바뀐다.
국내에서 이 소식이 도는 방식
국내 커뮤니티와 스레드에는 이런 도구가 “무료 AI 디자인 툴”이라는 한 줄로 옮겨지는 경우가 많다. 그런데 위에서 봤듯 무료의 범위는 실행 경로에 달려 있고, 그 구분은 원문 문서에만 있다.
같은 종류의 작업을 채팅창 대신 코딩 에이전트로 돌릴 생각이라면 클로드와 챗GPT에 같은 10-K를 넣어본 기록이 판단에 도움이 될 수 있다. 그래서 새 도구 소식을 볼 때 확인할 질문이 하나 늘어난다. “무엇이 무료인가”가 아니라 “무료인 경로로 들어가려면 무엇이 갖춰져 있어야 하는가”다. 이 글의 표를 그 용도로 쓰면 된다.
자주 묻는 질문
이것은 OpenAI 공식 Codex 플러그인인가요
아니다. Open Design은 Apache-2.0 라이선스의 제3자 오픈소스 프로젝트이고 Codex를 실행 런타임 중 하나로 지원한다. 문서에서 od mcp install codex로 자체 MCP 서버를 Codex 설정에 연결하는 방식을 제공한다. Open Design이 Codex를 지원하는 것이지 OpenAI가 Open Design을 배포하는 것이 아니다.
소프트웨어는 무료인데 언제 API 요금이 붙나요
라이선스는 무료다. 요금은 실행 경로에 달렸다. API 또는 BYOK 모드에서는 선택한 공급자·모델·사용량에 따라 내 계정으로 공급자 요금이 발생할 수 있다. 로컬 CLI 모드는 이미 인증된 에이전트 CLI를 별도 공급자 키 없이 호출한다고 문서가 설명하지만, 나는 과금 동작을 검증하지 못했고 플랜 한도와 크레딧은 각자의 에이전트 계정에 달려 있다.
내장 od mcp와 open-design-mcp 패키지는 뭐가 다른가요
od mcp install <에이전트>는 Open Design 제품에 포함된 기능으로 제품과 함께 배포되는 MCP 서버를 연결한다. npm의 open-design-mcp는 이미 실행 중인 데몬에 에디터를 붙여주는 별개의 제3자 브리지다. 브리지가 제품 설치를 대신하지 않는다.
이번 시험이 실제로 검증한 것은 무엇인가요
실행 시험으로는 설치, 기동, 버전 보고, 도구 10개 목록을 확인했다. 별도의 소스 검토에서 9개 도구가 OD_DAEMON_URL을 참조한다는 점을 확인했다. Open Design 제품 자체에 관한 내용은 저장소와 Quickstart를 읽은 것이지 실행한 결과가 아니다. 따라서 이 글은 코덱스 디자인 플러그인의 사용 후기가 아니라 설치 전 점검 기록이다.
2026년 8월 8일 확인. 다음 확인은 2026년 9월 예정이며 개발이 활발한 프로젝트다. 출처: nexu-io/open-design, 공식 Quickstart, npm의 open-design-mcp v0.16.1. 시험 기록: tarball 무결성 sha512-jNMOJOr6fbuaHUhZ/JnrFjteRb/ZJ6UavgImxhNfFUyT8tS3L/tGtVesPkmiGqnKEqwntWexDXKARf3SzLSPEQ==, server.js sha256 d1b51249597701c2332414e07881b43957546133e5d32feca3b39c4143800a71.
