Claude Code와 Codex가 작성한 Markdown 파일 미리보기 방법

Claude Code가 PLAN.md 파일을 작성했거나, 아니면 Codex가 HANDOFF.md를 남겼을 수 있습니다. 이 파일들을 cat으로 출력하고 파운드 기호(#), 별표(*), 파이프(|) 등을 스크롤하며 읽게 됩니다. 에이전트들은 답변 내에서 Markdown을 렌더링하지만, 그들이 작성한 파일을 사용자가 직접 읽을 때는 원본(raw) 상태로 보입니다. 이를 제대로 읽는 몇 가지 방법이 있습니다:

• 터미널에서: glow PLAN.md를 실행하면 헤딩, 리스트, 테이블, 코드를 바로 렌더링해 줍니다. 설치는 brew install glow로 할 수 있습니다.
• 앱에서: open PLAN.md를 사용하면 Mac에서 .md 파일을 처리하는 어떤 앱으로든 열립니다.
• 에이전트에게 맡기기: AGENTS.md나 CLAUDE.md 파일에 해당 에이전트가 작성한 모든 Markdown 파일에 대해 open을 실행하도록 지시하는 줄을 추가합니다.
• 클릭하기: Claude Code는 파일 이름을 링크로 출력합니다. 하나를 Cmd-click하면 파일이 열립니다.
• 주의할 점: 이 방법들 각각은 사용자를 다른 곳으로 이동시켜 읽게 하고, 다시 답변을 위해 돌아와야 합니다.

터미널에서 Markdown 파일을 읽으려면 어떻게 해야 할까요?

Markdown 렌더러를 사용하세요. Glow가 일반적입니다:

brew install glow
glow PLAN.md

이것은 스타일이 적용된 헤딩, 글머리 기호 리스트, 테이블, 강조 표시된 코드 블록과 함께 파일을 출력한 다음 프롬프트로 돌아옵니다. 파일이 길 경우, glow -p PLAN.md를 사용하면 화살표 키로 스크롤하고 q로 나갈 수 있는 페이지네이터(pager)에서 열립니다.

Glow는 파이프에서도 읽을 수 있으므로, cat NOTES.md | glow -도 작동합니다. 이는 세션의 터미널을 벗어나지 않고 계획을 읽는 가장 빠른 방법이지만, 스냅샷일 뿐입니다. 에이전트가 파일을 다시 편집하면, 이 명령을 다시 실행해야 합니다.

Markdown 파일을 앱에서 열려면 어떻게 해야 할까요?

macOS에는 이를 위한 명령어가 있습니다:

open PLAN.md

이는 Mac이 .md 파일에 사용하는 앱(예: 에디터 또는 Markdown 전용 앱)으로 파일을 엽니다. 어떤 앱을 사용할지 변경하려면, Finder에서 임의의 .md 파일을 선택하고 Cmd-I를 누른 다음 Open with 아래에서 앱을 선택하고 Change All을 클릭합니다.

이것은 에이전트 자체로부터도 작동하는 일반적인 셸 명령어이기 때문에 어디서든 사용할 수 있습니다.

에이전트가 파일을 열어줄 수 있을까요?

네. 에이전트는 매 세션 시작 시 프로젝트 지침을 읽기 때문에 한 줄이면 충분합니다. 이 내용을 Codex와 Grok Build가 읽는 AGENTS.md에 추가하거나, Claude Code를 위한 CLAUDE.md에 추가하세요:

- Markdown 계획이나 노트를 작성하거나 업데이트한 후에는 제가 읽을 수 있도록 `open <파일>`을 실행해 주세요.

이후부터 에이전트가 PLAN.md를 작성할 때, open PLAN.md를 실행하며 마무리해야 하고, 파일은 Markdown 앱에 나타날 것입니다. 만약 두 에이전트가 프로젝트에서 함께 작업한다면, 이 줄을 AGENTS.md에 넣고 CLAUDE.md가 @AGENTS.md로 이를 가져오게 하세요. Claude Code의 작업을 Codex로 넘기는 방법를 참고하세요.

Claude Code 출력에서 파일 이름을 클릭할 수 있나요?

네. Claude Code가 파일을 작성하거나 편집하면, 터미널 링크 형태로 파일 이름이 출력됩니다. Ghostty나 iTerm2처럼 링크를 지원하는 터미널에서는 Cmd 키를 누른 채 이름 부분을 클릭하면 기본 앱에서 파일이 열립니다.

에이전트가 지나가듯 파일에 대해 언급할 때 유용한 기능입니다. 경로를 복사하거나 Finder로 전환할 필요가 없습니다.

에이전트 터미널 옆에서 파일을 읽을 수 있나요?

네. PonyMux에는 Files 패널이 있어, 헤딩, 코드 블록, 테이블, 작업 목록, 이미지를 포함한 Markdown 내용을 터미널 옆에 렌더링합니다. Cmd-Option-F를 누르면 표시됩니다.

파일은 세 가지 방법으로 나타납니다:

• 터미널 출력에 있는 .md 파일(예: Claude Code가 출력한 파일 이름)을 Cmd-click하면, 다른 앱 대신 패널에서 열립니다.
• PonyMux 터미널에서 **pony open PLAN.md**를 실행합니다. 에이전트도 이를 실행할 수 있습니다. open <파일> 대신 상단 줄에 pony open <파일>을 넣으면, 어떤 에이전트가 파일을 열었는지 간략한 메모가 표시됩니다.
• 렌더링된 파일 내부의 링크를 클릭하면, 브라우저처럼 뒤로 가기/앞으로 가기가 가능한 패널에서 다른 .md 파일에 대한 상대적 링크가 열립니다.

최대 10개의 파일을 고정(pin)할 수 있습니다. 이 패널은 읽기 전용이며, 편집하려면 컨텍스트 메뉴를 통해 에디터에서 파일을 여십시오. 패널과 pony 명령어에 대한 자세한 내용은 Workspace and Navigation 및 pony CLI를 참조하십시오.

원래는 데모가 인터랙티브하게 제공되는 ponymux.com에 게시되었습니다.