Claude Code 설치 및 VSCode 통합 가이드 (Ubuntu 24.04)
Claude Code를 Ubuntu 24.04에서 설치하고 VSCode와 통합하는 전체 과정을 안내합니다.
1단계: 시스템 준비
필수 패키지들을 설치합니다:
sudo apt update
sudo apt install curl git build-essential -y2단계: Node.js 설치
Claude Code는 npm을 통해 설치하므로 Node.js가 필요합니다.
Node.js 20.x LTS 버전 설치:
# NodeSource 저장소 설정 스크립트 다운로드 및 확인 (권장)
curl -fsSL https://deb.nodesource.com/setup_20.x -o setup_nodejs.sh
cat setup_nodejs.sh # 내용 확인
sudo -E bash setup_nodejs.sh
rm setup_nodejs.sh
# 또는 원라이너로 바로 설치 (빠르지만 내용 확인 불가)
# curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
# Node.js 설치
sudo apt install nodejs -y
# 설치 확인
node --version
npm --version3단계: npm 전역 설치 디렉토리 설정
sudo 없이 전역 패키지를 설치할 수 있도록 설정합니다:
# npm 전역 디렉토리를 홈 디렉토리에 생성
mkdir -p ~/.npm-global
# npm 설정 변경
npm config set prefix '~/.npm-global'
# PATH 환경 변수에 추가
echo 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
# 설정 확인
npm config get prefix
echo $PATH4단계: Claude Code 설치
이제 sudo 없이 Claude Code를 설치합니다:
# Claude Code 설치
npm install -g @anthropic-ai/claude-code
# 설치된 파일 확인
ls -la ~/.npm-global/bin/
# 버전 확인
claude --version중요: 명령어는 claude-code가 아니라 claude입니다!
(선택사항) claude-code 별칭 생성
claude-code 명령어를 선호한다면:
# 방법 1: 심볼릭 링크 생성
ln -s ~/.npm-global/lib/node_modules/@anthropic-ai/claude-code/cli.js ~/.npm-global/bin/claude-code
# 방법 2: Bash 별칭 사용
echo "alias claude-code='claude'" >> ~/.bashrc
source ~/.bashrc5단계: API 키 설정
Claude Code를 사용하려면 Anthropic API 키가 필요합니다:
# API 키를 환경 변수로 설정
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.bashrc
source ~/.bashrc
# 또는 .zshrc를 사용하는 경우
# echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
# source ~/.zshrcAPI 키 발급: https://console.anthropic.com/settings/keys
6단계: VSCode와 통합
방법 1: VSCode 터미널에서 직접 사용
VSCode의 통합 터미널에서 Claude를 바로 사용할 수 있습니다:
- VSCode 실행
- Ctrl + ` (백틱) 또는 메뉴에서 Terminal > New Terminal
- 프로젝트 디렉토리로 이동
- Claude 명령어 실행:
# 프로젝트 디렉토리에서
claude "create a simple express server"방법 2: VSCode Tasks 설정
프로젝트별로 Claude를 쉽게 실행할 수 있도록 설정합니다:
- Ctrl + Shift + P로 명령 팔레트 열기
- "Tasks: Configure Task" 입력 및 선택
- "Create tasks.json file from template" 선택
- "Others" 선택
.vscode/tasks.json파일에 다음 내용 작성:
{
"version": "2.0.0",
"tasks": [
{
"label": "Claude Code",
"type": "shell",
"command": "claude",
"args": [
"${input:claudePrompt}"
],
"problemMatcher": [],
"presentation": {
"reveal": "always",
"panel": "new"
}
}
],
"inputs": [
{
"id": "claudePrompt",
"type": "promptString",
"description": "Enter your Claude prompt"
}
]
}- Ctrl + Shift + P > "Tasks: Run Task" > "Claude Code"로 실행
방법 3: 키보드 단축키 설정
더 빠른 접근을 위한 키보드 단축키:
- Ctrl + K, Ctrl + S로 키보드 단축키 설정 열기
- 우측 상단의 파일 아이콘 클릭하여
keybindings.json열기 - 다음 내용 추가:
[
{
"key": "ctrl+shift+c",
"command": "workbench.action.tasks.runTask",
"args": "Claude Code"
}
]이제 Ctrl + Shift + C로 Claude를 빠르게 실행할 수 있습니다.
7단계: 기본 사용법
간단한 명령어 예시:
# 현재 디렉토리에서 코드 생성
claude "create a Python script to analyze CSV files"
# 특정 파일 수정 요청
claude "refactor app.js to use async/await"
# 버그 수정
claude "fix the authentication bug in auth.py"대화형 모드:
# 대화형 세션 시작
claude도움말:
# 사용 가능한 옵션 확인
claude --help8단계: Git 통합 (권장)
Claude는 Git과 잘 통합되므로 프로젝트를 Git 저장소로 관리하세요:
# Git 저장소 초기화 (필요한 경우)
git init
# 작업 전 항상 커밋하는 습관
git add .
git commit -m "before claude changes"Claude가 코드를 수정하기 전에 커밋해두면 변경사항을 쉽게 되돌릴 수 있습니다.
문제 해결
명령어를 찾을 수 없는 경우:
# PATH 확인
echo $PATH
# npm 전역 경로 확인
npm config get prefix
# ~/.npm-global/bin이 PATH에 있는지 확인
# 없다면 다시 추가
echo 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc설치는 되었는데 실행이 안 되는 경우:
# 실제 설치 확인
ls -la ~/.npm-global/bin/
# 직접 실행 테스트
$HOME/.npm-global/bin/claude --version
# 파일 권한 확인
chmod +x ~/.npm-global/bin/claudeAPI 키 오류가 발생하는 경우:
# 환경 변수 확인
echo $ANTHROPIC_API_KEY
# 환경 변수가 비어있다면 다시 설정
export ANTHROPIC_API_KEY="your-api-key-here"추가 정보
- 공식 문서: https://docs.claude.com
- Claude Code 문서: https://docs.claude.com/en/docs/claude-code
- API 키 관리: https://console.anthropic.com/settings/keys
이제 Ubuntu 24.04에서 Claude Code를 VSCode와 함께 사용할 준비가 완료되었습니다!
cyan-inn.im