9. 계정·작업 공간·프로젝트의 차이
계정은 나를 구별합니다
서비스에 가입하면 그 서비스에서 나를 구별할 계정이 생깁니다. 로그인은 이미 만든 계정으로 들어가는 일입니다. 같은 이메일 주소로 가입했어도 GitHub와 Vercel, AI 도구의 자료가 자동으로 한곳에 모이는 것은 아닙니다. 각각의 서비스에 내 정보와 작업이 따로 있을 수 있습니다.
‘Google로 계속’처럼 다른 계정으로 들어가는 방식도 있습니다. 이 경우에는 어느 계정으로 로그인했는지 기억하는 것이 중요합니다. 개인 계정으로 만들었던 작업을 회사 계정에서 찾으면 목록에 보이지 않을 수 있습니다. 작업이 사라졌다고 판단하기 전에 현재 계정부터 확인할 이유입니다.
작업 공간과 프로젝트
서비스에 따라 작업 공간이나 팀이라는 묶음이 있습니다. 개인 작업과 여러 사람의 공동 작업을 나누는 자리라고 이해할 수 있습니다. 프로젝트는 그 안에서 하나의 결과물을 만드는 작업 단위입니다. ‘첫 소개 페이지’와 ‘링크 모음’을 서로 다른 프로젝트로 둘 수 있습니다.
이름은 서비스마다 다릅니다. 어떤 도구는 프로젝트 없이 대화 단위로 작업을 보관합니다. 중요한 것은 용어를 억지로 맞추는 것이 아니라 지금 어느 계정에서, 어느 공간의, 어떤 작업을 열고 있는지 아는 것입니다. 제목을 알아보기 쉽게 붙이면 나중에 다시 찾기가 쉬워집니다.
| 화면에서 보이는 것 | 확인할 질문 |
|---|---|
| 계정 이름·프로필 | 내가 만들 때 사용한 계정인가? |
| 팀·작업 공간 | 개인 연습 공간인가, 공동 공간인가? |
| 대화·프로젝트 제목 | 이번에 수정하려던 작업인가? |
로그인과 자료 접근 허용
로그인에 성공한 것과 다른 서비스가 내 자료를 읽거나 바꿀 수 있게 허용한 것은 구분해야 합니다. Vercel에서 GitHub 파일을 가져오려면 연결 과정이 생길 수 있습니다. 이때 요청하는 접근 권한과 대상 저장소를 확인합니다. 저장소는 프로젝트 파일과 기록을 모아 두는 곳입니다.
GitHub 앱 설치 화면에서는 저장소를 선택할 수 있는 경우가 있습니다. 처음 연습에는 해당 저장소만 연결하는 편이 범위를 이해하기 쉽습니다. ‘모든 저장소’와 ‘선택한 저장소’는 같은 허용이 아닙니다. 권한이 없다는 메시지가 나왔을 때 비밀번호를 대화창에 보내는 방식으로 해결하지 않습니다.
내 연습 공간을 구분하는 이유
처음 만드는 작업에는 ‘연습’이나 ‘첫 페이지’처럼 목적이 보이는 이름을 붙입니다. 이미 다른 사람이 사용하는 사이트와 혼동하면 간단한 수정 요청도 영향을 줄 수 있습니다. 새로 만든 프로젝트인지, 기존 프로젝트를 열었는지 확인하는 일은 첫 화면을 만드는 것만큼 기본적인 준비입니다.
계정과 프로젝트의 이름을 간단히 기록해 두는 것은 좋지만, 비밀번호까지 같은 메모에 적어 공유할 필요는 없습니다. 다음 장에서는 계정에 연결된 비용과 사용량을 구분합니다.
‘내 작업이 안 보여요’라는 상황
어제 개인 계정으로 만든 소개 페이지를 오늘 회사 계정으로 로그인해 찾고 있다고 해 봅시다. 목록이 비어 있다고 해서 결과가 삭제된 것은 아닐 수 있습니다. 프로필의 계정, 선택된 작업 공간, 프로젝트 목록 순서로 확인하면 코드에 손대지 않고 해결할 단서가 나옵니다. 작업 이름과 사용하는 계정을 기록해 두는 이유가 여기에 있습니다.
다른 사람이 초대한 공간에서 작업한다면 소유자와 내가 가진 권한도 다를 수 있습니다. 화면을 볼 수 있지만 수정할 수는 없거나, 파일은 수정해도 공개 설정은 바꾸지 못할 수 있습니다. 이런 제한을 만나면 무엇을 할 권한이 없는지 읽고 해당 작업의 관리자에게 필요한 범위를 설명해야 합니다. 접근 제한을 없애려고 비밀번호를 공유하는 방식으로 해결하지 않습니다.
연결 허용 화면을 읽는 사례
Vercel에서 GitHub 저장소를 가져오려는데 접근 허용 화면이 나타났다고 해 봅시다. 이때 ‘로그인만 하면 되는 단계’로 생각하고 모든 항목을 넘기기보다, 어느 서비스가 무엇을 읽거나 바꾸려는지 봅니다. 저장소 선택이 가능하면 연습용 저장소 이름을 고릅니다. 이미 운영하는 다른 저장소까지 포함할 필요가 있는지 생각합니다.
연결 뒤 저장소가 목록에 안 보이면 계정이 맞는지와 해당 저장소 접근이 허용되었는지를 확인합니다. 비밀번호를 다시 만들거나 파일을 새로 작성하는 것으로 해결될 문제가 아닐 수 있습니다. 어떤 자료가 어느 연결을 통해 보이는지 이해하면 같은 화면을 반복해서 오가는 일을 줄일 수 있습니다.
작업이나 계정을 못 찾을 때
소유자와 참여자의 차이
공동 작업 공간에서는 내가 만든 파일이라도 공간의 소유자나 관리 정책에 따라 접근 범위가 달라질 수 있습니다. 개인 계정과 팀 공간을 구별하는 이유입니다. 연습 결과를 오래 보관하려면 어디에 있는 작업인지 알고 있어야 합니다.
참여 권한에도 차이가 있습니다. 읽기만 가능한 권한, 파일을 바꿀 수 있는 권한, 사람을 초대하거나 공개 설정을 바꿀 수 있는 권한이 나뉠 수 있습니다. 어떤 버튼이 비활성화되어 있다면 코드 오류라고 생각하기 전에 내 역할과 필요한 권한을 확인할 수 있습니다. 권한 요청은 하려는 작업에 필요한 범위로 설명합니다.
로그인 오류를 전달하는 방법
도움을 받을 때는 ‘로그인이 안 돼요’에 더해 어느 서비스에서 어떤 안내가 나오는지 적습니다. 계정 선택 화면인지, 이메일 확인 요청인지, 권한이 없다는 안내인지 구분합니다. 개인정보를 제외한 안내 문장과 시도한 순서가 있으면 상황을 더 정확하게 설명할 수 있습니다.
비밀번호나 인증 번호를 보내 달라는 방식으로 문제를 해결하지 않습니다. 계정에 들어가는 정보와 오류를 설명하는 정보는 다릅니다. 화면을 보여 줄 때도 이메일 전체나 개인 자료가 필요 이상으로 노출되지 않게 합니다. 필요한 부분만 전달해도 도구 이름과 오류 종류를 알리는 데 충분한 경우가 많습니다.
작업 기록에 남길 이름
기록에는 서비스 이름, 로그인한 계정의 구별 정보, 작업 공간, 프로젝트 이름, 마지막 상태를 적을 수 있습니다. ‘개인 계정의 첫 소개 페이지, 소개글 수정 후 링크 확인’처럼 적으면 다시 찾기 쉽습니다. 비밀번호를 같은 기록에 포함할 필요는 없습니다.
작업이 늘어나면 이름의 규칙도 도움이 됩니다. 주제와 목적이 드러나는 이름을 쓰면 ‘새 프로젝트 7’보다 알아보기 쉽습니다. 이름을 정리하는 일은 코드 지식이 없어도 할 수 있고, 잘못된 작업을 수정하는 실수를 줄이는 데 직접 도움이 됩니다.
“같은 이름의 프로젝트가 두 개 있으면 어떻게 구분하나요?”
이름만 보지 말고 어느 계정과 작업 공간에 있는지, 마지막 수정이 언제인지, 어떤 내용이 들어 있는지를 함께 봅니다. 같은 이름을 다른 서비스에서 사용할 수도 있고 복사본을 만들었을 수도 있습니다. 제목이 같다는 이유로 파일과 설정이 동일하다고 생각하지 않습니다.
잘 작동하는 쪽을 확인했다면 구별되는 설명을 남길 수 있습니다. ‘공개 중’, ‘배치 연습’, ‘이전 파일 보관’처럼 목적이 보이는 이름이나 기록이 도움이 됩니다. 다만 이름을 바꾸는 것으로 실제 공개 설정이 바뀌지는 않습니다. 표시된 이름과 서비스의 연결 상태를 따로 확인합니다.
혼동이 생겼다고 오래된 것처럼 보이는 프로젝트를 바로 지우지 않습니다. 필요한 파일이나 연결이 남아 있을 수 있습니다. 무엇을 보관하고 어떤 작업을 계속할지 먼저 정합니다. 처음부터 연습용 새 프로젝트 이름을 명확하게 붙이는 작은 습관이 이런 혼란을 줄이는 데 도움이 됩니다.
꼭 기억하세요
작업을 못 찾거나 엉뚱한 화면이 보이면 계정·작업 공간·프로젝트를 차례로 확인합니다.