Claude Code CLI

​

개요

​

사전 준비

​

EvoLink API Key 발급

• EvoLink Dashboard에 로그인합니다
• 대시보드에서 API Keys를 찾아 “Create New Key” 버튼을 클릭한 후 생성된 Key를 복사합니다
• API Key는 일반적으로 sk-로 시작합니다

​

Step 1: Claude Code CLI 설치

​

1. 원클릭 설치

• macOS / Linux
• Windows

복사

curl -fsSL https://claude.ai/install.sh | bash

예상 결과: 다운로드 및 설치 정보가 표시되며, 마지막에 성공 메시지가 나타납니다.오류 발생 시: permission denied가 나타나면 명령어 앞에 sudo를 추가하세요.

​

1.1 Node.js 및 npm 설치 (이미 설치된 경우 건너뛰기)

처음 설치하는 경우:

1. Node.js 공식 웹사이트에서 다운로드하여 설치합니다 (LTS 버전 권장)
2. 설치 과정이 익숙하지 않다면 Node.js 설치 가이드를 참고하세요
3. Node.js v20 이상을 권장합니다

설치 확인:

복사

node -v
npm -v

​

1.2 Claude Code CLI 설치

PowerShell 또는 CMD에서 실행합니다:

복사

npm install -g @anthropic-ai/claude-code

예상 결과: 다운로드 및 설치 정보가 표시되며, 마지막에 성공 메시지가 나타납니다.오류 발생 시:

• permission denied: PowerShell 또는 CMD를 관리자 권한으로 실행하세요
• npm command not found: Node.js가 올바르게 설치되지 않았거나 환경 변수에 추가되지 않았습니다

​

2. 설치 확인

claude --version

​

Step 2: EvoLink API 설정

• 방법 1: settings.json 설정 (권장)
• 방법 2: 임시 설정 (현재 터미널만)
• 방법 3: 영구 설정 (전역)

참고: Claude Code CLI를 처음 사용하시는 경우, 먼저 “방법 2: 임시 설정”으로 설정을 테스트한 후 이 방법으로 영구 설정하는 것을 권장합니다.

​

1. 설정 디렉토리 열기

• Windows
• macOS
• Linux

Win + R을 누르고 다음을 붙여넣은 후 Enter를 누릅니다:

복사

%userprofile%\.claude

폴더가 없는 경우: .claude 폴더를 수동으로 생성합니다 (Win + R을 누르고 %userprofile%을 입력한 후 Enter를 눌러 사용자 디렉토리를 열고, .claude라는 이름의 새 폴더를 생성합니다).

Finder에서 Command + Shift + G를 누르고 다음 경로를 붙여넣은 후 Enter를 누릅니다:

복사

~/.claude

폴더가 없는 경우: 터미널을 열고 mkdir ~/.claude를 실행하여 폴더를 생성합니다.

파일 관리자를 열고 다음 경로로 이동합니다:

복사

~/.claude

폴더가 없는 경우: 터미널을 열고 mkdir ~/.claude를 실행하여 폴더를 생성합니다.

​

2. settings.json 편집

열린 폴더에서 settings.json이 없으면, 빈 공간에서 마우스 오른쪽 클릭 → 새로 만들기 → 텍스트 문서 → settings.json으로 이름 변경 (.txt 확장자 제거). 그런 다음 편집기로 열어 다음 내용을 추가합니다:

복사

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-evolink-api-key",
    "ANTHROPIC_BASE_URL": "https://code.evolink.ai",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

⚠️ 중요:

• 기호를 빠뜨리지 않고 완전히 복사하세요
• "your-evolink-api-key"를 실제 API Key로 교체하세요 (따옴표 유지)
• 구두점에 한국어 입력기를 사용하지 마세요

설정 옵션:

• ANTHROPIC_AUTH_TOKEN: EvoLink API Key
• ANTHROPIC_BASE_URL: https://code.evolink.ai (EvoLink API 엔드포인트)
• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 불필요한 네트워크 요청 감소

• Windows
• macOS / Linux

PowerShell에서:

복사

$env:ANTHROPIC_BASE_URL="https://code.evolink.ai"
$env:ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"

CMD에서:

복사

set ANTHROPIC_BASE_URL=https://code.evolink.ai
set ANTHROPIC_AUTH_TOKEN=your-evolink-api-key

참고: 터미널을 닫으면 설정이 초기화됩니다.

터미널에서:

복사

export ANTHROPIC_BASE_URL="https://code.evolink.ai"
export ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"

참고: 터미널을 닫으면 설정이 초기화됩니다.

⚠️ 참고: your-evolink-api-key를 실제 API Key로 교체하세요.

• Windows
• macOS
• Linux

GUI 설정:

1. “내 PC” 마우스 오른쪽 클릭 → “속성” → “고급 시스템 설정” → “환경 변수”
2. “사용자 변수” 또는 “시스템 변수”에서 새로 만들기:
   • 변수 이름: ANTHROPIC_BASE_URL
   • 변수 값: https://code.evolink.ai
3. ANTHROPIC_AUTH_TOKEN을 추가하고 API Key를 값으로 설정합니다
4. “확인”을 클릭하여 저장합니다

