GitHub Copilotgithub.blog
GitHub Copilot에서 Claude Haiku 5.5 쓰기모델 선택과 서브에이전트 지정
GitHub Copilot의 모델 목록에서 Claude Haiku 5.5를 고르고, 서브에이전트와 반복 작업에만 이 모델을 맡겨 비용을 줄이는 방법을 따라 합니다.
안녕하세요, muaco입니다.
이 글로 할 수 있는 일
이 글을 따라 하면 GitHub Copilot에서 Claude Haiku 5.5를 골라 실제 요청에 쓰게 됩니다. VS Code 채팅과 Copilot CLI 두 곳에서 모델을 바꾸는 순서를 다룹니다.
여기에 하나를 더합니다. 서브에이전트(큰 작업 중 일부를 떼어 받아 처리하는 보조 AI)에게만 Haiku 5.5를 지정하는 방법입니다. 무거운 판단은 큰 모델에 두고 반복 작업만 싸고 빠른 모델로 돌리는 구성입니다.
미리 갖춰야 할 준비
먼저 요금제를 확인하세요. GitHub 공지에 따르면 Haiku 5.5는 Copilot Pro, Pro+, Max, Business, Enterprise에서 쓸 수 있습니다.
- 쓰는 곳: VS Code, Copilot CLI, JetBrains IDE, github.com 등 대부분의 Copilot 화면입니다. 각 화면의 모델 선택기에서 고릅니다.
- 회사 계정이라면: Business와 Enterprise는 관리자가 Copilot 설정의 모델 정책으로 사용 여부를 정합니다. 기본값은 새 모델이 자동으로 켜지는 쪽이지만 관리자가 꺼 두었다면 목록에 나오지 않습니다.
- 출시 방식: 순차적으로 열리는 중입니다. 오늘 목록에 없다고 해서 설정이 틀렸다고 단정하기는 이릅니다.
Copilot CLI(터미널에 명령을 쳐서 쓰는 Copilot)는 먼저 설치하세요. Node.js 22 이상이 있다면 npm install -g @github/copilot 한 줄이면 됩니다. 다른 설치 방법은 GitHub 공식 설치 안내에 있습니다.
따라 하기: 모델 고르고 일 나눠 맡기기
VS Code 채팅에서 고르기
- VS Code 위쪽 제목 표시줄의 채팅 아이콘을 눌러 Copilot Chat을 여세요. 오른쪽에 대화 창이 열리면 됩니다.
- 채팅 창 아래쪽의 모델 드롭다운을 열고 Claude Haiku 5.5를 고릅니다. 드롭다운에 이 이름이 표시되면 다음 질문부터 Haiku 5.5가 답합니다.
- 이미 Auto(Copilot이 알아서 모델을 고르는 방식)로 쓰고 있었다면, 채팅 창 오른쪽 위의 새 채팅 버튼을 누르세요. 문서는 Auto 상태에서 모델을 바꾸려면 새 세션을 열라고 안내합니다.
- 간단한 요청을 하나 보내 보세요. "이 파일의 변수 이름을 더 알아보기 쉽게 바꿔 줘" 정도면 충분합니다. 답이 빠르게 돌아오면 선택이 적용된 상태입니다.
한 가지 짚어 둡니다. 채팅 모델을 바꿔도 코드를 치는 중에 뜨는 자동 완성 제안의 모델은 바뀌지 않습니다.
Copilot CLI에서 고르기
- 터미널을 열고 작업할 폴더로 이동한 뒤
copilot을 입력하세요. 처음 실행할 때 GitHub에 로그인돼 있지 않으면/login을 입력하라는 안내가 뜹니다. 화면 지시대로 인증을 마치면 시작된 상태입니다. /model을 입력해 모델 선택 화면을 열고 Claude Haiku 5.5를 고릅니다. 이렇게 바꾸면 지금 세션에만 적용됩니다.- 앞으로도 계속 Haiku 5.5로 시작하고 싶다면
/model --global로 기본값을 정하세요. 저장소 하나에만 고정하려면--repo를 붙입니다.
같은 /model 화면에서 추론 강도(모델이 답하기 전에 얼마나 오래 생각할지)도 조절됩니다. Haiku 5.5는 Haiku 계열 가운데 처음으로 이 강도를 고를 수 있는 모델입니다.
서브에이전트에 Haiku 5.5 지정하기
여기서부터가 비용을 줄이는 핵심입니다. 큰 모델과 대화하면서 자잘한 조사나 검토만 Haiku 5.5에게 넘기는 구성입니다. 아래는 VS Code 기준입니다.
- 채팅 창의 Configure Tools에서 Run Subagent(
agent/runSubagent)를 켜세요. 이 도구가 꺼져 있으면 서브에이전트를 부를 수 없습니다. - 명령 팔레트(Ctrl+Shift+P)를 열고 Chat: New Custom Agent를 실행합니다. 프로젝트용 에이전트 파일은
.github/agents폴더에.agent.md확장자로 만들어집니다. - 파일 맨 위 설정 칸에 모델 이름을 적으세요. 아래 예시처럼
model줄에 Haiku 5.5를 넣으면 됩니다.
---
name: Codebase Researcher
description: Find relevant code and explain existing patterns
user-invocable: false
model: Claude Haiku 5.5
tools: ['read', 'search']
---
Research the requested topic without changing files.
Return relevant file paths, existing patterns, and unanswered questions.
user-invocable: false는 사람이 직접 고르지 않고 서브에이전트로만 쓰겠다는 표시입니다. tools를 읽기와 검색으로 좁혀 두면 파일을 고칠 걱정도 없습니다.
공식 문서는 서브에이전트 모델 지정이 어느 VS Code 버전부터 되는지 밝히지 않습니다. 따라 하기 전에 VS Code를 최신 버전으로 업데이트하세요.
- 메인 채팅은 Sonnet 5.5나 Opus 5.5로 둔 채 자연어로 서브에이전트를 부르세요. 문서의 예는 "Use a subagent to find how authentication works in this codebase."입니다.
- 한 번만 모델을 콕 집으려면 요청에 모델 이름을 넣으세요. 예를 들면 "Use a subagent with Claude Haiku 5.5 to review the error handling in this module."입니다. 채팅 창에 서브에이전트 실행 기록이 따로 보이면 제대로 위임된 상태입니다.
- 설정에서
chat.subagents.showCreditUsage를 켜 두세요. 서브에이전트가 쓴 AI 크레딧이 표시돼 실제로 얼마나 아꼈는지 확인할 수 있습니다.
무거운 일은 다른 모델로 두는 기준
값부터 보겠습니다. GitHub의 요금 문서에 실린 100만 토큰(AI가 글을 읽고 쓰는 단위)당 가격입니다.
| 모델 | 입력 | 출력 | 맡길 일 |
|---|---|---|---|
| Claude Haiku 5.5 | $0.10 | $0.50 | 서브에이전트, 빠른 편집, 터미널 작업 |
| Claude Sonnet 5.5 | $2.00 | $10.00 | 복잡한 에이전트형 코딩 |
| Claude Opus 5.5 | $4.00 | $20.00 | 계획 세우기, 판단이 필요한 일 |
Haiku 5.5 가격은 프롬프트가 10만 토큰 이하일 때 기준입니다. 그보다 길면 입력 $0.50, 출력 $2.50으로 다섯 배가 됩니다.
나누는 기준은 단순합니다. 할 일이 분명하고 여러 번 반복되면 Haiku 5.5, 무엇을 할지부터 정해야 하면 큰 모델입니다. Anthropic도 복잡한 에이전트형 코딩은 Sonnet 5.5나 Opus 5.5가 낫다고 적었습니다.
AWS 소개 글이 그리는 짝도 같습니다. Opus 5.5가 계획과 판단을 맡고 Haiku 5.5가 잘 정의된 작업을 나란히 처리하는 방식입니다.
막히기 쉬운 세 군데
모델 목록에 Haiku 5.5가 없습니다
보이는 현상: 드롭다운이나 /model 화면에 이름이 뜨지 않습니다. 원인: 출시가 순차적으로 진행 중이고 회사 계정은 관리자 정책이 꺼져 있을 수 있습니다.
해결: 개인 요금제라면 시간을 두고 다시 확인하세요. Business나 Enterprise라면 관리자에게 Copilot 설정의 모델 정책에서 Haiku 5.5가 허용됐는지 물어보는 편이 빠릅니다.
모델을 바꿨는데 답하는 모델이 그대로입니다
보이는 현상: Haiku 5.5를 골랐는데 이전 대화가 계속 같은 방식으로 흘러갑니다. 원인: Auto로 시작한 세션은 중간에 모델을 바꾸려면 새 세션이 필요하다고 문서에 나와 있습니다.
해결: 새 채팅 버튼을 눌러 새 대화를 열고 다시 고르세요. Copilot Extensions가 선택한 모델을 덮어쓸 수도 있다는 점도 함께 기억해 두세요.
서브에이전트가 지정한 모델로 돌지 않습니다
보이는 현상: 서브에이전트가 아예 실행되지 않고 쓸 수 있는 모델 목록만 알려 줍니다. 원인: 서브에이전트 모델은 메인 대화 모델의 비용 등급을 넘지 못하게 막혀 있습니다.
해결: 메인 대화를 서브에이전트 모델과 같거나 더 비싼 모델로 두세요. 메인이 Opus 5.5라면 Haiku 5.5 서브에이전트는 문제없이 돕니다.
여기서 더 나아가려면
조사 담당, 검토 담당처럼 역할별 서브에이전트를 두세 개 만들어 보세요. 메인 에이전트 파일의 agents 항목에 이름을 적으면 부를 수 있는 서브에이전트를 제한할 수 있습니다. 이때 tools에 agent가 함께 들어 있어야 합니다.
이상으로 글 마치겠습니다.
출처
- GitHub Changelog: Claude Haiku 5.5 in GitHub Copilot
- Anthropic: Claude Haiku 5.5
- AWS: Introducing Claude Haiku 5.5 on AWS
- GitHub Docs: Changing the AI model for Copilot Chat
- GitHub Docs: Supported AI models
- GitHub Docs: Models and pricing for GitHub Copilot
- GitHub Docs: Installing GitHub Copilot CLI
- GitHub Docs: Copilot CLI command reference
- VS Code Docs: Custom agents
- VS Code Docs: Subagents
같은 분류의 글
GitHub Copilot · github.blog
GitHub Copilot computer use 설정법: CLI와 앱에서 데스크톱 앱 맡기기
GitHub Copilot의 computer use를 켜고 권한을 준 뒤, 데스크톱 앱 작업을 Copilot에게 맡기는 방법까지 차례로 따라 합니다.
GitHub Copilot · github.blog
GitHub Copilot 앱 캔버스 사용법: 말로 설명해 나만의 업무 화면 만들기
GitHub Copilot 앱에서 /create-canvas로 칸반 보드나 체크리스트 같은 업무 화면을 말로 만들고, 저장해 팀과 함께 다시 쓰는 방법을 따라 합니다.
GitHub Copilot · github.blog
GitHub Copilot 자동 모델 선택: 효율·균형·지능 등급 고르는 법
GitHub Copilot의 Auto에 새로 생긴 효율(efficiency)·균형(balance)·지능(intelligence) 등급이 각각 무엇을 아끼고 무엇을 챙기는지 알고, 작업에 맞춰 골라 쓸 수 있습니다.