AI 코딩 도구 원클릭 테이크오버

원클릭 테이크오버(Takeover)를 사용하면 구성 파일을 수동으로 편집할 필요 없이 자주 사용하는 AI 코딩 CLI 도구를 로컬 AI 게이트웨이로 연결할 수 있습니다. 테이크오버 후에는 해당 도구의 요청이 http://127.0.0.1:11580을 통해 게이트웨이에 구성된 공급자 채널로 통합 라우팅되며, 사용량과 비용 통계에도 함께 반영됩니다.

작동 원리

각 도구에 대해 원클릭 테이크오버를 실행하면 게이트웨이가 다음 단계를 순서대로 수행합니다.

1. 게이트웨이 상태를 확인하여 프록시 엔드포인트가 사용 가능한지 검증합니다.
2. 전용 가상 키를 자동으로 생성합니다(게이트웨이가 도구 구성에 기록하며, 평문은 키 페이지에서 언제든지 다시 확인할 수 있습니다).
3. 기존 구성 파일을 백업하여 .bak 확장자를 붙입니다(예: ~/.claude/settings.json.bak).
4. 게이트웨이를 가리키는 구성을 정밀하게 작성/심층 병합하며, 사용자의 다른 설정은 그대로 유지합니다.
5. 인터페이스 상태를 새로 고침하여 현재 테이크오버 상황을 표시합니다.

테이크오버 중지 또한 '정밀 제거' 방식으로 동작합니다. 구성이 실제로 본 게이트웨이를 가리키는 경우에만 해당 키를 제거하여 사용자가 수동으로 설정한 다른 구성이 실수로 삭제되는 것을 방지하며, 동시에 테이크오버 시 자동 생성된 가상 키도 폐기합니다.

테이크오버 상태

각 도구는 AI 게이트웨이 → 접속 관리 → 클라이언트 페이지에서 다음 네 가지 상태 중 하나로 표시됩니다.

상태	의미
테이크오버됨(본 게이트웨이)	도구가 로컬 AI 게이트웨이를 가리키고 있음
연결됨(다른 주소)	도구에 다른 주소가 구성되어 있음(수동 구성 또는 다른 게이트웨이 지정). 게이트웨이는 임의로 덮어쓰지 않음
테이크오버 안 됨	도구는 감지되었으나 아직 게이트웨이를 가리키지 않음
감지되지 않음	본 컴퓨터에서 해당 도구의 구성 디렉터리를 찾지 못함

사전 요구 사항

• ServBay 계정에 로그인되어 있고, 채널 페이지에서 사용 가능한 채널을 최소 하나 이상 구성한 상태여야 합니다.
• 대상 AI 도구가 본 컴퓨터에 설치되어 있어야 합니다(게이트웨이는 구성 디렉터리를 기준으로 존재 여부를 판단합니다).

원클릭 테이크오버 실행

AI 게이트웨이 → 접속 관리 → 클라이언트 페이지로 이동하여 도구 목록에서 대상 도구를 찾고 원클릭 테이크오버를 클릭합니다. 테이크오버가 성공하면 상태가 '테이크오버됨(본 게이트웨이)'으로 변경됩니다. 되돌리려면 테이크오버 중지를 클릭하면 됩니다.

도구별 테이크오버 세부 정보

아래 표는 각 도구가 테이크오버될 때 실제로 수정되는 구성 파일과 내용을 나열한 것으로, 이해와 문제 해결에 도움이 됩니다.

도구	구성 파일	기록 내용	게이트웨이 주소
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
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 코딩 도구가 동일한 공급자 구성과 비용 뷰를 공유하도록 할 수 있습니다. 자체 코드에서 게이트웨이를 호출하려면 엔드포인트 및 환경 변수를 참고하세요.