Claude Code 설정
Claude Code는 Anthropic이 개발자를 위해 제공하는 터미널 프로그래밍 도구입니다. 현재 프로젝트를 읽고 코드 설명, 파일 수정, 검사 명령어 실행을 지원하며, Claude 모델과 연동하여 복잡한 개발 작업을 처리할 수 있습니다.
공식 정보 다운로드 및 문서는 공식 사이트를 기준으로 합니다.
이 도구의 역할과 용도
코드 수정터미널 도구Claude 모델권한 설정 주의
설정 시 우선 확인할 위치
| 위치 | 추천 대상 | 설명 |
|---|---|---|
~/. claude/settings.json | 설정을 영구적으로 저장하려는 사용자 | Claude Code 관련 환경 변수를 설정 파일에 작성하면 문제 해결이 더 수월합니다. |
| 현재 터미널 환경 변수 | 임시로 테스트만 해보려는 사용자 | 터미널을 닫으면 일반적으로 설정이 유지되지 않습니다. |
| CC Switch | 여러 CLI를 동시에 관리하는 사용자 | CC Switch 페이지에서 프로바이더를 먼저 설정한 뒤 Claude Code에 적용합니다. |
키(Key) 및 인터페이스 입력 방법
공식 Claude를 사용하는 경우 Anthropic / Claude Code의 공식 로그인 또는 공식 키(Key) 절차를 우선 따르세요. AI 프로바이더를 사용하는 경우 해당 프로바이더가 Claude / Anthropic 인터페이스를 지원하는지 반드시 확인해야 하며, 일반 OpenAI 호환 주소를 Claude Code에 입력해서는 안 됩니다.
Claude Code settings.json 예시
{ "env": { "ANTHROPIC_API_KEY": "YOUR_KEY", "ANTHROPIC_BASE_URL": "https://YOUR_PROVIDER_CLAUDE_API_URL", "ANTHROPIC_MODEL": "PROVIDER_SUPPORTED_CLAUDE_MODEL" } }| 설정 항목 | 확인 위치 | 자주 하는 실수 |
|---|---|---|
| ANTHROPIC_API_KEY | 프로바이더 관리 콘솔의 Claude / Anthropic 키 | 토큰 이름(메모)을 키로 사용하지 마세요 |
| ANTHROPIC_BASE_URL | 프로바이더에서 제공하는 Claude / Anthropic 인터페이스 주소 | OpenAI 호환 주소를 그대로 복사하지 마세요 |
| ANTHROPIC_MODEL | 프로바이더 모델 목록에 표기된 Claude 모델명 | 대소문자, 하이픈(-), 버전 번호를 정확히 일치시켜 복사하세요 |
저장 후 테스트 방법
Claude Code 최소 테스트
claude "Please reply only: Configuration successful"이전 설정이 계속 적용된다면 시스템 환경 변수에 기존 키나 이전 Base URL이 남아있는지 먼저 확인하세요. 환경 변수의 우선순위로 인해 방금 변경한 설정이 적용되지 않을 수 있습니다.
Claude Code 설정 공식 문서 settings.json의 적용 범위 및 설정 방법을 확인하세요.
Claude Code 환경 변수 인증, Base URL 및 모델 변수 관련 설명을 확인하세요.