VPS에서 Aider와 Goose 코딩 에이전트 실행하기

코딩 에이전트를 VPS에서 실행하는 이유

코딩 에이전트는 코드베이스를 읽고, 변경 사항을 작성하며, 테스트를 위해 명령어를 실행하는 터미널 기반 도구입니다. 코딩 에이전트를 노트북이 아닌 VPS에서 실행하면 세 가지 장점이 있습니다. 연결을 끊어도 작업이 계속되며, 코드 및 빌드 도구와 같은 환경에 위치하고, 직접 호스팅하는 모델과 통신할 수 있습니다. tmux 세션 내에서 실행하면 노트북을 닫았다가 나중에 다시 작업을 이어갈 수 있는데, 이는 tmux를 사용하여 VPS에서 Claude Code 실행하기와 동일한 방식입니다.

알아둘 만한 터미널 기반 에이전트는 두 가지가 있습니다. Aider는 터미널 네이티브이자 git 중심적인 옵션입니다. 각 변경 사항을 적절한 메시지와 함께 자동으로 커밋하므로 기록이 깔끔하게 유지되고 모든 편집 내용을 되돌릴 수 있습니다. 릴리스 속도는 느려졌지만, 가장 오랫동안 사용된 터미널 코딩 에이전트 중 하나입니다. Block에서 개발한 Goose는 더 광범위한 도구입니다. Apache-2.0 라이선스를 따르는 에이전트로, 방대한 확장 생태계를 갖추고 있으며 로컬 Ollama 모델을 포함한 다양한 공급자를 지원합니다. 현재는 Linux Foundation 산하의 Agentic AI Foundation(AAIF)에서 개발되고 있습니다. Aider는 절제된 git 중심 워크플로에 적합하며, Goose는 다양한 플러그인을 갖춘 범용 어시스턴트에 적합합니다.

필요한 준비물

Aider를 사용하려면 git, tmux, 최신 버전의 Python이 설치된 VPS가 필요하며, Goose를 사용하려면 Goose 설치 프로그램이 필요합니다. 또한 모델이 필요합니다. Anthropic이나 OpenAI와 같은 제공업체의 호스팅된 API 키를 사용하거나, 동일한 VPS에서 Ollama로 구동되는 로컬 모델을 사용할 수 있습니다. 자체 호스팅 방식을 선택하면 코드가 서버 외부로 유출되지 않고 토큰당 비용이 발생하지 않지만, 성능이 좋은 모델을 구동하기 위한 충분한 메모리가 필요합니다.

Aider 설치 및 실행

Ubuntu 24.04는 가상 환경 외부에서의 pip install 사용을 제한하므로(PEP 668), apt를 통해 설치한 pipx를 사용하여 격리된 환경에 Aider를 설치합니다. 이후 연결이 끊겨도 작업이 유지되도록 tmux 세션 내에서 프로젝트와 함께 Aider를 실행합니다.

sudo apt install pipx
pipx ensurepath
pipx install aider-chat
tmux new -s aider
cd ~/my-project
aider

버전 관련 참고 사항: 이 설치 방법은 Ubuntu 24.04에서 정상 작동합니다. Ubuntu 26.04에서는 Aider의 고정된 의존성 패키지에 포함된 구형 numpy가 Python 3.14와 빌드되지 않아 현재 설치에 실패합니다. 해결 방법은 Aider에 별도의 Python 3.12를 할당하는 것입니다.

pipx install --python 3.12 --fetch-missing-python aider-chat

pipx는 Aider만을 위한 독립형 인터프리터를 다운로드하며, 이로써 설치가 완료됩니다. 이는 Aider의 릴리스 속도가 늦춰지고 있음을 보여주는 증상입니다. 이 점이 불편하다면 더 활발하게 유지보수되는 Goose를 선택하는 것이 좋습니다.

실행 후 Ctrl-b를 누른 뒤 d를 눌러 세션에서 분리하면 노트북을 닫아도 에이전트는 계속 작동합니다. 나중에 tmux attach -t aider를 사용하여 다시 접속하면 에이전트가 수행한 변경 사항을 확인할 수 있습니다. 두 번째 tmux 창을 열어 다른 에이전트를 실행하는 데 아무런 제약이 없으며, 두 에이전트 모두 Claude Code라면 사용자가 직접 전달할 필요 없이 두 세션 간에 작업을 주고받을 수 있습니다. Aider는 저장소를 읽고, 편집을 제안하고, 이를 적용한 뒤 각각 커밋합니다. 변경 사항이 여러 파일에 걸쳐 있을 경우 추가 파일을 불러와 문맥을 파악할 수도 있습니다. 모든 변경 사항이 커밋으로 기록되므로, 에이전트의 작업을 되돌리는 것은 간단히 git revert를 사용하면 됩니다. 이것이 바로 안심하고 에이전트를 사용할 수 있게 해주는 안전장치입니다. Goose는 문서화된 한 줄 스크립트로 설치되며 터미널에서 유사하게 실행되어 확장 기능을 통해 작업을 수행합니다.

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

호스팅 모델 또는 자체 호스팅 모델

호스팅 모델은 최고의 품질을 제공하며 로컬 하드웨어가 필요하지 않지만, 토큰당 비용이 발생하고 코드가 제공자에게 전송됩니다. 에이전트는 매 턴마다 전체 대화 내용을 다시 전송하므로 토큰당 비용은 대부분의 예상보다 빠르게 증가합니다. Aider와 Goose도 동일한 방식으로 과금하므로, 긴 에이전트 세션에서 실제로 소모되는 토큰량에 대한 Claude Code의 분석 내용이 여기에도 그대로 적용됩니다. Ollama를 통한 자체 호스팅 모델은 모든 데이터를 서버 내부에 유지하며 하드웨어 비용을 지불하고 나면 운영 비용이 무료입니다. 하지만 유용한 수준의 코딩 모델을 구동하려면 상당한 메모리가 필요합니다. 품질과 편의성, 그리고 개인정보 보호와 비용 사이에서 저울질해야 합니다.

