Skip to content

v0.3.1 - 세션별 API 설정(앤트로픽 키·모델 잠금) · 세션 검색

Choose a tag to compare

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

Claude Code Kit for Mac v0.3.1 - 세션별 API 설정 · 세션 검색

설치 / 업데이트

curl -fsSL https://github.com/hull-kr/Claude-Code-Kit-Mac/releases/latest/download/install.sh | bash

이미 설치했다면 설정 → 업데이트 → 지금 업데이트 로도 받을 수 있습니다 (v0.3.0 부터 받은 용량·속도가 실시간으로 보입니다).


🌐 '타사 API 설정' → '세션별 API 설정'

세션(폴더)마다 다른 API 키와 모델을 붙입니다. 등록 칸이 두 가지가 됐습니다.

종류 키 발급 쓰는 모델
오픈라우터 API 키 프로필 openrouter.ai (sk-or-v1-...) 다른 회사 모델 - 예: openai/gpt-5.6-luna
앤트로픽 API 키 프로필 (새로 추가) platform.claude.com (sk-ant-...) Claude 모델 - claude-opus-5-5 · claude-sonnet-5-5 · claude-haiku-5-5 · claude-fable-5-2

★ 지금처럼 폴더(프로젝트)별로만 적용합니다. 그 세션 폴더의 .claude/settings.local.json 에만 쓰고, 전역 ~/.claude/settings.json · OS 환경변수는 건드리지 않습니다.

  • 프로필 목록은 하나로 - # · 종류 · 이름 · 모델 · 엔드포인트. 수정 을 누르면 그 종류의 등록 칸으로 불러옵니다. 행을 고르면 그 프로필을 쓰는 세션이 아래에 나옵니다.
  • 앤트로픽 키는 apiKeyHelper 로 넣습니다 - ANTHROPIC_API_KEY 로 넣으면 세션 처음에 "use this API key?" 를 묻고, 한 번 No 를 고르면 그 뒤로 말없이 구독으로 돕니다. apiKeyHelper 는 묻지 않고 바로 키로 엽니다. 이 값은 셸 명령으로 실행되므로 키에는 영문·숫자·-·_·. 만 받습니다.
  • 모델 잠금 - 등록한 모델로만 열리고 그 폴더에서는 /model · --model 로 바꿀 수 없습니다 (model · availableModels · enforceAvailableModels). 해제하면 같이 풀립니다.
  • 전환이 깨끗하게 - 적용할 때마다 전에 넣은 값(env ANTHROPIC_* 7개 · 잠금 · CCKit 이 넣은 apiKeyHelper)을 먼저 지우고 새로 씁니다. 다른 설정은 그대로 둡니다.
  • 프로필을 고치면 그 프로필을 쓰던 폴더도 새 키·모델로 다시 적용합니다.
  • '사용 안 함' 표기 - PC 기본 인증에 따라 사용 안 함 (클로드 구독제 사용) 또는 (클로드 API 사용) 으로 보여 줍니다 (셸 환경변수·~/.claude/settings.json 에 API 키가 있으면 '클로드 API').
  • 로그인 확인 화면 제목이 앤트로픽 API 키 설정 이 되고 옆에 platform.claude.com 링크가 붙었습니다.

실제로 들어가는 값 - 앤트로픽 (<세션 폴더>/.claude/settings.local.json)

{
  "env": { "ANTHROPIC_API_KEY": "", "ANTHROPIC_MODEL": "claude-sonnet-5-5" },
  "apiKeyHelper": "echo sk-ant-...",
  "model": "claude-sonnet-5-5",
  "availableModels": ["claude-sonnet-5-5"],
  "enforceAvailableModels": true
}

오픈라우터는 v0.3.0 과 같은 env 6개에 위 잠금 3개가 더해집니다.

세션별 API 설정
세션 우클릭 - 세션별 API 설정 하위 메뉴

알아둘 점

  • 키로 연결한 세션 아래의 ⚠ claude.ai connectors are disabled … 경고는 정상입니다. Artifact · Docs · 리모트 컨트롤 · 커넥터 같은 claude.ai 계정 기능만 못 쓰고, 대화·파일 작업은 그대로 됩니다. 그래서 새 세션 창에서 프로필을 고르면 원격 연결 체크를 꺼 줍니다.
  • 앤트로픽 키 자체에는 모델 허용 목록이 없습니다. CCKit 의 잠금은 그 폴더에서만 걸립니다. 수업 등에 나눠 줄 키라면 Claude Console 에서 수업용 워크스페이스를 따로 만들어 지출 한도를 걸고 거기서 키를 만드세요 (기본 워크스페이스에는 지출 한도를 걸 수 없습니다).
  • OpenAI · 구글 키는 쓸 수 없습니다 - Claude Code 가 부르는 주소(/v1/messages)가 없습니다. GPT · Gemini 모델도 OpenRouter 키로 쓰세요.
  • v0.3.0 에서 만든 프로필은 그대로 '오픈라우터' 로 읽힙니다. 이미 적용된 폴더는 다시 적용하면 모델 잠금이 더해집니다.

🔍 새 기능 - 세션 검색

그룹 탭 줄 바로 아래에 검색칸이 생겼습니다. 제목 · 폴더 · 그룹 · 세션ID 중 하나라도 들어 있으면 보입니다 (대소문자 무시, 0.25초 멈추면 거름).
지금 탭과 선택한 그룹 안에서만 거르고, 왼쪽 메뉴로 탭을 옮겨도 검색어는 남습니다. Esc 또는 초기화 로 비웁니다.

세션 검색


확인한 것 (Mac 실기)

  • 실제 앤트로픽 키: 첫 화면 Sonnet 5.5 · API Usage Billing, 승인 질문 없음 → "Anthropic의 Claude Sonnet 5.5 모델이며, 모델 ID는 claude-sonnet-5-5입니다." → /model claude-opus-5-5 는 "is not available. Your organization restricts model selection." 으로 거부 → 해제·재시작하면 구독으로 이어짐.
  • 실제 OpenRouter 키: openai/gpt-5.6-luna 세션 대화 · 모델 잠금 · 앤트로픽으로 전환 · 해제, 프로필 수정 시 쓰던 폴더 다시 적용.
  • 세션 검색 (탭 이동 후 유지 · Esc · 초기화), 단위 테스트 40개.