AI 기업 Crystal Method Co., Ltd.에서 Claude Code를 일상 업무에 사용하는 팀의 기록입니다.
2026년 10월 20일에 Claude Code v2.1.304를 깨끗한 폴더에 설치하고, 처음 실행하여 작업을 요청할 때까지 실제 조작을 녹화했습니다. 이때, 처음 사용하는 사람이 주저할 만한 장소가 3군데 있었습니다. 화면은 모두 실제 출력 그대로입니다 (Linux・Opus 5.5・Claude Max 플랜).
사용된 것은 HTML・CSS・JavaScript의 파일 3개만 있는 작은 연습용 폴더입니다.
- 공식 커맨드 한 줄로 설치하기
- 작업 폴더에서
claude라고 입력하여 실행하기 - 일본어로 '이 폴더에 무엇이 있는지 설명해 달라'고 요청하기
- '제목 색을 파란색으로 바꿔달라'고 요청하고, 변경 내용을 확인한 후 덮어쓰게 하기
공식 설치 커맨드는 이것뿐입니다.
curl -fsSL https://claude.ai/install.sh | bash
실행하면 Claude Code successfully installed!라고 나오지만, 이번 환경에서는 그 아래에 Setup notes로 '~/.local/bin이 PATH에 포함되어 있지 않다'는 주의가 표시되었습니다. 이 상태에서 claude라고 입력해도 '커맨드를 찾을 수 없습니다'라는 메시지가 나옵니다.
화면에 나온 대로, export PATH="$HOME/.local/bin:$PATH"를 실행한 후 claude --version을 입력하자, 2.1.304 (Claude Code)가 표시되었습니다. 터미널을 다시 열 때마다 필요하지 않도록, 표시된 안내에 따라 셸 설정 파일(bash의 경우 ~/.bashrc 등)에 이 한 줄을 추가합니다.
작업 폴더에서 claude라고 입력하면, 처음에 '이 폴더를 신뢰할지'를 묻습니다. 이번 버전에서는 처음 선택된 것이 No, exit였습니다.
저희도 첫 녹화 때는 그대로 Enter를 눌러 Claude Code가 종료되어 버렸습니다. 직접 만든 폴더라면, 아래 화살표 키로 Yes, I trust this folder에 맞춰서 Enter를 누릅니다.
다운로드한 내용물이 알 수 없는 폴더에서는 No를 선택하여 먼저 내용을 확인하는 것이 안전합니다.
이번에는 Claude Code가 무엇을 하려고 하는지 하나하나 확인할 수 있도록, claude --permission-mode manual (수동으로 승인하는 모드)로 실행했습니다.
'이 폴더에 무엇이 있는지 초보자도 알기 쉽게 짧게 설명해 달라'고 요청하자, 3개 파일의 내용을 표시하는 커맨드를 실행해도 되는지 물어봤습니다. 화면에는 '이 커맨드의 변수는 실행 전에 확인할 수 없다'는 이유가 나와 있었습니다.
망가뜨리는 작업은 아니었으므로 1. Yes로 허가했습니다. 그 후, 파일별 역할(페이지의 뼈대・모양・움직임)을 표로 정리해서 답변해 주었습니다. 여러 번 물어보는 것이 귀찮다면, 화면의 두 번째 선택지에서 자동으로 판단하는 모드(auto mode)로 전환할 수 있습니다. 익숙해질 때까지는 무엇을 하려고 하는지 읽고 허가하는 편이 안심입니다.
계속해서 '제목 색을 파란색으로 바꿔달라'고 요청했습니다. Claude Code는 style.css를 읽어, 덮어쓰기 전에 변경 전(빨강)과 변경 후(초록)를 나란히 보여주며 덮어쓸지 확인합니다.
1. Yes를 선택하면 덮어쓰기가 진행되고, 무엇을 어떻게 바꿨는지 (#333333의 진한 회색에서 #0066cc의 파랑으로) 일본어로 보고해 주었습니다.
실행부터 덮어쓰기 보고까지, 이 연습용 폴더에서는 1분 남짓이 걸렸습니다.
- 설치 후 PATH 관련 주의가 나오면, 표시된
export 줄을 실행하고 설정 파일에도 추가한다 - 폴더 신뢰 확인은 처음에 No, exit가 선택되어 있다. 자신의 폴더라면 아래 화살표로 Yes를 선택한다 - 수동 모드에서는 파일을 읽기만 하는 커맨드라도 허가를 요청받을 수 있다. 무엇을 할지 읽고 나서 허가하는 것이 좋다
요금・시작 방법・할 수 있는 것의 전체 내용은 다음 기사에 정리했습니다.
