[TIP]Claude Code & Gemini 단축키 설정 가이드

AI CLI 도구인 Claude Code와 Gemini의 단축 명령어를 설정하여 터미널 작업 효율을 극대화하세요

"시간은 돈이다. 단축키는 시간을 아끼는 가장 빠른 방법이다."

복잡한 옵션을 기억할 필요 없이, 짧고 기억하기 쉬운 명령어로 AI 어시스턴트를 호출하세요.

🎯 1. 개요

왜 단축키가 필요한가요?

도구	원래 명령어	단축 명령어	이점
Claude Code	`claude --dangerously-skip-permissions`	`cld -y`	⚡ 65% 타이핑 감소
Gemini	`gemini --yolo`	`ge -y`	⚡ 50% 타이핑 감소

환경

항목	지원
OS	macOS
Shell	zsh
AI 도구	Claude Code, Gemini CLI

📂 2. 설정 파일 수정

(1) `.zshrc` 파일 열기

.zshrc 파일은 홈 디렉토리에 있는 숨김 파일입니다.

# 터미널에서 텍스트 에디터로 파일 열기
nano ~/.zshrc
# 또는
code ~/.zshrc
# 또는
vim ~/.zshrc

💡 숨김 파일 보기: Finder에서 Cmd + Shift + .을 누르면 숨김 파일이 표시됩니다.

⚙️ 3. 단축키 코드 추가

`.zshrc` 파일에 추가할 코드

# ============================================
# AI CLI Short Commands
# ============================================

# Claude Code 단축 명령어
cld() {
    local args=("$@")
    args=("${args[@]/-y/--dangerously-skip-permissions}")
    claude "${args[@]}"
}

# Gemini 단축 명령어
ge() {
    local args=("$@")
    args=("${args[@]/-y/--yolo}")
    gemini "${args[@]}"
}

코드 설명

# cld 함수 동작 원리
cld() {
    local args=("$@")           # 모든 인자를 배열로 저장
    args=("${args[@]/-y/--dangerously-skip-permissions}")  # -y를 실제 옵션으로 변환
    claude "${args[@]}"          # 변환된 인자로 claude 실행
}

구성요소	설명
`local args=("$@")`	모든 명령행 인자를 배열로 저장
`"${args[@]/-y/--dangerously-skip-permissions}"`	`-y`를 `--dangerously-skip-permissions`로 치환
`claude "${args[@]}"`	치환된 인자와 함께 명령어 실행

🔄 4. 적용 및 사용

(1) 터미널 재시작

설정을 적용하기 위해 터미널을 재시작하거나 다음 명령어를 실행하세요:

source ~/.zshrc

(2) 단축 명령어 사용

# Claude Code 실행 (권한 건너뛰기)
cld -y

# Gemini 실행 (yolo 모드)
ge -y

# 다른 옵션과 함께 사용
cld -y "프로젝트 분석해줘"
ge -y "이 코드 리뷰해줘"

🎨 5. 커스터마이징

원하는 대로 수정 가능

# 예시: 더 짧은 단축키
c() { claude "${@/-y/--dangerously-skip-permissions}"; }
g() { gemini "${@/-y/--yolo}"; }

# 예시: 의미있는 이름
ai() { claude "${@/-y/--dangerously-skip-permissions}"; }
ask() { gemini "${@/-y/--yolo}"; }

# 예시: 옵션 자동 포함
cc() { claude --dangerously-skip-permissions "$@"; }
gg() { gemini --yolo "$@"; }

📊 명령어 비교

기존 방식 vs 단축키 방식

┌─────────────────────────────────────────────────────────────────┐
                    Claude Code 실행 비교                          
├─────────────────────────────────────────────────────────────────┤
  기존: claude --dangerously-skip-permissions                       
       37 키 입력 + 복잡한 옵션 기억 필요                                 
                                                                 
  단축: cld -y                                                     
       6 키 입력 + 직관적인 옵션                                        
                                                                 
  효과: ⚡ 84% 입력 감소, ⏱️ 약 3초 시간 절약                             
