Repository navigation
v0.3.0 - 타사 API 설정(베타)
Claude Code Kit for Mac v0.3.0 - 타사 API 설정(베타)
설치 / 업데이트
curl -fsSL https://github.com/hull-kr/Claude-Code-Kit-Mac/releases/latest/download/install.sh | bash이미 설치했다면 설정 → 업데이트 → 지금 업데이트 로도 받을 수 있습니다.
🌐 새 기능 - 타사 API 설정 (베타)
Claude 구독 대신 OpenRouter 키로 다른 회사 모델(예: openai/gpt-5.6-luna)을 Claude Code 에서 씁니다.
★ 폴더(프로젝트)별로만 적용합니다. 그 세션 폴더의
.claude/settings.local.json에만 쓰고,
전역~/.claude/settings.json· OS 환경변수(~/.zshrc등)는 절대 건드리지 않습니다. 다른 프로젝트는 그대로 클로드 모델로 돕니다.
쓰는 순서
- openrouter.ai 에서 키를 만듭니다 (
sk-or-v1-..., 크레딧 충전 필요). - 왼쪽 메뉴 맨 아래 타사 API 설정 → 맨 위 입력 줄에 이름 · 모델 · API 키 → 추가.
- 모델 칸은 OpenRouter 공개 모델 목록(약 470개)에서 일부만 쳐도 찾습니다 (
luna,gemini,claude… 대소문자 무관, 중간 글자도 됨).↑↓로 고르고Enter확정,Esc닫기. - 프로필은 번호(#) 로 관리합니다. 수정 → 입력 줄로 불러와 고친 뒤 저장 (이름을 바꿔도 같은 프로필이 고쳐집니다).
- 모델 칸은 OpenRouter 공개 모델 목록(약 470개)에서 일부만 쳐도 찾습니다 (
- 세션 목록에서 세션 우클릭 → 타사 API 설정
[지금 적용된 것]→ 프로필 선택 (적용된 것에 ✓).- 새로 만들 세션이면 + 새 세션 창의 타사 API 프로필 칸에서 고르면 됩니다.
- 그 폴더에 열려 있는 세션이 있으면 "지금 재시작할까요? (대화는 이어집니다)" 를 묻습니다. 예 = 닫고 다시 열어 바로 그 모델로 이어집니다.
- 해제 = 우클릭 → 타사 API 설정 → 사용 안 함 (클로드 모델). 타사 API 탭에서 프로필을 누르면 그 프로필이 적용된 세션이 나오고 선택 세션에서 해제 로도 풉니다.
실제로 들어가는 값 - <세션 폴더>/.claude/settings.local.json
OpenRouter 공식 Claude Code 연동 방식 그대로입니다.
{
"env": {
"ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
"ANTHROPIC_AUTH_TOKEN": "sk-or-v1-...",
"ANTHROPIC_API_KEY": "",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "openai/gpt-5.6-luna",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "openai/gpt-5.6-luna",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "openai/gpt-5.6-luna"
}
}- 주소는 짧은
https://openrouter.ai/api만 넣습니다 - Claude Code 가/v1/messages를 스스로 붙입니다 (전체 주소를 넣으면 404). - 키는
ANTHROPIC_AUTH_TOKEN에,ANTHROPIC_API_KEY는 빈 값으로 명시해 다른 곳에 남은 키가 먼저 쓰이는 것을 막습니다. - 이 파일의 다른 설정은 그대로 두고 위 6개만 넣고 뺍니다. 해제하면 6개만 지우고, 파일이 깨져 있으면 덮어쓰지 않습니다.
이어 열기 모델 자동 보정
Claude Code 는 이어 열면(--resume) 대화 기록의 마지막 응답 모델을 그대로 씁니다. 그래서 해제한 뒤 그냥 이어 열면 타사 모델이 남아 "There's an issue with the selected model" 오류가 납니다. CCKit 은 이어 열 때 맞춰 엽니다.
- 폴더에 타사 설정이 있고 기록 모델과 다르면 →
--model <프로필 모델> - 폴더에 타사 설정이 없는데 기록 모델이 타사 ID(
/포함)면 →--model default
키 보안
- 키는 그 폴더의
settings.local.json에 평문으로 들어갑니다. git 저장소 폴더면.gitignore에.claude/settings.local.json을 자동으로 추가해 키가 커밋되지 않게 합니다 (이미 있으면 그대로). - 프로필(키 포함)은
~/Library/Application Support/CCKit/thirdparty.json에 저장됩니다.
알아둘 한계
- 키로 연결한 세션은 claude.ai 계정 기능(Artifact · Docs · 리모트 컨트롤 · 커넥터)을 쓸 수 없습니다 (
/remote-control=Unknown command). Anthropic API 키로 연결해도 같습니다. 로컬 스킬·파일 작업은 그대로 됩니다. 그래서 새 세션 창에서 프로필을 고르면 원격 연결 체크를 꺼 줍니다. - OpenAI 키(
sk-proj-...)는 쓸 수 없습니다. Claude Code 는/v1/messages주소를 부르는데api.openai.com에는 없어 404, OpenRouter 주소에 OpenAI 키를 넣으면 401 입니다. OpenRouter 키를 쓰세요 (OpenAI 모델도 OpenRouter 로 씁니다). - 설정은 폴더 단위라 그 폴더에서 연 세션이 전부 같은 모델을 씁니다. 사용 요금은 OpenRouter 크레딧에서 나갑니다.
🔔 개선 - 업데이트 다운로드 진행률
지금 업데이트 를 누르면 진행 막대가 고정 45% 대신 실제로 차오르며 45% (55.4MB / 121.1MB, 7.2MB/s) 처럼 받은 용량·전체 용량·속도를 보여 줍니다 (다음 업데이트부터 보입니다).
고친 것
- 우클릭 메뉴(그룹 지정 · 타사 API 설정)에서 체크된 줄이 회색으로 흐리게 보이던 것.
확인한 것 (Mac 실기)
- OpenRouter 키로
openai/gpt-5.6-luna세션 생성 → 대화 ("OpenAI의 GPT-5.6 Luna 모델이야.") - 해제 → 재시작 →
--model default로 구독 모델(Opus)로 오류 없이 이어짐 → 다시 적용 → 재시작 → 루나로 이어짐 - 프로필 추가·이름 바꿔 수정(번호 유지)·삭제, 모델 부분 일치 검색, 손으로 넣은 값 표시,
.gitignore자동 추가, 단위 테스트 35개


