Google Colab 은 단순한 노트북이 아닙니다. 공식 CLI 인 google-colab-cli 를 사용하면 터미널, VS Code 또는 SSH 를 지원하는 어떤 에디터에서든 GPU 유무와 관계없이 Colab 머신에 SSH 터미널을 바로 열 수 있습니다.
이 글에서는 CLI 설치, ~/.ssh/config 설정, 첫 로그인, 그리고 컴퓨트 유닛 낭비 없이 연결/해제하는 방법을 다룹니다.
필요한 것
- Colab 에 접근할 수 있는 Google 계정 (Google AI Subscription - Plus, Pro 또는 Ultra)
- uv 또는 pip 가 설치된 Python 3
- Linux, macOS, Windows 10/11 에 기본 내장된 OpenSSH
- ed25519 SSH 키
1. Colab CLI 설치하기
공식 패키지 이름은 google-colab-cli 이며, colab 명령어를 설치합니다.
1uv tool install google-colab-cli2# 또는: pip install google-colab-cli3colab version

2. SSH 키 준비하기
연결할 때 colab 은 머신에 공개 키를 전송합니다. 기본적으로 ~/.ssh/id_ed25519.pub 또는 id_ecdsa.pub 을 찾습니다. 아직 키가 없나요?
1ssh-keygen -t ed25519
다른 이름의 키를 사용 중인가요? 문제없습니다. 다음 단계에서 -i 옵션으로 경로를 지정하면 됩니다.
3. ~/.ssh/config 에 호스트 추가하기
~/.ssh/config 파일을 열고(또는 새로 만들고) 아래 블록을 붙여넣으세요.
1Host colab2 User root3 ProxyCommand colab ssh --proxy-mode -s colab -i ~/.ssh/id_ed25519.pub4 StrictHostKeyChecking no5 UserKnownHostsFile /dev/null

각 줄의 역할은 다음과 같습니다.
- Host colab: 별칭입니다. 이제부터
ssh colab만 입력하면 됩니다. - ProxyCommand: IP 로 직접 연결하는 대신, SSH 가
colab ssh --proxy-mode와 통신하여 Colab 머신으로 연결을 중계합니다.-s colab은 세션 이름이며, 해당 세션이 없으면 CLI 가 새로 생성합니다. - StrictHostKeyChecking no 및 UserKnownHostsFile /dev/null: 모든 세션은 새로운 호스트 키를 가진 새 머신입니다. 이 설정이 없으면 SSH 가 연결할 때마다 경고 메시지를 출력합니다.
시간을 낭비하게 만들었던 두 가지 함정:
- 설정 파일에 Host \ 블록이 있다면 colab 을 그 앞에 배치하세요. SSH 는 가장 먼저 발견된 값을 적용합니다. 즉, 위쪽에 있는 `Host
아래의StrictHostKeyChecking no` 가 colab 용 설정을 덮어써 버립니다. - Windows 에서는
-i에 키의 절대 경로(C:/Users/you/.ssh/id_ed25519.pub)를 사용하세요. ProxyCommand 내부의~는 확장되지 않습니다.
4. 실제 터미널에서 첫 로그인하기
처음 실행하면 CLI 가 Google 계정 인증을 요청합니다. 링크가 표시되고, 브라우저에서 승인한 뒤 Google 이 보여준 코드를 다시 붙여넣으면 됩니다.
1colab new -s colab

주의: 첫 로그인은 반드시 대화형 터미널(PowerShell, Terminal, iTerm 등)에서 진행하세요. AI 에이전트, 스크립트, 채팅 내에서 트리거된 명령처럼 키보드 입력이 불가능한 환경에서 첫 ssh colab 을 시도하면 CLI 가 코드를 입력받을 곳이 없어 "Malformed auth code" 오류와 함께 로그인이 실패합니다. 한 번 로그인이 저장되면 이후에는 어디서든 작동합니다.
GPU 가 필요하신가요? 세션을 만들 때 함께 지정하세요: colab new -s colab --gpu T4. L4, A100, H100 도 지원하며, RAM 을 더 늘리려면 --high-mem 을 추가하면 됩니다.
5. 연결하기
1ssh colab

Ubuntu 24.04 환경의 /content 디렉터리에 root 로 접속됩니다. 스크린샷의 비 GPU 세션은 2 vCPU, 12 GB RAM, 약 226 GB 디스크를 제공합니다.
셸을 열지 않고 단일 명령어만 실행할 수도 있습니다.
1ssh colab "nvidia-smi"
표준 SSH 를 사용하기 때문에 VS Code(Remote - SSH), scp, rsync 및 원격 머신을 지원하는 모든 에디터에서 추가 설정 없이 colab 호스트를 인식합니다.
6. 작업이 끝나면 종료하기
세션은 전원이 켜져 있는 동안 유휴 상태라도 컴퓨트 유닛을 소모합니다. 작업이 끝났다면 중지하고 확인하세요.
1colab stop -s colab2colab sessions3colab usage

기억력에 의존하지 않으려면 CLI 의 --rm 옵션을 사용하세요. SSH 연결이 끊기면 세션을 자동으로 중지합니다. ProxyCommand 에 추가하기만 하면 됩니다.
1ProxyCommand colab ssh --proxy-mode -s colab --rm -i ~/.ssh/id_ed25519.pub
사용 시간과 비용
- 머신 유형마다 유닛 소모율이 다릅니다. 비 GPU 는 거의 소모되지 않으며, T4 는 시간당 약 1.8, L4 는 4.8, A100 은 11~13 정도 소모합니다. 수치는 변동될 수 있으므로 세션이 켜져 있을 때
colab usage로 확인하세요. - 세션에는 시간 제한이 있으며(Pro 기준 최대 약 24 시간), 일정 시간 사용하지 않으면 자동 종료됩니다.
- 디스크는 휘발성입니다. 세션이 끝나면 모든 것이 사라집니다. 종료 전에 Git push 하거나 파일을 복사(scp, rsync 또는
colab download)하거나,colab drivemount로 Google Drive 를 마운트하세요.
꼭 기억해 둘 CLI 명령어
- colab sessions: 활성 세션 목록 표시
- colab status: 세션 상태 확인
- colab usage: 잔액 및 소모율 확인
- colab upload / colab download: 파일 전송 및 다운로드
- colab drivemount: 머신에 Google Drive 마운트
- colab stop -s <name>: 세션 중지
이제 끝입니다. Colab 은 ~/.ssh/config 에 등록된 또 하나의 호스트가 됩니다. ssh colab 한 줄이면 GPU 가 탑재된 Linux 머신에 접속되며, 켜져 있는 시간만큼만 비용을 지불하게 됩니다.





