Claude Code CLI 마이그레이션 가이드: Copilot, Gemini, Codex 비교

개요

2024년부터 시작된 CLI 기반 AI 코딩 도구의 급속한 발전으로, 개발자들은 이제 다양한 선택지를 갖게 되었습니다. Claude Code가 시장을 선도하고 있지만, GitHub Copilot CLI, Gemini CLI, Codex CLI 등 경쟁 도구들이 각자의 강점을 내세우며 빠르게 성장하고 있습니다.

왜 마이그레이션을 고려하는가

마이그레이션을 고려하는 주요 이유는 크게 세 가지입니다:

비용 최적화: Claude Code의 토큰 기반 과금($3/M input, $15/M output)은 사용량에 따라 월 $100 이상이 될 수 있습니다. 반면 Copilot CLI는 월 $10 정액제, Gemini CLI는 무료 티어를 제공합니다.
생태계 통합: GitHub 중심 워크플로우를 사용한다면 Copilot CLI가, Google Cloud를 주로 사용한다면 Gemini CLI가 더 나은 통합을 제공합니다.
기능 요구사항: 오픈소스 커스터마이징이 필요하다면 Codex CLI가, 복잡한 멀티에이전트 시스템이 필요하다면 Claude Code가 적합합니다.

핵심 비교: 4가지 CLI 도구

아키텍처 비교 표

항목	Claude Code	Copilot CLI	Gemini CLI	Codex CLI
제공사	Anthropic	GitHub/Microsoft	Google	OpenAI
LLM 모델	Claude 3.5/4	GPT-4, Claude, Gemini	Gemini 2.5	GPT-4o, o1
가격	토큰 기반	$10/월	무료〜$20/월	토큰 기반
설정 포맷	JSON	JSON	JSON	TOML
프로젝트 지시	CLAUDE.md	copilot-instructions.md	GEMINI.md	AGENTS.md
MCP 지원	네이티브	지원	지원	제한적
에이전트 시스템	서브에이전트	Extensions	없음	AGENTS.md
커스텀 명령	Slash commands	/commands	/prompts	/commands
GitHub 통합	gh CLI 활용	네이티브	별도 설정	별도 설정
오픈소스	아니오	아니오	아니오	예

설정 파일 구조 비교

각 도구의 프로젝트 설정 구조를 비교해보면 마이그레이션에 필요한 작업을 파악할 수 있습니다:

# Claude Code
project/
├── .claude/
│   ├── settings.json
│   ├── settings.local.json
│   ├── commands/
│   │   └── my-command.md
│   └── agents/
│       └── my-agent.md
├── .mcp.json
└── CLAUDE.md

# GitHub Copilot CLI
project/
├── .github/
│   ├── copilot-instructions.md
│   └── copilot/
│       └── extensions/
│           └── my-extension.md
├── mcp-config.json
└── .copilotignore

# Gemini CLI
project/
├── .gemini/
│   ├── settings.json
│   └── prompts/
│       └── my-prompt.toml
└── GEMINI.md

# Codex CLI
project/
├── .codex/
│   ├── config.toml
│   └── commands/
│       └── my-command.md
├── codex.toml
└── AGENTS.md

마이그레이션 가이드

1. GitHub Copilot CLI로 마이그레이션

GitHub Copilot CLI는 GitHub과의 긴밀한 통합과 월 $10의 합리적인 가격이 장점입니다. 특히 2025년부터 Claude와 Gemini 모델도 지원하여 Multi-vendor 환경을 제공합니다.

장점

저렴한 가격: 월 $10 정액제로 예측 가능한 비용
GitHub 네이티브 통합: PR 리뷰, 이슈 관리가 자연스럽게 연동
Multi-vendor 모델: GPT-4, Claude, Gemini 중 선택 가능
기업 환경 지원: Enterprise 플랜과 SSO 통합

주요 변환 작업

1) MCP 설정 마이그레이션

// Claude Code: .mcp.json
{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-brave-search"]
    }
  }
}

// Copilot CLI: mcp-config.json
{
  "servers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-brave-search"],
      "env": {}
    }
  }
}

2) 프로젝트 지시 파일 변환

<!-- Claude Code: CLAUDE.md -->
## 프로젝트 개요
Astro 기반의 블로그 프로젝트입니다.

## 명령어
npm run dev

<!-- Copilot CLI: .github/copilot-instructions.md -->
## Project Overview
Astro-based blog project.

## Commands
npm run dev

## Coding Standards
- Use TypeScript strict mode
- Follow ESLint rules

3) 에이전트/확장 변환

Claude Code의 서브에이전트를 Copilot Extensions로 변환할 때는 YAML frontmatter를 추가해야 합니다:

