Claude Code - VibeCodeCheap

Claude Code는 코드베이스를 이해하고 자연어 명령을 통해 더 빠른 코딩을 도와주는 터미널 기반 코딩 에이전트입니다 — 일상 작업 실행, 복잡한 코드 설명, git 워크플로우 처리 등. Claude Code는 코딩 플랜과 함께 더욱 강력해집니다 — Pro 플랜은 Claude Pro(월 20 USD)보다 더 많은 사용량을, Max 플랜은 Claude Max(월 200 USD)보다 더 많은 사용량을 제공합니다. 더 많은 토큰과 높은 신뢰성으로 더 빠르게 코딩하고, 더 스마트하게 디버깅하며, 워크플로우를 원활하게 관리하세요.

1단계: Claude Code 설치

권장 설치
Cursor 안내 설치

요구 사항: Node.js 18 이상

# Claude Code 설치
npm install -g @anthropic-ai/claude-code

npm에 익숙하지 않지만 Cursor가 있다면, Cursor에서 명령을 입력하여 안내를 받을 수 있습니다:

https://docs.anthropic.com/en/docs/claude-code/overview
Help me install Claude Code

설치 중 권한 오류가 발생하면 sudo(MacOS/Linux)를 사용하거나 명령 프롬프트를 관리자 권한으로 실행(Windows)해 보세요.

2단계: 코딩 플랜 설정

API 키 발급

VibeCodeCheap 오픈 플랫폼을 방문하여 회원가입 또는 로그인하세요.
API Keys 페이지에서 새 API 키를 생성하세요.
API 키를 복사하여 사용하세요.

환경 변수 설정

설정 방법은 2가지입니다: settings.json 파일(권장) 또는 환경 변수 내보내기.

방법 1: settings.json 파일 (권장)
방법 2: 환경 변수 내보내기
방법 3: --settings 플래그 사용

1단계: 올바른 settings.json 파일 경로 찾기

구성 파일은 운영 체제에 따라 다른 위치에 있습니다:

Windows
macOS
Linux

경로: %USERPROFILE%\.claude\settings.json예: C:\Users\YourName\.claude\settings.json

경로: ~/.claude/settings.json예: /Users/YourName/.claude/settings.json

경로: ~/.claude/settings.json예: /home/YourName/.claude/settings.json

2단계: settings.json 파일 열어 편집하기

다음 방법 중 하나를 선택하여 파일을 여세요:

claude 명령 사용
VS Code
Cursor
Notepad++ / Sublime / Vim
수동으로 열기

# Windows (Git Bash 또는 WSL)
claude --settings "$USERPROFILE\.claude\settings.json"

# macOS/Linux
claude --settings ~/.claude/settings.json

이 명령은 시스템의 기본 편집기에서 파일을 엽니다. 작동하지 않으면 아래의 다른 방법을 시도하세요.

# Windows
code "%USERPROFILE%\.claude\settings.json"

# macOS/Linux
code ~/.claude/settings.json

# Windows
cursor "%USERPROFILE%\.claude\settings.json"

# macOS/Linux
cursor ~/.claude/settings.json

# Notepad++ (Windows)
notepad++ "%USERPROFILE%\.claude\settings.json"

# Sublime Text
subl ~/.claude/settings.json

# Vim
vim ~/.claude/settings.json

# Nano
nano ~/.claude/settings.json

Windows:

파일 탐색기 열기
주소 표시줄에 %USERPROFILE%\.claude 입력
settings.json 찾아서 메모장 또는 다른 편집기로 열기

macOS/Linux:

Finder/파일 관리자 열기
Cmd+Shift+G (macOS) 또는 Ctrl+H 눌러 숨김 파일 표시
~/.claude/로 이동
settings.json 열기

3단계: 파일에 설정 추가

settings.json 파일에 env 필드를 추가하세요:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_api_key",
    "ANTHROPIC_BASE_URL": "https://api.vibecodecheap.com/v1/ai",
    "API_TIMEOUT_MS": "3000000"
  }
}

your_api_key를 VibeCodeCheap API 키로 교체하고 파일을 저장하세요.

일반적인 문제 해결

파일 열기 명령이 작동하지 않거나 잘못된 파일을 엽니다

원인: code, cursor 같은 명령이 PATH에 없거나 파일이 잘못된 위치에서 열립니다.해결책:

파일 위치 확인:

# Windows (PowerShell)
ls $env:USERPROFILE\.claude\settings.json

# macOS/Linux
ls -la ~/.claude/settings.json

파일이 없으면 디렉토리와 파일 생성:

# Windows (PowerShell)
mkdir -Force $env:USERPROFILE\.claude
echo '{"env":{}}' > $env:USERPROFILE\.claude\settings.json

# macOS/Linux
mkdir -p ~/.claude
echo '{"env":{}}' > ~/.claude/settings.json

절대 경로를 사용하여 파일 열기:

# Windows
code "C:\Users\YourName\.claude\settings.json"

