AI Coding Agent Tips

AI 코딩 에이전트를 효과적으로 활용하는 팁 모음

🟣 Claude Code

🖥️

Terminal Setup

터미널 테마 및 입력 최적화

/config로 테마를 전환하고, /terminal-setup으로 Shift+Enter 줄바꿈을 활성화. /vim으로 Vim 모드도 사용 가능.

⚡

Effort Levels

토큰 사용량 vs 지능 수준 조절

/model 명령으로 Low/Medium/High 에포트 레벨 선택. Low는 빠르고 저렴, High는 느리지만 더 똑똑.

🚀

Claude Code v2.1.68 (2026-03-04)부터 기본 effort level이 medium으로 바뀌어 답변 품질이 낮아질 수 있다. `.zshrc`에 `export CLAUDE_CODE_EFFORT_LEVEL=max`를 추가하면 모든 세션에 영구 적용된다. settings.json은 max 저장 버그가 있고, CLI 플래그는 매번 붙여야 하므로 환경변수가 최선.

🔌

Plugins, MCP, Skills

MCP 서버, 스킬, 에이전트 확장

/plugin으로 플러그인 마켓플레이스에서 LSP, MCP, 스킬, 에이전트를 설치. 회사 전용 마켓플레이스도 생성 가능.

🤖

Custom Agents

.claude/agents에 커스텀 에이전트 생성

.claude/agents/ 디렉토리에 .md 파일을 추가하면 커스텀 에이전트를 생성. 이름, 색상, 도구, 권한, 모델을 개별 지정 가능.

🔐

Permission Pre-approval

권한 사전 승인으로 워크플로우 가속

