# 막힐 때

막히는 건 잘못하고 계셔서가 아닙니다. 원래 자주 막힙니다. 두 가지만 기억해 주세요.

에러 메시지는 지우지 마세요. 빨간 글씨가 잔뜩 나오면 닫고 싶어지지만, 그 글이 무엇이 잘못됐는지 알려 주는 유일한 단서입니다. 그리고 혼자 오래 붙잡고 계시지 않아도 됩니다. 화면을 캡처해서 보내 주시면 됩니다.

## 누구에게 물어보나

**배준형에게 바로 물어보시면 됩니다.** 카톡으로 화면 캡처를 보내 주세요. 늦은 시간이어도 괜찮습니다. 보아 두었다가 답을 드립니다.

막힌 걸 푸는 일은 제가 할 일입니다. 같은 걸 여러 번 물으셔도 괜찮고, 사소해 보여도 괜찮습니다.

단톡방에 올리셔도 됩니다. 옆자리에서 먼저 겪었을 가능성이 높습니다. 따로 받으신 개인 페이지에는 주고받은 답이 쌓이니 나중에 다시 찾아보기 좋습니다.

캡처와 함께 무엇을 하다가 그렇게 됐는지 한 줄 덧붙여 주시면 더 빠릅니다.

## 증상으로 찾기

| 이런 메시지가 나오면 | 여기를 보세요 |
| --- | --- |
| `command not found`, `'git'은(는) 내부 또는 외부 명령… 아닙니다` | [command not found](https://opencircuit.club/wiki/stuck/command-not-found) |
| `git push` 가 `Authentication failed`, 또는 로그인 창이 안 뜸 | [git push 로그인 실패](https://opencircuit.club/wiki/stuck/git-push-auth) |
| 실습 웹을 다시 어떻게 띄우는지 모르겠음 | [다시 열기](https://opencircuit.club/wiki/start/reopen) |
| 실습 웹은 떴는데 무엇부터 할지 모르겠음 | [한 바퀴 돌기](https://opencircuit.club/wiki/start/run) |
| APIFrame 키를 어디서 가져오는지 모르겠음 | [APIFrame 키](https://opencircuit.club/wiki/tools/apiframe) |
| 실습한 것이 작품으로는 어떤 모양이 되는지 모르겠음 | [전시로 가기](https://opencircuit.club/wiki/exhibit) |

## Cursor에게 먼저 물어보기

에러 메시지를 그대로 복사해서 Cursor 채팅에 붙여 넣고 "오류를 해결해줘"라고 하시면 됩니다. 절반쯤은 이걸로 풀립니다.

그래도 안 되면 무엇을 하다가 이렇게 됐는지 순서대로 적어 주세요. Cursor는 화면을 못 보기 때문에, 앞뒤 사정을 알려 줄수록 답이 정확해집니다.

## 고쳤는데 더 나빠졌을 때

Cursor가 고쳐 놓은 게 마음에 안 들면 되돌리면 됩니다. 그러니 겁내지 말고 이것저것 시켜 보세요.

- **방금 것 하나만 되돌리기.** 편집기에서 <kbd>Ctrl/⌘</kbd>+<kbd>Z</kbd> 를 누릅니다.
- **한 묶음을 통째로 되돌리기.** 채팅의 그 답변에 있는 **Restore Checkpoint** 를 누릅니다. Cursor가 파일을 크게 손대기 전마다 찍어 두는 저장 지점으로 돌아갑니다. 대화 내용은 그대로 남습니다.
- **오늘 고친 것을 전부 버리기.** 채팅에 `내가 고친 것을 전부 버리고 마지막 커밋 상태로 되돌려 줘` 라고 하시면 됩니다.

체크포인트는 Git이 아닙니다. 내 컴퓨터에만 잠깐 남고, 손으로 직접 고친 부분은 잡히지 않으며, 오래된 것은 저절로 사라집니다. 정말 믿고 돌아갈 수 있는 자리는 커밋뿐이니 잘 되던 지점마다 커밋해 두세요([GitHub에 올리기](https://opencircuit.club/wiki/tools/github#고칠-때마다)). 체크포인트의 자세한 설명은 [Cursor 공식 문서](https://cursor.com/docs/agent/chat/checkpoints) 에 있습니다.

언제든 되돌릴 수 있다는 걸 알면 훨씬 과감하게 시켜 보게 됩니다. 그렇게 이것저것 해 보시는 게 이 방식에서는 가장 빨리 느는 길입니다.