cmux에서 파일 편집까지 편하게 — VSCode 스타일 Neovim 세팅 완벽 가이드

VSCode의 편의성을 버리긴 싫지만, 터미널 환경의 생산성도 놓치고 싶지 않은 개발자라면推荐的 조합이 바로 cmux + Neovim입니다. baryonlabs에서 공개한 cmux_setting_vscode_style_nvim 저장소를 활용하면, Vim 명령어를 몰라도 VSCode처럼 바로 적응할 수 있는 Neovim 환경을 구성할 수 있습니다.

cmux란?

cmux는 여러 AI 코딩 에이전트를 실행하고 조율하는 멀티 에이전트 코딩 워크스페이스입니다. AI 에이전트들이 각자 독립된 환경에서 코드를 작성하고,人类가 그 결과를 취합하는 흐름을 제공합니다.

터미널 기반의 AI 워크스페이스인 만큼, 최종적으로 코드를 검토하고 편집하는 환경은 터미널 내부에서完結해야 합니다. 그때문에 Neovim은 필수 도구이지만, Vim에 익숙하지 않은 개발자 입장에서는 진입 장벽이 높았죠.

cmux_setting_vscode_style_nvim은 바로 이 문제를 해결합니다. VSCode 사용자가 Neovim에 바로 적응할 수 있도록 설계된 세팅으로, 파일 탐색, 검색, Markdown 미리보기, 한글 입력 보정까지 포함되어 있습니다.

핵심 기능 정리

파일 탐색기 — Ctrl+b

VSCode의 Explorer 사이드바와 동일한 위치에 파일 탐색기가 열립니다. Ctrl+b(또는 Ctrl+n, Space e)로 열고 닫을 수 있으며, 탐색기 안에서도 같은 키로 닫힙니다. VSCode에서 익숙한 동작과 동일하게 동작하는 것이 특징입니다.

Ctrl+b  →  파일 탐색기 열기/닫기
Ctrl+n  →  파일 탐색기 열기/닫기
Space e →  파일 탐색기 열기/닫기
Space E →  현재 파일 위치를 탐색기에서 표시

내부적으로는 neo-tree.nvim 플러그인을 사용하며, VSCode의 사이드바 토글과 동일한 UX를 제공하도록 키 바인딩이 커스텀되어 있습니다.

빠른 파일 찾기 — Space ff

프로젝트 전체에서 파일 이름을 기준으로 검색합니다. VSCode의 Quick Open(Ctrl+P)에 해당하는 기능입니다.

Space ff →  파일 찾기 (Telescope 기반)
Space fg →  프로젝트 전체 문자열 검색
Space fb →  열린 파일 목록 (버퍼)

Space ff는 비동기 방식으로 동작하며, 타이핑과 동시에 결과가 필터링됩니다. large 프로젝트에서도 빠르게 반응하는 것이 특징입니다.

Markdown 미리보기 — Space mp

Neovim 안에서 Markdown 파일을 편집하면서, 브라우저에서 실시간 미리보기를 확인할 수 있습니다. 포트는 8755로 고정됩니다.

Space mp →  미리보기 열기/닫기 토글
Space mo →  미리보기만 열기
Space mc →  미리보기만 닫기

브라우저에서 http://localhost:8755로 접속하면 현재 Markdown 파일이 렌더링된 형태로 표시됩니다. 파일을 저장할 때마다 미리보기 내용이 자동으로 갱신됩니다.

마우스 창 조절

터미널 Neovim에서도 마우스로 창을 선택하고, 분할 창 크기를 조절할 수 있습니다. VSCode의 드래그로 창 크기 조절과 동일한 동작이 가능합니다.

우클릭 메뉴에서 Markdown 미리보기 토글도 가능하며, 상태바 우측의 TIP 영역에 마우스를 올리거나 클릭하면 상황별 사용 팁이 표시됩니다.

한글 입력 보정 — 가장 실용적인 기능

한국어 IME를 사용하는 사용자에게 Neovim에서 가장痛苦的 문제는 Insert mode에서 한글 입력을 끝내고 Esc를 눌렀을 때, 입력기가 한글 상태로 유지되어 j, k, dd 같은 명령이 동작하지 않는 것입니다.

이 세팅은 두 가지 방식으로 이 문제를 해결합니다.

첫째, 자동 입력기 전환. macism 또는 im-select가 설치되어 있으면, Insert mode를 나갈 때 자동으로 영문 입력기로 전환됩니다.

brew install macism
# 또는
brew install im-select

둘째, 한글 명령어 보정. 입력기 전환 도구가 없더라도, 한글 입력 상태에서 실수로 입력한 Ex 명령어가 영문 명령어로 해석됩니다.

VSCode 스타일 Neovim 세팅으로 터미널에서도舒适的 개발 환경

LSP와 자동완성

코드 편집의 핵심인 LSP(Language Server Protocol)와 자동완성도 기본으로 구성되어 있습니다.

LSP 자동완성과 코드 네비게이션 기능

설치 방법

LLM에게 설치 맡기기 (가장 간단)

AI 에이전트(ChatGPT, Claude, Codex 등)에게 다음 프롬프트를 전달하면 됩니다:

이 GitHub 저장소를 읽고, 내 macOS 머신에 이 Neovim 세팅을 설치해줘. 적용하기 전에 README.md와 NVIM_CORE_SETTINGS.md를 요약해줘. 만약 ~/.config/nvim/init.lua이 이미 존재하면 먼저 백업해줘.
https://github.com/baryonlabs/cmux_setting_vscode_style_nvim/

수동 설치

git clone https://github.com/baryonlabs/cmux_setting_vscode_style_nvim.git
cd cmux_setting_vscode_style_nvim
mkdir -p ~/.config/nvim
cp init.lua ~/.config/nvim/init.lua
nvim

한국어 진입 파일로 설치하려면:

cp init.lua ~/.config/nvim/cmux-base.lua
cp init.ko.lua ~/.config/nvim/init.lua
nvim

마무리

cmux 환경에서 파일 편집을 VSCode처럼 편하게 하고 싶다면, cmux_setting_vscode_style_nvim은 확실한 선택입니다. 파일 탐색, 검색, Markdown 미리보기, 한글 입력 보정까지 VSCode의 핵심 기능을 터미널 Neovim 환경에서再現했습니다.

Vim의 깊이 있는 편집 기능은 그대로 활용하면서, VSCode 수준의 바로使える環境이 필요한 개발자라면一试해볼 만합니다.