설치와 인증

npm install 한 번, 인증 경로 셋

Claude Code 는 단일 npm 패키지 — @anthropic-ai/claude-code. 설치하면 claude 가 PATH 에 들어가. 흥미로운 선택은 인증 — 어떻게 청구되고 어떻게 세션이 추적되는지를 결정하니까.

Claude Max / Pro OAuth. claude 실행하고 브라우저 플로우 따라가면 끝. 토큰은 ~/.claude.json 에 살아. 개인용으로 베스트 — 사용량이 Claude.ai 와 같은 구독으로 묶여. API key 회전할 일도, env var 잊을 일도 없어.

API key. 환경변수로 ANTHROPIC_API_KEY 설정. 종량제, 프로그램적으로 키 회전, 모든 CI 서버가 쓰는 그거. 키는 deploy 자격증처럼 다뤄 — 절대 커밋 X, 항상 주입.

Cloud provider 라우팅. CLAUDE_CODE_USE_BEDROCK=1 또는 CLAUDE_CODE_USE_VERTEX=1 로 AWS Bedrock / Google Vertex AI 통과. 엔터프라이즈가 데이터 거주성이나 조달 스토리상 모델이 자기네 클라우드 계정 뒤에 있어야 할 때 써.

설치 후 claude doctor 가 "안 돼요" 모든 질문의 첫 정거장 — node 버전, PATH, 인증, 연결성 한 명령어로 체크해.

Code

Install on a fresh machine·bash

# Prereqs
node --version    # 18+
npm --version

# Install globally
npm install -g @anthropic-ai/claude-code

# First run — triggers OAuth in browser if no API key set
cd ~/myproject
claude

# Health check
claude doctor

API key path (CI / servers / fleet)·bash

# Persistent in shell
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

# Or via direnv per-project (.envrc, gitignored)
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> .envrc
direnv allow

# CI: never echo the key, never log it
# GitHub Actions: ${{ secrets.ANTHROPIC_API_KEY }}

npm install 한 번, 인증 경로 셋

Code

External links

Exercise

Progress

댓글 0