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

VPS에서 coding agent를 실행해야 하는 이유

coding agent는 터미널에서 codebase를 읽고, 변경 사항을 작성하며, 테스트를 위한 명령어를 실행하는 도구입니다. VPS에서 실행하면 노트북을 사용하는 것보다 세 가지 장점이 있습니다. 첫째, 연결을 끊은 후에도 작업이 계속 유지됩니다. 둘째, 코드 및 build tools 바로 옆에서 실행됩니다. 셋째, 직접 호스팅하는 model과 통신할 수 있습니다. tmux session 내에서 실행하면 노트북을 닫았다가 나중에 작업을 다시 시작할 수 있습니다. 이는 tmux를 사용하여 VPS에서 Claude Code를 실행하는 방식과 동일한 패턴입니다.

알아두어야 할 두 가지 terminal-based agent가 있습니다. Aider는 terminal-native 방식이며 git-first 옵션입니다. 각 변경 사항을 적절한 메시지와 함께 auto-commit하므로 history를 깨끗하게 유지하고 모든 수정을 되돌릴 수 있습니다. Aider는 가장 오래된 terminal coding agent 중 하나이지만, 최근 release pace가 느려졌습니다. Block의 Goose는 더 광범위합니다. Goose는 Apache-2.0 license를 따르는 agent로, 대규모 extension ecosystem을 갖추고 있으며 local Ollama models를 포함한 많은 provider를 지원합니다. 현재 Linux Foundation의 Agentic AI Foundation (AAIF)에서 개발 중입니다. Aider는 규율 있는 git-centric workflow에 적합하며, Goose는 다양한 plugin set을 가진 범용 assistant에 적합합니다.

요구 사항

Aider를 위해서는 git, tmux, 그리고 최신 Python이 설치된 VPS가 필요합니다. Goose의 경우에는 Goose installer가 필요합니다. 또한 model이 필요합니다. Anthropic 또는 OpenAI와 같은 provider의 hosted API key를 사용하거나, 동일한 VPS의 Ollama를 통해 local model을 사용해야 합니다. self-hosted 방식은 코드를 자신의 서버에 유지하며 token당 비용이 들지 않지만, 유능한 model을 구동하기 위한 충분한 memory가 필요합니다.

Aider 설치 및 실행

pipx를 사용하여 격리된 environment에 Aider를 설치하십시오. Ubuntu 24.04는 virtual environment 외부에서 일반적인 pip install를 차단하므로(PEP 668), pipx는 apt를 통해 설치됩니다. 그 다음, 연결이 끊겨도 작업이 유지되도록 tmux session 내의 프로젝트 디렉토리에서 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의 pinned dependencies에 포함된 이전 버전의 numpy가 26.04의 Python 3.14과 호환되지 않기 때문입니다. 해결 방법은 Aider 전용 Python 3.12를 제공하는 것입니다.

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

pipx는 Aider만을 위한 standalone interpreter를 다운로드하며 설치가 완료됩니다. 이는 Aider의 느려진 release pace로 인한 현상입니다. 이 문제가 중요하다면 Goose가 더 활발하게 유지보수되는 선택지입니다.

실행 중인 상태에서 Ctrl-b를 누른 후 d를 눌러 session을 detach하면 노트북을 닫아도 agent는 계속 작동합니다. 나중에 tmux attach -t aider로 reattach하여 변경 사항을 확인할 수 있습니다. Aider는 repository를 읽고, 수정을 제안하고, 적용한 뒤 각각 commit합니다. 변경 사항이 여러 파일에 걸쳐 있는 경우 context를 위해 추가 파일을 가져올 수 있습니다. 모든 변경 사항은 commit이므로, agent의 작업을 되돌리는 것은 단순한 git revert이며, 이는 안전한 사용을 보장하는 safety net입니다. Goose는 문서화된 one-line script로 설치되며 terminal에서 유사하게 실행되며, extension을 통해 작업을 수행합니다.

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

Hosted model 또는 self-hosted model

hosted model은 최고의 품질을 제공하며 로컬 hardware가 필요 없지만, token당 비용이 발생하며 코드가 provider로 전송됩니다. agent가 매 turn마다 전체 대화 내용을 다시 전송하기 때문에 token 비용은 예상보다 빠르게 증가합니다. Aider와 Goose도 동일한 방식으로 과금되므로, long agent session의 실제 token 소모량에 대한 Claude Code의 분석이 여기에도 적용됩니다. Ollama를 통한 self-hosted model은 모든 데이터를 서버에 유지하며, hardware 비용을 제외하면 실행 비용이 무료입니다. 하지만 유용한 coding model을 사용하려면 충분한 memory가 필요합니다. 이것이 고려해야 할 trade-off입니다. 즉, 품질 및 편의성과 privacy 및 비용 사이의 선택입니다.

