AI 개발 도구의 원클릭 테이크오버

원클릭 테이크오버(Takeover) 기능을 사용하면 복잡한 설정 파일을 직접 편집하지 않고도 주요 AI 개발 CLI 도구들의 엔드포인트를 로컬 AI 게이트웨이로 손쉽게 전환할 수 있습니다. 테이크오버 이후엔 해당 도구들의 모든 요청이 http://127.0.0.1:11580로 통합 라우팅되며, 게이트웨이에서 설정한 공급 채널에 따라 처리됩니다. 모든 사용량과 비용도 한눈에 통합 관리할 수 있습니다.

동작 방식

각 도구에 대해 원클릭 테이크오버를 실행하면 게이트웨이가 다음 과정을 자동으로 진행합니다:

게이트웨이 정상 동작 확인 — 프록시 엔드포인트가 사용 가능한지 점검합니다.
고유 가상 키 자동 생성 — 해당 도구에만 사용되는 가상 키가 생성되며, 평문은 최초 한 번만 반환되어 도구 설정에 적용됩니다.
기존 설정 파일 백업 — 파일이 .bak 확장자(예: ~/.claude/settings.json.bak)로 자동 보관됩니다.
정확한 설정/깊은 병합 적용 — 게이트웨이를 가리키는 설정만 추가·수정하며, 기존의 다른 설정은 그대로 유지합니다.
상태 UI 즉시 업데이트 — 현재 테이크오버 현황을 직관적으로 보여줍니다.

테이크오버 해제 시에도 "정확한 제거"가 적용됩니다. 즉, 해당 설정이 실제로 우리 게이트웨이를 가리키는 경우에만 관련 키를 제거하여, 사용자가 수동으로 만든 기타 설정이 삭제되는 오류를 예방합니다.

테이크오버 상태

각 도구의 테이크오버 현황은 AI 게이트웨이 → 엔드포인트(Endpoints) 페이지에서 다음 네 가지 상태로 나타납니다:

상태	의미
테이크오버 완료(로컬 게이트웨이)	도구가 로컬 AI 게이트웨이를 가리키고 있음
이미 연결(다른 주소)	도구가 다른 주소(수동 설정 또는 타 게이트웨이)로 연결되어 있어, 설정을 자동으로 변경하지 않음
미테이크오버	도구는 발견되었으나 아직 게이트웨이를 가리키지 않음
미발견	해당 도구의 설정 디렉터리가 로컬에서 확인되지 않음

사전 조건

ServBay 계정에 로그인 되어 있고, 채널에서 최소 1개의 사용 가능한 채널이 미리 등록되어 있어야 합니다.
테이크오버 대상 AI 개발 도구가 이미 로컬에 설치되어 있어야 합니다(게이트웨이는 설정 디렉터리 존재 여부로 확인).

원클릭 테이크오버 하는 법

AI 게이트웨이 → 엔드포인트(Endpoints) 페이지에서 원하는 도구를 찾아 원클릭 테이크오버 버튼을 클릭하면 즉시 상태가 "테이크오버 완료(로컬 게이트웨이)"로 바뀝니다. 해제하고 싶을 땐 제거/복원 버튼을 눌러 언제든 되돌릴 수 있습니다.

도구별 테이크오버 상세

아래 표는 각 도구의 테이크오버 시 실제로 변경되는 설정 파일과 주요 내용, 적용되는 게이트웨이 주소를 보여줍니다. 문제 발생 시 참고하실 수 있습니다.

도구	설정 파일	적용 내용	게이트웨이 주소
Claude Code	`~/.claude/settings.json`	`env.ANTHROPIC_BASE_URL` + `env.ANTHROPIC_AUTH_TOKEN`	`http://127.0.0.1:11580` (/v1 없음)
Codex	`~/.codex/config.toml`	`[model_providers.servbay]` 섹션 + 최상단 `model_provider = "servbay"`	`http://127.0.0.1:11580/v1`
Gemini CLI	`~/.gemini/.env`	`GOOGLE_GEMINI_BASE_URL` + `GEMINI_API_KEY` 두 줄	`http://127.0.0.1:11580`
Qwen Code	`~/.qwen/.env`	`OPENAI_BASE_URL` + `OPENAI_API_KEY` (OpenAI 호환)	`http://127.0.0.1:11580/v1`
Kimi CLI	`~/.kimi/config.toml`	`[model_providers.servbay]` 섹션 + 모델 정의	`http://127.0.0.1:11580/v1`
CodeBuddy	`~/.codebuddy/models.json`	servbay 모델 노드를 깊게 병합	`http://127.0.0.1:11580/v1`
opencode	`~/.config/opencode/opencode.json`	`provider.servbay` 노드 깊은 병합(여러 채널 모델 통합)	`http://127.0.0.1:11580/v1`
Crush	`~/.config/crush/crush.json`	`providers.servbay` 노드 깊은 병합	`http://127.0.0.1:11580/v1`

