# Loki

> 내 PC와 대화하기. Claude Code 구독으로 도는 로컬 Slack 에이전트 — API 키 불필요.

- 수치: Slack
- 사람이 보는 화면: https://aitryed.com/ko/built/loki/
- 반대 언어: https://aitryed.com/en/built/loki/index.md
- 저장소: https://github.com/nobles92ts-ship-it/loki-agent
- 이 사이트 안내(AI용): https://aitryed.com/ko/llms.txt

---

**메신저에서 말을 걸면, 책상 밑 제 PC가 그 일을 해 줍니다. 밖에 있어도 휴대폰으로 시킬 수 있습니다.**

## 뭐 하는 물건인가요

회사에서 쓰는 메신저(슬랙)에 **제 PC를 «사람처럼» 참여시켜** 뒀습니다.

메시지를 보내면 **집에 있는 제 컴퓨터가 그 일을 실제로 수행**하고, 결과를 다시 메신저로 보내 줍니다.

비유하면 **집에 있는 조수에게 문자로 심부름을 시키는 것**입니다. 조수는 제 컴퓨터 앞에 앉아 있으니, 제 파일도 보고 제 프로그램도 돌립니다.

## 제일 중요한 설계 — 「사용료가 월정액입니다」

이게 이 물건이 성립하는 이유입니다.

보통 AI를 프로그램에 붙이면 **쓴 만큼 돈이 나갑니다.** 그러면 하루 종일 켜 두는 게 부담입니다. **가만히 있어도 뭔가 확인할 때마다 돈이 나가니까요.**

이건 다릅니다. **제가 이미 내고 있는 월정액 구독 위에서 돕니다.** 별도 요금이 붙지 않습니다.

| | 쓴 만큼 내는 방식 | 이 방식 |
|---|---|---|
| 하루 종일 켜 두기 | **부담됨** | **부담 없음** |
| 자주 확인시키기 | 쓸 때마다 돈 | **그냥 시킴** |

<strong>「하루 종일 켜 두는 게 현실적으로 가능해지는 지점」</strong>이 여기입니다. 기능이 아니라 요금 구조가 이걸 가능하게 했습니다.

## 실제로 어디에 쓰나 — 「대화보다 오래 사는 일」

제일 잘 쓰는 곳은 **몇 시간짜리 작업**입니다.

예를 들면 이렇습니다.

1. 휴대폰으로 <strong>「이 작업 돌려 줘」</strong>를 보냄
2. 휴대폰을 주머니에 넣고 다른 일을 함
3. 몇 시간 뒤 **결과 보고가 그 대화에 도착**

**일은 PC가 하고, 메신저는 손잡이일 뿐입니다.** 그래서 제가 어디 있든, 심지어 컴퓨터를 꺼 놓고 나가지만 않으면 됩니다.

## 공개해 두고 있습니다

만든 것을 누구나 볼 수 있게 열어 뒀습니다.

그리고 실제로 일이 있었습니다 — **가져다 쓰던 분이 버그를 찾아서, 원인 진단과 고치는 방법까지 붙여** 보내 주신 적이 있습니다.

## 네 갈래로 나눠 적었습니다

| | 무엇이 문제인가 |
|---|---|
| **구조** | 메신저도 AI도 갈아 끼우면서 **중심은 하나로** 두는 법 |
| **기능** | 채팅창 하나로 어디까지 시킬 수 있나 |
| **권한과 가드** | **제 PC를 마음대로 만질 수 있는 물건**을 남에게 열어 주는 법 |
| **조용한 고장** | 잡은 버그가 <strong>거의 전부 「성공했다고 답하면서 아무것도 안 한 것」</strong>이었습니다 |

마지막 편이 이 프로젝트에서 제일 값을 치른 이야기입니다.

## 여기부터는 자세한 기록입니다

슬랙에서 멘션하면 책상 밑 PC가 그 일을 한다. 디스코드도 같은 코어를 쓴다.

API 키가 없다. Claude Code 구독 위에서 돌기 때문에 토큰 종량제가 아니라 월정액이다 — 에이전트를 하루 종일 켜두는 게 현실적으로 가능해지는 지점이 여기다. 공개 레포로 굴리고 있고, 포크해서 쓰던 사람이 버그를 진단까지 해서 보내온 적도 있다.

## 네 갈래로 적었다

| | 무엇이 문제인가 |
|---|---|
| [구조](/ko/built/loki/architecture/index.md) | 플랫폼과 두뇌를 둘 다 갈아 끼우면서 코어를 하나로 두는 법 |
| [기능](/ko/built/loki/commands/index.md) | 채팅창 하나로 무엇까지 시킬 수 있나 |
| [권한과 가드](/ko/built/loki/permissions/index.md) | 내 PC에 셸 권한을 가진 에이전트를 남에게 열어 주는 법 |
| [조용한 고장](/ko/built/loki/silent-failures/index.md) | 잡은 버그가 거의 전부 성공을 리턴하면서 아무것도 안 했다 |

## 실제로 쓰는 곳

채팅 세션보다 오래 사는 파이프라인. 폰에서 [테스트 케이스 생성 런](/ko/built/tc-team/index.md)을 걸어 두고, 몇 시간 뒤 스레드로 리포트를 받는다. 일은 PC가 하고 슬랙은 손잡이일 뿐이다.

그리고 하나 더 — 다른 기계의 세션이 내 계정으로 슬랙에 글을 올리면 이 PC의 Loki가 그걸 실행한다. 그건 [조용한 고장](/ko/built/loki/silent-failures/index.md) 쪽 이야기인데, **버그 하나를 고치다가 생긴 기능**이다.