설치와 인증

설치는 간단하고, 인증은 쓰임새에 맞춰 고르면 돼

Claude Code는 @anthropic-ai/claude-code 패키지 하나로 설치해. 설치가 끝나면 claude 명령이 생기고, 이제 어떤 방식으로 인증할지만 정하면 돼. 이 선택은 단순한 로그인 방법이 아니라 비용을 어디에 청구하고 세션을 어떻게 관리할지 결정해.

개인이 Claude Max나 Pro를 쓴다면 브라우저에서 OAuth 로그인을 마치는 길이 가장 편해. 별도 API 키를 돌보지 않아도 되고 구독 사용량에 함께 잡혀. 서버나 CI에서는 ANTHROPIC_API_KEY를 환경변수로 주입하는 방식이 맞아. 조직이 AWS나 Google Cloud의 조달·데이터 거주 정책을 따라야 한다면 Bedrock 또는 Vertex AI 경로를 선택하고.

설치 뒤에는 바로 claude doctor를 실행해. Node 버전, PATH, 인증, 네트워크를 한 번에 확인하니 막연히 "왜 안 되지?"라고 헤매기 전에 볼 첫 번째 진단서가 돼.

직접 확인할 항목: CLAUDE_CODE_USE_BEDROCK=1, CLAUDE_CODE_USE_VERTEX=1.

Code

새 컴퓨터에 설치하기·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 키로 인증하기(CI·서버·여러 컴퓨터)·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 }}

Exercise

Claude Code를 설치하고 상황에 맞는 방식으로 인증해. 구독자는 OAuth를, 그 밖의 경우에는 API 키를 쓰면 돼. 이어서 claude doctor를 실행하고 결과를 노트에 복사해 둬. 나중에 문제를 해결할 때 설치 상태를 증명하는 영수증이 되어 줄 거야.

설치는 간단하고, 인증은 쓰임새에 맞춰 고르면 돼

Code

External links

Exercise

Progress

댓글 0