# macOS
code "/Users/YourName/.claude/settings.json"

저장 후 설정이 적용되지 않습니다

JSON 형식 확인: JSONLint를 사용하여 검증
Claude Code를 실행 중인 모든 터미널 닫기
새 터미널 열어 claude 다시 실행
Claude Code에서 /status 실행하여 설정 확인

.claude 디렉토리를 찾을 수 없습니다

원인: Claude Code가 아직 실행되지 않아 .claude 디렉토리가 생성되지 않았습니다.해결책:

claude를 한 번 실행 (즉시 종료 가능)

또는 수동으로 생성:

# Windows
mkdir %USERPROFILE%\.claude

# macOS/Linux
mkdir -p ~/.claude

settings.json 파일이 덮어쓰기되거나 설정이 손실됩니다

원인: Claude Code가 경우에 따라 settings.json을 자동으로 덮어쓸 수 있습니다.해결책:

설정 파일 백업:

cp ~/.claude/settings.json ~/.claude/settings.json.backup

덮어쓰기 방지를 위해 파일 잠금 (필요한 경우만):

# macOS/Linux
chmod 444 ~/.claude/settings.json

# Windows (PowerShell - 관리자 권한으로 실행)
Set-ItemProperty -Path "$env:USERPROFILE\.claude\settings.json" -Name IsReadOnly -Value $true

편집이 필요할 때 잠금 해제:

# macOS/Linux
chmod 644 ~/.claude/settings.json

# Windows (PowerShell)
Set-ItemProperty -Path "$env:USERPROFILE\.claude\settings.json" -Name IsReadOnly -Value $false

WSL: 'node: not found' 오류 또는 잘못된 Node 버전

원인: WSL이 Linux 버전 대신 Windows Node.js를 사용하고 있습니다.확인:

which node
which npm
# 결과가 /mnt/c/...이면 Windows Node를 사용 중입니다

해결책:

Linux용 Node.js 설치:

# nvm 사용 (권장)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install --lts

# 또는 패키지 매니저 사용
sudo apt update
sudo apt install nodejs npm

PATH 우선순위 수정 - ~/.bashrc 또는 ~/.zshrc에 추가:

# nvm이 로드되는지 확인
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

# Linux 경로 우선순위 지정
export PATH="$HOME/.local/bin:/usr/local/bin:/usr/bin:$PATH"

변경사항 적용:
```
source ~/.bashrc
```

macOS: 파일 편집 또는 명령 실행 시 권한 오류

원인: macOS에는 gatekeeper 및 SIP (System Integrity Protection) 보안이 있습니다.해결책:

터미널의 파일 액세스 허용:
- 시스템 설정 > 개인 정보 보호 및 보안 > 전체 디스크 접근 권한 열기
- Terminal.app 또는 iTerm2 추가

디렉토리 권한 수정:

sudo chown -R $(whoami) ~/.claude
chmod -R u+w ~/.claude

이 방법은 settings.json이 작동하지 않거나 빠르게 테스트하고 싶을 때 유용합니다.

임시 (현재 터미널 세션만)

# macOS/Linux
export ANTHROPIC_AUTH_TOKEN="your_api_key"
export ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
export API_TIMEOUT_MS="3000000"
claude

# Windows (PowerShell)
$env:ANTHROPIC_AUTH_TOKEN="your_api_key"
$env:ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
$env:API_TIMEOUT_MS="3000000"
claude

이러한 환경 변수는 현재 터미널에만 존재합니다. 터미널을 닫으면 다시 내보내기해야 합니다.

영구 (터미널을 열 때마다 자동 로드)

macOS/Linux (Bash)
macOS (Zsh - 기본값)
Windows (PowerShell)

~/.bashrc 또는 ~/.bash_profile에 추가:

# 파일 열기
nano ~/.bashrc
# 또는
nano ~/.bash_profile

# 파일 끝에 추가
export ANTHROPIC_AUTH_TOKEN="your_api_key"
export ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
export API_TIMEOUT_MS="3000000"

# 파일 저장 (Ctrl+O, Enter, Ctrl+X)

# 변경사항 적용
source ~/.bashrc
# 또는
source ~/.bash_profile

~/.zshrc에 추가:

# 파일 열기
nano ~/.zshrc

# 파일 끝에 추가
export ANTHROPIC_AUTH_TOKEN="your_api_key"
export ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
export API_TIMEOUT_MS="3000000"

# 파일 저장 (Ctrl+O, Enter, Ctrl+X)

# 변경사항 적용
source ~/.zshrc

PowerShell 프로필에 추가:

# 프로필 파일 확인
notepad $PROFILE

# 없으면 새로 생성
New-Item -Path $PROFILE -Type File -Force

# 파일에 추가
$env:ANTHROPIC_AUTH_TOKEN="your_api_key"
$env:ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
$env:API_TIMEOUT_MS="3000000"

# 저장 및 다시 로드
. $PROFILE

환경 변수가 설정되었는지 확인