PowerShell 명령어:

복사

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://code.evolink.ai', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'your-evolink-api-key', 'User')

참고: 터미널을 재시작해야 적용됩니다.

셸 설정 파일을 편집합니다 (사용 중인 셸에 따라 선택):zsh 사용 시 (macOS 기본):

복사

echo 'export ANTHROPIC_BASE_URL="https://code.evolink.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"' >> ~/.zshrc

bash 사용 시:

복사

echo 'export ANTHROPIC_BASE_URL="https://code.evolink.ai"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"' >> ~/.bash_profile

즉시 적용:

복사

source ~/.zshrc  # or source ~/.bash_profile

셸 설정 파일을 편집합니다 (사용 중인 셸에 따라 선택):bash 사용 시 (Linux에서 일반적):

복사

echo 'export ANTHROPIC_BASE_URL="https://code.evolink.ai"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"' >> ~/.bashrc

zsh 사용 시:

복사

echo 'export ANTHROPIC_BASE_URL="https://code.evolink.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"' >> ~/.zshrc

즉시 적용:

복사

source ~/.bashrc  # or source ~/.zshrc

⚠️ 참고: your-evolink-api-key를 실제 API Key로 교체하세요.

​

Step 3: Claude Code CLI 사용 시작

​

1. 안전한 작업 디렉토리로 이동

cd your-working-directory

​

2. 대화형 모드

claude

​

3. 설정 확인

claude "Who are you"

• AI 응답 텍스트가 표시됩니다 (여러 줄)
• 401, 403, API Key invalid 등의 오류가 없습니다

• 401 Unauthorized: API Key가 설정되지 않았거나 유효하지 않음 → settings.json을 확인하세요
• 403 Forbidden: API Key 권한 부족 → API Key를 확인하세요
• Network error: 네트워크 문제 → 연결 상태를 확인하세요

​

FAQ

​

1. Claude Code CLI란 무엇이며 어떤 용도로 사용하나요?

​

2. 처음 사용 시 설치 및 설정을 어떻게 확인하나요?

• claude --version: Claude Code CLI가 설치되었는지 확인
• claude "Who are you": API 설정이 올바른지 확인

​

3. 대화형 모드와 단일 명령 모드의 차이점은 무엇인가요?

• 대화형 모드: claude를 실행하여 연속 대화에 진입하며, 복잡한 작업에 적합한 다중 턴 상호작용이 가능합니다
• 단일 명령 모드: claude "질문"을 실행하여 단일 응답을 받고 종료하며, 빠른 질의에 적합합니다

​

4. Claude Code CLI가 로컬 파일과 코드를 자동으로 읽거나 업로드하나요?

​

5. Claude Code CLI로 로컬 파일 내용을 분석하거나 처리하려면 어떻게 하나요?

• 파일 경로를 입력하여 Claude가 읽도록 합니다
• 파일을 터미널 창으로 드래그합니다
• 파일 내용을 복사하여 붙여넣습니다

​

6. Claude Code CLI는 한국어 입력 및 출력을 지원하나요?

​

7. 실행 후 출력이 없는 경우 원인은 무엇인가요?

• 네트워크 연결 문제로 API 서버에 접근할 수 없음
• 유효하지 않은 API Key 또는 잔액 부족
• 잘못된 ANTHROPIC_BASE_URL 설정
• 방화벽 또는 프록시가 요청을 차단

​

8. 설정 파일이나 환경 변수 변경이 적용되지 않는 이유는 무엇인가요?

• 터미널 또는 커맨드라인 창을 재시작하세요
• settings.json의 JSON 구문이 올바른지 확인하세요
• 설정 파일 경로를 확인하세요:
  • Windows: C:\Users\{username}\.claude\settings.json
  • macOS / Linux: ~/.claude/settings.json

​

9. 401/403 오류의 원인은 무엇인가요?

• 401 오류: ANTHROPIC_AUTH_TOKEN이 설정되지 않았거나 유효하지 않은 API Key
• 403 오류: API Key 권한 부족 또는 만료된 키
• ANTHROPIC_BASE_URL이 https://code.evolink.ai로 설정되어 있는지 확인하세요

​

10. Claude Code CLI는 어떤 시나리오에 적합하고 어떤 시나리오에 적합하지 않나요?

• 코드 작성, 디버깅 및 리팩토링
• 커맨드라인 환경에서의 빠른 Q&A
• 파일 내용 분석 및 처리
• 자동화 스크립트 통합

• 그래픽 인터페이스가 필요한 복잡한 상호작용
• 실시간 협업 편집
• 대규모 배치 파일 처리

​

11. 모델을 어떻게 전환하나요?

​

12. EvoLink에서 지원하는 Claude 모델은 무엇인가요?

​

13. 이미지를 어떻게 업로드하나요?

• 방법 1: 이미지 경로를 참조합니다
• 방법 2: 이미지를 터미널로 드래그 앤 드롭합니다
• 방법 3: 이미지를 직접 붙여넣습니다

​

14. 커맨드라인 터미널 여는 방법

​

주의사항