└─────────────────────────────────────────────────────────────────┘

🛠️ 6. 문제 해결

자주 발생하는 문제

문제	원인	해결 방법
`command not found: cld`	`.zshrc` 변경사항 미적용	`source ~/.zshrc` 실행 또는 터미널 재시작
숨김 파일이 안 보임	Finder 기본 설정	`Cmd + Shift + .`으로 표시
명령어가 작동하지 않음	코드 복사 오류	코드를 다시 복사하고 들여쓰기 확인
옵션이 제대로 전달 안 됨	인자 처리 오류	`"$@"` 따옴표 확인

✨ 활용 팁

함수 네이밍: 자주 사용하는 만큼 짧고 기억하기 쉬운 이름 추천
옵션 조합: 자주 사용하는 옵션 조합을 함수로 만들면 더 효율적
주석 추가: 나중에 기억하기 쉽도록 용도를 주석으로 남기기
백업: .zshrc 수정 전 백업 파일 생성 (cp ~/.zshrc ~/.zshrc.backup)

📚 추가 리소스

Zsh 공식 문서 - 쉘 함수 작성 가이드
Claude Code 문서 - Claude Code 공식 문서
Gemini CLI 문서 - Gemini CLI 가이드

🎯 전체 흐름 요약

1. .zshrc 파일 열기
   └─ nano ~/.zshrc

2. 단축키 코드 추가
   └─ cld() 함수와 ge() 함수 복사/붙여넣기

3. 저장 후 에디터 종료
   └─ Ctrl+O, Enter, Ctrl+X (nano)

4. 설정 적용
   └─ source ~/.zshrc

5. 단축 명령어 사용
   └─ cld -y 또는 ge -y

★ Insight ─────────────────────────────────────

배열 파라미터 확장: "${args[@]/pattern/replacement}"는 Zsh의 강력한 배열 치환 문법으로, 모든 배열 요소에서 패턴을 찾아 교체합니다. 이는 -y 같은 짧은 플래그를 긴 옵션으로 변환하는 데 완벽합니다.
함수 vs Alias: alias cld='claude --dangerously-skip-permissions'도 가능하지만, 함수 방식을 사용하면 인자 치환(-y를 실제 옵션으로 변환)이 가능해 더 유연합니다. 복잡한 로직이 필요하면 함수를, 단순 치환이면 alias를 사용하세요.
Shell 호환성: 이 가이드는 Zsh 기준이지만, Bash에서도 동일한 코드가 작동합니다. .zshrc 대신 .bashrc를 수정하면 됩니다.
─────────────────────────────────────────────────

⚠️ 면책 조항

본 가이드를 따르면서 발생하는 모든 결과에 대한 책임은 전적으로 사용자 본인에게 있습니다. 이 문서는 참고용으로 제공되며, 작성자는 어떠한 손해나 문제에 대해 책임지지 않습니다.

금지 사항:

본 내용을 악의적인 목적으로 사용하는 것을 엄격히 금지합니다.
타인의 권리를 침해하거나 불법적인 활동에 사용하는 것을 금지합니다.
상업적 목적의 무단 복제나 재배포를 금지합니다.

본 가이드의 내용은 학습 및 교육 목적으로만 사용해야 합니다.

AI CLI 도구인 Claude Code와 Gemini의 단축 명령어를 설정하여 터미널 작업 효율을 극대화하세요

"시간은 돈이다. 단축키는 시간을 아끼는 가장 빠른 방법이다."

복잡한 옵션을 기억할 필요 없이, 짧고 기억하기 쉬운 명령어로 AI 어시스턴트를 호출하세요.

🎯 1. 개요

왜 단축키가 필요한가요?

도구	원래 명령어	단축 명령어	이점
Claude Code	`claude --dangerously-skip-permissions`	`cld -y`	⚡ 65% 타이핑 감소
Gemini	`gemini --yolo`	`ge -y`	⚡ 50% 타이핑 감소

