내 PC 클로드 코드를 리니어 직원으로 쓴다

프로젝트 관리 도구 리니어(Linear)에서 이슈를 위임하면 내 컴퓨터에서 돌아가는 클로드 코드(Claude Code)가 이를 받아 처리하고, 결과를 이슈의 에이전트 세션 스레드에 답글로 남긴다. 이런 구조를 구현한 오픈소스 '리니어-클로드 브릿지(linear-claude-bridge)'가 해커뉴스(Hacker News)에 공개됐다. 핵심은 에이전트가 남의 클라우드가 아니라 내 작업 디렉터리 안에서, 내 설정과 지식을 그대로 물려받은 채 돌아간다는 점이다.

무슨 일인가 — '내 맥락을 아는 직원'을 협업툴에 앉히기

이 프로젝트는 프레임워크 없이 1,000줄 미만으로 작성된 최소 참조 구현이다. 이슈를 받아 풀리퀘스트를 만들어 주는 코딩 에이전트가 아니라(그 용도로는 사이러스(Cyrus) 같은 별도 프로젝트를 권한다), 지식베이스나 운영 리포지터리처럼 맥락이 쌓여 있는 폴더를 통째로 아는 에이전트와 협업툴 안에서 대화하는 용도다. 작업 디렉터리를 지정하면 그 안의 CLAUDE.md 지침, MCP(모델 컨텍스트 프로토콜) 서버, 스킬이 전부 세션에 실린다.

핵심 짚어보기 — 구조가 교과서적이다

동작 흐름은 이렇다. 리니어에서 멘션이나 위임이 발생하면 웹훅 이벤트가 로컬 서비스로 들어오고, 서명(HMAC)을 검증한 뒤 5초 안에 응답을 돌려준다. 요청은 동시성 1의 직렬 큐로 처리되며, 클로드 에이전트 SDK 세션이 지정된 폴더를 작업 디렉터리 삼아 실행된다. 리니어 세션과 SDK 세션의 매핑을 JSON 파일로 저장해 두기 때문에 이슈에 후속 질문을 달면 이전 대화가 그대로 이어진다. 준비물은 Node 22 이상, 항상 켜져 있는 컴퓨터, 로그인된 클로드 코드, 그리고 웹훅을 받을 공개 HTTPS 경로(테일스케일 퍼널이나 클라우드플레어 터널이면 충분)다. 앤스로픽 API 키가 아니라 클로드 코드 구독 인증으로 돌아가므로 추가 API 비용이 들지 않는다.

1인기업 실전 적용 포인트

• '구독으로 에이전트 돌리기' 패턴을 눈여겨보라. API 종량 과금 없이 월 구독 하나로 자동화 에이전트를 상시 운영하는 구조는 혼자 여러 시스템을 굴리는 사업자의 비용 구조를 바꿔 준다.
• 지식베이스 폴더를 에이전트의 작업 디렉터리로 지정해 보라. 운영 문서와 의사결정 기록이 쌓인 폴더를 통째로 알고 답하는 '사내 위키 직원'을 만드는 것이 이 브릿지의 원래 용도다.
• 웹훅 검증 → 빠른 응답 → 직렬 큐 → 세션 재개라는 골격은 리니어가 아니어도 통한다. 다른 협업툴이나 메신저에 자기만의 브릿지를 붙일 때 설계 참고서로 삼을 만하다.
• 항상 켜진 머신이 없다면 미니PC나 홈서버 한 대가 진입 조건이라는 점도 비용 계산에 넣어야 한다.

전망

에이전트를 채팅창이 아니라 업무 도구 안으로 데려오는 시도가 늘고 있다. 이 프로젝트가 보여 준 것은 그 최소 골격이 생각보다 작다는 사실이다. 다만 로컬 머신 상시 가동과 웹훅 노출에는 보안·운영 부담이 따르는 만큼, 처음에는 읽기 전용 지식 응대부터 시작해 권한을 조금씩 넓혀 가는 접근이 현실적이다.

출처: GitHub — MPIsaac-Per/linear-claude-bridge (https://github.com/MPIsaac-Per/linear-claude-bridge)