# macOS/Linux
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

# Windows (PowerShell)
echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL

settings.json이 다른 위치에 있거나 사용자 정의 파일을 지정하려는 경우.

# 임의의 위치에 settings.json 생성
nano ~/my-claude-config.json

# 내용 추가
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_api_key",
    "ANTHROPIC_BASE_URL": "https://api.vibecodecheap.com/v1/ai",
    "API_TIMEOUT_MS": "3000000"
  }
}

# --settings 플래그로 claude 실행
claude --settings ~/my-claude-config.json

# 또는 영구 사용을 위한 별칭 생성
# ~/.bashrc 또는 ~/.zshrc에 추가
alias claude-vcc='claude --settings ~/my-claude-config.json'

# 그런 다음 입력
claude-vcc

3단계: Claude Code 시작하기

설정 후, 터미널에서 Claude Code를 사용할 수 있습니다:

cd your-project-directory
claude

Windows를 사용하는 경우, 처음에는 Git Bash 또는 **Ubuntu (WSL)**를 사용하여 **claude**를 실행해야 합니다.

Claude Code를 처음 실행할 때, 파일 접근 권한을 요청하는 보안 프롬프트가 표시될 수 있습니다:

Do you trust the files in this folder?

 Claude Code may read, write, or execute files contained in this directory. 
 This can pose security risks, so only use files from trusted sources.

 ❯ 1. Yes, proceed
   2. No, exit

**“Yes, proceed”**를 선택하고 Enter를 눌러 Claude Code가 프로젝트 디렉토리의 파일에 접근할 수 있도록 허용하세요.

FAQ

사용 중인 모델을 변경하는 방법

Claude Code 내부 모델 환경 변수와 모델 간의 매핑:

모델	배율	컨텍스트
`claude-sonnet-4-5`	1x	200K 토큰
`claude-sonnet-4-5-20250929`	1x	200K 토큰
`claude-opus-4-5-20251101`	2x	200K 토큰
`gpt-5-mini`	0x (무료 사용)	128K 토큰
`glm-4.6`	0x (무료 사용)	200K 토큰
`glm-4.7`	0x (무료 사용)	200K 토큰

gpt-5-mini, glm-4.6 및 glm-4.7은 VibeCodeCheap에서 코딩 플랜 구독 시 무제한 사용이 가능한 무료 모델입니다.

조정이 필요한 경우, 구성 파일 ~/.claude/settings.json을 직접 편집할 수 있습니다:

Claude 모델
GPT-5 Mini
GLM 4.6
GLM 4.7

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5-20250929",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5-20251101"
  }
}

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5-mini",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5-mini",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5-mini"
  }
}

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.6"
  }
}

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"
  }
}

현재 모델 상태를 확인하는 방법

새 터미널을 열고 **claude**를 실행한 다음, **/help**를 입력하여 사용 가능한 모든 명령을 확인하세요.

**/status**를 입력하여 현재 모델 상태를 확인하세요.
**/models**를 입력하여 사용 가능한 모든 모델을 나열하세요.

수동 설정이 작동하지 않는 경우

~/.claude/settings.json 파일을 편집했지만 변경 사항이 적용되지 않는 경우:

모든 Claude Code 창을 닫고 새 터미널을 열어 claude를 다시 실행하세요.
여전히 작동하지 않으면 ~/.claude/settings.json 파일을 삭제하고 다시 설정해 보세요.
JSON 형식이 올바른지 확인하고, 변수 이름과 쉼표가 누락되거나 추가되지 않았는지 확인하세요.

권장 Claude Code 버전

최신 버전의 Claude Code를 사용하는 것을 권장합니다:

# 현재 버전 확인
claude --version

# 최신 버전으로 업그레이드
claude update

​1단계: Claude Code 설치

​2단계: 코딩 플랜 설정

​1단계: 올바른 settings.json 파일 경로 찾기

​2단계: settings.json 파일 열어 편집하기

​3단계: 파일에 설정 추가

​일반적인 문제 해결

​임시 (현재 터미널 세션만)

​영구 (터미널을 열 때마다 자동 로드)

​환경 변수가 설정되었는지 확인

​3단계: Claude Code 시작하기

​FAQ

​사용 중인 모델을 변경하는 방법

​현재 모델 상태를 확인하는 방법

​수동 설정이 작동하지 않는 경우

​권장 Claude Code 버전

1단계: Claude Code 설치

2단계: 코딩 플랜 설정

1단계: 올바른 settings.json 파일 경로 찾기

2단계: settings.json 파일 열어 편집하기

3단계: 파일에 설정 추가

일반적인 문제 해결

임시 (현재 터미널 세션만)

영구 (터미널을 열 때마다 자동 로드)

환경 변수가 설정되었는지 확인

3단계: Claude Code 시작하기

FAQ

사용 중인 모델을 변경하는 방법

현재 모델 상태를 확인하는 방법

수동 설정이 작동하지 않는 경우

권장 Claude Code 버전