Amazon Bedrock을 데스크톱 앱에서 쓰는 법

Amazon Bedrock은 앱이 아니라 AWS API예요. 내 컴퓨터에서 Claude나 다른 Bedrock 모델과 대화하려면 내 AWS 자격 증명으로 요청에 서명해 주는 클라이언트가 있어야 해요. Foxl은 Mac, Windows, Linux에서 쓰는 무료 데스크톱 AI 에이전트로, ~/.aws에 이미 있는 AWS 프로필, SSO 로그인, 액세스 키를 그대로 써요.

시작하기 전에: AWS 계정의 모델 접근 권한

AWS는 AWS Marketplace 권한만 맞으면 Bedrock 기반 모델 상당수를 기본으로 쓸 수 있게 열어 둬요. 일부 모델은 계정 단위 접근 권한이 따로 필요하고, Anthropic 모델은 처음 호출하기 전에 한 번만 First Time Use 양식을 내야 해요. 쓰는 AWS 자격 증명에도 Bedrock 모델을 호출할 권한이 있어야 해요.

1단계: 컴퓨터에 AWS 자격 증명 넣기

Foxl은 AWS CLI와 SDK가 자격 증명을 찾는 방식 그대로 읽어요. 그래서 AWS CLI로 설정해 두면 돼요.

• 액세스 키: aws configure를 실행해요. CLI가 홈 폴더의 .aws 폴더 안 credentials 파일에 저장해요.
• IAM Identity Center(SSO): aws configure sso로 프로필을 만든 다음 aws sso login으로 로그인해요. Foxl의 SSO 로그인 버튼도 같은 로그인을 대신 실행해 주는데, AWS CLI가 설치돼 있어야 해요.

credential_process 프로필, 환경 변수, 인스턴스 역할도 쓸 수 있어요.

2단계: Foxl을 Bedrock에 연결하기

1. foxl.ai에서 Foxl을 내려받아 설치하고 로그인해요. macOS 13 이상, Windows 10 이상(64비트), Linux x86-64(AppImage)에서 돌아가요.
2. 설정에서 모델/제공자를 열고, AI 제공자 항목의 제공자를 Amazon Bedrock으로 바꿔요.
3. AWS 인증에서 프로필을 골라요. 기본값 (env / 인스턴스)는 AWS의 기본 조회 순서를 따르고, 이름 있는 프로필을 고르면 그 프로필을 써요. SSO 프로필이라면 SSO 로그인을 눌러요.
4. 확인을 눌러 Foxl이 요청에 서명할 수 있는지 확인해요.
5. 리전을 고르고(기본값은 us-west-2), 기본 모델을 고른 다음 제공자 설정 저장을 누르면 끝이에요.

리전과 모델 ID

Foxl에서 고를 수 있는 리전은 us-west-2, us-east-1, us-east-2, ap-northeast-1, eu-west-2, ap-south-1, ap-southeast-2 일곱 곳이에요. 서울(ap-northeast-2)은 아직 목록에 없어요. 한국에서 써도 기본값인 us-west-2를 그대로 두는 게 가장 무난해요. 모델 목록은 내 계정에서 읽어 오는 게 아니라 Foxl에 들어 있고, 대부분의 모델이 교차 리전 추론 프로필 ID를 써요. us. 프로필은 요청을 미국 리전 안에서만 처리하고, global. 프로필은 어느 상용 AWS 리전이든 쓸 수 있어요. us. 모델이 미국 밖 리전에서 오류를 내면 리전을 us-west-2나 us-east-1로 바꿔 보세요.

Bedrock API 키는 어떻게 하나요

Bedrock API 키는 두 가지예요. 최대 12시간까지 쓰는 단기 키와, AWS가 탐색용으로만 권하는 장기 키가 있어요. 도구들은 이 키를 AWS_BEARER_TOKEN_BEDROCK 환경 변수에서 읽어요. Foxl 설정에는 키를 붙여 넣는 칸이 없으니, 프로필이나 SSO 로그인으로 설정하는 게 가장 간단해요.

자주 묻는 질문

Bedrock 사용료를 Foxl에 내나요?

아니요. Foxl은 무료이고 내 AWS 자격 증명으로 Bedrock을 호출하니까, 사용료는 Bedrock 요금대로 내 AWS 계정에 청구돼요.

Foxl에 Bedrock API 키를 붙여 넣을 수 있나요?

Foxl 설정에는 그런 칸이 없어요. Foxl은 표준 AWS 자격 증명 체인을 쓰니까 ~/.aws의 AWS 프로필이나 SSO 로그인으로 설정하는 게 가장 간단해요.

서울 리전에서도 쓸 수 있나요?

지금 Foxl의 리전 목록에는 서울(ap-northeast-2)이 없어요. 기본값인 us-west-2를 쓰면 되고, us.로 시작하는 모델은 미국 리전에서 쓰는 게 안전해요.

어떤 Bedrock 모델을 쓸 수 있나요?

Foxl에는 Claude를 포함한 Bedrock 모델 목록이 들어 있어요. 그중 어떤 모델이 응답하는지는 내 AWS 계정에 열려 있는 모델 접근 권한에 따라 달라요.