SSH로 원격 서버에서 에이전트 돌리기

준비물

• SSH 키로 로그인되는 서버 — TiniaCode는 비밀번호 로그인을 쓰지 않습니다. 키가 없다면 아래 키 만들기를 따라 하세요.
• 64비트 x86 리눅스 서버(x86_64)
• 서버에 설치하고 로그인해 둔 에이전트 — Claude Code 또는 Codex CLI. 에이전트의 로그인 정보는 서버에 남습니다.
• 서버의 인터넷 연결 — Node.js 22가 없으면 TiniaCode가 서버에 내려받습니다.

1. 서버 등록하기

1. 명령 팔레트나 폴더 열기 창에서 원격 폴더 열기…를 고릅니다.
2. 호스트 관리에서 새 호스트를 누릅니다.
3. "별칭 (Host)", "호스트 주소 (HostName)", "로그인 계정 (User)", "포트 (Port)", "인증 키 파일 (IdentityFile)"을 채웁니다. 점프 서버를 거친다면 고급 항목의 "경유 호스트 (ProxyJump)"를 씁니다.
4. 저장하고 연결 테스트를 누릅니다.

TiniaCode는 호스트 정보를 따로 보관하지 않고 여러분의 ~/.ssh/config를 백업한 뒤 고칩니다. 그래서 이미 ~/.ssh/config에 있는 서버는 목록에 바로 나오고, 터미널의 ssh 명령과 같은 설정을 씁니다.

2. 키가 없다면

1. 호스트 화면에서 새 키 만들기를 누릅니다.
2. 저장을 눌러 새 키를 "인증 키 파일 (IdentityFile)"로 기록합니다.
3. 공개키를 서버에 복사 (터미널)을 누릅니다. 열린 터미널에 서버 비밀번호를 한 번 입력하면 됩니다. 비밀번호는 터미널에만 입력되고 TiniaCode는 보지 않습니다.

3. 처음 연결할 때 서버 지문 확인

처음 연결하는 서버는 지문(host key fingerprint)을 확인하라는 안내가 나옵니다. 서버 관리자나 클라우드 콘솔에서 알려 준 지문과 같은지 확인한 뒤 지문 확인하고 기록을 누르세요. 지문이 다르면 연결하지 마세요.

4. 서버의 프로젝트 열고 에이전트 돌리기

1. 연결된 호스트를 고르고 서버의 프로젝트 폴더를 엽니다. 다음부터는 "최근 프로젝트"에서 한 번에 열립니다.
2. 평소처럼 에이전트 세션을 시작하고 지시합니다.
3. 처음 한 번은 TiniaCode가 필요한 실행 파일을 서버의 ~/.tiniacode/ssh-agent에 올립니다. 에이전트는 서버에 설치된 CLI와 그 로그인으로 서버에서 실행됩니다.

아직 원격에서 안 되는 것

• 서버 밖에서 바뀐 파일을 실시간으로 감지하기
• 서버의 웹 포트를 내 PC에서 열어 보기
• 작업 트리 연결 · 지시별 체크포인트 · 되돌리기 · Git 조작
• 할 일 탭, 기록 탭, 저장해 둔 초안, 첫 push 도우미
• 원격 터미널을 닫으면 그 원격 셸도 끝납니다.

메모는 원격 프로젝트에서도 쓸 수 있습니다. 메모는 서버의 프로젝트 폴더(.tiniacode/memo)에 저장됩니다.

연결이 안 될 때

TiniaCode는 PC에 설치된 OpenSSH를 그대로 씁니다. 먼저 터미널에서 아래 명령이 비밀번호를 묻지 않고 접속되는지 확인하세요. 비밀번호를 묻는다면 키가 서버에 등록되지 않은 것입니다.

ssh 별칭

회사 서버라면 방화벽이 SSH 포트를 막지 않는지, 점프 서버가 필요한지 관리자에게 확인하세요.