설정 참조
설정 화면, 설정 파일 위치, 앱이 고정하는 엔진 설정, 환경 변수를 정리합니다.
설정 화면
프로필 메뉴 > 설정에서 엽니다. 메뉴는 권한에 따라 다르게 보입니다.
| 메뉴 | 내용 | 문서 |
|---|---|---|
| 사용량 | 플랜, 토큰, 이용 내역 | 모델과 사용량 |
| 모델 설정 | 기관의 모델 활성화 | 기관 관리자 가이드 |
| 구성원 관리 | 구성원별 토큰 한도 | 기관 관리자 가이드 |
| MCP 환경설정 | MCP 서버 | MCP |
사이드바 프로필 메뉴에는 설정, 기관 변경(데스크톱), 로그아웃(데스크톱)이 있습니다.
파일 위치
| 항목 | 데스크톱 | 런박스 |
|---|---|---|
| 앱 데이터 폴더 | OS별 사용자 데이터 폴더의 <제품명>/ (HelpyCode) | ~/.helpycode/ |
| 작업 루트(임시 대화 포함) | 문서/HelpyCode/ (임시 대화: chats/ 아래) | ~/HelpyCode/ |
엔진 설정 폴더(configDir) | <앱 데이터 폴더>/opencode/ | ~/.helpycode/opencode/ |
| 엔진 설정 파일 | <configDir>/config/opencode/opencode.json | 같음 |
| 전역 지침 | <configDir>/config/opencode/AGENTS.md | 같음 |
| 전역 서브에이전트 | <configDir>/config/opencode/agents/ | 같음 |
| 전역 스킬 | <configDir>/config/opencode/skills/ | 같음 |
| 엔진 데이터(세션, 승인 기록) | <configDir>/data/ | 같음 |
| 첨부 파일 | <앱 데이터 폴더>/attachments/ | ~/.helpycode/attachments/ |
| 프로젝트 목록 | <앱 데이터 폴더>/projects.json | ~/.helpycode/projects.json |
| 로그인 세션 | account.bin(암호화) | ~/.helpycode/account-session.json |
note
헬피코드는 엔진의 XDG_CONFIG_HOME, XDG_DATA_HOME, XDG_STATE_HOME, XDG_CACHE_HOME을 위 폴더 아래로 옮겨서 실행합니다. 그래서 일반 opencode의 ~/.config/opencode와 별개입니다.
앱이 고정하는 엔진 설정
앱은 엔진을 시작할 때 다음 설정을 주입합니다. 계정 로그인 모드에서는 환경 변수(OPENCODE_CONFIG_CONTENT) 로 주입되어 프로젝트의 opencode.json보다 우선하며, 이 설정을 프로젝트 파일로 바꿀 수 없습니다.
| 설정 | 값 | 이유 |
|---|---|---|
autoupdate | false | 앱이 엔진 버전을 관리합니다. |
share | disabled | 대화를 외부로 공유하지 않습니다. |
skills.paths | ~/.config/opencode/skills | 사용자 스킬 폴더 |
instructions | <configDir>/instructions.md | MCP 설정 안내 |
permission.present_files | allow | 파일 카드는 묻지 않음 |
permission.external_directory | 첨부 폴더 allow | 첨부 파일은 권한 카드 없이 읽음 |
엔진 프로세스에는 다음 환경 변수가 설정됩니다: OPENCODE_DISABLE_AUTOUPDATE=1, OPENCODE_DISABLE_CLAUDE_CODE_PROMPT=1(CLAUDE.md를 읽지 않음).
사용자가 opencode.json으로 바꿀 수 있는 것
| 항목 | 설명 | 문서 |
|---|---|---|
mcp | MCP 서버 | MCP |
permission | 도구별 허용/확인/거부 | 권한 |
agent | 에이전트 정의·덮어쓰기 | 서브에이전트 |
command | 사용자 정의 슬래시 명령 | 슬래시 명령 |
subagent_depth | 서브에이전트 중첩 한도(기본 1) | 서브에이전트 |
default_agent | 기본 에이전트 |
warning
opencode.json 수정은 AI가 하더라도 보호 파일이라 확인 패널이 뜹니다. 잘못된 설정은 엔진이 시작하지 못하게 할 수 있으니, 수정 후 앱을 재시작해 확인하세요.