환경

항목	지원
OS	macOS
Shell	zsh
AI 도구	Claude Code, Gemini CLI

📂 2. 설정 파일 수정

(1) `.zshrc` 파일 열기

.zshrc 파일은 홈 디렉토리에 있는 숨김 파일입니다.

# 터미널에서 텍스트 에디터로 파일 열기
nano ~/.zshrc
# 또는
code ~/.zshrc
# 또는
vim ~/.zshrc

💡 숨김 파일 보기: Finder에서 Cmd + Shift + .을 누르면 숨김 파일이 표시됩니다.

⚙️ 3. 단축키 코드 추가

`.zshrc` 파일에 추가할 코드

# ============================================
# AI CLI Short Commands
# ============================================

# Claude Code 단축 명령어
cld() {
    local args=("$@")
    args=("${args[@]/-y/--dangerously-skip-permissions}")
    claude "${args[@]}"
}

# Gemini 단축 명령어
ge() {
    local args=("$@")
    args=("${args[@]/-y/--yolo}")
    gemini "${args[@]}"
}

코드 설명

# cld 함수 동작 원리
cld() {
    local args=("$@")           # 모든 인자를 배열로 저장
    args=("${args[@]/-y/--dangerously-skip-permissions}")  # -y를 실제 옵션으로 변환
    claude "${args[@]}"          # 변환된 인자로 claude 실행
}

구성요소	설명
`local args=("$@")`	모든 명령행 인자를 배열로 저장
`"${args[@]/-y/--dangerously-skip-permissions}"`	`-y`를 `--dangerously-skip-permissions`로 치환
`claude "${args[@]}"`	치환된 인자와 함께 명령어 실행

🔄 4. 적용 및 사용

(1) 터미널 재시작

설정을 적용하기 위해 터미널을 재시작하거나 다음 명령어를 실행하세요:

source ~/.zshrc

(2) 단축 명령어 사용

# Claude Code 실행 (권한 건너뛰기)
cld -y

# Gemini 실행 (yolo 모드)
ge -y

# 다른 옵션과 함께 사용
cld -y "프로젝트 분석해줘"
ge -y "이 코드 리뷰해줘"

🎨 5. 커스터마이징

원하는 대로 수정 가능

# 예시: 더 짧은 단축키
c() { claude "${@/-y/--dangerously-skip-permissions}"; }
g() { gemini "${@/-y/--yolo}"; }

# 예시: 의미있는 이름
ai() { claude "${@/-y/--dangerously-skip-permissions}"; }
ask() { gemini "${@/-y/--yolo}"; }

# 예시: 옵션 자동 포함
cc() { claude --dangerously-skip-permissions "$@"; }
gg() { gemini --yolo "$@"; }

📊 명령어 비교

기존 방식 vs 단축키 방식

┌─────────────────────────────────────────────────────────────────┐
                    Claude Code 실행 비교                          
├─────────────────────────────────────────────────────────────────┤
  기존: claude --dangerously-skip-permissions                       
       37 키 입력 + 복잡한 옵션 기억 필요                                 
                                                                 
  단축: cld -y                                                     
       6 키 입력 + 직관적인 옵션                                        
                                                                 
  효과: ⚡ 84% 입력 감소, ⏱️ 약 3초 시간 절약                             
└─────────────────────────────────────────────────────────────────┘

🛠️ 6. 문제 해결

자주 발생하는 문제

문제	원인	해결 방법
`command not found: cld`	`.zshrc` 변경사항 미적용	`source ~/.zshrc` 실행 또는 터미널 재시작
숨김 파일이 안 보임	Finder 기본 설정	`Cmd + Shift + .`으로 표시
명령어가 작동하지 않음	코드 복사 오류	코드를 다시 복사하고 들여쓰기 확인
옵션이 제대로 전달 안 됨	인자 처리 오류	`"$@"` 따옴표 확인

