모델을 선택하기 전에 이미지 이해, 파일 수정, 도구 실행, 텍스트 정리 중 무엇이 필요한지 생각하세요. 모델은 이해와 생성을 담당하고, Agent는 그 능력을 도구와 작업 환경에 연결합니다. Codex와 Claude Code는 Agent 실행 도구이며, 모델은 화면에서 별도로 선택합니다. 개념은 모델과 Agent를 참고하세요.
- Agent.Space 모델사용 가능한 요금제 또는 Flex 사용
- 자체 모델 API제공자를 Workspace에 연결
- Developer API외부 클라이언트에서 Model API Key 사용
그림은 두 키의 방향을 구분합니다. 자체 모델 API는 외부 서비스를 Workspace로 연결하고, Model API Key는 외부 클라이언트가 Agent.Space 모델 서비스를 사용하도록 합니다. 이름이 비슷해도 같은 자격 증명이나 청구가 아닙니다.
사용 가능한 Agent와 모델 조합 선택하기
새 대화에서 Agent를 고른 뒤 모델 메뉴의 선택지를 확인하세요. 모델 목록에 있다고 모든 Agent나 첨부 파일과 호환되는 것은 아닙니다. 이미지 입력은 모델, Agent, 실행 진입점이 함께 지원해야 합니다. 지원하지 않으면 이미지를 제거하거나 조합을 바꾸라는 안내가 나옵니다.
긴 작업 전에 작은 작업으로 확인하세요.
현재 웹페이지 파일을 읽고 휴대전화에서 읽기 가장 불편한 문제 세 가지를 알려 주세요. 분석만 하고 수정하지 마세요. 추가 도구나 자료가 필요하면 먼저 알려 주세요.
응답이 실제 파일을 반영하는지, 부족한 자료를 설명하는지 확인합니다. 이미지 기능을 확인하려면 관련 스크린샷을 첨부하고 직접 검증할 수 있는 세부 사항을 물어보세요. 유창한 답변만으로 자료를 읽었다고 판단할 수는 없습니다.
기존 Session의 Agent 유형은 자유롭게 바꿀 수 없습니다. 다른 Agent가 필요하면 새 대화를 만들고 목표, 파일 경로, 확정한 결정을 알려 주세요. 고급 옵션은 현재 Agent가 제공하므로 메뉴가 서로 다른 것은 정상입니다. 반복 개선은 결과물 개선하기를 참고하세요.
요금제 한도, Flex, 실제 비용 부담자
구독 마켓에서 현재 요금제, 포함 모델, 남은 한도, 초기화 시간을 확인하세요. 여러 기간별 한도가 하나의 요금제에 동시에 적용될 수 있습니다. 한 기간에 여유가 있다고 모든 한도를 사용할 수 있는 것은 아닙니다. 한도는 고정된 메시지 개수도 아닙니다. 문맥, 출력, 모델에 따라 소비량이 달라집니다.
모델이 요금제에 포함되고 한도가 남았다면 해당 요금제를 먼저 사용합니다. 요금제 밖이거나 한도가 부족하면 조건에 맞는 호출은 Flex 크레딧으로 사용량 기반 과금될 수 있습니다. Flex 페이지는 잔액, 출처, 만료일을 표시합니다. 증정 크레딧과 구매 크레딧은 용도가 같지 않을 수 있으므로, 잔액이 있다고 영구 유효하거나 모든 서비스를 포함한다고 생각하지 마세요.
일반 Workspace 모델 호출은 Workspace 소유자의 사용 가능한 혜택을 사용합니다. 멤버는 작업 시작 전에 이를 이해해야 합니다. 로컬 Agent는 해당 컴퓨터의 로그인과 구독을, 자체 모델 API는 외부 제공자의 과금을 사용합니다. 전용 Mac, 외부 API, 모델 호출에도 각각 조건이 있으므로 요금제 이름만으로 모두 포함된다고 판단할 수 없습니다.
가격, 포함 모델, 공급 상태는 바뀝니다. 현재 목록과 결제 확인 페이지를 기준으로 하세요. 비교할 때는 필요한 모델, 보통 작업 크기, 초기화까지 기다릴 수 있는 시간, 사용량 과금으로 계속할지 네 가지를 기록하면 됩니다. 구매나 변경 전 적용일과 갱신 안내를 확인하세요. 갱신 중지와 즉시 환불은 다른 동작입니다.
내 모델 API를 Workspace에 연결하기(BYOK)
외부 모델 제공자의 API 주소와 키를 가진 소유자를 위한 경로입니다. Workspace 설정의 “자체 모델”에서 “모델 API 연결”을 누르고 서비스 이름, 엔드포인트, 해당 키를 입력한 다음 모델을 선택하고 저장합니다.
저장 전에 각 모델이 도구를 호출하고 도구 결과를 받은 후 계속할 수 있는지 시험합니다. 인터페이스나 기능이 맞지 않으면 이유가 표시됩니다. 검사를 통과하고 현재 Agent에 맞는 모델만 선택 목록에 들어가며, 제공자별로 메뉴 앞쪽에 표시됩니다. 클라우드 컴퓨터가 실행 중일 때 추가하거나 수정했다면 재시작 안내에 따라 새 설정을 적용하세요.
먼저 검사 결과를 확인하고, 새 대화에서 해당 제공자의 모델을 골라 작은 작업을 완료합니다. 멤버는 모델을 사용할 수 있지만 키를 읽을 수 없습니다. 키는 암호화해 저장하고 멤버나 Agent에 전달하지 않습니다. 호출은 입력한 제공자에게 전송되고 제공자가 소유자에게 청구합니다. Agent.Space 요금제 한도나 크레딧을 소비하지 않습니다.
주소와 키는 같은 서비스의 것이어야 합니다. 로그인 비밀번호나 로컬 구독 계정은 API 키가 아닙니다. 키를 대화, 공개 웹페이지, 프로젝트 파일에 붙여 넣지 마세요. 모델이 나타나지 않으면 호환성 검사와 재시작 안내를 확인합니다. 도구 호출을 지원하지 않는 엔드포인트는 반복 저장으로 고칠 수 없습니다.
Model API Key로 외부 클라이언트 연결하기
사이드바 “더 보기”의 “Model API Key”는 Developer API 페이지를 엽니다. 외부 클라이언트가 Agent.Space를 호출하는 입구입니다. 위의 BYOK 입력 화면이나 Workspace 파일을 마음대로 읽고 쓰는 만능 키가 아닙니다.
페이지가 사용 자격을 확인합니다. 현재 유효한 요금제 또는 크레딧 구독, 만료되지 않은 구매 크레딧은 자격을 충족할 수 있습니다. 증정 크레딧만으로는 API를 활성화할 수 없습니다. API 사용 자격과 특정 요청에 충분한 잔액 및 사용 가능한 모델이 있는지는 별개로 확인합니다. 일반 Workspace 대화는 조건에 따라 증정 크레딧을 사용할 수 있습니다.
연결 가이드에서 클라이언트와 사용 가능한 모델을 선택하고 알아보기 쉬운 이름의 키를 만든 뒤, 페이지의 전체 설정을 해당 클라이언트에 복사합니다. 예를 들어 personal-laptop으로 이름을 짓고 다른 도구에는 별도 키를 쓰면 사용량 확인과 폐기가 쉬워집니다. 주소, 프로토콜, 모델 식별자는 가이드를 따르고 다른 서비스의 비슷한 필드를 섞지 마세요.
키에는 지출 한도와 초기화 주기, 허용 모델, 만료일을 설정할 수 있으며 새 요청에 적용됩니다. 모델 제한을 선택하지 않으면 모든 모델을 허용하고, 날짜를 비워 두면 만료되지 않습니다. 키 보기나 재생성 같은 민감한 작업은 재인증이 필요할 수 있습니다. 키가 유출되면 즉시 폐기하거나 재생성하고 클라이언트 설정도 갱신하세요.
작은 요청을 한 번 실행한 뒤 API 페이지로 돌아와 해당 키의 요청 기록과 사용량을 확인합니다. 클라이언트에 응답이 있고 여기에도 일치하는 기록이 있어야 의도한 서비스를 썼다고 확인할 수 있습니다. 그렇지 않으면 클라이언트가 이전 설정을 계속 쓰고 있을 수도 있습니다.
사용량 문제는 경로별로 확인하기
모델을 선택할 수 없으면 Agent 호환성, 사용 권한, 모델 상태를 확인합니다. 한도 때문에 멈췄으면 모든 기간별 한도와 유효한 Flex 잔액을 봅니다. API가 거부되면 사용 자격, 키 만료, 모델 제한, 지출 한도도 확인합니다. BYOK 실패는 외부 제공자의 키, 엔드포인트, 청구를, 로컬 작업 실패는 로컬 로그인과 구독을 확인하세요.
도움을 요청할 때 발생 시간, 모델, Agent, 사용 경로, 오류 문구를 기록하되 전체 키는 넣지 마세요. “어디서 실행하고, 어느 서비스를 호출하며, 누가 비용을 내는지”를 분명히 하면 모델을 계속 바꾸는 것보다 원인을 빨리 찾을 수 있습니다.