암프, 1년 만에 BYOK 재개: AIHubMix 연결 및 구성

암프가 BYOK(Bring Your Own Key)를 재개하였으며, AIHubMix가 이를 지원합니다. 이 가이드는 앤트로픽의 클로드 모델을 예시로 사용하여 암프를 AIHubMix API에 맞추는 방법을 설명합니다. 여기에는 Custom URL 및 모델 라우팅을 통해 API 키, 모델 이름 매핑 및 프로젝트 설정이 포함됩니다.

"Amp BYOK 설정", "Amp를 AIHubMix에 연결", "AIHubMix API 키", "Amp Custom URL" 또는 "Amp 모델 라우팅"을 검색하고 있다면, 아래 단계가 이를 다룹니다.

암프는 무엇에 유용한가요?

다중 모델 워크플로우: 서로 다른 모델을 서로 다른 모드 및 에이전트에 할당 — 클로드, GPT 또는 경량 작업을 위한 빠른 모델.
전체 프로젝트 컨텍스트: 암프는 코드베이스를 읽고, 파일을 수정하며, 명령을 실행하고, 테스트를 수행합니다.
BYOK 및 사용자 지정 라우팅: 모델 라우팅, 사용자 지정 URL 및 타사 API 서비스를 통해 원하는 모델과 공급자를 선택합니다.
웹 및 CLI 함께: 브라우저에서 모델을 구성한 후 터미널에서 계속 작업합니다.
팀을 위한 설계: 모든 스레드를 공유하고 팀원과 함께 작업합니다.
클라우드 동기화 스레드: 모든 스레드는 자동으로 클라우드에 동기화되어 팀이 항상 동일한 상태에서 작업을 이어갈 수 있습니다.

이 가이드의 나머지 부분은 앤트로픽의 클로드 모델을 사용하여 AIHubMix를 암프에 연결하는 방법을 보여줍니다.

왜 AIHubMix를 통해 암프를 라우팅하나요? 하나의 키와 하나의 기본 URL로 400개 이상의 모델에 접근할 수 있으며, 엔드포인트는 앤트로픽 메시지 API와 호환됩니다(따라서 암프가 원활하게 통신합니다). 키별 모델 이름 매핑 및 오류 대체 기능을 통해 클라이언트가 기대하는 이름에 맞게 조정할 수 있습니다. 계정 만들기 →

1부 — API 연결하기

1단계: 개인 설정 열기

암프 홈 화면에서 왼쪽 하단의 개인 설정을 클릭합니다.

2단계: 사용자 지정 모델 경로 추가

왼쪽 사이드바에서 모델 라우팅을 찾아 오른쪽에서 추가를 클릭하고 사용자 지정 URL을 선택합니다.

3단계: API 키 생성 및 모델 이름 매핑 설정

AIHubMix 콘솔로 이동하여 API 키를 생성한 후, 모델 이름 매핑을 구성합니다.

암프는 모델 이름을 provider/model 형식으로 기대합니다 — 예를 들어 anthropic/claude-fable-5-1. AIHubMix 모델 ID는 provider/ 접두사가 없으므로, 암프가 모델 ID AIHubMix가 제공하는 것으로 전송하는 이름을 재작성하는 매핑을 추가합니다:

별칭 (암프가 전송하는 것)	대상 (AIHubMix 모델 ID)
`anthropic/claude-fable-5-1`	`claude-fable-5-1`

별칭을 사용한 요청은 대상 모델 ID로 재작성됩니다. 각 키는 최대 5개의 매핑을 지원하며, 요청 오류 시 순서대로 재시도할 대체 모델을 선택적으로 추가할 수 있습니다.

4단계: 연결 세부정보 입력

암프의 사용자 지정 URL 화면으로 돌아가서 필드를 채웁니다:

API 키: AIHubMix에서 방금 생성한 키.
API 형식: 앤트로픽 메시지 API와 호환을 선택합니다.
기본 URL: https://aihubmix.com — 암프는 필드 아래에서 요청이 https://aihubmix.com/v1/messages로 간다고 확인합니다.
모델: 매핑한 별칭을 한 줄에 하나씩 나열합니다(예: anthropic/claude-fable-5-1). 암프는 각 별칭을 해결하고 그 아래에 표시 이름을 보여줍니다.

생성 후 활성화를 체크한 상태로 두어 새 요청이 즉시 공급자를 통해 라우팅되도록 한 후 생성을 클릭합니다.

5단계: 연결 확인

저장 후 모델 라우팅 페이지에 새 사용자 지정 URL이 나열됩니다. 접근 확인을 클릭하여 연결을 테스트합니다.

작동하는 키는 GET https://aihubmix.com/v1/models 프로브와 함께 유효한 키를 반환하며, HTTP 200 응답과 가시 모델 수를 제공합니다. 아래 모델 목록은 이 사용자 지정 URL이 접근할 수 있는 모든 것을 보여줍니다.

2부 — 프로젝트 및 스레드 생성

6단계: 프로젝트 생성

왼쪽 하단의 프로젝트 항목을 클릭한 후 오른쪽 상단의 새 프로젝트 버튼을 클릭합니다.

처음부터 시작을 선택하고 프로젝트 이름을 입력한 후 프로젝트 생성을 완료합니다.

7단계: 스레드 생성

프로젝트 내에서 새 스레드를 클릭하여 작업을 시작합니다.

3부 — 모델 할당 및 작업 시작

8단계: 각 역할에 모델 할당

다시 개인 설정으로 돌아가서 모드 다이얼을 엽니다. 각 모드는 자동으로 모델을 선택하며, 여기에서 특정 모델과 추론 노력을 모드의 주 에이전트, 오라클, 서브 에이전트에 고정할 수 있습니다. 자동으로 남겨진 것은 암프의 자체 라우팅을 따릅니다.