VS Code 1.146 Local harness 이전은 2027년 2월 제거 전에 시작하세요. 다만 Copilot harness를 선택해도 기존 설정과 세션이 모두 자동 이전되는 것은 아니므로, 먼저 백업하고 대표 작업으로 원격 작업 공간의 실행 결과를 검증해야 합니다. 공식 일정과 상태는 VS Code 1.146 릴리스 안내에서 확인할 수 있습니다.
Local harness를 아직 쓰는 개발자라면 현재 세션과 개인 설정부터 확인하세요.
Remote SSH로 원격 Mac에서 개발한다면 저장소, Agent Host, 명령 실행 위치를 별도로 검증해야 합니다.
팀 관리자는 전사 배포 전에 정책, 권한, 샌드박스 동작을 시험하세요.
마지막 업데이트: 2026년 11월 12일. VS Code 공식 1.146 릴리스 안내와 Local-to-Copilot 이전 문서를 기준으로 확인했습니다.
이전 일정과 새 기본값을 구분하세요
VS Code 1.146에서 Local harness는 사용 중단 대상으로 표시되었고, 공식 제거 예정 시점은 2027년 2월입니다. Copilot harness는 새 세션의 기본 선택이지만, 이는 기존 세션이나 사용자 설정까지 자동으로 변환된다는 뜻이 아닙니다. 일정과 기본값은 공식 릴리스 안내 및 Local에서 Copilot으로 옮기는 공식 안내에서 각각 확인하세요.
용어도 분리해서 기록해야 합니다. harness는 Agent가 도구와 작업을 처리하는 실행 구조이고, 모델은 응답을 생성하는 선택 항목입니다. 실행 위치는 명령과 파일이 실제로 처리되는 환경이며, Agent Host는 Agent 작업을 담당하는 호스트입니다. Agent harness 개념 문서와 Agent Host 안내를 기준으로 구분하면, 모델만 바꾼 뒤 이전이 끝났다고 오판하는 일을 줄일 수 있습니다.
첫 단계: 기존 작업을 기록하고 설정을 백업하세요
먼저 작고 반복 가능한 작업을 하나 고르세요. 예를 들어 특정 테스트를 실행하고 실패한 테스트 파일을 수정하게 한 뒤, 변경 사항을 검토하는 흐름을 사용할 수 있습니다. 프로젝트 경로, 실행 명령, 필요한 도구, 승인 요청, 예상 변경 파일과 결과를 기록하면 이전 전후를 같은 조건으로 비교할 수 있습니다.
그다음 개인 Agent, 지침 파일, Hooks, MCP 서버 설정, 관련 자격 증명과 권한을 목록으로 만들고 안전한 위치에 백업하세요. 설정 파일을 복사할 때 비밀 키나 토큰이 저장소에 포함되지 않도록 확인해야 합니다. MCP 연결 정보는 VS Code MCP 설정 문서의 구성 방식을 참고하고, 각 서버가 새 세션에서 실제로 연결되는지 별도로 점검하세요.
| 점검 대상 | 이전 전에 할 일 | Copilot harness에서 확인할 점 |
|---|---|---|
| 작업 기준 | 프로젝트, 명령, 예상 변경과 승인 흐름 기록 | 동일한 작업을 새 세션에서 재현 |
| 개인 Agent와 지침 | 파일 위치와 내용을 백업 | 지침 적용 여부와 응답 차이 확인 |
| Hooks와 도구 | 실행 조건, 명령, 접근 권한 기록 | 호출 여부와 승인 동작을 시험 |
| MCP 서버 | 설정과 자격 증명 참조 위치 점검 | 서버 연결과 필요한 도구 호출 확인 |
| 기존 세션 | 진행 중 작업과 필요한 맥락을 기록 | 공식 인계 경로가 적용되는지 확인 |
세션 대상 변경은 설정 변환이 아닙니다. 공식 안내에 명시된 지원 범위를 확인하고, 자동으로 옮겨질 것이라고 가정하지 않은 항목은 새 환경에서 하나씩 재구성하세요.
둘째 단계: Copilot harness에서 기준 작업을 재현하세요
새 세션을 만들고 Session Target에서 Copilot을 선택하세요. 이어 계정 상태, 사용할 수 있는 모델, 필요한 도구가 준비되어 있는지 확인합니다. 새 세션에서 Copilot harness가 기본으로 사용된다는 사실만 믿기보다, 세션 대상 표시와 실제 명령 실행을 함께 확인하세요.
기준 작업을 같은 프로젝트에서 실행하고, 파일 변경, 명령 실행, 승인 요청이 기록한 기준과 어떻게 달라졌는지 비교합니다. 모델을 변경했다면 그 사실도 별도 기록하세요. harness 차이와 모델 차이를 한 번에 바꾸면 결과가 달라진 원인을 분리하기 어렵습니다.
| 변경 항목 | 확인할 증거 | 실패하면 할 일 |
|---|---|---|
| 세션 대상 | 새 세션의 대상이 Copilot인지 확인 | 세션을 다시 만들고 대상 선택 재확인 |
| 모델 | 선택한 모델과 시험 조건 기록 | 모델만 바꿔 다시 실행해 차이를 분리 |
| 명령과 승인 | 명령 실행 및 승인 동작 기록 | 권한과 도구 구성을 검토 |
| 결과물 | 변경 파일과 테스트 결과 비교 | 작업 지침과 도구 연결을 조정 |
기존 Local 세션을 이어야 한다면 공식 이전 안내에서 설명하는 인계 경로를 사용하세요. 인계 후에는 대화 기록, 작성 중인 초안, 작업 공간과 권한이 필요한 만큼 유지됐는지 확인해야 합니다. 이를 양방향 전환으로 간주하지 말고, 원래 세션으로 되돌아갈 수 있다고 가정하지 마세요.
Remote SSH와 원격 Mac에서 실행 위치를 검증하세요
Remote SSH 연결은 편집기가 원격 시스템의 작업 공간에 접속하는 흐름입니다. 연결 자체가 Agent Host의 위치나 모든 명령의 실행 환경까지 보장하지는 않습니다. Remote SSH 공식 문서와 Agent Host 설명을 참고하되, 실제로 쓰는 프로젝트에서 상태를 확인해야 합니다.
| 확인 항목 | 원격 작업 공간에서 확인할 내용 | 통과 기준 |
|---|---|---|
| 저장소 | 현재 경로와 브랜치가 의도한 작업 대상인지 | 예상 프로젝트의 파일을 읽고 수정함 |
| 셸과 명령 | Agent가 호출한 셸 및 프로젝트 명령 | 대상 환경에서 명령이 실행됨 |
| Agent Host | Host의 상태와 작업 처리 위치 | 의도한 작업 흐름과 도구 호출이 확인됨 |
| macOS 도구 | 프로젝트가 요구하는 빌드 또는 테스트 | 프로젝트 자체의 검증 결과가 통과함 |
| 권한 | 파일 접근, 도구 승인과 제한 정책 | 필요한 권한만 허용되고 정책이 적용됨 |
Remote SSH를 처음부터 구성하는 방법이 필요하다면 원격 Mac의 개발 환경 선택지를 먼저 살펴보세요. 이 글의 이전 검증에서는 새 연결 설정 자체보다, 편집기가 붙은 작업 공간과 Agent가 명령을 실행하는 환경을 따로 확인하는 것이 중요합니다. 연결 표시가 정상이어도 프로젝트의 빌드나 테스트가 실패하면 이전 검증은 끝난 것이 아닙니다.
macOS 전용 도구가 필요한 작업은 원격 Mac에서 프로젝트가 실제로 요구하는 빌드나 테스트를 실행해 판정하세요. VS Code 창이 원격에 연결되었거나 Agent가 세션을 열었다는 사실만으로 macOS 도구 체인의 성공을 대신할 수 없습니다. 팀 정책이 개입하는 환경이라면 기업용 AI 설정 관리 문서도 확인하고, 사용 중인 정책이 새 세션에 적용되는지 시험해야 합니다.
작은 범위로 배포하고 남은 의존성을 없애세요
개인 시험이 통과한 뒤에는 대표 프로젝트와 통합을 골라 제한된 범위에서 적용하세요. 특히 권한, 샌드박스, Hooks와 MCP 서버가 포함된 작업을 넣어야 단순한 코드 편집 외의 차이를 발견할 수 있습니다. 시험 중단 기준과 담당자를 정하고, 막히는 항목은 Local harness 의존 여부와 해결 방법을 기록하세요.
다음 조건을 모두 만족하면 팀 범위를 넓힐 수 있습니다.
- Copilot harness에서 기준 작업의 결과와 필요한 도구 호출이 확인됩니다.
- 원격 저장소, 셸 명령, Agent Host가 의도한 작업 환경과 일치합니다.
- 기업 정책과 권한이 예상대로 적용되고, 민감한 자격 증명이 노출되지 않습니다.
- 기존 세션에서 이어야 할 맥락이 공식 인계 경로로 보존되거나 별도 정리되었습니다.
| 결정 | 적용 조건 | 권장 조치 |
|---|---|---|
| 시험을 확대 | 기준 작업과 정책 검증이 모두 통과 | 대표 프로젝트부터 팀 적용 |
| 보류 후 수정 | 도구, Hook, MCP 연결 중 일부가 실패 | 설정을 분리해 원인을 찾고 재시험 |
| 수동 이전 | 자동 호환 경로가 없거나 세션 맥락이 중요 | 항목별 재구성과 결과 검토 |
| 이전을 완료 처리 | 원격 명령과 프로젝트 자체 검증이 통과 | Local harness 의존 항목을 정리하고 일정 재확인 |
공식 제거 일정이나 호환 안내는 바뀔 수 있으므로 실제 배포 전에는 최신 릴리스 안내와 정책 문서를 다시 확인하세요. 원격 Mac을 계속 사용하는 프로젝트라면 한국에서 이용 가능한 원격 Mac 환경도 검토할 수 있습니다. 여기서는 제품 성능을 전제하지 말고, 네트워크 접근 방식과 프로젝트별 도구 요구 사항을 먼저 맞춰 보세요.
자주 묻는 질문
Local harness 이전은 지금 바로 전부 끝내야 하나요?
아닙니다. 공식 안내상 제거 예정 시점은 2027년 2월이지만, 그 전에 개인 설정과 팀 통합을 확인하고 대표 작업으로 시험을 마치는 것이 핵심입니다. Local harness에 의존하는 항목을 먼저 찾아 우선순위를 정하고, 해결되지 않은 항목은 담당자와 대체 절차를 지정하세요. 마감 직전의 일괄 전환은 권한이나 도구 문제를 발견해도 검증할 시간을 줄입니다.
설정을 선택만 하면 자동 이전되나요?
아닙니다. 새 세션에서 Copilot harness를 선택하는 것과 기존 설정의 호환 여부는 별개의 문제입니다. Hooks, MCP, 지침, 개인 Agent, 자격 증명과 권한을 항목별로 점검해야 합니다. 공식 이전 문서에 별도 처리 방식이 없는 항목은 시험 세션에서 작동 여부를 확인하고, 지원되지 않으면 재구성하거나 다른 실행 절차를 마련하세요.
Remote SSH가 연결되면 Agent도 원격에서 명령을 실행하나요?
연결 성공만으로 단정할 수 없습니다. 편집기가 바라보는 저장소와 Agent Host의 상태, 실제 명령이 처리된 셸을 각각 확인하세요. 특히 로컬 터미널과 원격 터미널이 혼재하면 Agent가 다른 경로에서 명령을 실행할 수 있습니다. 기록한 프로젝트 경로와 명령 결과를 대조하고, macOS 환경이 필요한 작업이라면 프로젝트 빌드나 테스트까지 완료해야 합니다.
모델을 바꾸면 harness도 바뀌나요?
아닙니다. 모델과 harness는 서로 다른 선택 요소입니다. 모델을 바꾸면 응답이 달라질 수 있지만, 그것만으로 실행 구조나 도구 접근 방식이 변경되었다고 볼 수 없습니다. 이전 시험에서는 세션 대상과 모델을 따로 기록하고, 한 번에 한 항목씩 바꿔 결과를 비교하세요. 그래야 오류가 모델 응답, 도구 설정, 실행 환경 중 어디에서 비롯됐는지 좁힐 수 있습니다.
이전 결과에 따라 실행 환경을 선택하세요
프로젝트 명령과 macOS 도구 체인이 목표 환경에서 정상적으로 검증됐다면 현재 환경을 계속 쓰면 됩니다. 반대로 Linux 서버에서는 macOS 전용 도구를 실행할 수 없고, 개인 Mac은 장시간 작업 중 절전이나 다른 작업과의 자원 경쟁을 고려해야 합니다. 안정적으로 계속 켜 둘 Mac이 이미 있다면 직접 운영하는 편이 맞을 수 있지만, 단기간의 이전 검증이나 지속 실행용 macOS 작업 공간이 필요하고 물리 장비를 구매하고 싶지 않다면 VpsHold의 원격 Mac 사용 방식을 살펴보세요. 실제 프로젝트 요구 사항과 필요한 접근 방식을 먼저 확인한 뒤 선택하는 것이 안전합니다.
자주 묻는 질문
VS Code 1.146에서 Local harness는 언제 없어지나요?
VS Code 1.146 공식 릴리스 안내에 따르면 Local harness는 더 이상 사용하지 않도록 표시되었으며, 제거 시점은 2027년 2월로 안내되어 있습니다. 따라서 지금 바로 모든 팀 설정을 한꺼번에 바꾸기보다, 제거 전에 대표 프로젝트를 선정해 Copilot harness에서 기존 작업이 재현되는지 확인하고 남은 의존 항목을 처리하는 편이 안전합니다.
Copilot harness를 선택하면 기존 사용자 설정도 자동으로 옮겨지나요?
아닙니다. 새 세션에서 Copilot harness를 선택하는 것과 기존 설정을 이전하는 것은 별개입니다. 개인 Agent, 지침 파일, Hooks, MCP 설정, 자격 증명 및 도구 권한이 자동으로 모두 호환된다고 가정하지 마세요. 항목별로 백업한 뒤 공식 이전 안내와 실제 시험 세션을 기준으로 지원 여부를 확인하고, 자동 이전 경로가 없는 설정은 별도 재구성해야 합니다.
새 세션이 Copilot harness로 실행되는지 어디에서 확인하나요?
새 세션을 만들 때 Session Target에서 Copilot을 선택했는지 확인하고, 세션의 대상 표시와 실제 도구 실행 결과도 함께 살펴보세요. 모델 이름만으로 harness를 판별할 수는 없습니다. 모델은 응답을 생성하는 선택 항목이고, harness는 Agent가 도구와 작업 흐름을 다루는 방식이므로 둘을 따로 기록해야 이전 전후 동작을 비교할 수 있습니다.
Remote SSH 작업 공간에서는 Agent Host와 프로젝트 명령을 어떻게 확인하나요?
먼저 편집기가 연결된 원격 작업 공간에서 저장소 경로와 터미널 셸을 확인합니다. 이어 Agent Host가 어느 환경에서 동작하는지 상태와 실제 명령 실행으로 점검하고, Agent가 의도한 저장소의 파일을 수정하는지도 확인하세요. macOS 도구가 필요한 프로젝트라면 세션 연결 성공만으로 통과 처리하지 말고 프로젝트의 빌드나 테스트를 직접 실행해 결과를 판정해야 합니다.
이전한 개발 환경을 전용 원격 장비에서 검증하세요
다른 사용자와 자원을 나누지 않는 전용 실물 장비에서 원격 작업 공간과 명령 실행 결과를 확인하세요.