#### macOS 사용자

``배쉬
#Xcode 명령줄 도구 설치
sudo xcode-select --install

# Homebrew를 설치합니다(아직 설치하지 않은 경우).
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Homebrew를 통해 Node.js 설치
양조 설치 노드

# 설치 확인
노드 --버전

### 3. 구성 및 사용 시작

#### 필요한 구성 정보 얻기

두 가지 중요한 구성 항목을 준비해야 합니다.

| 구성 항목 | 설명 | 획득 방법 |
|---------|------|----------|
| **ANTHROPIC_AUTH_TOKEN** | API 인증 토큰 | 등록 후 `API 토큰` 페이지에서 `토큰 추가`를 클릭하여 획득하세요(`sk-`로 시작) |
| **ANHROPIC_BASE_URL** | API 서비스 주소 | `https://yossapi.com` 이용 (메인사이트 주소와 동일) |

> 📝 **토큰 생성 시 권장 설정**:
> - 이름: 원하는 대로 이름을 지정하세요.
> - 할당량: 무제한 할당량으로 설정
> - 그룹 : 클로드 코드 단독 또는 클로드 3 이상으로 정식 이전 선택
> - 기타 옵션: 기본 설정 유지

#### 클로드 코드 시작

프로젝트 디렉터리에서 다음을 실행합니다.

``배쉬
# 프로젝트 디렉토리를 입력하세요
CD 프로젝트 폴더

#Linux/Unix 환경 변수 설정
내보내기 ANTHROPIC_AUTH_TOKEN=sk-... # 실제 토큰으로 교체
ANTHROPIC_BASE_URL=https://yossapi.com 내보내기
내보내기 API_TIMEOUT_MS=300000 # 시간 초과를 300초로 설정

# 클로드 코드 시작
클로드

#### 첫 실행 구성

시작되면 다음 구성 단계가 표시됩니다.

1. **테마 선택** → 원하는 테마 선택 + Enter 누르기
2. **안전 지침** → 안전 지침 확인 + Enter 누르기
3. **터미널 구성** → 기본 구성 사용 + Enter 누르기
4. **작업 디렉터리 신뢰** → 현재 디렉터리를 신뢰하고 Enter 키를 누릅니다.

✨ **축하합니다! ** 이제 AI 프로그래밍 파트너와 함께 코딩을 시작할 수 있습니다!


## ❓ FAQ

### Q: '잘못된 API 키 · /로그인을 실행하세요' 오류가 발생했나요?

**A:** 이는 Claude Code가 환경 변수를 감지하지 못했음을 나타냅니다. 확인하세요:
- `ANTHROPIC_AUTH_TOKEN` 및 `ANTHROPIC_BASE_URL`이 올바르게 설정되어 있습니까?
- 환경 변수 값이 올바른지 여부(토큰은 `sk-`로 시작함)
- 영구 구성을 사용하는 경우 단말기 재시작 여부

### Q: '오프라인' 상태가 표시되는 이유는 무엇인가요?

**A:** Claude Code는 Google에 연결하여 네트워크 상태를 확인합니다. '오프라인' 표시는 일반적인 사용에 영향을 주지 않으며 단지 Google에 연결할 수 없다는 의미일 뿐입니다.

### Q: 웹을 탐색할 때 가져오기가 실패하는 이유는 무엇입니까?

**답:** Claude Code는 웹페이지에 접속하기 전에 보안 점검을 위해 Claude 서비스를 호출해야 합니다. 당신은 다음이 필요합니다
- 안정적인 국제 인터넷 연결을 유지하세요
- 필요한 경우 글로벌 프록시를 사용하세요.

### Q: 요청에 항상 "가져오기 실패"가 표시됩니까?

**답:** 네트워크 환경에 따라 문제가 발생할 수 있습니다. 해결책:
1. 프록시 도구를 사용해 보세요


### Q: API 오류를 처리하는 방법은 무엇입니까?

**답:** 포워딩 에이전트의 불안정으로 인해 발생할 수 있습니다. 제안:
- 클로드 코드 종료(Ctrl+C)
- `claude` 명령을 다시 실행하세요.
- 문제가 지속되면 나중에 다시 시도해 보세요.

### Q: 웹페이지 로그인 오류가 발생했나요?

**답:** 이 사이트에서 쿠키를 삭제하고 다시 로그인해 보세요.

## 😀 주의사항

- 본 사이트는 클로드코드 공식 포워딩 서비스로 바로 연결됩니다.
- Claude Code의 API 트래픽만 지원하며, 기타 API 호출은 지원하지 않습니다.
- API 토큰이 유출되지 않도록 올바르게 보관하시기 바랍니다.

## 🔗 관련 링크

- [클로드 코드 공식 문서](https://docs.anthropic.com)
- [Node.js 공식 홈페이지](https://nodejs.org)

---

💡 **팁**: 다른 문제가 발생하면 공식 문서를 확인하거나 기술 지원팀에 문의하세요.