Skip to content

v0.3.0 - 타사 API 설정(베타)

Choose a tag to compare

@hull-kr hull-kr released this 11 Nov 06:36
· 19 commits to main since this release

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 등)는 절대 건드리지 않습니다. 다른 프로젝트는 그대로 클로드 모델로 돕니다.

쓰는 순서

  1. openrouter.ai 에서 키를 만듭니다 (sk-or-v1-..., 크레딧 충전 필요).
  2. 왼쪽 메뉴 맨 아래 타사 API 설정 → 맨 위 입력 줄에 이름 · 모델 · API 키 → 추가.
    • 모델 칸은 OpenRouter 공개 모델 목록(약 470개)에서 일부만 쳐도 찾습니다 (luna, gemini, claude … 대소문자 무관, 중간 글자도 됨). ↑↓ 로 고르고 Enter 확정, Esc 닫기.
    • 프로필은 번호(#) 로 관리합니다. 수정 → 입력 줄로 불러와 고친 뒤 저장 (이름을 바꿔도 같은 프로필이 고쳐집니다).
  3. 세션 목록에서 세션 우클릭 → 타사 API 설정 [지금 적용된 것] → 프로필 선택 (적용된 것에 ✓).
    • 새로 만들 세션이면 + 새 세션 창의 타사 API 프로필 칸에서 고르면 됩니다.
  4. 그 폴더에 열려 있는 세션이 있으면 "지금 재시작할까요? (대화는 이어집니다)" 를 묻습니다. 예 = 닫고 다시 열어 바로 그 모델로 이어집니다.
  5. 해제 = 우클릭 → 타사 API 설정 → 사용 안 함 (클로드 모델). 타사 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개