이 문서는 영어 원문을 자동 번역한 것으로, 내용이 원문과 다를 수 있습니다.영어 원문 보기
Anthropic의 에이전트형 코딩 CLI인 Claude Code를
Upstage Solar 모델로 구동합니다. 스크립트 하나로 Claude Code를 Upstage API에 연결해
실행할 수 있으며, 셸 프로필과 기존 ~/.claude 설정은 그대로 유지됩니다.
설치
다음 한 줄 명령으로 설치합니다:
처음 실행하면 스크립트가 Upstage API 키를 읽고 테스트 호출로 검증한 뒤, Claude Code를 Solar 모델로 구동합니다. 사용자 확인 없이는 아무것도 설치하지 않습니다.
사전 준비물
- Upstage API 키 — Upstage Console에서 발급할 수 있습니다.
- Claude Code CLI — 미리 설치되어 있어야 합니다. Anthropic의 설치 가이드를 참고하십시오.
스크립트가 하는 일
API 키 찾기
UPSTAGE_API_KEY 환경 변수나 저장된 자격 증명에서 키를 읽고, 없으면 입력값이 가려지는
일회성 프롬프트로 입력받습니다. 이후 실행 전에 키를 검증합니다.
키는 오직 https://api.upstage.ai로만 전송됩니다.
안전한 저장 (선택)
동의하면 키가 macOS Keychain이나 Linux Secret Service 같은 OS 보안 저장소(secret store), 또는 접근 권한이 제한된 파일에 저장됩니다. 거절하면 아무것도 저장되지 않습니다.
Solar 모델로 Claude Code 구동
Upstage Solar 모델로 Claude Code를 시작합니다(기본 모델: solar-pro4). Solar 환경은 해당
Claude Code 세션에만 적용됩니다.
유용한 명령어
처음 실행할 때 스크립트를 ~/.local/bin에 claude-solar로 설치할지 물어봅니다. 설치한
뒤에는 하위 명령어를 사용할 수 있습니다:
다음으로 할 수 있는 일
Claude Code가 Solar 모델로 구동되면 자연어 명령으로 코드베이스를 다룰 수 있습니다:
- 반복 작업 자동화 — 프로젝트 전반에서 코드를 작성하고, 리팩터링하고, 수정합니다.
- 코드 이해 — 복잡하거나 낯선 코드의 설명을 Claude Code에 요청합니다.
- git 워크플로우 처리 — 변경사항을 스테이징하고, 커밋 메시지를 작성하고, 풀 리퀘스트를 생성합니다.