From 945bd623689cf8b652c2ab5f890a9f8a2bfa3f6a Mon Sep 17 00:00:00 2001 From: infra Date: Sun, 14 Jun 2026 23:52:45 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20AI(Claude=20=EB=93=B1)=EB=8A=94=20?= =?UTF-8?q?=ED=94=84=EB=A1=9C=EC=A0=9D=ED=8A=B8=20=ED=8F=B4=EB=8D=94=20?= =?UTF-8?q?=EC=95=88=EC=97=90=EC=84=9C=20=EC=8B=A4=ED=96=89=20=EC=95=88?= =?UTF-8?q?=EB=82=B4=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.8 --- MANUAL.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/MANUAL.md b/MANUAL.md index 666975f..f7c2d68 100644 --- a/MANUAL.md +++ b/MANUAL.md @@ -145,6 +145,16 @@ npm run dev # 앱 실행 (미리보기는 7-2 참고) - `GET /db` — 내 DB(Postgres) 연결 확인 - `GET /s3` — MinIO(파일 저장소) 연결 확인 +**(5) AI 에이전트(Claude 등) 실행** — **반드시 본인 프로젝트 폴더 안에서** 실행해야 합니다. +AI 도구는 "지금 있는 폴더"를 작업 대상으로 삼기 때문에, 폴더가 틀리면 엉뚱한 곳을 봅니다. +```bash +cd ~/projects/myapp # ← 먼저 본인 프로젝트 폴더로 이동 (이미 그 폴더면 생략) +claude # Claude Code 실행 (또는 codex / gemini) +``` +> 위 (3)에서 **File → Open Folder 로 그 폴더를 열어 두었다면**, 새로 연 터미널은 이미 그 폴더에서 +> 시작하므로 `cd` 없이 바로 `claude` 만 입력해도 됩니다. +> AI 키를 아직 안 넣었으면 5번(`update-litellm-key`)을 먼저 하세요. + > **`.project-env` 가 그 프로젝트의 설정 파일입니다** (DB·S3). 값을 바꾸려면 이 파일 한 곳만 고치면 됩니다. > 프로젝트 폴더에 들어가면(cd) 자동으로 환경변수에 반영됩니다. (git에는 올라가지 않습니다) > LiteLLM 키만은 프로젝트가 아니라 워크스페이스 전체 공용이라 `~/.env`(5번 `update-litellm-key`)에서 관리합니다.