self-hosted 방식을 선택할 경우, 서버에 적합한 model을 찾는 것이 실질적인 문제입니다. 수용할 수 없는 사양의 서버에 8GB 모델을 다운로드하기 전에 크기를 측정하십시오.

안전성: 파일 수정 및 명령어 실행

coding agent는 수동적이지 않습니다. 파일을 재작성하고 build 및 test 명령어를 실행할 수 있으므로, 시스템을 변경할 수 있는 다른 프로세스와 동일한 주의를 기울여야 합니다. 세 가지 습관으로 대부분의 위험을 방지할 수 있습니다. 첫째, 모든 변경 사항이 추적되고 되돌릴 수 있도록 git repository 내에서 작업하십시오. Aider는 이 작업을 자동으로 수행합니다. 둘째, least-privilege users 원칙에 따라 root가 아닌 일반 unprivileged user로 agent를 실행하여 잘못된 명령어가 시스템 전체에 영향을 미치지 않게 하십시오. 셋째, coding VPS는 여전히 public server이므로 서버 자체를 hardening하십시오. key-only SSH, default-deny firewall 등을 적용하십시오. OpenClaw hardening guide도 자율적인 agent를 위해 동일한 입장을 취하며, 이 원칙들은 공통적으로 적용됩니다.

coding agent를 자신의 workflow에 연결하려면, Claude로 AI agent 구축하기에서 하나의 model이 도구를 제어하는 방법을 확인할 수 있습니다. VPS에서 Google Gemini CLI 실행하기는 또 다른 terminal 옵션이며, OpenHands self-hosting은 더 무거운 autonomous 방식입니다. 이 분야에서 가장 많은 star를 받은 오픈 프로젝트는 현재 자체 가이드를 보유하고 있습니다: VPS에서 OpenCode 실행하기에서 동일한 tmux 및 unprivileged-user 패턴으로 설정할 수 있습니다.

FAQ

유료 API 대신 local model로 coding agent를 실행할 수 있습니까?

네. Aider와 Goose 모두 Ollama로 제공되는 local models와 작동하므로, token 비용 없이 코드가 서버를 떠나지 않는 완전한 self-hosted coding agent를 실행할 수 있습니다. 주의할 점은 memory입니다. 유용한 코드를 작성할 수 있는 충분한 능력을 갖춘 model은 상당한 양의 RAM 또는 VRAM을 필요로 하므로, 모델을 결정하기 전에 machine의 사양을 확인하십시오.

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

workflow가 terminal 및 git 중심이고 가장 성숙하며 오버헤드가 낮은 옵션을 원한다면 Aider를 선택하십시오. Aider는 모든 변경 사항을 auto-commit하므로 history를 되돌릴 수 있습니다. 광범위한 extension ecosystem과 다양한 provider 지원을 갖춘 범용 assistant를 원한다면 Goose를 선택하십시오. 두 도구 모두 terminal에서 실행되며 Ollama와 작동하므로 VPS에 적합합니다.

self-hosted coding model에는 어느 정도의 memory가 필요합니까?

model의 크기와 quantization 정도에 따라 다릅니다. 작은 quantized model은 몇 GB에서 실행될 수 있지만, 더 강력한 model은 훨씬 더 많은 메모리를 요구하며, 긴 context window는 메모리 사용량을 늘립니다. 모델과 context length를 다운로드하기 전에 위의 sizing tool을 사용하여 필요한 메모리를 추정하십시오.

AI agent가 코드를 수정하고 명령어를 실행하도록 두는 것이 안전합니까?

올바른 습관을 갖추면 관리 가능합니다. 모든 수정 사항이 되돌릴 수 있는 commit이 되도록 작업을 git repository에서 수행하고, agent를 root가 아닌 unprivileged user로 실행하며, 일반적인 public server와 마찬가지로 VPS를 hardening하십시오. agent가 commit하는 변경 사항을 맹목적으로 신뢰하지 말고 검토하십시오. 특히 시스템에 대해 실행하려는 명령어는 반드시 확인해야 합니다.