docs: add OpenChamber feature docs and translations (#1400)
* docs: add OpenChamber feature docs and translations Add 30 new docs pages covering OpenChamber-specific workflows and setup: OpenCode server, providers/models/agents, MCP, skills, commands & snippets, usage, projects, context, notes/todos/plans, scheduled tasks, project actions, preview, worktrees, multi-run, git & GitHub, magic prompts, git identities, mobile/PWA, security, notifications, voice, project icons, remote instances, desktop browser, updates, and three troubleshooting pages. Rebuild sidebar into eight task-oriented sections and translate every new page into all six supported locales (uk, zh-cn, es, pt-br, ko, pl). * docs: surface new sections on homepage and cross-link tunnels Add an Explore block to the docs homepage (all seven locales) linking to the new section anchors, and cross-link the Tunnels page to Security and PWA & Mobile.
This commit is contained in:
Bohdan Triapitsyn
committed by
GitHub
GitHub
parent
bf6043a472
commit
967704a9b9
@@ -0,0 +1,39 @@
|
||||
---
|
||||
title: 명령 및 스니펫
|
||||
description: 채팅에서 재사용할 수 있는 슬래시 명령과 텍스트 스니펫을 만드세요.
|
||||
---
|
||||
|
||||
# 명령 및 스니펫
|
||||
|
||||
명령과 스니펫은 모두 같은 내용을 다시 입력하는 수고를 덜어줍니다. 명령은 `/`로 실행하는 전체 프롬프트이고, 스니펫은 `#`로 메시지에 넣는 짧은 텍스트 조각입니다.
|
||||
|
||||
## Commands
|
||||
|
||||
명령은 `/review`처럼 슬래시로 실행하는 저장된 프롬프트입니다. **Settings → Commands**에서 관리합니다.
|
||||
|
||||
1. **Settings → Commands**를 열고 명령을 만듭니다.
|
||||
2. 이름, 설명, 보낼 프롬프트 텍스트를 지정합니다.
|
||||
3. 필요하다면 특정 에이전트나 모델에 고정합니다.
|
||||
4. personal 또는 project 범위를 선택합니다.
|
||||
|
||||
채팅에서 메시지의 **첫** 글자로 `/`를 입력하면 명령이 나타나며, 그중 하나를 선택합니다. 텍스트에는 플레이스홀더를 사용할 수 있습니다.
|
||||
|
||||
- `$ARGUMENTS` — 명령 뒤에 입력한 내용
|
||||
- `@filename` — 파일의 내용을 삽입
|
||||
- `` !`command` `` — 셸 명령의 출력을 삽입
|
||||
|
||||
내장된 `init`과 `review` 명령은 초기화할 수 있지만 삭제할 수는 없습니다.
|
||||
|
||||
## Snippets
|
||||
|
||||
스니펫은 `#signoff`처럼 해시태그로 인라인에서 참조하는 재사용 가능한 텍스트입니다. **Settings → Snippets**에서 관리합니다.
|
||||
|
||||
1. **Settings → Snippets**를 열고 스니펫을 만듭니다.
|
||||
2. 이름과 대체할 텍스트를 지정합니다. 트리거를 여러 개 두려면 별칭을 추가합니다.
|
||||
3. personal 또는 project 범위를 선택합니다.
|
||||
|
||||
채팅에서 `#`를 입력하고 스니펫을 선택합니다. OpenChamber가 보내기 전에 전체 텍스트로 바꿔 넣습니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Skills](/ko/skills/) — 더 큰 지침 모음을 필요할 때 불러오세요
|
||||
@@ -0,0 +1,38 @@
|
||||
---
|
||||
title: 컨텍스트
|
||||
description: 세션이 모델의 메모리를 얼마나 사용하는지 확인하세요.
|
||||
---
|
||||
|
||||
# 컨텍스트
|
||||
|
||||
모든 모델은 한 번에 대화의 일정량만 담을 수 있습니다. 이것이 컨텍스트입니다. OpenChamber는 컨텍스트가 얼마나 찼는지 보여주므로, 세션이 한도에 가까워져 응답이 오래된 세부 내용을 버리기 시작할 시점을 알 수 있습니다.
|
||||
|
||||
## 빠른 표시기
|
||||
|
||||
채팅하는 동안 작은 게이지가 사용한 컨텍스트의 비율을 표시합니다. 채워질수록 색이 바뀝니다.
|
||||
|
||||
- 초록색 — 여유 충분
|
||||
- 노란색 — 차고 있음(약 4분의 3)
|
||||
- 빨간색 — 거의 가득 참
|
||||
|
||||
게이지에 마우스를 올리면(모바일에서는 탭하면) 정확한 토큰 수를 볼 수 있습니다.
|
||||
|
||||
## 전체 컨텍스트 패널
|
||||
|
||||
현재 세션을 더 자세히 보려면 오른쪽 사이드바의 **Context** 탭을 엽니다.
|
||||
|
||||
- 사용 중인 모델과 세션 시작 시점
|
||||
- 모델 한도 대비 총 토큰 수
|
||||
- 메시지 및 비용 합계
|
||||
- 마지막 응답의 토큰 분석
|
||||
- 무엇이 컨텍스트를 차지하는지에 대한 대략적인 구분(사용자 메시지, 에이전트 메시지, 도구 출력)
|
||||
|
||||
이 구분은 정확한 수치가 아니라 추정치입니다. 청구가 아니라 무엇이 창을 채우는지 파악하는 데 사용하세요.
|
||||
|
||||
## 가득 찼을 때 할 일
|
||||
|
||||
하나의 세션을 끝없이 키우지 말고 새 작업에는 새 세션을 시작하세요. 짧은 컨텍스트가 더 빠르고 모델을 집중시킵니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Projects](/ko/projects/) — 세션은 프로젝트별로 그룹화됩니다
|
||||
@@ -0,0 +1,22 @@
|
||||
---
|
||||
title: 데스크톱 브라우저
|
||||
description: 검사 및 콘솔 캡처 기능과 함께 데스크톱 앱 안에서 임의의 페이지를 탐색하세요.
|
||||
---
|
||||
|
||||
# 데스크톱 브라우저
|
||||
|
||||
데스크톱 앱에는 내장 브라우저가 있어 채팅 바로 옆에서 임의의 페이지를 열고, 요소를 가리켜 질문하고, 페이지의 콘솔을 캡처할 수 있습니다. 앱 헤더의 지구본 버튼에서 엽니다.
|
||||
|
||||
> 데스크톱 브라우저는 **데스크톱 전용** 기능입니다. 웹에서는 [미리보기](/ko/preview/) 패널이 로컬 개발 서버에 대해 동일한 검사 및 콘솔 도구를 제공합니다.
|
||||
|
||||
## 검사 및 주석
|
||||
|
||||
**inspect**를 켜고 페이지의 임의 요소를 클릭합니다. OpenChamber가 그것이 무엇인지, 스타일, 위치, 스크린샷을 담은 메모를 캡처해 채팅 메시지에 첨부합니다. 에이전트에게 "바로 여기 이 요소"라고 알리는 가장 빠른 방법입니다.
|
||||
|
||||
## 콘솔 캡처
|
||||
|
||||
브라우저는 페이지의 콘솔 출력(오류, 경고, 로그)을 수집하므로 개발자 도구를 열지 않고도 필터링하여 읽을 수 있습니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Preview & Dev Servers](/ko/preview/) — 로컬 개발 서버에 대한 동일한 도구
|
||||
@@ -0,0 +1,30 @@
|
||||
---
|
||||
title: Git 아이덴티티
|
||||
description: 저장소마다 올바른 이름과 이메일로 커밋하세요.
|
||||
---
|
||||
|
||||
# Git 아이덴티티
|
||||
|
||||
git 신원은 커밋에 서명되는 이름과 이메일입니다. 개인 저장소와 업무 저장소를 오가며 작업한다면, 하나의 전역 설정에 의존하는 대신 신원을 저장해 두고 저장소마다 알맞은 것을 적용할 수 있습니다. **Settings → Git**에서 관리합니다.
|
||||
|
||||
## 신원 추가하기
|
||||
|
||||
1. **Settings → Git**를 열고 **New**를 선택합니다.
|
||||
2. 커밋에 사용할 **name**과 **email**을 입력합니다.
|
||||
3. 원격과 인증하는 방식을 선택합니다.
|
||||
- **SSH** — SSH 키를 지정합니다
|
||||
- **token** — 호스트에 저장된 자격 증명을 사용합니다
|
||||
4. 필요하다면 알아보기 쉽도록 색상과 아이콘을 지정합니다.
|
||||
|
||||
시스템의 전역 신원도 읽기 전용으로 표시됩니다.
|
||||
|
||||
## 저장소에 신원 적용하기
|
||||
|
||||
신원을 적용하면 해당 저장소의 **local** git 설정에 기록됩니다. 전역 설정이 아니라 그 저장소에만 영향을 줍니다. SSH 신원은 사용자의 키를 사용하도록 SSH 명령도 설정하고, token 신원은 호스트용 자격 증명 저장소를 설정합니다.
|
||||
|
||||
OpenChamber가 기존 git 자격 증명에서 찾아낸 신원을 가져와 token 신원으로 저장할 수 있습니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Git & GitHub Workflows](/ko/git/) — 설정한 신원으로 커밋하세요
|
||||
- [GitHub Issues & PRs](/ko/github/) — PR을 위해 GitHub 계정을 연결하세요
|
||||
@@ -0,0 +1,41 @@
|
||||
---
|
||||
title: Git 및 GitHub 워크플로
|
||||
description: OpenChamber를 벗어나지 않고 스테이징, 커밋, 브랜치 관리를 하세요.
|
||||
---
|
||||
|
||||
# Git 및 GitHub 워크플로
|
||||
|
||||
OpenChamber에는 내장 git 보기가 있어 터미널로 전환하지 않고도 변경 사항을 검토하고, 커밋하고, 브랜치를 관리할 수 있습니다. 오른쪽 사이드바의 **Git** 탭에서 엽니다.
|
||||
|
||||
## 검토 및 커밋
|
||||
|
||||
git 보기는 변경 사항을 **staged**와 **unstaged**로 나눕니다.
|
||||
|
||||
- 파일의 **+**를 클릭해 스테이징하거나 **−**를 클릭해 스테이징을 해제합니다
|
||||
- 그룹의 모든 항목을 한 번에 스테이징하거나 해제합니다
|
||||
- 파일을 클릭해 diff를 봅니다
|
||||
|
||||
그런 다음 커밋 메시지를 작성하고 커밋합니다. OpenChamber가 스테이징된 변경 사항에서 **커밋 메시지를 생성**하게 할 수 있습니다. 현재 세션의 모델을 사용하므로 세션이 열려 있어야 합니다.
|
||||
|
||||
## 브랜치와 히스토리
|
||||
|
||||
git 보기는 일상적인 나머지 git 작업도 다룹니다.
|
||||
|
||||
- 브랜치 생성, 전환, 이름 변경, 삭제
|
||||
- push, pull, fetch
|
||||
- 히스토리와 커밋별 diff 탐색
|
||||
- 변경 사항 stash 및 복원
|
||||
|
||||
## 풀 리퀘스트
|
||||
|
||||
GitHub를 연결하면([GitHub Issues & PRs](/ko/github/) 참고) **PR** 탭에서 풀 리퀘스트를 열고, 업데이트하고, 준비 완료로 표시하거나 병합할 수 있습니다. 그리고 커밋 메시지와 같은 방식으로 제목과 설명을 생성할 수 있습니다.
|
||||
|
||||
## 충돌 가져오기
|
||||
|
||||
병합, 리베이스, 통합이 충돌하면 OpenChamber가 무엇이 막혔는지 보여주고 해결하게 해줍니다. 에이전트에게 넘기는 것도 포함됩니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [GitHub Issues & PRs](/ko/github/) — GitHub를 연결하고 이슈에서 작업을 시작하세요
|
||||
- [Worktree Sessions](/ko/worktrees/) — 브랜치를 자체 폴더에 격리하세요
|
||||
- [Git Identities](/ko/git-identities/) — 저장소마다 올바른 사람으로 커밋하세요
|
||||
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: GitHub 이슈 및 PR
|
||||
description: GitHub를 연결하고 이슈와 풀 리퀘스트에서 세션을 시작하세요.
|
||||
---
|
||||
|
||||
# GitHub 이슈 및 PR
|
||||
|
||||
GitHub 계정을 연결하면 OpenChamber가 이슈와 풀 리퀘스트를 가져오고, 그중 하나에서 바로 세션을 시작하고, PR을 열거나 업데이트할 수 있습니다.
|
||||
|
||||
## GitHub 연결하기
|
||||
|
||||
1. **Settings → Git**를 엽니다.
|
||||
2. GitHub 아래에서 **Connect**를 선택합니다. OpenChamber가 링크와 짧은 코드를 표시합니다.
|
||||
3. 링크를 열고 코드를 입력한 뒤 승인합니다.
|
||||
|
||||
연결되면 GitHub 섹션 아래에 계정이 표시됩니다. 계정을 여러 개 연결해 전환할 수 있으며, 언제든 연결을 해제할 수 있습니다.
|
||||
|
||||
## 이슈나 PR에서 작업 시작하기
|
||||
|
||||
GitHub가 연결된 상태에서 [worktree 세션](/ko/worktrees/)을 만들면 **Start from GitHub issue/PR**을 선택할 수 있습니다.
|
||||
|
||||
- **issue**를 선택하면 OpenChamber가 그 이슈에 따라 브랜치 이름을 짓고, 이슈와 그 댓글을 첫 메시지로 하여 세션을 엽니다
|
||||
- **pull request**를 선택하면 PR의 브랜치를 체크아웃합니다. PR의 diff를 포함하면 에이전트가 전체 변경 사항을 갖게 됩니다
|
||||
|
||||
이렇게 하면 컨텍스트가 이미 로드된 세션으로 바로 들어갑니다.
|
||||
|
||||
## 풀 리퀘스트 열기 및 관리
|
||||
|
||||
[git 보기](/ko/git/)의 **PR** 탭에서 풀 리퀘스트를 만들고, 업데이트하고, 초안을 준비 완료로 표시하거나 병합할 수 있습니다. OpenChamber는 변경 사항에서 PR 제목과 설명을 생성할 수 있습니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Git & GitHub Workflows](/ko/git/) — 커밋하고 브랜치를 관리하세요
|
||||
- [Worktree Sessions](/ko/worktrees/) — 이슈 및 PR 세션이 시작되는 곳
|
||||
@@ -20,6 +20,13 @@ OpenChamber는 OpenCode(터미널에서 실행되는 AI 코딩 에이전트)를
|
||||
- [터널](/ko/tunnels/)
|
||||
- [문제 해결](/ko/troubleshooting/)
|
||||
|
||||
## 더 둘러보기
|
||||
|
||||
- [프로젝트](/ko/projects/)와 [Worktree 세션](/ko/worktrees/) — 작업을 정리하고 격리하세요
|
||||
- [공급자, 모델, 에이전트](/ko/providers/) — OpenCode를 연결하고 모델을 선택하세요
|
||||
- [Git 및 GitHub 워크플로](/ko/git/) — 커밋하고 검토하고 PR을 여세요
|
||||
- [보안](/ko/security/)과 [터널](/ko/tunnels/) — 인스턴스를 보호하고 접속하세요
|
||||
|
||||
## OpenChamber는 무엇을 위한 것인가
|
||||
|
||||
OpenChamber는 관제 센터가 도움이 되는 AI 코딩 작업을 위한 것입니다. 세션 분기, diff 검토, 터미널 관리, 도구 진행 상황 관찰, 프로젝트 액션 실행, 그리고 에이전트가 작업하는 동안 전체 보드를 한눈에 유지하는 일입니다.
|
||||
|
||||
@@ -0,0 +1,26 @@
|
||||
---
|
||||
title: 매직 프롬프트
|
||||
description: OpenChamber의 자동화 흐름 뒤에 있는 내장 프롬프트를 맞춤 설정하세요.
|
||||
---
|
||||
|
||||
# 매직 프롬프트
|
||||
|
||||
OpenChamber는 커밋 메시지 작성, PR 초안 작성, 이슈 검토, 충돌 해결, 세션 요약 같은 작업을 자동으로 할 때마다 뒤에서 내장 프롬프트를 사용합니다. Magic Prompts는 그러한 프롬프트를 읽고 다시 쓰는 곳입니다. **Settings → Magic Prompts**에서 엽니다.
|
||||
|
||||
일반적인 사용에는 이 페이지가 필요하지 않습니다. 흐름이 다르게 동작하기를 원할 때, 예를 들어 특정 스타일의 커밋 메시지를 원할 때 사용하세요.
|
||||
|
||||
## 프롬프트 편집하기
|
||||
|
||||
1. **Settings → Magic Prompts**를 엽니다.
|
||||
2. 사이드바의 그룹(Git, GitHub, Planning, Session)에서 프롬프트를 선택합니다.
|
||||
3. 텍스트를 편집하고 저장합니다.
|
||||
|
||||
일부 프롬프트에는 보이는 부분(사용자에게 표시되는 메시지)과 지침 부분(에이전트를 위한 숨겨진 안내)이 있습니다. 프롬프트에는 diff나 이슈 제목처럼 OpenChamber가 채워 넣는 `{{placeholders}}`가 포함될 수 있으니 그대로 두세요.
|
||||
|
||||
## 초기화
|
||||
|
||||
마음이 바뀌었나요? 각 프롬프트에는 **reset to default**가 있고, 모든 곳에서 처음부터 다시 시작하려면 **reset all**이 있습니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Git & GitHub Workflows](/ko/git/) — 이러한 프롬프트 중 다수가 git 흐름을 구동합니다
|
||||
@@ -0,0 +1,30 @@
|
||||
---
|
||||
title: MCP 서버
|
||||
description: MCP 서버를 추가하여 에이전트에 추가 도구를 제공하세요.
|
||||
---
|
||||
|
||||
# MCP 서버
|
||||
|
||||
MCP 서버는 에이전트에 데이터베이스 검색, API 호출, 사용하는 서비스 읽기 같은 추가 도구를 제공합니다. **Settings → MCP**에서 추가합니다.
|
||||
|
||||
## 서버 추가하기
|
||||
|
||||
1. **Settings → MCP**를 엽니다.
|
||||
2. 서버를 추가하고 유형을 선택합니다.
|
||||
- **local** — OpenChamber가 사용자의 컴퓨터에서 명령을 실행합니다. 실행할 명령과, 필요하다면 환경 변수를 제공합니다.
|
||||
- **remote** — OpenChamber가 다른 누군가가 호스팅하는 URL에 연결합니다. URL과 필요한 헤더(예: 인증 토큰)를 제공합니다.
|
||||
3. 저장합니다. 서버는 기본적으로 켜져 있으며, 삭제하지 않고도 끌 수 있습니다.
|
||||
|
||||
## 적용 범위
|
||||
|
||||
서버를 추가할 때 범위를 선택합니다.
|
||||
|
||||
- **personal** — 모든 프로젝트에서 사용 가능
|
||||
- **project** — 현재 프로젝트에서만 사용 가능하며, 프로젝트의 다른 설정과 함께 저장됨
|
||||
|
||||
서버 이름에는 소문자, 숫자, 하이픈, 밑줄을 사용합니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Providers, Models & Agents](/ko/providers/) — 먼저 모델을 연결하세요
|
||||
- [Skills](/ko/skills/) — 에이전트의 기능을 확장하는 또 다른 방법
|
||||
@@ -0,0 +1,31 @@
|
||||
---
|
||||
title: PWA 및 모바일 접속
|
||||
description: OpenChamber를 앱으로 설치하고 휴대폰에서 사용하세요.
|
||||
---
|
||||
|
||||
# PWA 및 모바일 접속
|
||||
|
||||
OpenChamber 웹 앱은 휴대폰 앱(PWA)처럼 설치되므로 홈 화면에 두고 전체 화면으로 사용할 수 있습니다. [터널](/ko/tunnels/)과 함께 사용하면 어디서든 세션을 확인할 수 있습니다.
|
||||
|
||||
## 설치하기
|
||||
|
||||
OpenChamber는 브라우저의 내장 설치 기능을 사용하므로 별도의 다운로드가 없습니다.
|
||||
|
||||
- **데스크톱 브라우저** — 주소 표시줄의 **Install** 옵션을 사용합니다
|
||||
- **iPhone/iPad (Safari)** — 공유 → **홈 화면에 추가**
|
||||
- **Android (Chrome)** — 메뉴 → **앱 설치** / **홈 화면에 추가**
|
||||
|
||||
설치되면 브라우저 크롬 없이 자체 창에서 열립니다.
|
||||
|
||||
## 휴대폰에서 접근하기
|
||||
|
||||
서버가 사용자의 컴퓨터에서 실행될 때 휴대폰에서 OpenChamber를 열려면 [터널](/ko/tunnels/)을 시작하고 휴대폰에서 링크를 열거나 QR 코드를 스캔합니다. 이렇게 할 때는 항상 강력한 [UI 비밀번호](/ko/security/)를 사용하세요.
|
||||
|
||||
## 모바일 설정
|
||||
|
||||
**Settings → OpenChamber** 아래의 몇 가지 옵션은 모바일 및 설치된 경험을 조정합니다. 앱의 설치 이름, 화면 방향, 화면 키보드의 동작 방식이 해당됩니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Tunnels](/ko/tunnels/) — 다른 네트워크에서 인스턴스에 접근하세요
|
||||
- [Security](/ko/security/) — 노출하기 전에 UI를 보호하세요
|
||||
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: Multi-run
|
||||
description: 동일한 프롬프트를 여러 모델이나 세션에서 한 번에 실행하세요.
|
||||
---
|
||||
|
||||
# Multi-run
|
||||
|
||||
Multi-run은 하나의 양식에서 여러 세션을 시작합니다. 같은 작업을 다른 모델로 시도하고 결과를 비교하는 데 유용합니다. 세션 사이드바 상단의 버튼에서 엽니다.
|
||||
|
||||
## Multi-run 시작하기
|
||||
|
||||
1. multi-run 런처를 엽니다.
|
||||
2. 프로젝트를 선택하고 실행 그룹의 이름을 지정합니다.
|
||||
3. 프롬프트를 작성하고 실행할 모델을 선택합니다(그룹당 최대 다섯 개).
|
||||
4. **isolate runs** 여부를 선택합니다.
|
||||
5. 시작합니다.
|
||||
|
||||
각 모델은 자체 세션을 가지며, 모두 사용자의 프롬프트로 시작합니다.
|
||||
|
||||
## 격리된 실행
|
||||
|
||||
**isolate runs**를 켜면 모든 실행에 자체 [worktree](/ko/worktrees/)와 브랜치가 부여되어 같은 파일을 절대 건드리지 않습니다. 이를 위해서는 git 저장소가 필요하며, 저장소가 아닌 폴더에서는 자동으로 꺼집니다. 실행이 시작될 브랜치를 선택하세요.
|
||||
|
||||
격리를 끄면 모든 실행은 프로젝트 폴더 안의 평범한 세션입니다.
|
||||
|
||||
## 결과 비교하기
|
||||
|
||||
각 실행은 열고, 읽고, 유지하거나 버릴 수 있는 일반 세션입니다. 접근 방식을 비교하려고 실행을 시작했다면 나란히 검토하고 가장 좋은 것을 이어가세요.
|
||||
|
||||
단일 실행이 시작에 실패해도 나머지는 계속 시작됩니다. 요청한 것보다 세션이 적게 보일 뿐입니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Worktree Sessions](/ko/worktrees/) — 격리가 내부적으로 작동하는 방식
|
||||
@@ -0,0 +1,37 @@
|
||||
---
|
||||
title: 프로젝트 메모, 할 일, 계획
|
||||
description: 프로젝트마다 노트, 할 일 목록, 저장된 계획을 유지하세요.
|
||||
---
|
||||
|
||||
# 프로젝트 메모, 할 일, 계획
|
||||
|
||||
각 프로젝트에는 노트, 할 일 목록, 저장된 계획을 위한 자체 작업 공간이 있습니다. 이들은 특정 세션이 아니라 프로젝트에 속하므로 세션 사이를 오가도 그대로 유지됩니다. 오른쪽 사이드바의 **Context** 탭(모바일에서는 전용 탭)에서 찾을 수 있습니다.
|
||||
|
||||
## Notes
|
||||
|
||||
프로젝트에 대해 기억하고 싶은 것을 자유롭게 적는 노트 상자입니다. 입력하는 동안 자동으로 저장됩니다.
|
||||
|
||||
## Todos
|
||||
|
||||
간단한 체크리스트입니다. 항목을 추가하고, 체크하고, 드래그로 순서를 바꾸고, 완료된 항목을 정리합니다.
|
||||
|
||||
각 할 일에는 에이전트에게 넘길 수 있는 **send** 메뉴가 있습니다.
|
||||
|
||||
- 현재 세션으로 보내기
|
||||
- 그것으로 새 세션 시작
|
||||
- 그것으로 새 [worktree 세션](/ko/worktrees/) 시작(프로젝트가 git 저장소일 때만 가능)
|
||||
|
||||
## Plans
|
||||
|
||||
더 긴 계획을 저장된 파일로 보관하는 공간입니다. 다음을 할 수 있습니다.
|
||||
|
||||
- Markdown 또는 텍스트 파일에서 계획 가져오기
|
||||
- 계획을 열어 사이드 패널에서 읽기
|
||||
- 더 이상 필요 없는 계획 삭제
|
||||
|
||||
노트가 저장되거나, 할 일이 체크되거나, 계획이 목록에 표시된 상태로 Context 탭에 돌아와야 합니다. 그것으로 반영되었음을 알 수 있습니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Worktree Sessions](/ko/worktrees/) — 할 일을 자체 브랜치에서 실행하세요
|
||||
- [Projects](/ko/projects/) — 이들은 활성 프로젝트에 속합니다
|
||||
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: 알림
|
||||
description: 세션이 사용자를 필요로 하거나 완료될 때 알림을 받으세요.
|
||||
---
|
||||
|
||||
# 알림
|
||||
|
||||
알림은 화면을 지켜보지 않아도 무언가가 사용자의 주의를 필요로 할 때, 즉 세션이 완료되었거나, 오류가 발생했거나, 질문했거나, 무언가를 할 권한이 필요할 때 알려줍니다. **Settings → OpenChamber → Notifications**에서 설정합니다.
|
||||
|
||||
## 켜기
|
||||
|
||||
1. **Settings → OpenChamber → Notifications**를 엽니다.
|
||||
2. 브라우저나 시스템이 요청하면 알림을 허용합니다.
|
||||
3. 알림받고 싶은 내용을 선택합니다.
|
||||
- 세션 **완료**
|
||||
- 세션 **오류** 발생
|
||||
- 세션이 **질문**할 때
|
||||
- 세션이 **권한**을 필요로 할 때
|
||||
- **하위 작업** 완료
|
||||
|
||||
## 전달 방식
|
||||
|
||||
- **데스크톱**에서는 네이티브 시스템 알림을 받습니다
|
||||
- **브라우저 또는 설치된 앱**에서는 웹 푸시 알림을 받으므로 탭이 백그라운드에 있어도 도착합니다
|
||||
|
||||
자동 수락으로 설정된 세션은 권한 알림으로 귀찮게 하지 않습니다.
|
||||
|
||||
## 문구 맞춤 설정
|
||||
|
||||
각 알림 종류에는 에이전트 이름과 모델 같은 필드를 사용해 편집할 수 있는 제목과 메시지 템플릿이 있습니다. 또한 알림이 짧게 유지되도록 마지막 메시지를 얼마나 포함할지에 대한 제한도 있습니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Voice Mode](/ko/voice/) — 대신 응답을 소리내어 들으세요
|
||||
@@ -0,0 +1,54 @@
|
||||
---
|
||||
title: OpenCode 서버
|
||||
description: OpenChamber를 로컬 또는 원격 OpenCode 서버에 연결하세요.
|
||||
---
|
||||
|
||||
# OpenCode 서버
|
||||
|
||||
OpenChamber는 OpenCode 서버 위에서 실행됩니다. 기본적으로 OpenChamber가 서버를 직접 시작하므로 따로 할 일은 없습니다. 이미 운영 중인 서버를 OpenChamber가 사용하도록 지정하거나, OpenChamber가 시작한 서버를 관리하려는 경우에만 이 페이지가 필요합니다.
|
||||
|
||||
## OpenChamber가 서버를 찾는 방법
|
||||
|
||||
OpenChamber가 시작되면 다음 순서로 서버를 찾습니다.
|
||||
|
||||
1. 이미 시작한 서버를 재사용합니다
|
||||
2. 외부 서버를 사용하도록 지정했다면 그 서버에 연결합니다(아래 참고)
|
||||
3. 기본 포트(`4096`)에서 서버를 자동으로 감지합니다
|
||||
4. 그 외에는 자체 서버를 시작하고 관리합니다
|
||||
|
||||
아무것도 설정하지 않으면 4단계가 자동으로 실행되어 바로 사용할 수 있습니다.
|
||||
|
||||
## 이미 운영 중인 서버에 연결하기
|
||||
|
||||
OpenChamber를 시작하기 전에 다음을 설정하세요.
|
||||
|
||||
```bash
|
||||
OPENCODE_HOST=http://localhost:4096 OPENCODE_SKIP_START=true openchamber
|
||||
```
|
||||
|
||||
- `OPENCODE_HOST` — 포트를 포함한 OpenCode 서버의 전체 주소(예: `http://localhost:4096`)입니다. 끝에 경로가 붙어서는 안 됩니다.
|
||||
- `OPENCODE_SKIP_START=true` — OpenChamber가 자체 서버를 시작하지 않도록 지정합니다.
|
||||
|
||||
포트만 변경하면 된다면 `OPENCODE_HOST` 대신 `OPENCODE_PORT`를 설정하세요.
|
||||
|
||||
`OPENCODE_HOST`에 포트가 없거나 경로가 붙어 있으면 OpenChamber는 이를 무시하고 자체 서버를 시작하는 방식으로 되돌아갑니다. 예상한 연결이 일어나지 않았다면 시작 로그에서 `[config]` 경고를 확인하세요.
|
||||
|
||||
## CLI에서 서버 관리하기
|
||||
|
||||
```bash
|
||||
openchamber status
|
||||
openchamber logs
|
||||
openchamber restart
|
||||
openchamber stop
|
||||
```
|
||||
|
||||
`openchamber`만 입력하면 서버가 백그라운드에서 시작됩니다. 터미널에 연결된 상태로 유지하려면 `--foreground`를 추가하세요.
|
||||
|
||||
## "OpenCode is restarting"
|
||||
|
||||
서버가 시작되거나 재시작되는 동안 OpenChamber는 "OpenCode is restarting" 상태를 표시하고 준비가 끝날 때까지 요청을 일시 중지합니다. 실행 직후나 재시작 직후에는 정상적인 동작입니다. 이 상태가 계속 사라지지 않으면 [OpenCode 연결](/ko/troubleshooting/opencode-connection/)을 참고하세요.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Providers, Models & Agents](/ko/providers/) — 서버가 통신할 대상을 설정합니다
|
||||
- [OpenCode 연결](/ko/troubleshooting/opencode-connection/) — 연결되지 않을 때
|
||||
@@ -0,0 +1,32 @@
|
||||
---
|
||||
title: 미리보기 및 개발 서버
|
||||
description: 실행 중인 개발 서버를 OpenChamber 안에서 여세요.
|
||||
---
|
||||
|
||||
# 미리보기 및 개발 서버
|
||||
|
||||
개발 서버를 시작하면 OpenChamber는 별도의 브라우저 탭이 아니라 앱 안에서 바로 열 수 있습니다. 그래서 채팅 옆에서 사이트를 보고, 콘솔을 캡처하고, 요소를 가리켜 질문할 수 있습니다.
|
||||
|
||||
## 미리보기 열기
|
||||
|
||||
OpenChamber는 터미널 출력에서 로컬 주소(Vite, Next.js, Astro 같은 도구가 출력하는 `Local:` 줄)를 감시합니다. 발견하면 다음과 같이 동작합니다.
|
||||
|
||||
- 터미널에 **Open preview** 버튼이 나타납니다
|
||||
- auto-open이 켜진 [프로젝트 액션](/ko/project-actions/)이 대신 열어줍니다
|
||||
- 채팅 메시지의 로컬 링크로도 열 수 있습니다
|
||||
|
||||
사이트는 사이드 패널에 로드됩니다. 로컬 주소(사용자 자신의 컴퓨터)만 미리볼 수 있습니다.
|
||||
|
||||
## 콘솔과 검사
|
||||
|
||||
미리보기 패널에서 다음을 할 수 있습니다.
|
||||
|
||||
- 페이지의 **console**(오류, 경고, 로그)을 원하는 대로 필터링하여 확인
|
||||
- **inspect**를 켜고 임의의 요소를 클릭한 뒤 그에 대한 메모(선택자, 스타일, 위치, 스크린샷)를 바로 채팅으로 전송
|
||||
|
||||
이것은 설명 없이 에이전트에게 "여기 이 버튼"이라고 알리는 가장 빠른 방법입니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Project Actions](/ko/project-actions/) — 서버를 시작할 때 자동으로 열기
|
||||
- [Desktop Browser](/ko/desktop-browser/) — 데스크톱에서 임의의 페이지에 동일한 도구 사용
|
||||
@@ -0,0 +1,28 @@
|
||||
---
|
||||
title: 프로젝트 작업
|
||||
description: 자주 실행하는 명령을 저장하고 클릭 한 번으로 실행하세요.
|
||||
---
|
||||
|
||||
# 프로젝트 작업
|
||||
|
||||
프로젝트 액션은 한 번 저장해 두고 클릭으로 실행하는 셸 명령입니다. 개발 서버, 빌드, 테스트 실행 등이 해당됩니다. 각 프로젝트는 자체 목록을 유지합니다. **Settings → Projects → Project Actions**에서 설정합니다.
|
||||
|
||||
## 액션 추가하기
|
||||
|
||||
1. **Settings → Projects**를 열고 **Project Actions** 섹션을 찾습니다.
|
||||
2. 액션을 추가하고 이름을 지정하고 아이콘을 선택하고 실행할 명령을 입력합니다.
|
||||
3. 저장합니다.
|
||||
|
||||
명령이 특정 운영체제에서만 의미가 있다면 액션을 해당 운영체제로 제한할 수 있습니다.
|
||||
|
||||
## 액션 실행하기
|
||||
|
||||
액션은 앱 헤더의 메뉴에 있습니다. 하나를 클릭하면 OpenChamber가 프로젝트 폴더의 터미널에서 실행하고, 출력을 볼 수 있도록 터미널 보기로 전환합니다. 같은 메뉴에서 중지할 수 있습니다.
|
||||
|
||||
## 개발 서버 자동 열기
|
||||
|
||||
서버를 시작하는 액션에 **auto-open URL**을 켭니다. OpenChamber가 출력에서 로컬 주소를 감시하다가 열기를 제안합니다. [Preview & Dev Servers](/ko/preview/)를 참고하세요. 데스크톱에서는 SSH 포트 포워딩을 통해 라우팅할 수도 있습니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Preview & Dev Servers](/ko/preview/) — 실행 중인 개발 서버를 OpenChamber 안에서 여세요
|
||||
@@ -0,0 +1,20 @@
|
||||
---
|
||||
title: 프로젝트 아이콘
|
||||
description: 각 프로젝트에 알아보기 쉬운 아이콘을 지정하세요.
|
||||
---
|
||||
|
||||
# 프로젝트 아이콘
|
||||
|
||||
프로젝트 아이콘은 한눈에 프로젝트를 구분하기 쉽게 해줍니다. OpenChamber가 아이콘을 찾아주려고 시도하며, 언제든 직접 설정할 수 있습니다. **Settings → Projects**에서 관리합니다.
|
||||
|
||||
## 자동 검색
|
||||
|
||||
프로젝트를 추가하면 OpenChamber가 그 안의 `favicon` 파일을 찾아 프로젝트 아이콘으로 사용합니다. 저장소에 이미 favicon이 있으면 대개 아이콘이 그냥 나타나며, 할 일이 없습니다.
|
||||
|
||||
## 직접 설정하기
|
||||
|
||||
**Settings → Projects**를 열고 이미지(PNG, JPEG 또는 SVG, 최대 5 MB)를 업로드합니다. 사용자 지정 이미지는 자동으로 검색된 것보다 우선합니다. 대신 색상을 선택할 수도 있고, 이미지를 제거해 검색으로 되돌릴 수도 있습니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Projects](/ko/projects/) — 프로젝트의 이름, 색상을 정하고 정리하세요
|
||||
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: 프로젝트
|
||||
description: 작업을 프로젝트로 정리하고 그 사이를 전환하세요.
|
||||
---
|
||||
|
||||
# 프로젝트
|
||||
|
||||
프로젝트는 OpenChamber가 추적하는 사용자 컴퓨터의 폴더로, 보통 하나의 코드베이스입니다. 프로젝트를 전환하면 에이전트가 작업하는 폴더가 그 프로젝트의 세션 및 설정과 함께 전환됩니다.
|
||||
|
||||
## 프로젝트 추가하기
|
||||
|
||||
몇 군데에서 프로젝트를 추가할 수 있습니다.
|
||||
|
||||
- 명령 팔레트의 **Add project** 항목
|
||||
- 세션 사이드바 상단의 **+** 버튼
|
||||
- 디렉터리를 선택할 때 나오는 폴더 브라우저
|
||||
|
||||
폴더를 지정하면 OpenChamber가 기억합니다. 이름은 폴더에서 가져오며, 나중에 변경할 수 있습니다.
|
||||
|
||||
## 프로젝트 전환하기
|
||||
|
||||
사이드바에서 프로젝트를 선택하면 활성화됩니다. 세션, git, 노트 등 모든 것이 열려 있는 프로젝트를 따릅니다.
|
||||
|
||||
## 프로젝트를 알아보기 쉽게 만들기
|
||||
|
||||
**Settings → Projects**를 열어 프로젝트에 사용자 지정 이름, 색상, 아이콘을 지정합니다. OpenChamber는 아이콘을 자동으로 찾으려고 시도합니다. [Project icons](/ko/project-icons/)를 참고하세요.
|
||||
|
||||
> VS Code에서는 OpenChamber가 항상 열려 있는 폴더를 유일한 프로젝트로 사용하므로 추가하거나 전환할 것이 없습니다. 거기서는 Projects 설정 페이지가 숨겨집니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Project Notes, Todos & Plans](/ko/notes-todos-plans/) — 프로젝트별로 작업 노트를 유지하세요
|
||||
- [Project Actions](/ko/project-actions/) — 자주 실행하는 명령을 저장하세요
|
||||
- [Context](/ko/context/) — 세션이 모델의 메모리를 얼마나 사용하는지 확인하세요
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
title: 공급자, 모델, 에이전트
|
||||
description: AI 공급자를 연결하고 모델을 선택하며 에이전트를 설정하세요.
|
||||
---
|
||||
|
||||
# 공급자, 모델, 에이전트
|
||||
|
||||
OpenChamber가 무언가를 하려면 먼저 최소한 하나의 AI 공급자가 연결되어 있어야 합니다. 이 페이지에서는 공급자 연결, 모델 선택, 에이전트 맞춤 설정을 다룹니다.
|
||||
|
||||
## 공급자 연결하기
|
||||
|
||||
1. **Settings → Providers**를 엽니다.
|
||||
2. **Add provider** 메뉴를 열고 아직 연결되지 않은 공급자를 선택합니다.
|
||||
3. 공급자에 따라 다음 두 가지 방법 중 하나로 로그인합니다.
|
||||
- **API key** — 키를 붙여넣고 저장합니다.
|
||||
- **Sign-in (device flow)** — OpenChamber가 링크와 짧은 코드를 표시합니다. 링크를 열고 코드를 입력한 뒤 승인합니다. 나머지 연결은 OpenChamber가 알아서 마무리합니다.
|
||||
|
||||
공급자가 연결됨으로 표시되면 해당 모델을 채팅에서 사용할 수 있습니다.
|
||||
|
||||
연결을 해제하려면 공급자를 열고 로그인을 제거하도록 선택합니다.
|
||||
|
||||
## 모델 선택하기
|
||||
|
||||
작업하는 위치에서 모델을 선택합니다.
|
||||
|
||||
- 채팅에서는 메시지 바의 모델 선택기로 해당 세션의 공급자와 모델을 설정합니다
|
||||
- 에이전트별로 기본 모델을 설정합니다(아래 참고)
|
||||
|
||||
## 에이전트 설정하기
|
||||
|
||||
에이전트는 모델, 성격, 허용된 작업을 묶어 이름을 붙인 설정입니다.
|
||||
|
||||
1. **Settings → Agents**를 엽니다.
|
||||
2. 에이전트를 선택하거나 새로 만듭니다.
|
||||
3. 다음 항목을 편집합니다.
|
||||
- **description** — 에이전트의 용도
|
||||
- **model** — 기본 모델
|
||||
- **temperature** — 답변의 창의성 정도
|
||||
- **prompt** — 항상 따르는 상시 지침
|
||||
- **tool rules** — 사용할 수 있는 도구
|
||||
|
||||
## 로그인 정보가 저장되는 위치
|
||||
|
||||
공급자 로그인 정보는 OpenChamber가 아니라 OpenCode에 저장되므로 OpenCode CLI와 공유됩니다. 같은 공급자를 여러 곳에 설정하면 가장 구체적인 설정이 우선합니다. 프로젝트별 설정이 개인 설정을 덮어씁니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [MCP Servers](/ko/mcp/) — 에이전트에 추가 도구를 제공합니다
|
||||
- [Usage & Quotas](/ko/usage/) — 사용량을 추적합니다
|
||||
@@ -0,0 +1,30 @@
|
||||
---
|
||||
title: 원격 인스턴스
|
||||
description: 데스크톱 앱을 SSH로 다른 컴퓨터의 OpenChamber에 연결하세요.
|
||||
---
|
||||
|
||||
# 원격 인스턴스
|
||||
|
||||
데스크톱 앱은 SSH를 통해 업무 서버, 클라우드 인스턴스, 홈랩 등 다른 컴퓨터에서 실행 중인 OpenChamber에 연결하여, 마치 로컬인 것처럼 그 UI를 화면에 가져올 수 있습니다. **Settings → Remote Instances**에서 설정합니다.
|
||||
|
||||
> 원격 인스턴스는 **데스크톱 전용** 기능입니다. 웹이나 VS Code에서는 대신 [OpenCode Server](/ko/opencode-server/)의 환경 변수로 원격 서버에 연결하세요.
|
||||
|
||||
## 원격 인스턴스 추가하기
|
||||
|
||||
1. **Settings → Remote Instances**를 열고 하나를 추가합니다.
|
||||
2. 평소에 그 컴퓨터에 접근할 때 사용하는 SSH 명령과 별칭을 지정합니다.
|
||||
3. OpenChamber가 거기서 실행되는 방식을 선택합니다.
|
||||
- **managed** — OpenChamber가 원격 컴퓨터에 직접 설치하고 시작합니다
|
||||
- **external** — 이미 실행 중인 것에 연결합니다
|
||||
4. 연결합니다.
|
||||
|
||||
OpenChamber가 연결 확인, 원격 설정, 서버 시작, 포트 포워딩 단계를 안내하며 각 단계의 진행 상황을 보여줍니다. **ready**에 도달하면 원격 UI가 로컬에 로드됩니다.
|
||||
|
||||
## 자격 증명
|
||||
|
||||
SSH 및 UI 비밀번호를 저장할지, 매번 입력할지 결정합니다. 연결이 끊기면 OpenChamber가 어느 단계가 실패했는지 알려주므로 고칠 수 있습니다. [Remote access](/ko/troubleshooting/remote-access/)를 참고하세요.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [OpenCode Server](/ko/opencode-server/) — 웹이나 VS Code에서 원격 서버에 연결하세요
|
||||
- [Remote access](/ko/troubleshooting/remote-access/) — 연결이 완료되지 않을 때
|
||||
@@ -0,0 +1,33 @@
|
||||
---
|
||||
title: 예약 작업
|
||||
description: 일정에 따라 프롬프트를 자동으로 실행하세요.
|
||||
---
|
||||
|
||||
# 예약 작업
|
||||
|
||||
예약 작업은 일정에 따라 프롬프트를 대신 실행합니다. 예를 들어 매일 "어제 변경 사항 요약"이나 주간 정리 같은 것입니다. 실행되면 OpenChamber가 새 세션을 시작하고 프롬프트를 알아서 보냅니다. 세션 사이드바 상단의 버튼에서 스케줄러를 엽니다.
|
||||
|
||||
## 작업 만들기
|
||||
|
||||
1. 세션 사이드바에서 예약 작업 대화 상자를 엽니다.
|
||||
2. 작업을 추가하고 이름을 지정합니다.
|
||||
3. 실행 시점을 선택합니다.
|
||||
- **daily** — 매일 하나 이상의 시각에
|
||||
- **weekly** — 선택한 요일과 시각에
|
||||
- **once** — 단일 날짜와 시각에
|
||||
4. 동작을 설정합니다. 보낼 프롬프트와 사용할 공급자, 모델, 에이전트를 지정합니다. 프롬프트는 `/review`처럼 슬래시 명령일 수 있습니다.
|
||||
5. 저장하고 작업이 활성화되어 있는지 확인합니다.
|
||||
|
||||
**run now**로 작업을 즉시 실행하여 기대대로 동작하는지 확인할 수 있습니다.
|
||||
|
||||
## 성공이란 어떤 모습인가
|
||||
|
||||
실행 후 작업에는 마지막 실행 시각, 성공 여부, 생성된 세션으로의 링크가 표시됩니다. 실행이 실패하면 오류도 거기에 표시됩니다.
|
||||
|
||||
## 유의할 점
|
||||
|
||||
작업은 OpenChamber 서버가 실행 중일 때만 동작합니다. 서버를 닫으면 다시 켤 때까지 예약 실행이 일시 중지됩니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Commands & Snippets](/ko/commands-snippets/) — 슬래시 명령을 프롬프트로 재사용하세요
|
||||
@@ -0,0 +1,37 @@
|
||||
---
|
||||
title: 보안
|
||||
description: 노출하기 전에 비밀번호와 패스키로 UI를 보호하세요.
|
||||
---
|
||||
|
||||
# 보안
|
||||
|
||||
OpenChamber는 사용자의 컴퓨터와 코드에 대한 접근 권한을 제공하므로, 본인 외의 누군가가 접근할 수 있게 되기 전에 잠가 두세요. 이 페이지는 UI 비밀번호, 패스키, 그리고 OpenChamber를 네트워크에 노출하기 전에 알아야 할 사항을 다룹니다.
|
||||
|
||||
## UI 비밀번호 설정하기
|
||||
|
||||
비밀번호와 함께 OpenChamber를 시작하면 브라우저 UI가 비밀번호를 요구합니다.
|
||||
|
||||
```bash
|
||||
openchamber --ui-password be-creative-here
|
||||
```
|
||||
|
||||
명령줄에 넣는 대신 `OPENCHAMBER_UI_PASSWORD` 환경 변수로 설정할 수도 있습니다. 로그인하면 OpenChamber가 한동안 기기를 기억하므로 매번 묻지 않습니다.
|
||||
|
||||
다른 사람이 인스턴스에 접근할 수 있다면, 특히 [터널](/ko/tunnels/)이나 공용 인터넷을 통해 접근할 수 있다면 항상 비밀번호를 설정하세요.
|
||||
|
||||
## 패스키
|
||||
|
||||
비밀번호가 설정되면 더 빠른 로그인을 위해 패스키(Face ID, Touch ID, 보안 키)를 추가할 수 있습니다. **Settings → OpenChamber → Passkeys**에서 추가하세요.
|
||||
|
||||
패스키는 현재 비밀번호에 연결됩니다. 비밀번호를 변경하거나 제거하면 저장된 패스키가 삭제되며, 다시 추가해야 합니다.
|
||||
|
||||
## 노출하기 전에
|
||||
|
||||
- 기본적으로 OpenChamber는 사용자 자신의 컴퓨터(`127.0.0.1`)에서만 수신 대기합니다. 더 넓게 수신 대기하려면 의도적인 변경이 필요하며, 먼저 비밀번호를 설정해야 합니다.
|
||||
- 인터넷에 포트를 여는 것보다 [터널](/ko/tunnels/)이나 사설 네트워크(예: VPN)를 선호하세요.
|
||||
- OpenChamber를 자체 HTTPS 서버 뒤에 둔다면 [Reverse Proxy](/ko/reverse-proxy/)를 참고하세요.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Tunnels](/ko/tunnels/) — 원격으로 인스턴스에 접근하는 권장 방법
|
||||
- [Reverse Proxy](/ko/reverse-proxy/) — 자체 서버 뒤에서 OpenChamber 실행
|
||||
@@ -0,0 +1,27 @@
|
||||
---
|
||||
title: 스킬 카탈로그
|
||||
description: 이미 만들어진 스킬을 둘러보고 설치하세요.
|
||||
---
|
||||
|
||||
# 스킬 카탈로그
|
||||
|
||||
Skills Catalog를 사용하면 직접 작성하는 대신 다른 사람이 게시한 스킬을 설치할 수 있습니다. **Settings → Skills → Catalog**에서 엽니다.
|
||||
|
||||
직접 스킬을 작성하려면 [Skills](/ko/skills/)를 참고하세요.
|
||||
|
||||
## 스킬 설치하기
|
||||
|
||||
1. 카탈로그를 엽니다.
|
||||
2. 내장된 소스(Anthropic 스킬 저장소와 ClawdHub 커뮤니티 레지스트리)를 둘러보거나 검색합니다.
|
||||
3. 스킬을 선택하고 설치합니다.
|
||||
4. 설치 위치를 선택합니다. 모든 작업에 적용할지, 현재 프로젝트에만 적용할지 선택합니다.
|
||||
|
||||
같은 이름의 스킬이 이미 있으면 OpenChamber가 어떻게 할지 묻습니다. 건너뛰기, 덮어쓰기, 또는 스킬별로 결정할 수 있습니다.
|
||||
|
||||
## 직접 소스 추가하기
|
||||
|
||||
`owner/repo` 이름이나 전체 Git URL을 사용해 임의의 Git 저장소를 소스로 추가할 수 있습니다. 비공개 저장소는 사용자의 컴퓨터에 접근 설정(SSH 키 또는 저장된 자격 증명)이 필요합니다. 소스가 인증에 실패하면 카탈로그가 조용히 실패하는 대신 그 사실을 알려줍니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Skills](/ko/skills/) — 설치한 스킬을 만들고 관리하세요
|
||||
@@ -0,0 +1,30 @@
|
||||
---
|
||||
title: 스킬
|
||||
description: 에이전트가 필요할 때 불러오는 재사용 가능한 지침을 만드세요.
|
||||
---
|
||||
|
||||
# 스킬
|
||||
|
||||
스킬은 에이전트가 관련이 있을 때 불러올 수 있는 재사용 가능한 지침 모음입니다. 예를 들어 "커밋 메시지를 작성하는 방식"이나 "우리의 API 규칙" 같은 것입니다. **Settings → Skills**에서 관리합니다.
|
||||
|
||||
직접 작성하는 대신 이미 만들어진 스킬을 설치하려면 [Skills Catalog](/ko/skills-catalog/)를 참고하세요.
|
||||
|
||||
## 스킬 만들기
|
||||
|
||||
1. **Settings → Skills**를 엽니다.
|
||||
2. 스킬을 만들고 이름과 짧은 설명을 지정합니다. 에이전트는 이 설명을 보고 스킬이 적용될 시점을 판단하므로 구체적으로 작성하세요.
|
||||
3. 지침을 작성합니다. 스킬에 필요하다면 보조 파일을 추가합니다.
|
||||
4. 저장 위치를 선택합니다.
|
||||
- **personal** — 모든 프로젝트에서 사용 가능
|
||||
- **project** — 현재 프로젝트에서만 사용 가능
|
||||
|
||||
## 채팅에서 스킬 사용하기
|
||||
|
||||
메시지 중간에 `/`를 입력하면 스킬 선택기가 나타나며, 그중 하나를 선택합니다. 에이전트가 해당 스킬의 지침을 응답에 불러옵니다.
|
||||
|
||||
메시지 맨 앞의 `/`는 대신 [명령](/ko/commands-snippets/)을 엽니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Skills Catalog](/ko/skills-catalog/) — 다른 사람이 게시한 스킬을 설치하세요
|
||||
- [Commands & Snippets](/ko/commands-snippets/) — 채팅에서 텍스트를 재사용하는 다른 방법
|
||||
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: OpenCode 연결
|
||||
description: OpenChamber가 OpenCode 서버에 연결되지 않는 문제를 해결하세요.
|
||||
---
|
||||
|
||||
# OpenCode 연결
|
||||
|
||||
OpenChamber가 로드되지만 "OpenCode is restarting"에서 넘어가지 못하거나 채팅이 응답하지 않는다면, 통신하는 서버에 접근할 수 없는 상태입니다. 다음을 차례로 확인하세요.
|
||||
|
||||
## "OpenCode is restarting"에서 멈춰 있음
|
||||
|
||||
- 실행 직후에는 잠시 기다리세요. 서버가 시작되는 동안에는 정상적인 상태입니다
|
||||
- `openchamber status`로 서버가 살아 있는지 확인합니다
|
||||
- `openchamber restart`로 재시작합니다
|
||||
- `openchamber logs`로 시작 세부 정보를 봅니다
|
||||
|
||||
## 직접 운영하는 서버에 연결 중
|
||||
|
||||
OpenChamber가 기존 서버를 사용하도록 설정했다면 [OpenCode Server](/ko/opencode-server/)의 설정을 다시 확인하세요.
|
||||
|
||||
- `OPENCODE_HOST`에는 포트가 포함되어야 하며 경로가 없어야 합니다(예: `http://localhost:4096`)
|
||||
- OpenChamber가 자체 서버를 함께 시작하지 않도록 `OPENCODE_SKIP_START=true`를 설정합니다
|
||||
- 주소가 올바르지 않으면 OpenChamber가 이를 무시하고 자체 서버를 시작합니다. 로그에서 `[config]` 경고를 찾아보세요
|
||||
|
||||
## 여전히 실패함
|
||||
|
||||
- Node.js 버전이 `20` 이상인지 확인합니다
|
||||
- 최신 CLI를 다시 설치합니다
|
||||
- 터널이나 원격 링크를 테스트하기 전에 `http://localhost:3000`을 직접 엽니다
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [OpenCode Server](/ko/opencode-server/) — OpenChamber가 서버를 찾고 관리하는 방법
|
||||
- [문제 해결](/ko/troubleshooting/) — 다른 일반적인 문제
|
||||
@@ -0,0 +1,38 @@
|
||||
---
|
||||
title: 원격 접속
|
||||
description: 터널, 원격 인스턴스, 다른 기기에서 OpenChamber에 접근하는 문제를 해결하세요.
|
||||
---
|
||||
|
||||
# 원격 접속
|
||||
|
||||
휴대폰이나 다른 컴퓨터에서 OpenChamber에 접근할 수 없을 때, 해결 방법은 연결 방식에 따라 다릅니다.
|
||||
|
||||
## 먼저 기본 사항 확인
|
||||
|
||||
- 같은 컴퓨터에서 `http://localhost:3000`을 먼저 엽니다. 이것이 실패하면 원격 문제가 아닙니다. [OpenCode 연결](/ko/troubleshooting/opencode-connection/)을 참고하세요
|
||||
- `openchamber status`로 서버가 실행 중인지 확인합니다
|
||||
|
||||
## 터널 링크가 작동하지 않음
|
||||
|
||||
- `openchamber tunnel status --all`을 실행합니다
|
||||
- 같은 인스턴스와 포트에서 터널을 재시작합니다
|
||||
- 이전 링크가 이미 사용되었다면 연결 링크를 다시 생성합니다
|
||||
|
||||
전체 설정은 [Tunnels](/ko/tunnels/)를 참고하세요.
|
||||
|
||||
## 원격 인스턴스가 연결되지 않음(데스크톱)
|
||||
|
||||
[원격 인스턴스](/ko/remote-instances/)가 멈추면 OpenChamber가 실패한 단계를 알려줍니다.
|
||||
|
||||
- **auth** — SSH 또는 UI 비밀번호가 거부됨. 다시 입력하세요
|
||||
- **install / start** — OpenChamber가 원격 컴퓨터에서 서버를 설정하거나 시작하지 못함. 그 컴퓨터의 요구 사항을 확인하세요
|
||||
- **forwarding** — 연결은 되었지만 포트가 도달하지 않음. 다른 로컬 포트를 시도하세요
|
||||
|
||||
## 자체 서버 뒤에 있음
|
||||
|
||||
OpenChamber를 리버스 프록시 뒤에 두었는데 이상하게 로드되거나 연결되지 않으면 [Reverse Proxy](/ko/reverse-proxy/)를 참고하세요.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Tunnels](/ko/tunnels/) · [Remote Instances](/ko/remote-instances/) · [Reverse Proxy](/ko/reverse-proxy/)
|
||||
- [Security](/ko/security/) — 노출하기 전에 UI를 보호하세요
|
||||
@@ -0,0 +1,35 @@
|
||||
---
|
||||
title: Worktree 및 Git
|
||||
description: 일반적인 worktree 및 git 문제를 해결하세요.
|
||||
---
|
||||
|
||||
# Worktree 및 Git
|
||||
|
||||
[worktree 세션](/ko/worktrees/)과 [git 보기](/ko/git/)에서 발생하는 문제와 해결 방법입니다.
|
||||
|
||||
## worktree에 주의가 필요함
|
||||
|
||||
OpenChamber는 무언가 잘못되면 worktree를 표시합니다.
|
||||
|
||||
- **folder missing** — worktree의 폴더가 OpenChamber 외부에서 삭제되거나 이동됨. 세션을 제거하고 새 worktree를 만드세요
|
||||
- **detached or unborn branch** — worktree가 정상적인 브랜치에 있지 않음. 정상 브랜치로 체크아웃하세요
|
||||
- **merge, rebase, or cherry-pick in progress** — 작업이 절반만 끝남. git 보기에서 완료하거나 중단하세요
|
||||
|
||||
## worktree를 만들 수 없음
|
||||
|
||||
- **branch already exists** — 다른 브랜치 이름을 선택하거나 existing-branch 옵션을 사용하세요
|
||||
- **name already in use** — 다른 worktree 이름을 선택하세요
|
||||
|
||||
## 커밋 또는 PR 생성 실패
|
||||
|
||||
커밋 메시지나 PR 설명 생성은 활성 세션에서 실행되므로, 작동하는 모델이 선택된 세션이 열려 있어야 합니다. 세션을 열거나 선택한 뒤 다시 시도하세요.
|
||||
|
||||
## SSH 또는 Windows 경로 문제
|
||||
|
||||
- 저장소가 사용하는 SSH 키가 [git 신원](/ko/git-identities/)에 설정된 것과 같은지 확인하세요
|
||||
- Windows에서 git은 Unix 스타일 경로(예: `/c/Users/...`)를 사용합니다. OpenChamber가 이를 처리하지만, 사용자 지정 SSH 키 경로도 같은 형식을 따라야 합니다
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Worktree Sessions](/ko/worktrees/) — worktree가 생성되고 제거되는 방법
|
||||
- [Git Identities](/ko/git-identities/) — 저장소마다 올바른 키와 신원을 설정하세요
|
||||
@@ -80,4 +80,6 @@ openchamber tunnel stop --port 3000
|
||||
|
||||
## 관련 문서
|
||||
|
||||
- [보안](/ko/security/) — 외부에 공개하기 전에 UI를 보호하세요
|
||||
- [PWA 및 모바일 접속](/ko/mobile/) — 휴대폰에서 OpenChamber에 접속하세요
|
||||
- [문제 해결](/ko/troubleshooting/) — 터널 링크가 작동하지 않을 때
|
||||
|
||||
@@ -0,0 +1,31 @@
|
||||
---
|
||||
title: 업데이트
|
||||
description: 데스크톱, 웹, VS Code에서 OpenChamber를 최신 상태로 유지하세요.
|
||||
---
|
||||
|
||||
# 업데이트
|
||||
|
||||
OpenChamber를 업데이트하는 방법은 설치 방식에 따라 다릅니다. 어떤 경우든 **Settings → OpenChamber → About**에서 현재 버전을 확인할 수 있습니다.
|
||||
|
||||
## 데스크톱 앱
|
||||
|
||||
데스크톱 앱은 GitHub 릴리스를 기준으로 업데이트를 확인합니다. 업데이트가 있으면 OpenChamber가 알려주고, 선택하면 다운로드한 뒤 다음 재시작 때 설치합니다. 항상 사용자가 제어하며, 동의 없이는 아무것도 설치되지 않습니다.
|
||||
|
||||
## 웹 / CLI
|
||||
|
||||
CLI를 설치했다면 **About**의 확인 및 업데이트 버튼으로 업데이트하거나, 터미널에서 업데이트합니다.
|
||||
|
||||
```bash
|
||||
openchamber update
|
||||
```
|
||||
|
||||
OpenChamber는 설치 방식(npm, pnpm, yarn 또는 bun)을 감지하여 알맞은 업데이트를 실행합니다.
|
||||
|
||||
## OpenCode 서버
|
||||
|
||||
OpenChamber와 OpenCode는 별도로 업데이트됩니다. 새 OpenCode 버전이 있으면 OpenChamber가 업데이트를 제안하고, 이후 서버를 재시작합니다. 그 서버가 관리되는 방식은 [OpenCode Server](/ko/opencode-server/)를 참고하세요.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Install](/ko/install/) — 각 앱이 처음에 설치되는 방법
|
||||
- [OpenCode Server](/ko/opencode-server/) — 기반 서버 업데이트
|
||||
@@ -0,0 +1,28 @@
|
||||
---
|
||||
title: 사용량 및 할당량
|
||||
description: 공급자 요금제를 얼마나 사용했는지 추적하세요.
|
||||
---
|
||||
|
||||
# 사용량 및 할당량
|
||||
|
||||
Usage 페이지는 각 공급자 요금제를 얼마나 사용했는지 보여주므로 한도에 얼마나 가까운지 확인할 수 있습니다. **Settings → Usage**에서 엽니다.
|
||||
|
||||
## 표시되는 내용
|
||||
|
||||
연결된 각 공급자에 대해 OpenChamber는 다음을 표시합니다.
|
||||
|
||||
- 현재 기간 동안 사용한 양을 막대로 표시
|
||||
- 모델별 분석
|
||||
- 한도에 도달할 추세인지 알 수 있는 사용 속도 지표
|
||||
|
||||
어떤 공급자를 표시할지 선택할 수 있으며, 동일한 요약은 앱 헤더의 드롭다운에서도 확인할 수 있습니다.
|
||||
|
||||
## 지원되는 공급자
|
||||
|
||||
Usage는 Claude, Codex, GitHub Copilot, Google, OpenRouter, Kimi, NanoGPT, z.ai, Zhipu, MiniMax, Ollama Cloud, Wafer를 포함해 할당량을 공개하는 공급자에서 작동합니다.
|
||||
|
||||
공급자는 [Providers](/ko/providers/) 페이지에서 로그인한 뒤에만 사용량을 표시합니다. 일부 공급자는 추가 단계가 필요합니다. 예를 들어 Ollama Cloud는 별도로 설정한 세션 파일을 읽습니다. 공급자에 데이터가 표시되지 않는다면 대개 그 추가 자격 증명이 누락된 것입니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Providers, Models & Agents](/ko/providers/) — 사용량이 표시되기 전에 로그인하세요
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
title: 음성 모드
|
||||
description: OpenChamber에 말하고 응답을 소리내어 들으세요.
|
||||
---
|
||||
|
||||
# 음성 모드
|
||||
|
||||
음성 모드를 사용하면 메시지를 받아쓰게 하고 응답을 소리내어 들을 수 있습니다. **Settings → OpenChamber → Voice**에서 켭니다.
|
||||
|
||||
## 응답을 소리내어 읽기(text-to-speech)
|
||||
|
||||
응답을 읽는 방식을 선택합니다.
|
||||
|
||||
- **browser** — 브라우저의 내장 음성, 설정 불필요
|
||||
- **OpenAI** — OpenAI의 음성. API 키를 붙여넣고 음성을 선택합니다
|
||||
- **OpenAI-compatible** — OpenAI 형식을 지원하는 모든 서비스. URL과, 필요하다면 API 키를 입력합니다
|
||||
- **macOS say** — 내장 `say` 명령. 이를 지원하는 Mac에서 사용 가능
|
||||
|
||||
켜면 메시지에 재생 버튼이 생겨 소리내어 들을 수 있습니다.
|
||||
|
||||
## 메시지 받아쓰기(speech-to-text)
|
||||
|
||||
음성을 텍스트로 변환하는 방식을 선택합니다.
|
||||
|
||||
- **browser** — 브라우저의 내장 인식, 설정 불필요
|
||||
- **server** — OpenAI 호환 변환 서비스. URL과, 필요하다면 API 키를 입력합니다
|
||||
- **on-device** — 브라우저에서 실행되며 처음 사용할 때 다운로드되는 음성 모델
|
||||
|
||||
## 휴대폰 관련 참고 사항
|
||||
|
||||
휴대폰에서 응답을 소리내어 읽을 때는 OpenAI 또는 OpenAI-compatible 옵션이 가장 안정적입니다. 모바일 브라우저는 내장 음성을 제한합니다.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Notifications](/ko/notifications/) — 듣는 대신 알림을 받으세요
|
||||
- [Providers, Models & Agents](/ko/providers/) — OpenAI 키가 이미 저장되어 있을 수 있는 곳
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
title: Worktree 세션
|
||||
description: 세션에 자체 브랜치와 폴더를 부여하여 작업을 격리하세요.
|
||||
---
|
||||
|
||||
# Worktree 세션
|
||||
|
||||
worktree 세션은 자체 브랜치 위에서 체크아웃된 저장소 사본으로 실행됩니다(git worktree). 그래서 병렬 세션이 서로의 파일을 건드리지 않으며, 한 세션이 리팩터링하는 동안 다른 세션이 버그를 고칠 수 있고 오갈 필요가 없습니다.
|
||||
|
||||
## 만들기
|
||||
|
||||
1. 세션 사이드바 상단의 버튼에서 새 worktree 대화 상자를 엽니다.
|
||||
2. 시작 지점을 선택합니다.
|
||||
- **new branch** — 브랜치 이름을 지정하고 어느 브랜치에서 시작할지 선택합니다
|
||||
- **existing branch** — 이미 가지고 있는 브랜치를 체크아웃합니다
|
||||
3. worktree 폴더를 확인합니다(OpenChamber가 브랜치 이름에서 하나를 제안합니다).
|
||||
4. 만듭니다.
|
||||
|
||||
OpenChamber가 브랜치를 만들고 폴더를 설정한 뒤 그 안에서 세션을 시작합니다. [할 일](/ko/notes-todos-plans/)이나 [GitHub 이슈 또는 PR](/ko/github/)에서 바로 시작할 수도 있습니다.
|
||||
|
||||
## 작업 되돌려 가져오기
|
||||
|
||||
작업이 만족스러우면 Git 보기에서 **Integrate**를 사용해 worktree의 커밋을 다른 브랜치(예: `main`)로 가져옵니다. 변경 사항이 충돌하면 충돌을 에이전트에게 넘겨 해결하게 할 수 있습니다.
|
||||
|
||||
## 정리하기
|
||||
|
||||
세션을 삭제하거나 보관하면 worktree를 제거할 수 있습니다. 로컬 브랜치와, 있다면 원격 브랜치까지 함께 삭제할지 선택합니다. 요청하지 않으면 아무것도 삭제되지 않습니다.
|
||||
|
||||
## 무언가 잘못된 것처럼 보이면
|
||||
|
||||
worktree는 폴더가 사라졌거나, 브랜치가 detached 상태이거나, 병합 또는 리베이스가 절반만 끝난 경우 주의가 필요할 수 있습니다. OpenChamber가 이를 표시하여 고칠 수 있게 합니다. [Worktrees & Git](/ko/troubleshooting/worktrees-git/)을 참고하세요.
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- [Multi-run](/ko/multi-run/) — 여러 worktree 세션을 한 번에 시작하세요
|
||||
- [Git & GitHub Workflows](/ko/git/) — OpenChamber 안에서 커밋하고 통합하세요
|
||||
Reference in New Issue
Block a user