<!-- Claude Code: .claude/agents/seo-optimizer.md -->
# SEO Optimizer Agent
SEO 최적화를 담당하는 에이전트입니다.
...

<!-- Copilot CLI: .github/copilot/extensions/seo-optimizer.md -->
---
name: seo-optimizer
description: Handles SEO optimization tasks
triggers:
  - seo
  - meta
  - sitemap
---
# SEO Optimizer Extension
Handles SEO optimization tasks.
...

마이그레이션 체크리스트

mcp-config.json으로 MCP 서버 설정 이전
CLAUDE.md → copilot-instructions.md 변환
서브에이전트 → Extensions 변환 (YAML frontmatter 추가)
Slash commands → /commands 디렉토리 이전
.gitignore에 .copilotignore 규칙 동기화
GitHub CLI 인증 확인

예상 소요 시간: 중간 규모 프로젝트 기준 9〜13시간

2. Gemini CLI로 마이그레이션

Gemini CLI는 무료 티어와 Google 생태계 통합이 가장 큰 장점입니다. 단, 서브에이전트 시스템이 없어 복잡한 워크플로우에는 제한이 있습니다.

장점

무료 티어: 개인 개발자에게 이상적
Google 생태계: Firebase, Cloud Run, BigQuery 등과 통합
빠른 응답: Gemini 2.5의 빠른 처리 속도
멀티모달: 이미지, 동영상 분석 지원

주요 변환 작업

1) MCP 설정 마이그레이션

// Claude Code: .mcp.json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-context7"]
    }
  }
}

// Gemini CLI: .gemini/settings.json
{
  "mcp": {
    "servers": {
      "context7": {
        "command": "npx",
        "args": ["-y", "@anthropic-ai/mcp-server-context7"]
      }
    }
  }
}

2) 프로젝트 지시 파일 변환

<!-- Claude Code: CLAUDE.md -->
## 아키텍처
- Astro 5.0 사용
- Content Collections로 블로그 관리

## 코드 스타일
TypeScript strict 모드 활성화

<!-- Gemini CLI: GEMINI.md -->
## Architecture
- Using Astro 5.0
- Blog managed with Content Collections

## Code Style
TypeScript strict mode enabled

## Gemini-Specific
- Prefer concise responses
- Use Korean for comments

3) 커맨드 변환 (Markdown → TOML)

<!-- Claude Code: .claude/commands/generate-post.md -->
새로운 블로그 포스트를 생성합니다.
$ARGUMENTS에 제목을 입력하세요.

# Gemini CLI: .gemini/prompts/generate-post.toml
[prompt]
name = "generate-post"
description = "Generate a new blog post"

[prompt.parameters]
title = { type = "string", required = true }

[prompt.template]
content = """
Create a new blog post with the title: {{title}}
Follow the project's content guidelines.
"""

제한 사항

서브에이전트 없음: 복잡한 워크플로우 분리 불가
커스텀 명령 제한: TOML 형식만 지원
GitHub 통합: 네이티브 지원 없음 (별도 설정 필요)

마이그레이션 체크리스트

settings.json으로 MCP 설정 이전
CLAUDE.md → GEMINI.md 변환
Slash commands → TOML prompts 변환
Google Cloud 인증 설정
서브에이전트 로직을 단일 프롬프트로 통합

예상 소요 시간: 중간 규모 프로젝트 기준 6〜9시간

3. Codex CLI로 마이그레이션

Codex CLI는 OpenAI의 오픈소스 프로젝트로, TypeScript SDK와 Rust로 구현된 빠른 성능이 특징입니다.

장점

오픈소스: 완전한 커스터마이징 가능
TypeScript SDK: CI/CD 자동화에 적합
Rust 구현: 빠른 시작과 낮은 메모리 사용
AGENTS.md: 유연한 에이전트 정의

주요 변환 작업

1) 설정 파일 변환 (JSON → TOML)

// Claude Code: .claude/settings.json
{
  "permissions": {
    "allow": ["Read", "Write", "Bash"],
    "deny": ["mcp__notionApi__*"]
  }
}

# Codex CLI: codex.toml
[permissions]
allow = ["read", "write", "bash"]
deny = ["notion:*"]

[model]
provider = "openai"
name = "gpt-4o"

2) 에이전트 정의 변환

<!-- Claude Code: .claude/agents/reviewer.md -->
코드 리뷰를 담당하는 에이전트입니다.
- 코드 스타일 검사
- 버그 탐지
- 성능 개선 제안

<!-- Codex CLI: AGENTS.md -->
## reviewer

코드 리뷰를 담당하는 에이전트입니다.

