Claude Code 소개 및 설치

나는 업무 문서를 vscode를 이용하여 일기처럼 작성한다. 그런데 ai를 사용하기 위해서 복사해서 claude.ai에 넣는 과정이 너무 번거롭습니다.

ai를 편하게 vscode에서 사용하고 싶다.

claude code with terminal

Claude code는 터미널에서 claude ai를 사용할 수 있는 cli 툴이다.

일단 이걸 설치해보고 사용해보자.

curl -fsSL https://claude.ai/install.sh | bash # 기존에는 Npm인데 바뀌였음.
claude

hi.

alt text

터미널에서 잘 동작한다.

커맨드	설명	예시
claude	대화형 모드 시작	claude
claude "task"	일회성 작업 실행	claude "fix the build error"
claude -p "query"	일회성 쿼리 실행 후 종료	claude -p "explain this function"
claude -c	가장 최근 대화 계속	claude -c
claude -r	이전 대화 재개	claude -r
claude commit	Git 커밋 생성	claude commit

claude code with vscode

이제 vscode extension을 설치해보자.

code --install-extension anthropic.claude-code

alt text

이제 화면에 claude code 아이콘이 보인다.

alt text

누르면 claude code 패널이 열린다.

alt text

alt text

이제 업무 문서를 작성하면서도 claude ai를 vscode를 벗어나지 않고 사용할 수 있다.

활용

현재 파일 선택

현재 파일 내용이 필요하면 claude가 자동으로 불러온다.

alt text

현재 파일의 내용을 바탕으로 요약해줘.

선택한 내용

특정부분을 선택하면 자동으로 claude에 보내진다.

alt text

현재 선택한 내용을 바탕으로 요약해줘.

mode

3가지 모드가 있다 shift + tab로 전환가능하다.

• normal : 계속 accept를 눌러줘야한다.

• accept edits on : 수정사항을 자동으로 받아들인다.

• plan mode : 작업계획을 세운다. 실제 변경 없음.

alt text

alt text

alt text

vs code에서는 다음 부분을 클릭하면 바뀐다.

alt text

alt text

alt text

ctrl + c

ai는 항상 잘못된 길로 달려가기도 한다. 그렇게 되면 토큰을 다 써버려 제한에 걸릴 수 있다.

그럴때는 ctrl + c로 중단시키고 다시 시도하면 된다.

ctrl + c를 두려워하지 말자.

잘못된 방향으로가는 느낌이 나면 멈추고 다시 정리해서 올바른 길로 인도해야한다.

가만 두면 더 이상해진다.

이미지 사용하기

• 클립보드 이미지 : ctrl + v로 이미지 스샷을 붙여넣을 수 있다.

• 이미지 파일 : 이미지 파일을 드래그 앤 드롭으로 올릴 수 있다.

• @을 사용하여 경로를 사용할수 있다.

유용한 커맨드 (terminal)

claude code실행후

claude code 실행후 / 를 입력하면 커맨드 목록이 나온다.

alt text

• /context : Visualize current context usage as a colored grid

alt text

• /clear (reset, new): Clear conversation history and free up context

• /compact : Clear conversation history but keep a summary in context. Optional: /compact

• /add-dir: 여러 디렉토리에 나눠저 잇는걸 한꺼번에 사용해야하는경우 Add a new working directory

• /model <alias|name>

  1. Sonnet   Sonnet 4.5 · Smartest model for daily use · $3/$15 per Mtok ✔
  2. Haiku    Haiku 4.5 · Fastest model for simple tasks
  3. Opus     max user만 가능

• /status

  

  alt text

  

  alt text

  

  alt text
• /terminal-setup : shift + enter : new line in prompt ``

• /statusline : 상태를 볼수있음 , https://code.claude.com/docs/ko/statusline

cat > ~/.claude/statusline.sh << 'EOF'
#!/bin/bash

input=$(cat)

MODEL_DISPLAY=$(echo "$input" | jq -r '.model.display_name')
CURRENT_DIR=$(echo "$input" | jq -r '.workspace.current_dir')

echo "[$MODEL_DISPLAY] 📁 ${CURRENT_DIR##\*/}"
EOF

chmod +x ~/.claude/statusline.sh

vi ~/.claude/settings.json

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh",
    "padding": 0 // 선택 사항: 상태 줄이 가장자리까지 가도록 0으로 설정
  }
}

terminal에서 실행시

• 터미널에서 ? 를 입력하면 추가 옵션을 볼수 있다.

alt text

• ctrl + t : show todos

• shift + enter : new line in prompt

• double tap esc : clear input

• 기존 대화 이어서 진행 : claude --continue (-c))

• 기존 대화 목록 보기 : claude --resume (-r)

  

  alt text
• model 변경 :claude --model

• haiku : 싸고 빠름 품질 다른모델에 비해서 낮음 그러나 괞찮음

• sonnet : 중간 가격에 중간속도 중간품질 (기본으로 많이 사용)

• opus : 비싸고 느림 그러나 품질이 좋음 max 요금제만 가능

model

https://code.claude.com/docs/en/model-config

모델별칭	동작
default	계정 유형에 따라 권장되는 모델 설정
sonnet	일상적인 코딩 작업을 위해 최신 Sonnet 모델(현재 Sonnet 4.5) 사용
opus	특화된 복잡한 추론 작업을 위해 Opus 모델(현재 Opus 4.1) 사용
haiku	간단한 작업을 위해 빠르고 효율적인 Haiku 모델 사용
sonnet[1m]	긴 세션을 위해 1백만 토큰 컨텍스트 윈도우를 사용하는 Sonnet 사용
opusplan	계획 모드에서 opus를 사용한 후 실행 중에 sonnet으로 전환하는 특수 모드

유용한 커맨드 (vscode)

• 기존 대화 내용

alt text