2026 OpenCode 2.0 여러 명이 Mac을 함께 쓰면 프로젝트가 섞일까요?

먼저 판단할 점: 공유 서비스는 사용자 격리 기능이 아닙니다

OpenCode V2 공식 문서는 기본 공유 백그라운드 서비스가 현재 사용자 계정의 세션, 설정, 연동 항목, 권한, 도구 실행을 관리한다고 설명합니다. 관리 대상은 다섯 범주입니다(V2 CLI 문서). 따라서 OpenCode 2.0을 여러 명이 Mac에서 사용한다면, 서비스 공유를 다인 격리로 간주하지 마세요. 운영체제 계정, 프로젝트 폴더, 인증 정보, 서비스 접속 경계를 먼저 검증해야 합니다. 검증 전에는 서로 다른 연구 과제를 같은 사용자 세션에서 처리하지 않는 것이 기본 판단입니다.

이 글은 OpenCode 2.0을 한 대의 Mac에서 운영하려는 연구실 책임자, 계정과 서비스 경계를 정해야 하는 실험실 관리자, 개인 환경을 팀 환경으로 옮기는 연구 소프트웨어 개발자를 위한 점검 안내입니다.

같은 Mac 공유와 같은 계정 공유는 다릅니다

“Mac을 같이 쓴다”는 말은 서로 다른 운영 형태를 가리킬 수 있습니다. 기기만 같고 macOS 계정은 다를 수도 있고, 한 계정을 여럿이 돌려 쓸 수도 있습니다. 또 각자 클라이언트를 열어도 같은 OpenCode 서비스에 연결할 수 있습니다. 이 차이를 정리하지 않으면 화면이 분리돼 보인다는 이유만으로 코드와 설정도 격리됐다고 오판하기 쉽습니다.

OpenCode V2 CLI 문서는 별도 실행 방식과 지정 서버 연결 방식을 다룹니다. 그러므로 각 클라이언트에서 어느 서버에 연결했는지를 확인해야 합니다. 서비스의 실제 동작은 설치 버전과 설정을 기준으로 검증하세요. 공식 변경 기록도 배포 전에 확인해야 합니다(V2 변경 기록).

주의: 한 macOS 계정을 함께 쓰면 해당 계정이 접근할 수 있는 프로젝트 파일이나 인증 정보를 다른 사용자도 다룰 가능성이 있습니다. 애플리케이션 안의 권한 설정은 macOS 계정과 파일 권한을 대신하는 운영체제 격리 기능이 아닙니다.

세션과 설정이 섞이는 지점은 연결 대상입니다

OpenCode의 공유 백그라운드 서비스는 공식 문서상 현재 사용자 계정의 세션과 설정 등을 관리합니다. 여기서 핵심은 “공유”라는 단어가 곧바로 “팀 구성원 사이에 독립된 상태를 보장한다”는 뜻은 아니라는 점입니다. 다른 창이나 기기에서 접속해도 같은 사용자 계정의 서비스에 연결했다면, 세션 목록이나 설정이 공유될 수 있는지 확인해야 합니다.

설정 항목은 기본값이라고 가정하지 말고 실제 파일과 실행 환경을 확인하세요. 현재 V2 설정 문서에서 사용 중인 구성 항목을 대조하고(설정 문서), 서비스에 연결한 뒤 각 사용자의 세션 목록을 비교합니다. 검증 결과는 계정 이름, 서비스 연결 대상, 설정 파일 위치, 세션 식별 정보를 포함해 기록합니다. 민감한 값은 기록에 복사하지 않습니다.

첫 번째 단계: 테스트 계정과 저장소 준비

1. 실제 과제 코드 대신 민감하지 않은 시험용 저장소를 준비합니다.
2. 참여자별 macOS 계정과 OpenCode 실행 계정을 기록합니다.
3. 각 클라이언트가 연결할 서비스 주소와 실행 사용자를 확인합니다.
4. 참여자별 세션 목록과 설정 파일 위치를 따로 확인합니다.
5. 한 사용자가 만든 시험 파일을 다른 계정에서 읽고 수정할 수 있는지 시험합니다.
6. 결과가 예상과 다르면 실제 연구 코드나 인증 정보를 연결하지 말고 설정을 재검토합니다.

