codeme
1. 설치와 첫 실행
다운로드 페이지에서 플랫폼에 맞는 것을 받아 실행합니다.
설치 직후 필요한 것은 git 하나뿐입니다. 에이전트를 쓸 생각이라면
쓰던 CLI(Claude Code, Codex 등)가 PATH에 있으면 됩니다 —
codeme는 무엇도 대신 설치하지 않고, 이미 있는 것만 씁니다.
첫 실행에서 로그인 화면은 없습니다. 계정이 없기 때문입니다.
2. 프로젝트 열기
사이드바 위쪽의 프로젝트 목록에서 폴더를 엽니다. 최근 목록은 CtrlR 로 다시 부릅니다. 프로젝트는 여러 개를 동시에 열어 둘 수 있고, 각 프로젝트 아래에 그 프로젝트의 worktree가 쌓입니다.
사이드바 배치는 두 가지 중에 고릅니다 (workbench.sidebar):
one-rail— 프로젝트 · worktree · 파일이 왼쪽 한 줄에 쌓입니다. 기본값입니다.two-rails— 왼쪽에 프로젝트마다 worktree, 오른쪽에 파일.
3. worktree 만들기
프로젝트 행의 ＋ 로 worktree를 만듭니다. 브랜치 이름을 새로 주면 그 브랜치를 만들면서 worktree를 함께 만들고, 이미 있는 브랜치를 고르면 그 브랜치의 worktree만 만듭니다.
왜 브랜치 전환이 아니라 worktree인가. 브랜치를 갈아끼우면
같은 디렉터리의 파일이 통째로 바뀌고, 빌드 캐시와 node_modules가
그때마다 무효가 됩니다. worktree는 디렉터리를 따로 쓰므로 셋을 동시에 열어 두고
각자 빌드를 남겨 둘 수 있습니다.
4. 에이전트 붙이기
worktree 카드의 ＋ 메뉴에서 에이전트를 고릅니다. 이 메뉴는 두 가지를 다른 항목으로 보여 줍니다.
- 새로 시작 — 빈 세션을 엽니다.
- 이어서 — 그 worktree에서 돌던 세션을 이어 받습니다.
에이전트가 돌고 있는지, 나를 기다리는지는 메뉴 막대에 숫자로 뜹니다. 창이 앞에 없을 때는 OS 알림이 대신 말합니다 — 창이 앞에 있을 때는 모서리 토스트가 그 일을 하므로 기본값은 알림을 보내지 않는 쪽입니다.
5. 바뀐 것 읽기
Ctrl⇧X 로 Agent changes 패널을 엽니다. 왼쪽에 에이전트가 건드린 파일, 오른쪽에 그 파일의 diff입니다.
- 기준점은 에이전트가 시작한 순간입니다. 그 전에 내가 해 둔 편집은 섞이지 않습니다.
- hunk 사이의 접힌 줄은 펼쳐서 "이 세 줄이 어느 함수 안인지"까지 봅니다.
- 좌우 분할 보기로 바꿀 수 있습니다.
- 다 읽었으면 Mark reviewed 로 기준점을 앞으로 옮깁니다.
6. 커밋과 푸시
Ctrl⇧G 가 커밋 패널, Ctrl⇧H 가 히스토리 그래프입니다. 스테이징 · 커밋 · 푸시가 한 자리에 있고, 푸시는 커밋과 같은 화면에 삽니다 — 커밋하고 나서 밀어 올릴 곳을 따로 찾아가지 않습니다.
히스토리는 브랜치가 갈라지고 합쳐지는 모양을 그대로 그립니다. 십만 커밋짜리 저장소로 실측했습니다.
7. 내 작업 연결 (선택)
Ctrl⇧Y 로 내 작업 패널을 엽니다. 리뷰 요청이 위, 내가 맡은 것이 아래입니다. GitHub · Forgejo · Jira를 각자의 API로 직접 읽고, 연결에 필요한 것은 패널에서 토큰을 한 번 붙여넣는 일뿐입니다.
- 토큰은 맥 키체인에 들어갑니다.
- 설정 파일에는 주소만 남습니다. 어떤 IPC 명령도 토큰을 창으로 돌려주지 않습니다.
- 로그인되지 않은 연결은 실패가 아니라 호출한 주소 한 줄 + Sign in 버튼으로 표시됩니다.
PR 하나를 클릭하면 브라우저에서 열거나, 그 PR의 브랜치로 worktree를 만듭니다. 이 머신에 없는 브랜치면 가져온 다음 만듭니다.
8. 테마 고르기
테마는 두 축입니다. 하나를 바꿔도 다른 하나는 움직이지 않습니다.
| 설정 | 무엇을 칠하나 | 고를 수 있는 것 |
|---|---|---|
workbench.theme |
창의 외형 — 사이드바, 툴바, 패널 | system · light · dark |
workbench.codeTheme |
코드가 그려지는 표면 — 에디터 · 터미널 · diff | 카탈로그 전체 |
이 사이트 헤더의 테마 메뉴가 쓰는 목록이 바로 그 카탈로그의 일부입니다 — 같은 파일에서 나옵니다.
9. 단축키
기본 스킴은 VS Code 배치입니다 (IntelliJ 스킴도 있습니다).
| 키 | 하는 일 |
|---|---|
| ⌘1 / 2 / 3 | 레이아웃 — 한 그룹 / 그룹+터미널 / 두 그룹+터미널 |
| Ctrl` | 새 터미널 |
| ⌘\ | 에디터 분할 |
| ⌘P | 파일로 가기 |
| ⌘⇧F | 파일 전체에서 찾기 |
| Ctrl⇧G | 소스 컨트롤 (커밋) |
| Ctrl⇧H | 히스토리 |
| Ctrl⇧X | Agent changes |
| Ctrl⇧Y | 내 작업 |
| Ctrl⇧D | 컨테이너 |
| Ctrl⇧Q | 데이터베이스 |
| ⌘B | 사이드바 접기/펴기 |
| CtrlR | 최근 프로젝트 열기 |
| ⌘, | 설정 |
10. 막혔을 때
완성·호버·정의로 이동이 안 됩니다
그 언어의 언어 서버가 이 기계에 설치돼 있어야 합니다 —
rust-analyzer, gopls, clangd, pyright
중 이미 있는 것만 씁니다. 없으면 상태바가 그렇게 말합니다.
TypeScript/JavaScript는 Monaco가 자체 서비스로 답하므로 목록에 없습니다.
내 작업 패널이 비어 있습니다
토큰이 없거나 만료됐습니다. 실패가 아니라 호출한 주소 한 줄 + Sign in 으로 표시되니, 그 줄에 적힌 주소가 맞는지부터 봅니다.
터미널 글자가 깨집니다
GPU 렌더러가 없는 기계에서는 코어가 그것을 판정해 CPU 렌더러로 떨어집니다. 그래도 이상하면 설정에서 렌더러를 직접 고를 수 있습니다.
그 밖의 문제
설치본을 받은 경로로 알려 주세요. 어떤 진단 데이터도 자동으로 전송되지 않으므로, 무슨 일이 있었는지는 적어 주셔야 압니다.