왜 Claude Code 주소에 /v1이 없나요

Claude Code는 Anthropic 프로토콜을 사용하며, 게이트웨이가 /v1/messages 등 경로를 자동으로 덧붙여줍니다. 그래서 ANTHROPIC_BASE_URL은 무조건 루트 주소(/**/v1 없이)**여야 합니다. 나머지 도구들은 OpenAI 호환 프로토콜을 쓰므로 /v1 접미사가 필요합니다. 원클릭 테이크오버가 도구별로 자동 설정해주니 신경 쓸 필요 없습니다.

복원 및 문제해결

기존 설정 복원 — 제거 버튼 클릭 시, 게이트웨이가 로컬 게이트웨이 관련 설정만 정확하게 삭제합니다. 수동 복원이 필요하다면 같은 디렉터리에 저장된 .bak 파일로 원래 설정을 직접 덮어쓸 수도 있습니다.
"이미 연결(다른 주소)" 상태 — 현재 도구가 다른 주소 또는 타 게이트웨이를 참조하고 있다는 뜻입니다. 기존 설정을 덮지 않기 위해 게이트웨이에서는 자동으로 테이크오버하지 않으니, 수동으로 해당 설정을 삭제 후 재시도하세요.
테이크오버 후에도 오류 발생 — 게이트웨이 프록시가 정상 실행 중인지, 사용 채널 상태와 가상 키가 발급·정상인지 확인하세요. 통계/모니터링 페이지에서 요청이 정상적으로 경유하는지도 점검 가능합니다.

자주 묻는 질문(FAQ)

Q: 원클릭 테이크오버가 기존 도구 설정을 망가뜨릴 수 있나요?
- A: 그렇지 않습니다. 게이트웨이는 게이트웨이 관련 키만 정확히 기록/병합하고, 기존 파일은 .bak 백업으로 저장합니다. 다른 설정은 그대로 유지합니다.
Q: 테이크오버 후 수동으로 원상복구할 수 있나요?
- A: 가능합니다. "제거"를 클릭해 게이트웨이에서 되돌릴 수 있고, 직접 .bak 백업 파일로 복원해도 됩니다.
Q: 테이크오버에 사용되는 가상 키는 어디서 확인하나요?
- A: 게이트웨이가 테이크오버된 각 도구마다 전용 가상 키를 자동 생성합니다. 키 관리 페이지에서 생성/관리할 수 있습니다.
Q: 목록에서 "미발견"으로 표시되는 도구가 있습니다. 왜 그런가요?
- A: 해당 도구의 설정 디렉터리가 로컬에서 발견되지 않아 발생한 현상입니다. 먼저 도구를 설치하고 한 번 실행해서 설정 디렉터리를 생성한 후 테이크오버를 진행하십시오.

요약

원클릭 테이크오버를 활용하면 번거롭고 실수하기 쉬운 "도구별 설정 파일 수동 편집"이 단 한 번의 클릭으로 자동화됩니다. 가상 키 자동 생성, 설정 백업·정확한 병합, 언제든 복원까지 모두 지원합니다. 게다가 모든 AI 개발 도구의 사용량/비용 관리까지 하나의 공급자 체계로 통합할 수 있습니다. 만약 코드상에서 직접 게이트웨이를 호출하려면 엔드포인트와 환경 변수를 참고하세요.

AI 개발 도구의 원클릭 테이크오버 ​

동작 방식 ​

테이크오버 상태 ​

사전 조건 ​

원클릭 테이크오버 하는 법 ​

도구별 테이크오버 상세 ​

복원 및 문제해결 ​

자주 묻는 질문(FAQ) ​

요약 ​