세션의 표시 여부와 파일의 접근 가능 여부는 별개입니다. 세션이 보이지 않아도 공유 폴더를 통해 파일에 접근할 수 있고, 반대로 같은 파일을 보더라도 서비스 세션은 다를 수 있습니다. 따라서 둘을 한 번의 “격리 테스트”로 묶지 말고 각각 확인하세요.

프로젝트 폴더와 Git 작업 공간은 따로 검증합니다

공용 서비스에 연결한 뒤 잘못된 작업 경로를 선택하거나, 여러 사람이 같은 작업 복사본을 수정하면 변경 내용이 다른 과제 폴더에 들어갈 수 있습니다. 이는 OpenCode 세션의 분리 여부와 별개의 파일 시스템 문제입니다. 세션 목록이 나뉘어도 공유 작업 폴더가 열려 있으면 프로젝트 간 변경이 섞일 수 있습니다.

시험용 저장소에서 읽기, 파일 생성, 수정, 브랜치 전환, 결과물 저장 위치를 확인하세요. 한 저장소에서 작업 디렉터리를 분리할 필요가 있다면 Git 공식 문서의 git worktree 설명을 검토할 수 있습니다(Git worktree 문서). 다만 작업 공간을 나누는 것만으로 macOS 사용자 권한이나 OpenCode 서비스 연결까지 분리되지는 않습니다.

macOS 계정 추가 절차는 Mac 사용자 계정 안내에서 확인할 수 있습니다. 계정별 파일 접근은 파일 및 폴더 권한 안내, 계정 간 공유 폴더는 Mac 파일 공유 설정을 함께 살펴보세요. 계정이 나뉘어 있다는 사실만으로 모든 디렉터리가 자동으로 차단되는 것은 아닙니다.

권한과 인증 정보는 서비스 설정만으로 보호되지 않습니다

OpenCode 권한 설정은 도구 사용을 통제하는 데 중요하지만, 이를 macOS 자체의 계정·파일 권한과 같은 경계로 간주하면 안 됩니다. 현재 V2 권한 문서에서 허용 범위를 검토하고(권한 문서), 실제로 실행할 수 있는 명령과 접근 가능한 경로를 시험 계정에서 확인하세요.

특히 점검할 항목은 터미널 명령 실행 범위, 환경 변수에 포함된 비밀 값, 모델 제공자 인증 정보의 저장 위치와 소유자입니다. 여러 사람이 같은 macOS 계정으로 작업하면 그 계정이 읽을 수 있는 파일과 환경 값에 접근할 수 있습니다. 인증 정보가 사용자 홈 디렉터리나 실행 환경에 저장되는 방식은 팀 정책과 맞춰 확인하고, 기록이나 공유 문서에 비밀 값을 붙여 넣지 마세요.

원격 접속은 노출 범위를 먼저 확인합니다

OpenCode 원격 서비스 문서는 원격 접근을 사용하려면 원격 서비스를 활성화했는지 확인하도록 안내합니다(원격 서비스 문서). 따라서 로컬에서만 쓰는 경우와 네트워크를 통해 접속하는 경우를 구분하세요. 현재 설정에서 서비스가 켜져 있는지, 연결 대상과 허용된 접속 경로가 무엇인지 확인하고, 인증 방식도 운영 담당자가 점검해야 합니다.

암호나 암호화 전송은 접속 관리의 일부이지, 연구 데이터 취급 규칙이나 기관의 보안 승인을 대신하지 않습니다. 원격 macOS 과제 환경을 검토한다면 연구 데이터의 외부 반출 가능 여부와 기관 규칙부터 확인하세요. 원격 환경을 알아보는 단계에서는 metalvnc 도움말을 참고하고, 이용 방식과 비용은 요금 안내에서 실제 조건을 확인할 수 있습니다.

원격 접속이 필요하지 않다면 켜 두지 마세요. 필요하다면 누가 어떤 경로로 연결할 수 있는지 문서화하고, 시험 계정으로 접속 경계를 검증한 뒤 실제 과제에 적용합니다.

연구실 Mac 사용 방식은 검증 결과로 결정합니다

다음 조건 분기로 선택하세요.

