Claude Code CLI

Documentation Index

Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

개요

​

사전 준비

​

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 설정

• CC Switch
• settings.json
• 영구
• 임시

CC Switch는 설정 파일을 수동으로 편집할 필요 없이 그래픽 인터페이스로 Claude Code 공급자 설정을 관리할 수 있는 데스크톱 GUI 도구입니다.

​

1. CC Switch 설치

GitHub Releases에서 사용 중인 플랫폼에 맞는 설치 파일을 다운로드하여 설치하세요.

​

2. EvoLink 설정

1. CC Switch 열기
2. 오른쪽 상단의 아이콘을 클릭하여 설정 페이지로 이동

3. 이미지와 같이 각 항목을 입력

4. “추가” 클릭

CC Switch가 자동으로 settings.json에 설정을 기록합니다. 수동 작업이 필요 없습니다.

CC Switch는 시스템 트레이 빠른 전환, MCP 서버 관리, 클라우드 설정 동기화 등의 기능도 지원합니다.

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

​

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://direct.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://direct.evolink.ai (EvoLink API 엔드포인트)
• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 불필요한 네트워크 요청 감소

• Windows
• macOS
• Linux

GUI 설정:

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

PowerShell 명령어:

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

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

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

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

bash 사용 시:

echo 'export ANTHROPIC_BASE_URL="https://direct.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://direct.evolink.ai"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"' >> ~/.bashrc

zsh 사용 시:

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

즉시 적용:

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

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

• Windows
• macOS / Linux

PowerShell에서:

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

CMD에서:

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

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

터미널에서:

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

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

⚠️ 참고: 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://direct.evolink.ai로 설정되어 있는지 확인하세요

​

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

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

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

​

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

​

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

​

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

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

​

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

​

주의사항