Anthropic API 키를 대화 밖에서 설정하는 llm-keys-ui 0.1
원격 서버에서 코딩 에이전트를 사용할 때 API 키를 채팅이나 프롬프트에 붙여 넣으면 키가 에이전트의 대화 맥락에 포함될 수 있다. llm-keys-ui 0.1은 Anthropic 같은 서비스의 API 키를 브라우저에서 직접 설정할 수 있게 해 주는 LLM용 로컬 웹 UI 플러그인이다.1
이 도구의 핵심 가치는 키 입력 경로와 에이전트의 대화 맥락을 분리하는 데 있다. 에이전트에게 키를 전달하는 대신, 사용자가 LLM이 실행되는 환경에 직접 키를 저장할 수 있다.
LLM 실행 환경에서 웹 UI 열기
플러그인은 LLM과 동일한 환경에 설치해야 한다. 다음과 같이 설치하고 실행하면 웹 UI가 기본 주소인 127.0.0.1:8010에서 열린다.1
llm install llm-keys-ui
llm keys-ui별도로 설치하지 않고 임시 환경에서 실행하려면 다음 명령을 사용할 수 있다.2
uvx --with llm-keys-ui llm keys-ui --all서버 포트는 -p 또는 --port, 수신할 네트워크 인터페이스는 -h 또는 --host로 변경할 수 있다. --all을 지정하면 서버가 0.0.0.0에서 수신하고, 컴퓨터에 할당된 각 IPv4 주소의 HTTP URL을 출력한다.1 이 목록에는 로컬 네트워크 또는 Tailscale 기기 IP가 포함될 수 있어 다른 장비의 브라우저에서 원격 서버의 입력 화면에 접속할 수 있다.
--all을 사용하기 전에 확인할 점
웹 UI에는 인증 기능이 구현되어 있지 않다.1 따라서 기본값인 127.0.0.1은 같은 컴퓨터에서만 사용할 때 적합하고, 원격 접속을 위해 --all을 사용하면 해당 주소와 포트에 접근할 수 있는 다른 사용자에게도 화면이 노출될 수 있다.
원격으로 키를 설정해야 한다면 다음 원칙을 적용하는 편이 좋다.
먼저 기본 로컬 주소로 충분한지 확인한다.
원격 접속이 필요할 때만
--all을 사용한다.출력된 URL 중 어떤 네트워크 주소가 노출되는지 확인한다.
키 저장이 끝나면 서버를 즉시 종료한다.
저장한 Anthropic API 키는 다음 명령으로 가져올 수 있다.2
llm keys get anthropic이 명령은 키를 터미널에 출력하므로 화면 공유, 셸 기록, 로그 등에 값이 남지 않도록 주의해야 한다.
결론: 비밀 관리 시스템이 아닌 입력 경로 분리 도구
llm-keys-ui 0.1은 완전한 비밀 관리 시스템이 아니다. 원격 코딩 에이전트의 대화에 API 키를 붙여 넣지 않고, LLM 실행 환경에 직접 저장할 수 있도록 입력 경로를 분리하는 작은 도구다.
요약: Anthropic 키를 설정할 때는 기본 로컬 주소를 우선 사용하자. Tailscale 등으로 원격 접속하기 위해 --all을 사용한다면 노출되는 주소와 접근 범위를 확인하고, 저장이 끝나는 즉시 서버를 종료해야 한다.
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.