• macOS 사용자와 서비스 연결 대상이 분리되고, 시험 저장소에서 파일 접근과 인증 정보 경계까지 확인됐다면 별도 계정 기반의 공동 Mac 운영을 검토합니다.
• 개발자들이 같은 프로젝트를 함께 작업하지만 사용자 경계와 파일 권한을 따로 관리할 수 있다면 작업 디렉터리와 저장소 경계를 명시하고, 시험 결과를 기록한 뒤 적용합니다.
• 같은 macOS 계정을 공유하거나 서비스 연결 대상이 불분명하다면 서로 다른 연구 과제에 공용 세션을 사용하지 말고 계정을 분리합니다.
• 데이터 접근 규칙을 만족하는지 판단할 수 없거나 원격 접속 범위를 확인할 수 없다면 실제 코드와 인증 정보를 연결하지 말고 관리자 검토를 먼저 받습니다.
• 독립된 접근 경계를 계정 분리만으로 만들기 어렵다면 별도 Mac 환경을 검토하되, 임대나 원격 접속이 격리 또는 규정 준수를 보장한다고 간주하지 않습니다.

FAQ: 팀 운영 전에 확인할 질문

OpenCode 2.0의 공유 백그라운드 서비스는 어떤 정보를 관리하나요?
V2 문서는 기본 공유 서비스가 현재 사용자 계정의 세션, 설정, 연동 항목, 권한, 도구 실행을 관리한다고 설명합니다. 따라서 같은 서비스에 연결한 클라이언트가 서로 다른 화면을 보여 준다는 사실만으로 세션이나 설정이 분리됐다고 판단하면 안 됩니다. 실제 로그인 계정과 연결 대상, 세션 목록을 각각 확인하세요.

같은 Mac에서 계정을 나누면 다른 사람의 프로젝트를 볼 수 없나요?
계정 분리는 파일 접근 경계를 나누는 데 도움이 되지만, 폴더 권한이나 파일 공유 설정이 열려 있으면 접근이 가능할 수 있습니다. 반대로 같은 macOS 계정을 함께 쓰면 그 계정이 읽을 수 있는 파일과 인증 정보를 사용자들이 함께 다룰 수 있습니다. 시험용 저장소로 읽기와 쓰기 범위를 먼저 검증하세요.

OpenCode 2.0 원격 서비스의 접속 경계는 어떻게 확인하나요?
원격 연결을 사용하기 전에 공식 문서의 원격 서비스 설정을 확인하고, 서비스가 실제로 활성화됐는지와 연결 대상이 어디인지 점검합니다. 이어서 허용된 접속 경로와 인증 방식을 관리자 관점에서 확인하세요. 비밀번호나 암호화 연결만으로 기관의 데이터 보호 규칙을 충족한다고 간주해서는 안 됩니다.

연구실에서는 공용 계정과 개인 계정 중 무엇을 선택해야 하나요?
서로 다른 연구 과제의 코드나 인증 정보를 다루고, 파일 접근 경계를 입증할 수 없다면 계정을 나누는 편이 안전합니다. 공용 계정은 동일 사용자가 관리하는 시험 환경처럼 공유 대상이 명확한 경우에만 검토하세요. 계정 분리만으로 서비스 노출이나 폴더 권한까지 해결되지는 않으므로 각각 별도로 확인해야 합니다.

마지막으로, OpenCode 2.0 다인 운영에서 핵심은 Mac 한 대인지가 아니라 서비스, 계정, 프로젝트 폴더, 인증 정보가 실제로 어디까지 공유되는지입니다. 이미 쓰는 장비를 공용으로 돌리는 방식은 비용을 줄일 수 있지만, 계정 경계를 흐리게 하고 프로젝트 파일과 인증 정보의 책임 소재를 불명확하게 만들 수 있습니다. 팀에 대화형 macOS 환경이 필요하고 연구 데이터 규칙을 확인했다면 metalvnc의 원격 Mac 사용 방식을 검토할 수 있습니다. 다만 임대 Mac 자체가 사용자 격리나 기관 승인을 보장하지 않으므로, 적용 전 계정과 접속 경계를 별도로 확인하세요.

마지막 업데이트: 2026년 11월 3일. OpenCode V2 CLI, 설정, 권한, 원격 서비스 문서와 공식 변경 기록, macOS 사용자·파일 권한 안내를 기준으로 확인했습니다.

자주 묻는 질문