Claude Code Practical Guide
AI & HCI챗봇이랑 뭐가 달라요? 물어보는 사람이 많아서 정리했다.
A practical reference guide for Claude Code — the terminal-based AI coding agent by Anthropic. Covers the key difference from the chat interface, essential commands, and common gotchas that trip up first-time users.
Core concept: Claude Code runs in your terminal and acts directly on your local environment. It creates real files, runs real code, and can spawn parallel sub-agents. The chat interface cannot do any of this.
Key commands covered:
! — run shell commands without leaving Claude Code
# — pass session hints (volatile, not saved to CLAUDE.md)
Shift+Tab — cycle permission modes: default → acceptEdits → plan → auto
Option+T / ultrathink — toggle extended thinking (Mac requires Option-as-Meta setup)
/rewind — checkpoint restore menu: code only, conversation only, or both
/memory — inspect and edit what Claude currently has loaded
CLAUDE.md — three scopes: global (~/.claude/), project (root), local (.claude/)
/export — save full session transcript to file
Common mistakes documented:
# hints disappear when the session ends — use CLAUDE.md for persistent rules
Esc × 2 only opens the rewind menu when the input field is empty
acceptEdits mode auto-approves file edits, but shell commands still prompt
bash-modified files (!rm, !mv) are not restored by /rewind
Anthropic의 터미널 기반 AI 코딩 에이전트 Claude Code의 실용 안내서. 챗봇과의 차이, 핵심 명령어, 처음 쓸 때 자주 막히는 지점들을 정리했다.
핵심 개념: Claude Code는 내 컴퓨터 터미널에서 실행되며 로컬 환경에 직접 작동한다. 실제 파일을 만들고, 실제 코드를 실행하고, 병렬 Sub-agent를 호출할 수 있다. 챗봇 인터페이스로는 이 중 어느 것도 할 수 없다.
주요 명령어:
! — Claude Code 안에서 쉘 명령어 직접 실행
# — 세션 힌트 전달 (세션 종료 시 사라짐, CLAUDE.md에 저장 안 됨)
Shift+Tab — 권한 모드 순환: default → acceptEdits → plan → auto
Option+T / ultrathink — 확장 추론 토글 (맥은 Option-as-Meta 사전 설정 필요)
/rewind — 체크포인트 복원 메뉴: 파일만 / 대화만 / 둘 다
/memory — 현재 로드된 메모리 확인 및 편집
CLAUDE.md — 3가지 범위: 글로벌 / 프로젝트 / 로컬
/export — 세션 전체 대화 파일로 저장
자주 하는 실수:
# 힌트는 세션이 끝나면 사라짐 — 영구 저장은 CLAUDE.md 직접 편집
Esc × 2는 입력창이 빈 상태에서만 rewind 메뉴 열림
acceptEdits 모드는 파일 수정만 자동 승인 — 쉘 명령은 여전히 물어봄
!rm, !mv 등 bash로 변경한 파일은 /rewind로 복원 안 됨
Links
Leave a Comment: