Update MANUAL.md

This commit is contained in:
2026-06-15 05:05:29 +00:00
parent 55da853fa8
commit 574b8a2033

View File

@@ -45,7 +45,7 @@
- **External Authentication** : Gitea(그대로 둠)
- **CPU / Memory / Home disk size**: 기본값(2 Core / 4 GiB / 10 GiB)으로 두면 됩니다. 필요하면 나중에 늘릴 수 있습니다.
3. **`Create Workspace`** 클릭
4. 워크스페이스가 빌드됩니다 (**처음엔 이미지 다운로드로 2~5분** 걸릴 수 있습니다. 오래 걸리거나 기대한 시간보다 오래 걸린다는 경고 메시지가 나와도 VS Code Web 까지 아이콘이 표시될 때까지 기다리세요).
4. 워크스페이스가 빌드됩니다 (**처음엔 이미지 다운로드로 2~5분** 걸릴 수 있습니다. VS Code Web 까지 아이콘이 표시될 때까지 기다리세요).
- 상태가 **Running** 이 되면 준비 완료.
> 이 워크스페이스는 한번 만들면 계속 사용합니다. 한번 만들어진 워크스페이스는 가상 PC처럼 **Start** 만 누르면 됩니다.
@@ -55,7 +55,7 @@
## 3. VS Code 열기
1. 워크스페이스 화면에서 **`VS Code Web`** 버튼(두번째 아이콘) 클릭
2. 브라우저에 VS Code가 열리고, 자동으로 **`/home/coder/projects`** 폴더가 열립니다.
2. 브라우저에 VS Code가 열리고, 자동으로 **`/home/coder/projects`** 폴더가 열립니다. (Yes. I trust the authors 클릭)
3. 그 안에 **`sample`** 폴더가 이미 있습니다 — 참조용 예제입니다(직접 고치지 말고 복사해 쓰세요, 7번 참고).
> 작업 파일은 반드시 **`/home/coder/projects`** 아래에 두세요. 이 폴더만 영구 보존됩니다.
@@ -82,8 +82,8 @@
Claude Code / Codex / Gemini 가 사내 AI 게이트웨이를 쓰려면 **본인 LiteLLM virtual key**가 필요합니다.
키는 **한 곳에만** 넣으면 모든 도구(CLI·확장)가 공유합니다.
1. 터미널 열기: VS Code 상단 메뉴 **Terminal → New Terminal**
2. 아래 명령을 입력하고, 안내가 나오면 발급받은 본인 키(`sk-...`)를 붙여넣습니다:
1. 터미널 열기: VS Code 상단 맨위 메뉴 버튼(작대기 3개) **Terminal → New Terminal**
2. 화면 아래 터미널 창이 나오면, 다음 명령을 입력하고, 안내가 나오면 발급받은 본인 키(`sk-...`)를 붙여넣습니다:
```bash
update-litellm-key
```
@@ -98,6 +98,14 @@ Claude Code / Codex / Gemini 가 사내 AI 게이트웨이를 쓰려면 **본인
echo $ANTHROPIC_BASE_URL # https://litellm.bok.or.kr 가 나오면 정상
claude # Claude Code CLI 실행
```
```bash
echo $GOOGLE_GEMINI_BASE_URL # https://litellm.bok.or.kr 가 나오면 정상
gemini # Gemini CLI 실행
```
```bash
echo $OPENAI_BASE_URL # https://litellm.bok.or.kr/v1 가 나오면 정상
codex # Codex CLI 실행
```
각 도구의 **기본 모델**은 사내 게이트웨이에 맞춰 미리 설정돼 있습니다(바꾸려면 각 설정 파일 수정):
@@ -123,11 +131,21 @@ Claude Code / Codex / Gemini 가 사내 AI 게이트웨이를 쓰려면 **본인
예:
```bash
cd ~/projects
## 만약 새로운 repo를 다운로드 하고 싶을 경우
git clone https://gitea.bokdev.in/<org>/<repo>.git
## 사용예
git clone https://gitea.bokdev.in/playground/sample.git
## 새로운 버전으로 동기화
cd ~/projects/sample
git add .
git pull
# gitea 행번 / 비밀번호
```
---
## 7. 새 프로젝트 시작하기 (sample 복사)
`~/projects/sample` 은 바로 돌려볼 수 있는 Node 예제이며 **읽기 전용 참조**입니다.