### Capabilities
- Code style checking
- Bug detection
- Performance improvement suggestions

### Tools
- read_file
- grep
- ast_query

3) MCP 설정 (제한적)

Codex CLI는 프로젝트별 MCP 설정이 제한적이며, 글로벌 설정을 주로 사용합니다:

# ~/.codex/config.toml
[mcp.servers.brave-search]
command = "npx"
args = ["-y", "@anthropic-ai/mcp-server-brave-search"]

마이그레이션 체크리스트

settings.json → codex.toml 변환
서브에이전트 → AGENTS.md 통합
Slash commands → commands 디렉토리 이전
MCP 서버를 글로벌 설정으로 이동
TypeScript SDK 설정 (CI/CD용)

예상 소요 시간: 중간 규모 프로젝트 기준 8〜12시간

상황별 최적 도구 선택

도구 선택은 팀의 환경, 예산, 기술 요구사항에 따라 달라집니다. 아래는 각 상황에 맞는 권장 도구입니다.

GitHub Copilot CLI를 선택해야 하는 경우

GitHub 중심 워크플로우: PR, 이슈, Actions를 주로 사용
팀 협업: 조직 전체의 표준화된 도구 필요
기업 환경: Enterprise 통합, SSO, 감사 로그 필요
안정성 중시: 공식 지원과 SLA가 중요
예산 예측: 월 고정 비용 선호

flowchart TD
    A[GitHub 사용?] -->|Yes| B[팀 규모?]
    B -->|5명 이상| C[Copilot CLI 권장]
    B -->|5명 미만| D[예산 제약?]
    D -->|있음| E[Gemini CLI]
    D -->|없음| C

Gemini CLI를 선택해야 하는 경우

비용 제약: 무료 티어가 필수
Google Cloud 생태계: Firebase, Cloud Run 등 사용
간단한 프로젝트: 복잡한 에이전트 시스템 불필요
빠른 프로토타이핑: 빠른 응답 속도 중시
멀티모달 작업: 이미지/동영상 분석 필요

Codex CLI를 선택해야 하는 경우

OpenAI 모델 선호: GPT-4o, o1 모델 사용
오픈소스 커스터마이징: 내부 수정이 필요
CI/CD 자동화: TypeScript SDK로 파이프라인 구축
성능 중시: Rust 구현의 빠른 시작 속도
자체 호스팅: 에어갭 환경에서 운영

Claude Code를 유지해야 하는 경우

복잡한 멀티에이전트 워크플로우: 10개 이상의 서브에이전트
Claude의 추론 능력: 복잡한 아키텍처 설계, 리팩토링
고도화된 에이전트 시스템: 세밀한 권한 제어, 전문화된 에이전트
MCP 생태계 활용: 다양한 MCP 서버 통합
장문 컨텍스트: 200K 토큰 컨텍스트 윈도우 필요

하이브리드 전략

단일 도구에 의존하기보다 각 도구의 강점을 활용하는 하이브리드 전략을 권장합니다.

권장 조합

flowchart LR
    A[작업 유형] --> B{GitHub 관련?}
    B -->|Yes| C[Copilot CLI]
    B -->|No| D{복잡도?}
    D -->|높음| E[Claude Code]
    D -->|중간| F{비용 제약?}
    F -->|있음| G[Gemini CLI]
    F -->|없음| E

1. Copilot CLI: GitHub 관련 작업

# PR 리뷰
copilot review pr 123

# 이슈 분석
copilot analyze issue 456

# 커밋 메시지 생성
copilot commit --message

2. Claude Code: 복잡한 설계 작업

# 아키텍처 설계
claude "마이크로서비스 아키텍처로 리팩토링 계획을 세워줘"

# 복잡한 리팩토링
claude "레거시 코드를 TypeScript로 마이그레이션해줘"

# 멀티에이전트 작업
claude "@seo-optimizer 사이트 전체 SEO 분석"

3. Gemini CLI: 빠른 조회 및 간단한 작업

# 빠른 정보 조회
gemini "React 19의 새로운 기능 요약"

# 간단한 스크립트 생성
gemini "CSV를 JSON으로 변환하는 Python 스크립트"

# 이미지 분석
gemini analyze screenshot.png

도구 간 컨텍스트 공유

각 도구가 프로젝트 컨텍스트를 공유하도록 설정합니다:

project/
├── README.md              # 모든 도구가 참조
├── CLAUDE.md              # Claude Code용
├── GEMINI.md              # Gemini CLI용
├── .github/
│   └── copilot-instructions.md  # Copilot CLI용
└── AGENTS.md              # Codex CLI용