✨ 활용 팁

함수 네이밍: 자주 사용하는 만큼 짧고 기억하기 쉬운 이름 추천
옵션 조합: 자주 사용하는 옵션 조합을 함수로 만들면 더 효율적
주석 추가: 나중에 기억하기 쉽도록 용도를 주석으로 남기기
백업: .zshrc 수정 전 백업 파일 생성 (cp ~/.zshrc ~/.zshrc.backup)

📚 추가 리소스

Zsh 공식 문서 - 쉘 함수 작성 가이드
Claude Code 문서 - Claude Code 공식 문서
Gemini CLI 문서 - Gemini CLI 가이드

🎯 전체 흐름 요약

1. .zshrc 파일 열기
   └─ nano ~/.zshrc

2. 단축키 코드 추가
   └─ cld() 함수와 ge() 함수 복사/붙여넣기

3. 저장 후 에디터 종료
   └─ Ctrl+O, Enter, Ctrl+X (nano)

4. 설정 적용
   └─ source ~/.zshrc

5. 단축 명령어 사용
   └─ cld -y 또는 ge -y

★ Insight ─────────────────────────────────────

배열 파라미터 확장: "${args[@]/pattern/replacement}"는 Zsh의 강력한 배열 치환 문법으로, 모든 배열 요소에서 패턴을 찾아 교체합니다. 이는 -y 같은 짧은 플래그를 긴 옵션으로 변환하는 데 완벽합니다.
함수 vs Alias: alias cld='claude --dangerously-skip-permissions'도 가능하지만, 함수 방식을 사용하면 인자 치환(-y를 실제 옵션으로 변환)이 가능해 더 유연합니다. 복잡한 로직이 필요하면 함수를, 단순 치환이면 alias를 사용하세요.
Shell 호환성: 이 가이드는 Zsh 기준이지만, Bash에서도 동일한 코드가 작동합니다. .zshrc 대신 .bashrc를 수정하면 됩니다.
─────────────────────────────────────────────────

⚠️ 면책 조항

금지 사항:

본 내용을 악의적인 목적으로 사용하는 것을 엄격히 금지합니다.
타인의 권리를 침해하거나 불법적인 활동에 사용하는 것을 금지합니다.
상업적 목적의 무단 복제나 재배포를 금지합니다.

본 가이드의 내용은 학습 및 교육 목적으로만 사용해야 합니다.

🎯 1. 개요

왜 단축키가 필요한가요?

환경

📂 2. 설정 파일 수정

(1) .zshrc 파일 열기

⚙️ 3. 단축키 코드 추가

.zshrc 파일에 추가할 코드

코드 설명

🔄 4. 적용 및 사용

(1) 터미널 재시작

(2) 단축 명령어 사용

🎨 5. 커스터마이징

원하는 대로 수정 가능

📊 명령어 비교

기존 방식 vs 단축키 방식

🛠️ 6. 문제 해결

자주 발생하는 문제

✨ 활용 팁

📚 추가 리소스

🎯 전체 흐름 요약

⚠️ 면책 조항

태그

🎯 1. 개요

왜 단축키가 필요한가요?

환경

📂 2. 설정 파일 수정

(1) .zshrc 파일 열기

⚙️ 3. 단축키 코드 추가

.zshrc 파일에 추가할 코드

코드 설명

🔄 4. 적용 및 사용

(1) 터미널 재시작

(2) 단축 명령어 사용

🎨 5. 커스터마이징

원하는 대로 수정 가능

📊 명령어 비교

기존 방식 vs 단축키 방식

🛠️ 6. 문제 해결

자주 발생하는 문제

✨ 활용 팁

📚 추가 리소스

🎯 전체 흐름 요약

⚠️ 면책 조항

태그

(1) `.zshrc` 파일 열기

`.zshrc` 파일에 추가할 코드

(1) `.zshrc` 파일 열기

`.zshrc` 파일에 추가할 코드