/permissions로 도구별 허용/차단 목록 설정. 와일드카드 지원 — Bash(bun run *), Edit(/docs/**) 등.

📦

Sandbox Mode

파일/네트워크 격리로 안전성 향상

/sandbox로 오픈소스 샌드박스 런타임 활성화. 파일 격리 + 네트워크 격리로 권한 프롬프트 감소.

📊

Custom Status Line

컴포저 하단에 커스텀 정보 표시

/statusline으로 모델명, 디렉토리, 남은 컨텍스트, 비용 등을 컴포저 바로 아래에 표시.

⌨️

Keybinding Customization

모든 키바인딩을 자유롭게 재매핑

/keybindings로 Claude Code의 모든 키 바인딩을 재매핑. 설정이 실시간 리로드되어 즉시 적용.

🪝

Hooks

Claude 라이프사이클에 결정론적으로 개입

훅으로 권한 요청을 Slack으로 라우팅하거나, 턴 종료 시 넛지 추가, 도구 호출의 전처리/후처리 등이 가능.

🔄

Spinner Verbs

로딩 스피너 동사 커스터마이징

settings.json에서 기본 스피너 동사 목록에 자신만의 동사를 추가하거나 교체. 팀과 공유 가능.

🎨

Output Styles

응답 톤과 포맷 설정

/config에서 출력 스타일 설정. "explanatory" 스타일은 코드 패턴을 설명하며 작업, "learning" 스타일은 코칭 형태.

⚙️

settings.json 관리

37개 설정 + 84개 환경 변수

settings.json을 Git에 체크인하면 팀 전체 설정 공유. 코드베이스/서브폴더/개인/엔터프라이즈 단위로 설정 가능.

📝

CLAUDE.md 작성법 — 순서 최적화와 베스트 프랙티스

안 바뀌는 건 위에, 자주 바뀌는 건 아래에 — 프롬프트 캐싱 최적화

CLAUDE.md는 매 세션마다 자동 로드되는 프로젝트 규칙서. 순서가 중요하다 — 안 바뀌는 내용(프로젝트 설명, 코딩 규칙)을 위에, 자주 바뀌는 내용(현재 작업)을 아래에 두면 프롬프트 캐시 히트율이 올라간다.

⚖

Commands vs Skills 완전 비교

.claude/commands/ 와 .claude/skills/ — 언제 뭘 써야 하나

Commands는 단일 .md 파일의 단순 프롬프트, Skills는 디렉토리 구조의 복잡한 워크플로우. 호출 방식, 구조, 자동 트리거 여부가 다르다. 한눈에 비교 정리.

🧩

Context · Memory · Handoff 완전 정리

Claude Code의 세 가지 "기억" 메커니즘 — 각각 언제 쓰이고 어떻게 다른가

Claude Code에는 Context(현재 대화), Memory(세션 간 기억), Handoff(세션 이동)라는 세 가지 기억 체계가 있다. 이 세 개를 혼동하면 "왜 기억 못 하지?" 문제가 생긴다.

🧠

Auto Memory

세션 간 컨텍스트 자동 기억

Claude Code는 세션 간 중요한 정보를 ~/.claude/projects/에 자동 저장. "이거 기억해" 명령으로 수동 저장도 가능.

💬

/btw (By The Way)

대화를 오염시키지 않고 별도 질문이 가능한 "그런데" 기능

작업 중인 대화를 중단하지 않고, 별도의 질문이나 요청을 사이드로 할 수 있는 /btw 명령. Cursor에서 별도 채팅을 여는 것과 비슷한 느낌으로 Claude Code에 탑재.

🤖

Auto Permission Mode

도구 사용을 자동 판단하여 장시간 자율 작업 가능

claude --permission-mode auto로 Claude 자신이 도구 사용 여부를 판단하여, 사람의 승인 없이 장시간 자율적으로 작업을 계속할 수 있음.

🎙️

/voice — Voice Input

음성으로 Claude Code에 지시하기

/voice 명령으로 음성 입력 모드를 시작. 키보드 없이 자연어로 지시할 수 있어 핸즈프리 코딩이 가능.

🗜️

/compact — 컨텍스트 압축

대화 컨텍스트를 압축하여 토큰 절약

/compact 명령으로 현재 대화를 요약·압축하여 컨텍스트 윈도우를 확보. 긴 세션에서도 성능 저하 없이 작업을 이어갈 수 있음.

📱

Remote Control — 모바일에서 Claude Code

claude remote-control로 스마트폰/브라우저에서 접속

claude remote-control 명령으로 로컬 세션을 스마트폰(Claude 앱)이나 브라우저(claude.ai/code)에서 이어서 사용할 수 있습니다. SSH 설정 없이 QR코드 스캔만으로 연결.

🔄

--resume / --continue — 세션 이어하기

이전 대화를 이어서 작업, claude.ai ↔ Claude Code 세션 이동

--continue로 최근 세션을 즉시 재개하거나, --resume으로 과거 세션을 선택하여 이어서 작업. claude.ai 웹에서 시작한 세션을 Claude Code로 가져오거나, 그 반대도 가능합니다.

🚫

.claudeignore — 불필요한 파일 읽기 차단

토큰 낭비 방지 + 민감 파일 보호

.claudeignore는 .gitignore와 동일한 문법으로 Claude Code가 읽지 말아야 할 파일/디렉토리를 지정. 대용량 파일, 빌드 결과물, 민감 정보 파일을 차단하여 토큰 낭비를 방지한다.

🎓

Claude Code 학습 리소스 총정리

공식 코스, 핸즈온 랩, MCP·Agent 스킬까지 — 공부할 때 보면 좋은 링크

Anthropic 공식 학습 플랫폼(Skilljar)과 GitHub 코스 레포를 정리. Claude Code 실전, Agent Skills, MCP 프로토콜까지 단계별 학습 경로.

📨

Channels — 텔레그램/디스코드에서 Claude Code 제어

밖에서 모바일로 세션에 메시지를 보내고, Claude가 로컬 파일시스템에서 작업

2025년 3월 출시된 Channels 기능. 텔레그램이나 디스코드에서 실행 중인 Claude Code 세션으로 메시지를 보내면, Claude가 내 컴퓨터의 파일·Git·MCP에 완전히 접근해서 작업하고 답장을 보내준다. 클라우드가 아니라 내 로컬 세션에 창을 하나 더 여는 개념.