Repository navigation
v0.3.1 - 세션별 API 설정(앤트로픽 키·모델 잠금) · 세션 검색
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개가 더해집니다.
알아둘 점
- 키로 연결한 세션 아래의
⚠ 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개.


