Anthropic에서 만든 에이전트 코딩 도구인 Claude Code에 대해 알아보세요. 현재 연구 미리보기로 베타 버전입니다.
sudo npm install -g
를 사용하지 마세요. 권한 오류가 발생하면 Claude Code 구성에서 권장 솔루션을 참조하세요./bug
명령을 통해 직접 보고하거나 GitHub 저장소를 통해 보고할 수 있습니다.npm
을 사용하고 있을 수 있습니다. 다음을 시도해보세요:
npm config set os linux
실행npm install -g @anthropic-ai/claude-code --force --no-os-check
로 설치 (sudo
사용하지 마세요)claude
를 실행할 때 exec: node: not found
오류가 표시되면 WSL 환경이 Windows의 Node.js 설치를 사용하고 있을 수 있습니다. which npm
과 which node
로 확인할 수 있으며, 이는 /mnt/c/
가 아닌 /usr/
로 시작하는 Linux 경로를 가리켜야 합니다. 이 문제를 해결하려면 Linux 배포판의 패키지 관리자를 통해 또는 nvm
을 통해 Node를 설치해 보세요.
Claude Code 설치
npm install -g @anthropic-ai/claude-code
sudo npm install -g
를 사용하지 마세요. 권한 오류가 발생하면 Claude Code 구성에서 권장 솔루션을 참조하세요.프로젝트로 이동
cd your-project-directory
Claude Code 시작
claude
입력인증 완료
claude
로 Claude Code 시작summarize this project
와 같은 간단한 명령 시도/init
으로 CLAUDE.md 프로젝트 가이드 생성--print
(-p
)를 사용하세요. 이 모드에서는 ANTHROPIC_API_KEY
환경 변수를 설정하여 사용자 지정 API 키를 제공할 수 있습니다.
비대화형 모드는 Claude가 사용할 수 있는 명령 세트를 미리 구성할 때 특히 유용합니다:
명령 | 설명 | 예시 |
---|---|---|
claude | 대화형 REPL 시작 | claude |
claude "query" | 초기 프롬프트로 REPL 시작 | claude "explain this project" |
claude -p "query" | 일회성 쿼리 실행 후 종료 | claude -p "explain this function" |
cat file | claude -p "query" | 파이프된 콘텐츠 처리 | cat logs.txt | claude -p "explain" |
claude config | 설정 구성 | claude config set --global theme dark |
claude update | 최신 버전으로 업데이트 | claude update |
claude mcp | Model Context Protocol 서버 구성 | 튜토리얼의 MCP 섹션 참조 |
--print
(-p
): 대화형 모드 없이 응답 출력--json
: --print
모드에서 JSON 출력 반환, 스크립팅 및 자동화에 유용--verbose
: 상세 로깅 활성화, 전체 턴별 출력 표시(인쇄 및 대화형 모드 모두에서 디버깅에 유용)--dangerously-skip-permissions
: 권한 프롬프트 건너뛰기명령 | 목적 |
---|---|
/bug | 버그 보고(대화를 Anthropic에 전송) |
/clear | 대화 기록 지우기 |
/compact [instructions] | 선택적 집중 지침으로 대화 압축 |
/config | 구성 보기/수정 |
/cost | 토큰 사용 통계 표시 |
/doctor | Claude Code 설치 상태 확인 |
/help | 사용 도움말 얻기 |
/init | CLAUDE.md 가이드로 프로젝트 초기화 |
/login | Anthropic 계정 전환 |
/logout | Anthropic 계정에서 로그아웃 |
/memory | CLAUDE.md 메모리 파일 편집 |
/pr_comments | 풀 리퀘스트 댓글 보기 |
/review | 코드 리뷰 요청 |
/terminal-setup | 줄바꿈을 위한 Shift+Enter 키 바인딩 설치(iTerm2 및 VSCode만 해당) |
/vim | 삽입 및 명령 모드를 번갈아 사용하는 vim 모드 진입 |
메모리 유형 | 위치 | 목적 | 사용 사례 예시 |
---|---|---|---|
프로젝트 메모리 | ./CLAUDE.md | 팀 공유 규칙 및 지식 | 프로젝트 아키텍처, 코딩 표준, 일반적인 워크플로우 |
프로젝트 메모리(로컬) | ./CLAUDE.local.md | 개인 프로젝트별 기본 설정 | 샌드박스 URL, 선호하는 테스트 데이터 |
사용자 메모리 | ~/.claude/CLAUDE.md | 전역 개인 기본 설정 | 코드 스타일 기본 설정, 개인 도구 단축키 |
#
단축키로 빠르게 메모리 추가하기#
문자로 시작하는 것입니다:
/memory
로 직접 메모리 편집하기/memory
슬래시 명령을 사용하여 시스템 편집기에서 메모리 파일을 열어 더 광범위한 추가 또는 구성을 할 수 있습니다.
도구 유형 | 예시 | 승인 필요 | ”Yes, don’t ask again” 동작 |
---|---|---|---|
읽기 전용 | 파일 읽기, LS, Grep | 아니오 | 해당 없음 |
Bash 명령 | 쉘 실행 | 예 | 프로젝트 디렉토리 및 명령별로 영구적 |
파일 수정 | 파일 편집/쓰기 | 예 | 세션 종료까지 |
도구 | 설명 | 권한 필요 |
---|---|---|
Agent | 복잡한 다단계 작업을 처리하기 위해 하위 에이전트를 실행합니다 | 아니오 |
Bash | 환경에서 쉘 명령을 실행합니다 | 예 |
Glob | 패턴 매칭을 기반으로 파일을 찾습니다 | 아니오 |
Grep | 파일 내용에서 패턴을 검색합니다 | 아니오 |
LS | 파일 및 디렉토리를 나열합니다 | 아니오 |
Read | 파일의 내용을 읽습니다 | 아니오 |
Edit | 특정 파일에 대한 대상 편집을 수행합니다 | 예 |
Write | 파일을 생성하거나 덮어씁니다 | 예 |
NotebookEdit | Jupyter 노트북 셀을 수정합니다 | 예 |
NotebookRead | Jupyter 노트북 내용을 읽고 표시합니다 | 아니오 |
WebFetch | 지정된 URL에서 콘텐츠를 가져옵니다 | 예 |
/allowed-tools
를 사용하거나 권한 설정에서 구성할 수 있습니다.
curl
및 wget
과 같이 웹에서 임의의 콘텐츠를 가져오는 위험한 명령을 차단합니다/bug
로 의심스러운 동작 보고변수 | 목적 |
---|---|
DISABLE_AUTOUPDATER | 자동 업데이터를 비활성화하려면 1 로 설정 |
DISABLE_BUG_COMMAND | /bug 명령을 비활성화하려면 1 로 설정 |
DISABLE_COST_WARNINGS | 비용 경고 메시지를 비활성화하려면 1 로 설정 |
DISABLE_ERROR_REPORTING | Sentry 오류 보고를 옵트아웃하려면 1 로 설정 |
DISABLE_TELEMETRY | Statsig 원격 측정을 옵트아웃하려면 1 로 설정(Statsig 이벤트에는 코드, 파일 경로 또는 bash 명령과 같은 사용자 데이터가 포함되지 않음) |
HTTP_PROXY | 네트워크 연결을 위한 HTTP 프록시 서버 지정 |
HTTPS_PROXY | 네트워크 연결을 위한 HTTPS 프록시 서버 지정 |
MCP_TIMEOUT | MCP 서버 시작을 위한 타임아웃(밀리초) |
MCP_TOOL_TIMEOUT | MCP 도구 실행을 위한 타임아웃(밀리초) |
claude config
를 실행하거나 대화형 REPL을 사용할 때 /config
명령을 사용하여 Claude Code를 구성하세요.
claude config list
claude config get <key>
claude config set <key> <value>
claude config add <key> <value>
claude config remove <key> <value>
config
는 프로젝트 구성을 변경합니다. 전역 구성을 관리하려면 --global
(또는 -g
) 플래그를 사용하세요.
claude config set -g <key> <value>
를 사용하세요:
키 | 값 | 설명 |
---|---|---|
autoUpdaterStatus | disabled 또는 enabled | 자동 업데이터 활성화 또는 비활성화(기본값: enabled ) |
env | JSON (예: '{"FOO": "bar"}' ) | 모든 세션에 적용될 환경 변수 |
preferredNotifChannel | iterm2 , iterm2_with_bell , terminal_bell , 또는 notifications_disabled | 알림을 받고 싶은 위치(기본값: iterm2 ) |
theme | dark , light , light-daltonized , 또는 dark-daltonized | 색상 테마 |
verbose | true 또는 false | 전체 bash 및 명령 출력을 표시할지 여부(기본값: false ) |
claude config set <key> <value>
로 프로젝트 구성 관리(-g
플래그 없이):
키 | 값 | 설명 |
---|---|---|
allowedTools | 도구 배열 | 수동 승인 없이 실행할 수 있는 도구 |
ignorePatterns | glob 문자열 배열 | 도구 사용 시 무시되는 파일/디렉토리 |
allowedTools
규칙 형식은 권한을 참조하세요.
/config
명령을 통해 언제든지 Claude Code의 테마를 터미널에 맞출 수 있습니다.
\
다음에 Enter를 입력하여 줄 바꿈 생성/terminal-setup
을 실행하여 Shift+Enter를 더 직관적인 대안으로 자동 구성하세요.
/vim
또는 /config
를 통해 활성화할 수 있는 Vim 키 바인딩의 하위 집합을 지원합니다.
지원되는 하위 집합에는 다음이 포함됩니다:
Esc
(NORMAL로), i
/I
, a
/A
, o
/O
(INSERT로)h
/j
/k
/l
, w
/e
/b
, 0
/$
/^
, gg
/G
x
, dw
/de
/db
/dd
/D
, cw
/ce
/cb
/cc
/C
, .
(반복)/cost
를 사용하여 현재 세션 사용량 확인/config
를 실행하고 “Auto-compact enabled”로 이동
/compact
사용
/compact Focus on code samples and API usage
/clear
를 사용하여 컨텍스트 재설정
claude-opus-4-20250514
를 사용합니다. 다음 환경 변수를 사용하여 이를 재정의할 수 있습니다:
ANTHROPIC_BEDROCK_BASE_URL
환경 변수를 사용할 수 있습니다:
~/.aws/credentials
또는 AWS_ACCESS_KEY_ID
, AWS_SECRET_ACCESS_KEY
와 같은 관련 환경 변수)이 필요합니다. AWS 자격 증명을 설정하려면 다음을 실행하세요:
ANTHROPIC_VERTEX_BASE_URL
환경 변수를 사용할 수 있습니다:
us-east5
지역만 지원합니다. 프로젝트에 이 특정 지역에 할당된 할당량이 있는지 확인하세요.ANTHROPIC_AUTH_TOKEN
: Authorization
및 Proxy-Authorization
헤더의 사용자 지정 값(여기에 설정한 값 앞에 Bearer
가 붙습니다)ANTHROPIC_CUSTOM_HEADERS
: 요청에 추가하려는 사용자 지정 헤더(Name: Value
형식)HTTP_PROXY
: HTTP 프록시 URL 설정HTTPS_PROXY
: HTTPS 프록시 URL 설정env
객체에 이러한 변수를 추가할 수 있습니다.
apiKeyHelper
: API 키를 가져오기 위한 사용자 지정 쉘 스크립트(시작 시 한 번 호출되며 각 세션 기간 동안 캐시됨)claude --dangerously-skip-permissions
를 실행할 수 있습니다. 필요에 맞게 사용자 지정할 수 있는 참조 구현을 포함했습니다.