네, GitHub는 무료입니다. GitHub Free 플랜에서는 퍼블릭 및 프라이빗 저장소를 무제한으로 생성할 수 있고, 협업자 수도 무제한이며, 매월 2,000분의 GitHub Actions 실행 시간을 제공합니다. AI 에이전트 역시 이 무료 플랜에서 활용할 수 있습니다. GitHub 공식 문서에 따르면 공식 MCP 서버는 "플랜 유형과 관계없이 모든 GitHub 사용자에게 제공"되므로, 유료 GitHub 플랜이 없어도 Claude Code, Codex, OpenCode 같은 에이전트가 이슈를 읽고, 풀 리퀘스트(PR)를 생성하고, 워크플로 실행 상태를 확인할 수 있습니다. 비용이 발생할 수 있는 유일한 부분은 에이전트에 쓰이는 모델인데, 이 비용마저 0원으로 유지할 수 있는 방법이 있습니다.
요약 (TL;DR)
세분화된 개인 액세스 토큰(fine-grained PAT)을 사용해 GitHub 공식 MCP 서버를 코딩 에이전트에 연결하세요. GitHub Free에서 신경 써야 할 주요 제한 사항은 프라이빗 저장소의 Actions 실행 시간, REST API 호출 한도, 그리고 퍼블릭 저장소에서만 지원되는 몇 가지 협업 기능뿐입니다. 실제 비용은 에이전트 쪽에서 발생합니다. Claude Code와 Codex는 유료 플랜이나 API 크레딧이 필요한 반면, OpenCode는 현재 여러 무료 모델을 지원합니다. 에이전트가 실무에 투입될 만큼 준비되면, Sharkly의 GitHub 연동 기능을 활용해 새로 등록된 이슈를 Agent에 할당할 수 있는 Task로 손쉽게 전환할 수 있습니다.
| 구분 | 무료 여부 | 제한 사항 | 초과 시 비용 |
|---|---|---|---|
| GitHub Free | 무료 | 프라이빗 저장소 기준 Actions 월 2,000분(퍼블릭 저장소는 무료), Packages 스토리지 500MB | 유료 GitHub 플랜 구독 또는 종량제 분당 요금 |
| GitHub MCP server | 무료 (모든 플랜) | 토큰의 REST API 할당량: 시간당 5,000회 요청 | 유료 기능과 연동된 도구는 해당 구독 필요 |
| Copilot Free | 무료 | 월 2,000회 코드 완성, AI 크레딧 제공량 미공개, 클라우드 에이전트 미지원 | Copilot Pro 이상 플랜 구독 |
| 에이전트: OpenCode 무료 모델 | 무료 (현재 기준) | 프로모션 모델, 한정 기간 제공 | OpenCode Zen 또는 Go |
| 에이전트: Claude Code / Codex | 유료 | 별도 플랜 또는 API 키 필요 | Claude/ChatGPT 구독료 또는 토큰 사용료 |
| Sharkly 보드 | 현재 무료 | 최대 5인 조직까지 | 인당 월 $7 (연간 결제 시) |
GitHub 무료 플랜: 에이전트 활용 시 꼭 알아둬야 할 제한 사항
GitHub Free는 스토리지와 참여자 수 측면에서는 매우 관대하지만, 에이전트가 주로 리소스를 많이 소모하는 영역에서는 상대적으로 제한이 타이트합니다.
Actions 실행 시간. 요금제 페이지를 보면 월 2,000분이 제공되며, Actions는 "퍼블릭 저장소의 경우 무료"로 명시되어 있습니다. 하지만 풀 리퀘스트를 생성하는 에이전트는 푸시할 때마다 CI를 트리거합니다. 예를 들어 테스트 실행에 6분이 걸리는 환경에서 에이전트가 하루 10개의 PR을 올리고 각각 2번씩 푸시한다면, 한 달에 약 3,600분을 소모하게 됩니다. 따라서 프라이빗 저장소에서는 이 시간 제한이 가장 먼저 맞닥뜨리는 걸림돌이 될 수 있습니다. CI 실행 시간을 짧게 유지하거나 워크플로에 concurrency 그룹을 설정해 이전 실행을 자동으로 취소하도록 구성하세요.
API 호출 한도(Rate limits). 모든 MCP 도구 호출은 사용자의 토큰을 사용하는 GitHub API 호출로 이어집니다. GitHub의 REST 호출 한도 문서에 따르면 개인 토큰은 시간당 5,000회의 요청이 가능하며, 콘텐츠 생성 요청의 경우 분당 약 80회 수준의 보조 제한(secondary limit)이 적용됩니다. 에이전트 하나만 실행할 때는 이 한도에 도달할 일이 거의 없지만, 여러 에이전트가 단일 토큰을 공유하면 한도에 걸릴 수 있습니다.
퍼블릭 저장소 전용 기능. 무료 플랜에서는 코드 소유자(Code owners), 드래프트 풀 리퀘스트(Draft PR), 환경 보호 규칙 등이 퍼블릭 저장소에만 적용됩니다. 에이전트가 프라이빗 저장소에서 드래프트 PR을 열도록 하려면 유료 플랜이 필요합니다.
Copilot Free. 월 최대 2,000회의 코드 완성을 비롯해 에디터 내 에이전트 모드 및 MCP를 지원합니다. 하지만 플랜 안내 페이지에 따르면 Copilot 클라우드 에이전트는 포함되지 않으며, AI 크레딧 제공량도 구체적인 수치로 명시되어 있지 않습니다. 따라서 이슈를 배정할 수 있는 팀원이라기보다는 에디터 어시스턴트로 생각하는 편이 맞습니다.
MCP 서버 자체의 제한. GitHub의 MCP 설정 문서에는 한 가지 주의사항이 명시되어 있습니다. "해당 기능에 유료 GitHub 또는 Copilot 라이선스가 필요한 경우, 이에 상응하는 MCP 도구 역시 동일한 구독이 필요합니다." 이슈, 풀 리퀘스트, 저장소 관리, Actions 로그 조회 등은 무료 플랜에서도 정상 작동하지만, Copilot 클라우드 에이전트를 구동하는 도구는 작동하지 않습니다.
Claude Code, Codex, OpenCode에 GitHub 연결하기
github-mcp-server 저장소에서는 이를 실행하는 두 가지 방법을 안내합니다. https://api.githubcopilot.com/mcp/로 제공되는 GitHub의 호스팅 엔드포인트를 사용하는 방법과 로컬 Docker 이미지를 사용하는 방법입니다. 호스팅 엔드포인트는 별도 설치가 필요 없으므로 이 방식부터 시작하는 것을 추천합니다.
1. 세분화된 개인 액세스 토큰(fine-grained PAT) 발급. 에이전트가 접근해야 하는 저장소로만 범위를 좁히고, Issues 및 Pull requests에 대한 읽기/쓰기 권한과 Contents 및 Actions에 대한 읽기 권한을 부여하세요. GitHub 가이드에는 기존 클래식 repo 스코프도 언급되어 있지만, 에이전트 용도로는 소수의 저장소로 한정된 세분화 토큰을 사용하는 것이 훨씬 안전합니다.
2a. Claude Code. GitHub의 Claude 가이드에 따라 일반 터미널에서 다음 명령을 실행합니다.
claude mcp add --transport http github https://api.githubcopilot.com/mcp \
-H "Authorization: Bearer YOUR_GITHUB_PAT"
그런 다음 claude mcp list를 실행하여 github가 잘 연결되었는지 확인합니다.
2b. Codex. GitHub의 Codex 가이드에서는 토큰이 설정 파일에 직접 저장되지 않도록 환경 변수에서 읽어오는 방식을 사용합니다.
export GITHUB_PAT_TOKEN=your_token
codex mcp add github --url https://api.githubcopilot.com/mcp/ \
--bearer-token-env-var GITHUB_PAT_TOKEN
Codex 내에서 /mcp를 실행하면 사용 가능한 도구 목록을 확인할 수 있습니다.
2c. OpenCode. GitHub의 OpenCode 가이드에 따라 프로젝트 루트의 opencode.json에 다음 설정을 추가합니다.
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"github": {
"type": "remote",
"url": "https://api.githubcopilot.com/mcp/",
"enabled": true,
"oauth": false,
"headers": {
"Authorization": "Bearer {env:GITHUB_PERSONAL_ACCESS_TOKEN}"
}
}
}
}
{env:...} 형식을 사용하면 토큰이 커밋 위험이 있는 파일 대신 셸 환경 변수에 안전하게 유지됩니다.
3. 툴셋(toolset) 최적화. 기본 툴셋은 context, repos, issues, pull_requests, users로 구성됩니다. 도구 수를 줄이면 도구 설명에 소비되는 컨텍스트(토큰)를 절약할 수 있습니다. 로컬 서버의 경우 --read-only 플래그도 지원하므로, 이슈 분류(triage) 작업만 수행하는 에이전트라면 이 옵션으로 시작하는 것이 합리적입니다.
4. 간단한 작업으로 테스트하기. "이 저장소에서 bug 라벨이 붙은 열린 이슈를 나열하고 가장 오래된 이슈 3개를 요약해 줘" 같은 프롬프트 하나로 토큰 권한, 서버 연동, 에이전트 동작을 한 번에 검증할 수 있습니다.
비용 0원으로 구축하는 방법
현재 시점에서 비용이 전혀 들지 않는 조합은 바로 GitHub Free, 세분화된 토큰을 연동한 호스팅 MCP 서버, 그리고 OpenCode의 무료 모델을 함께 사용하는 구성입니다.
OpenCode의 무료 티어는 로그인이나 API 키 입력조차 필요 없습니다. 2026년 10월 16일 기준(npx opencode-ai@latest를 통한 OpenCode 1.19.2) 테스트 결과, opencode/deepseek-v4.1-flash-free 모델에서 코드 작성 및 실행 작업이 32초 만에 완료되었습니다. OpenCode Zen 문서를 보면 이 모델은 glm-5.3-flash-free 등과 함께 현재 무료로 제공되며, 제공업체 측에서 데이터를 일체 보관하지 않고(zero retention) 학습에도 사용하지 않는다고 명시되어 있습니다. 반면 동일 목록에 있는 다른 일부 무료 모델은 사용자 데이터를 학습에 활용할 수 있으므로, 프라이빗 저장소에 적용하기 전에 안내 사항을 반드시 확인해야 합니다.
알아두어야 할 현실적인 한계:
- 무료 모델은 프로모션 성격입니다. Zen에서는 대부분의 모델이 "한정된 기간 동안" 무료라고 안내하고 있습니다. 해당 모델이 언제든 종료될 수 있음을 염두에 두어야 합니다.
- 무료 티어는 OpenCode를 통해서만 호출할 수 있습니다. 스크립트 등에서 동일한 엔드포인트를 직접 호출하면 HTTP 403
FreeTierError가 반환됩니다. - Actions 실행 시간 제한은 여전히 적용됩니다. 에이전트 자체는 무료지만, 프라이빗 저장소에서 에이전트가 트리거하는 CI 실행 시간은 무제한이 아닙니다.
- Claude Code와 Codex는 이 무료 구성에 포함되지 않습니다. Claude Code는 유료 Claude 플랜이나 API 크레딧이 필요하며, Codex는 ChatGPT 플랜이나 OpenAI API 키가 있어야 합니다.
단순 대화에서 업무 할당으로
터미널에 "issue #142 해결해 줘"라고 직접 입력하는 방식은 혼자 일할 때는 괜찮습니다. 하지만 팀 단위 협업에서는 에이전트에게 이슈를 정식으로 할당하고, 팀원 모두가 확인할 수 있는 곳에 작업 결과를 남기도록 하는 것이 훨씬 효과적입니다.
Sharkly는 바로 이러한 워크플로를 지원하는 본격적인 GitHub 연동 기능을 제공합니다. 자세한 내용은 GitHub 연동 문서에 기술되어 있습니다.
- 이슈가 Task로 자동 변환됩니다. 조직 소유자나 관리자가 GitHub App을 설치하고 연동할 저장소를 지정합니다. 저장소를 특정 Space에 연결하면 새로 등록되는 이슈가 Task로 동기화됩니다. 기존에 생성되어 있던 이슈는 자동으로 가져오지 않습니다. 기본적으로 GitHub에서 Sharkly로의 단방향 동기화이며, Space당 하나의 양방향 저장소를 연결할 수도 있습니다.
- 풀 리퀘스트와 자동 연결됩니다. 브랜치명, PR 제목 또는 PR 본문에 Task ID를 포함하면 Sharkly가 해당 PR을 Task에 자동으로 연결합니다. PR이 머지되어도 Task 상태는 변경되지 않지만, 동기화된 이슈가 닫히거나 다시 열리면 Task 상태가 업데이트될 수 있습니다.
- Task를 Agent에 배정합니다. Agent는 사용자의 자체 머신(Computer)에서 Claude Code, Codex, OpenCode 등을 실행합니다. 각 Task는 격리된 git worktree에서 안전하게 처리되며, 진행 상황과 작업 결과가 해당 Task로 다시 반영됩니다.
한 가지 주의할 점이 있습니다. GitHub App이 Agent에 직접 git clone 권한을 부여하지는 않는다는 점입니다. 저장소 클론은 Agent나 Space에 설정된 머신(Computer)의 기존 SSH 키나 HTTPS 인증 정보를 통해 수행됩니다.
그렇다면 Sharkly 실행 환경 내에서 MCP 서버는 어떻게 동작할까요? Sharkly 공식 문서에는 MCP에 대한 직접적인 언급이 없습니다. 하지만 Agent가 저장소의 worktree 내에서 에이전트 CLI 자체를 직접 실행하는 구조이므로, 저장소에 커밋된 프로젝트 범위의 .mcp.json 파일(또는 해당 머신에 설정된 사용자 설정)이 실행 시 정상적으로 로드될 것으로 판단됩니다. 실무에 본격적으로 활용하기 전에 간단한 Task 하나로 스모크 테스트(smoke test)를 먼저 진행해 보세요. 구체적인 흐름은 GitHub 이슈를 AI 에이전트에 할당하는 방법을 참고하시고, GitHub 자체의 에이전트 할당 접근 방식은 GitHub Agent HQ 살펴보기에서 확인하실 수 있습니다.
Sharkly 보드는 현재 5인 이하 조직에 무료로 제공되며, Agent와 Computer는 시트(seat) 수에 포함되지 않습니다. 모델 사용 비용 역시 사용자가 보유한 기존 구독이나 API 키를 그대로 활용합니다. 이슈 등록부터 최종 머지까지의 맥락, 진행 상황, 병목 지점, 작업 결과, 코드 리뷰를 한곳에서 깔끔하게 관리해 보세요.
주의사항 (Gotchas)
- 토큰을 공유하면 호출 한도도 공유됩니다. 작업량이 많은 에이전트 하나 때문에 다른 에이전트까지 한도 제한에 걸리지 않도록, 에이전트마다 별도의 세분화된 토큰을 발급하세요.
.mcp.json에 토큰을 일반 텍스트로 직접 입력하지 마세요. Claude Code는.mcp.json헤더에서${VAR}환경 변수 확장을 지원하므로, 변수명만 커밋하고 실제 토큰 값은 머신(Computer) 환경 변수로 관리해야 합니다.- 프라이빗 저장소의 드래프트 PR 생성에는 유료 플랜이 필요합니다. 무료 플랜에서는 에이전트가 제목에 "WIP"를 붙여 일반 PR을 열도록 지시하세요.
- 에이전트의 잦은 푸시는 Actions 실행 시간을 빠르게 소모합니다.
concurrency그룹에cancel-in-progress: true옵션을 추가하여 불필요해진 이전 워크플로 실행을 즉시 중단시키세요. - 무료 플랜에서는 Copilot 클라우드 에이전트 도구가 실패합니다. 이는 토큰 오류가 아니라 유료 라이선스 정책에 따른 정상적인 동작입니다.
자주 묻는 질문 (FAQ)
GitHub는 무료인가요? 네, 무료입니다. GitHub Free 플랜에는 퍼블릭 및 프라이빗 저장소 무제한 생성, 협업자 수 무제한, 프라이빗 저장소 기준 월 2,000분의 Actions 실행 시간, 500MB의 Packages 스토리지가 포함되어 있습니다.
GitHub MCP 서버는 무료인가요? 네, 무료입니다. GitHub에 따르면 플랜에 관계없이 모든 사용자에게 제공됩니다. 다만 Copilot 클라우드 에이전트처럼 유료 기능과 연결된 도구를 사용하려면 해당 유료 구독이 필요합니다.
GitHub 무료 플랜에서 에이전트 사용 시 지원되지 않는 기능은 무엇인가요? 프라이빗 저장소에서의 무제한 Actions 실행, 프라이빗 저장소의 드래프트 풀 리퀘스트 및 코드 소유자(code owners) 기능, 그리고 Copilot 클라우드 에이전트가 지원되지 않습니다.
GitHub에서 비용 0원으로 코딩 에이전트를 운영할 수 있나요? 네, 가능합니다. GitHub Free 플랜, 호스팅 MCP 서버, 그리고 OpenCode의 무료 모델을 조합하면 됩니다. 다만 무료 모델은 기간 한정 프로모션이므로 향후 모델 전환이 필요할 수 있습니다. 모델별 비용 조합에 대한 자세한 내용은 무료 및 저비용 티어로 에이전트 크루를 운영할 때 발생하는 비용을 참고하시고, 여러 에이전트의 작업을 효율적으로 정리하는 방법은 Claude Code 프로젝트 관리 가이드를 확인해 보세요.