마이그레이션 플로우

전체 마이그레이션 과정을 시각화하면 다음과 같습니다:

flowchart TD
    A[현재 Claude Code 설정 분석] --> B[대상 도구 선택]
    B --> C[설정 파일 변환]
    C --> D[MCP 서버 마이그레이션]
    D --> E[에이전트/확장 변환]
    E --> F[커스텀 명령 이전]
    F --> G[테스트 및 검증]
    G --> H{문제 발견?}
    H -->|Yes| I[디버깅 및 수정]
    I --> G
    H -->|No| J[점진적 전환]
    J --> K[기존 도구 제거]

결론

CLI AI 도구의 선택은 단순한 기능 비교를 넘어 팀의 워크플로우, 예산, 기술 요구사항을 종합적으로 고려해야 합니다.

핵심 결정 요소

예산: 정액제(Copilot) vs 사용량 기반(Claude, Codex) vs 무료(Gemini)
생태계: GitHub → Copilot, Google Cloud → Gemini, OpenAI → Codex
복잡도: 복잡한 에이전트 → Claude Code, 단순 작업 → Gemini
커스터마이징: 오픈소스 필요 → Codex

권장 접근법

점진적 마이그레이션을 권장합니다:

1단계: 새 도구를 기존 도구와 병행 사용
2단계: 특정 작업부터 새 도구로 전환
3단계: 설정 파일 및 에이전트 순차 마이그레이션
4단계: 팀 전체 전환 후 기존 도구 제거

하이브리드 전략을 통해 각 도구의 강점을 활용하면, 비용을 절감하면서도 생산성을 극대화할 수 있습니다. Claude Code의 강력한 추론 능력, Copilot의 GitHub 통합, Gemini의 무료 티어를 상황에 맞게 조합하여 최적의 개발 환경을 구축하세요.

Reading Complete!

Claude Code CLI 마이그레이션 가이드: Copilot, Gemini, Codex 비교

개요

왜 마이그레이션을 고려하는가

핵심 비교: 4가지 CLI 도구

아키텍처 비교 표

설정 파일 구조 비교

마이그레이션 가이드

1. GitHub Copilot CLI로 마이그레이션

장점

주요 변환 작업

마이그레이션 체크리스트

2. Gemini CLI로 마이그레이션

장점

주요 변환 작업

제한 사항

마이그레이션 체크리스트

3. Codex CLI로 마이그레이션

장점

주요 변환 작업

마이그레이션 체크리스트

상황별 최적 도구 선택

GitHub Copilot CLI를 선택해야 하는 경우

Gemini CLI를 선택해야 하는 경우

Codex CLI를 선택해야 하는 경우

Claude Code를 유지해야 하는 경우

하이브리드 전략

권장 조합

1. Copilot CLI: GitHub 관련 작업

2. Claude Code: 복잡한 설계 작업

3. Gemini CLI: 빠른 조회 및 간단한 작업

도구 간 컨텍스트 공유

마이그레이션 플로우

결론

핵심 결정 요소

권장 접근법

다른 언어로 읽기

글이 도움이 되셨나요?

저자 소개

Kim Jangwook

Reading Complete!

개요

왜 마이그레이션을 고려하는가

핵심 비교: 4가지 CLI 도구

아키텍처 비교 표

설정 파일 구조 비교

마이그레이션 가이드

1. GitHub Copilot CLI로 마이그레이션

장점

주요 변환 작업

마이그레이션 체크리스트

2. Gemini CLI로 마이그레이션

장점

주요 변환 작업

제한 사항

마이그레이션 체크리스트

3. Codex CLI로 마이그레이션

장점

주요 변환 작업

마이그레이션 체크리스트

상황별 최적 도구 선택

GitHub Copilot CLI를 선택해야 하는 경우

Gemini CLI를 선택해야 하는 경우

Codex CLI를 선택해야 하는 경우

Claude Code를 유지해야 하는 경우

하이브리드 전략

권장 조합

1. Copilot CLI: GitHub 관련 작업

2. Claude Code: 복잡한 설계 작업

3. Gemini CLI: 빠른 조회 및 간단한 작업

도구 간 컨텍스트 공유

마이그레이션 플로우

결론

핵심 결정 요소

권장 접근법

다른 언어로 읽기

글이 도움이 되셨나요?

저자 소개

Kim Jangwook

관련 글

Claude Skills 완벽 가이드: 프로젝트 적용기와 실전 노하우

EffiFlow Part 3: 38분 만에 달성한 실전 개선 - 안정성 99%와 완성도 100%

Jules를 이용한 오토코딩: Google의 자율 AI 코딩 에이전트 완벽 가이드