자체 호스팅을 선택한다면 어떤 모델이 서버에 적합한지가 실질적인 문제입니다. 이때 컨텍스트 윈도우를 주의 깊게 살펴야 합니다. Ollama는 기본값이 작게 설정되어 있으며 그보다 긴 내용은 별도의 알림 없이 잘라내기 때문입니다. 코딩 에이전트의 경우 방금 읽은 파일이 프롬프트에서 사라지는 결과를 초래합니다. num_ctx를 높이면 이 문제가 해결되지만, 그에 따라 필요한 더 큰 KV 캐시는 예산에 포함해야 할 메모리 용량의 일부가 됩니다. 8GB 모델을 수용할 수 없는 장비에 다운로드하기 전에 크기를 먼저 산정하십시오.

안전: 파일 편집 및 명령어 실행

코딩 에이전트는 수동적인 도구가 아닙니다. 파일을 직접 수정하고 빌드 및 테스트 명령어를 실행할 수 있으므로, 시스템을 변경할 수 있는 다른 프로세스와 동일한 수준의 주의를 기울여야 합니다. 다음 세 가지 습관으로 대부분의 위험을 방지할 수 있습니다. 첫째, git 저장소 내부에서 작업하십시오. 모든 변경 사항이 기록되어 되돌릴 수 있으며, Aider는 이를 자동으로 처리합니다. 둘째, 최소 권한 사용자 원칙에 따라 에이전트를 root가 아닌 일반 사용자 권한으로 실행하여, 잘못된 명령어가 시스템 전체에 영향을 미치지 않도록 하십시오. 셋째, 코딩용 VPS 역시 공개 서버이므로 SSH 키 인증, 기본 거부(default-deny) 방화벽 설정 등 서버 자체의 보안을 강화하십시오. OpenClaw 보안 강화 가이드는 더 자율적인 에이전트에 대해 동일한 입장을 취하고 있으며, 해당 원칙들은 공통으로 적용됩니다.

코딩 에이전트를 자신의 워크플로우에 통합하려면, Claude를 활용한 AI 에이전트 구축을 통해 모델이 도구를 제어하는 방법을 확인하십시오. VPS에서 Google Gemini CLI 실행하기는 또 다른 터미널 기반 옵션이며, OpenHands 셀프 호스팅은 더 무거운 자율형 경로입니다. 현재 이 분야에서 가장 많은 별을 받은 오픈 프로젝트 역시 자체 가이드를 제공합니다. VPS에서 OpenCode 실행하기는 tmux와 일반 사용자 패턴을 사용하여 환경을 구성하는 방법을 안내합니다.

FAQ

유료 API 대신 로컬 모델로 코딩 에이전트를 실행할 수 있습니까?

네, 가능합니다. Aider와 Goose 모두 Ollama로 구동되는 로컬 모델을 지원하므로, 토큰당 비용을 지불하거나 코드가 서버 외부로 유출될 걱정 없이 완전히 자체 호스팅된 환경에서 코딩 에이전트를 실행할 수 있습니다. 다만 메모리 요구 사항에 주의해야 합니다. 유용한 코드를 작성할 만큼 성능이 좋은 모델은 상당한 양의 RAM이나 VRAM을 필요로 하므로, 모델을 선택하기 전에 서버 사양을 먼저 확인하십시오.

Aider와 Goose 중 무엇을 사용해야 합니까?

터미널과 git 중심의 워크플로우를 선호하고 가장 성숙하며 오버헤드가 적은 도구를 원한다면 Aider를 선택하십시오. Aider는 모든 변경 사항을 자동으로 커밋하므로 기록을 언제든 되돌릴 수 있습니다. 더 넓은 범위의 확장 생태계와 다양한 공급자를 지원하는 범용 어시스턴트를 원한다면 Goose를 선택하십시오. 두 도구 모두 터미널에서 실행되며 Ollama와 호환되므로 VPS 환경에 적합합니다.

자체 호스팅 코딩 모델을 실행하려면 메모리가 얼마나 필요합니까?

모델의 크기와 양자화(quantization) 수준에 따라 다릅니다. 작은 양자화 모델은 몇 기가바이트의 메모리로도 실행할 수 있지만, 성능이 뛰어난 모델은 훨씬 더 많은 메모리를 요구하며 긴 컨텍스트 윈도우를 사용할 경우 메모리 사용량은 더 늘어납니다. 모델을 다운로드하기 전에 위에서 제공한 사이징 도구를 사용하여 특정 모델과 컨텍스트 길이에 필요한 메모리 용량을 추정하십시오.

AI 에이전트가 코드를 수정하고 명령어를 실행하게 해도 안전합니까?

올바른 습관을 갖춘다면 충분히 관리할 수 있습니다. 모든 수정 사항을 되돌릴 수 있도록 작업을 git 저장소에서 관리하고, 에이전트는 root가 아닌 권한이 제한된 사용자로 실행하며, 일반적인 공개 서버를 운영할 때와 마찬가지로 VPS 보안을 강화하십시오. 에이전트가 커밋한 변경 사항을 맹목적으로 신뢰하지 말고 반드시 검토하십시오. 특히 시스템을 대상으로 실행하려는 명령어는 더욱 주의 깊게 확인해야 합니다.