🔧 VS Code에서 tmux를 자동으로 통합하고 지속 세션 유지

Source: Dev.to

🟢 기본 솔루션 (명백한 방법)

VS Code에서는 터미널 프로필을 다음과 같이 설정할 수 있습니다:

// "terminal.integrated.profiles.osx": {
//   "tmux-shell": {
//     "path": "tmux",
//     "args": ["new-session", "-A", "-s", "${workspaceFolderBasename}"]
//   }
// },
// "terminal.integrated.defaultProfile.osx": "tmux-shell"

이 방법의 장점

• 하나의 워크스페이스 → 하나의 tmux 세션 (-A 로 자동 지속)
• 간단하고 깔끔한 설정
• 스크립트가 필요 없음

많은 환경에서 충분히 좋고 우아합니다.

🔴 실제 제한점

settings.json은 조건 로직을 지원하지 않습니다. ${workspaceFolderBasename} 같은 변수는:

• ✅ 확장됨
• ❌ 변형할 수 없음
• ❌ 정규식 사용 불가
• ❌ 그룹화하거나 정규화할 수 없음

여러 폴더를 하나의 세션으로 묶기

여러 관련 프로젝트가 있고, 컨텍스트, 팬, 레이아웃을 유지하기 위해 하나의 공유 tmux 세션에서 모두 작업하고 싶다고 가정해 보세요:

fe-dashboard, fe-admin, be-api, be-auth

기본 설정에서는 각 폴더가 자체 tmux 세션을 강제하므로, 개념적으로 모두 같은 “작업 컨텍스트”에 속하더라도 별도 세션이 생성됩니다. 다음과 같은 규칙을 표현할 수 없습니다:

“폴더가 fe- 또는 be- 로 시작하면 work 세션을 사용한다”

이는 VS Code 터미널 설정으로는 표현할 수 없습니다.

🧠 견고한 솔루션: 로직을 셸로 이동

VS Code는 VSCODE_PID와 TERM_PROGRAM=vscode 같은 환경 변수를 주입합니다. 이를 통해 터미널이 VS Code에서 실행된 것인지 신뢰성 있게 감지할 수 있습니다. 이후 셸이 판단을 수행합니다.

fish 예시:

if set -q VSCODE_PID; or test "$TERM_PROGRAM" = "vscode"
    if not set -q TMUX
        set -l folder_name (basename (pwd))

        if string match -qr "^fe-.*" -- $folder_name
            set folder_name "work"
        else if string match -qr "^be-.*" -- $folder_name
            set folder_name "work"
        else
            set folder_name "projects"
        end

        # tmux new-session -A -s $folder_name &>/dev/null
    end
end

VS Code는 단순히 실행기 역할을 할 뿐이며, 의사결정 로직은 셸에 위치합니다.

🚀 실용적인 장점

• 폴더 이름이 아니라 의미에 따라 프로젝트를 그룹화
• VS Code를 닫아도 tmux 세션 재사용 가능
• 세션 중복 방지
• 팬과 레이아웃 지속
• 플러그인·확장 프로그램 필요 없음 — tmux와 표준 환경 변수만 사용

⚠️ 참고 사항

• 통합 터미널에만 적용되며 외부 터미널에는 적용되지 않음
• VSCODE_PID는 공식 API는 아니지만 수년간 안정적으로 사용되어 왔음
• 동일한 패턴을 bash나 zsh에서도 사용할 수 있음

VS Code를 편집기로, tmux를 세션 관리자로 사용하는 경우, 이 통합은 마찰을 없애고 일상적인 작업 흐름을 크게 개선합니다.

프로젝트별 터미널 세션을 어떻게 관리하고 계신가요?