본문으로 건너뛰기

기계 번역입니다. 정식 기준은 영어판이며, 원어민 검수는 아직 완료되지 않았습니다.

Self-hosted

Claude Code, Codex, Grok을 내 서버에서 실행하기: 브라우저로 제어

작성자 Olivares AI 2 분 소요

코딩 에이전트는 코드와 빌드 도구, 자격 증명이 있는 머신에서 가장 좋은 성능을 냅니다. 대부분의 팀에게 그 머신은 노트북이 아니라 서버입니다. Olivares AI는 그 서버에서 Claude Code, Codex, Grok Build를 실행하고, 세션을 시작하고 지켜보고 중지할 수 있는 웹 콘솔 하나와 CLI 하나를 제공합니다.

엔진 설치하기

Olivares AI는 콘솔이 내장된 단일 프로그램입니다. Linux나 macOS에서는 명령 하나로 설치되며, 무엇이든 설치하기 전에 릴리스를 먼저 검증합니다.

curl -fsSL https://olivares.ai/olivares/install.sh | sh
olivares quickstart

quickstart는 콘솔 주소와 첫 번째 관리자를 만들 때 쓰는 일회용 토큰을 출력합니다. Docker 이미지, Debian·RPM·Alpine 패키지, Homebrew tap도 제공됩니다. 모든 설치 방법은 설치 가이드에 나와 있습니다.

이미 가진 계정으로 도구 연결하기

콘솔에서 AI tools를 엽니다. 여기서 Claude Code, Codex, Grok Build를 설치하고 각 도구 자체의 로그인 절차를 실행하므로, 팀이 이미 결제하고 있는 구독으로 로그인할 수 있습니다. 로그인한 계정마다 별도의 도구 인스턴스가 만들어지며, 콘솔에는 해당 도구가 보고하는 요금제, 사용량 구간, 모델이 표시됩니다.

API 키를 선호한다면 Providers에서 추가하세요. 로컬 모델도 사용할 수 있습니다. Ollama는 접근 가능한 엔드포인트와 모델 이름만 있으면 됩니다.

세션 시작하기

Sessions → New session을 선택하고 준비된 도구를 고르세요. 프로필과 프로젝트 폴더는 엔진이 채워 줍니다. 첫 메시지를 입력하고 Start를 누르면 됩니다.

터미널에서도 똑같이 할 수 있습니다. session start에는 폴더와 첫 프롬프트를 넘깁니다.

olivares login
olivares session start ~/work/api "Explain this project." --name api-review --detach

--detach는 프롬프트를 보내고 응답을 기다리지 않고 바로 돌아옵니다. 터미널을 닫아도 세션은 서버에서 계속 실행됩니다. 어느 터미널에서든 olivares session follow api-review로 출력을 다시 따라갈 수 있습니다. Business에서는 콘솔의 라이브 터미널과 olivares session send, resume으로 계속 세션을 조종할 수 있습니다.

git 저장소에서는 Work in a new git worktree를 사용하면 세션마다 전용 브랜치와 작업 디렉터리가 주어지므로, 두 세션이 같은 체크아웃을 수정하는 일이 없습니다. 정리 작업은 커밋되지 않았거나 병합되지 않은 작업을, 명시적으로 지시하지 않는 한 버리지 않습니다.

승인, 중단, 중지, 재개

Ask before each action을 켜면 도구는 동작하기 전에 사용자의 응답을 기다립니다. 요청은 Approvals에 나타나며, 거기서 승인하거나 거부할 수 있습니다.

Interrupt는 현재 턴을 끝내고 대화는 유지합니다. Stop은 프로세스를 종료합니다. Business에서는 Resume이 같은 프로필, 계정, 폴더로 같은 세션을 다시 시작하며, 그 전에 자격 증명과 정책을 다시 확인합니다. 세션이 스스로 다른 로그인으로 바뀌는 일은 없습니다. 계정을 더 이상 사용할 수 없으면 실행이 거부됩니다.

모든 세션에 적용되는 규칙

모든 세션이 엔진에서 시작되므로 같은 규칙이 전부에 적용됩니다. Olivares AI는 deny-closed(기본 거부) 방식의 네 가지 강제 지점에서 동작을 검사합니다. Claude Code 내부, 모델 프록시, 모든 MCP 도구 호출, 그리고 에이전트 사이입니다. Business에서는 팀, 에이전트, 모델별 예산이 지출에 대해 경고하거나, 속도를 늦추거나, 중단시킵니다. 모든 결정은 서명되고 변조가 드러나는 로그에 기록됩니다.

제공업체 키에 묶인 Claude Code와 Codex 세션은 세션별 프록시를 통해 해당 제공업체의 엔드포인트에만 접근하며, 그렇지 않으면 시작되지 않습니다. 계정으로 로그인하는 세션, 그리고 Grok Build와 OpenCode 세션은 이런 방식으로 격리되지 않습니다. 네트워크가 허용하는 모든 호스트에 접근할 수 있습니다.

직접 사용해 보기

Community는 무료 오픈 소스이며 사용자 수에 제한이 없습니다. GitHub 저장소에서 설치하거나, 먼저 작동 방식을 읽어 보세요. Business는 상용 라이선스와 함께 대규모 조직과 규제 대상 조직에 필요한 기능을 더합니다.

관련 글

후크 PEP 내부: Claude Code 내부 거부 폐쇄 정책

PEP가 모든 Claude Code 후크 이벤트를 게이팅, 컨텍스트 또는 관찰로 분류하고, 이벤트별로 올바른 출력 스키마를 연결하고, 알 수 없는 이벤트를 거부하고 닫는 방법입니다.

자주 묻는 질문

기존 Claude 또는 ChatGPT 구독을 그대로 사용할 수 있나요?

네. AI tools 페이지에서 각 도구 자체의 로그인 절차를 실행하며, 로그인한 계정마다 별도의 도구 인스턴스가 만들어집니다. Providers에서 API 키나 로컬 모델 엔드포인트(예: Ollama)를 추가할 수도 있습니다.

노트북을 닫으면 어떻게 되나요?

세션은 서버에서 계속 실행됩니다. olivares session follow로 출력을 다시 따라갈 수 있습니다. 콘솔의 라이브 터미널에 다시 연결하는 기능은 Business에 포함됩니다.

무료인가요?

Community는 AGPL-3.0 라이선스의 무료 오픈 소스이며 사용자 수에 제한이 없습니다. Business는 상용 라이선스와 함께 대규모 조직과 규제 대상 조직에 필요한 기능을 더합니다.

에이전트가 무엇에 접근할 수 있는지 확인하세요

Olivares AI는 당신의 AI 환경을 위한 개방형 자체 호스팅 플랫폼입니다. 자체 인프라에 배포하고 보안 및 플랫폼 팀이 필요로 하는 액세스 맵을 확보하세요.