dsh 설정 위치와 DeepSeek·Ollama 연결 방법
dsh의 실제 설정 경로인 ~/.dsh와 release 0.2.0-rc.2의 settings.yaml.imported 변경점을 확인하고, DeepSeek API key와 로컬 Ollama endpoint별로 외부로 전송되는 범위를 설명합니다.
dsh의 설정 저장 위치
dsh(DeepSeek Harness)는 하네스 데이터를 $DSH_HOME에 보관하며, 기본값은 ~/.dsh입니다. 또한 공유 에이전트 설정은 별도의 루트인 $DSH_AGENTS_HOME에서 읽어오며, 기본값은 ~/.agents입니다. 웹 UI에서 설정한 모든 내용은 해당 경로에 일반 파일 형태로 기록됩니다. 설정을 다른 서버로 옮길 때는 하네스 홈 디렉터리와 공유 에이전트 루트에 있는 모든 전역 지침 및 스킬을 함께 복사하십시오.
주요 하네스 설정, 비밀 정보, 세션 로그는 다음 네 가지 경로에 저장됩니다.
~/.dsh/profiles/<profile>/cordis.patch.yml에는 해당 프로필에 대해 웹 UI가 기록한 설정이 포함되며, 여기에는 공급자 및 모델 경로가 포함됩니다.dsh web은web프로필을 실행하므로, 관련 파일은~/.dsh/profiles/web/cordis.patch.yml입니다.~/.dsh/.credentials.yaml에는 비밀 정보가 저장됩니다. 설정 파일에는 자격 증명에 대한 참조만 유지되므로, 실제 키 값은 별도의 파일에 존재합니다.~/.dsh/profiles/에는 명명된 프로필이 저장되며,~/.dsh/sessions/에는 저장된 세션 로그가 보관됩니다.~/.dsh/cordis.patch.yml은 사용자가 정의한 패치 레이어입니다. 이 레이어는 모든 프로필의 내장 설정 위에 적용되며 프로필 파일보다 우선순위가 높습니다. 따라서 이 레이어에서 재정의되는 항목을 웹 UI에서 수정하려고 하면 저장이 거부됩니다.
공유 에이전트 루트는 다른 에이전트 도구와 공유되므로 $DSH_HOME 외부에 위치합니다. dsh는 ~/.agents/AGENTS.md에서 사용자 전역 지침을 읽고 ~/.agents/skills/에서 스킬을 검색합니다. 해당 루트를 옮기려면 DSH_AGENTS_HOME을 설정하십시오.
이전 빌드에서는 이러한 설정을 ~/.dsh/settings.yaml에 보관했습니다. 현재 빌드에서는 해당 파일을 활성 프로필로 한 번 가져온 뒤 settings.yaml.imported로 이름을 변경합니다. 따라서 settings.yaml을 수정하라고 안내하는 구형 가이드는 현재 dsh가 더 이상 읽지 않는 파일을 가리키고 있는 것입니다.
DeepSeek는 이 하네스를 MIT 라이선스 기반의 개발자 프리뷰로 배포하며, README에는 호환성이 깨지는 변경 사항이 발생할 수 있다고 명시되어 있습니다. 이 가이드의 필드 이름과 경로는 2026년 11월 5일 기준으로 확인된 현재 저장소 문서와 일치합니다. 프리뷰 버전은 릴리스마다 명칭이 변경될 수 있으므로, 본 가이드를 포함한 어떤 가이드의 설정을 복사하기 전에도 반드시 설치된 버전의 문서와 대조하여 확인하십시오.
최초 실행을 위한 최소한의 조건
dsh는 Node.js 24.9 이상이 필요합니다. 2026년 11월 5일 기준으로 package.json은 >=24.9.0를 명시하고 있으므로, 22 버전은 지원되지 않습니다. Node 24.0에서 24.8 사이 버전도 충분하지 않습니다. 버전 불일치는 시작 시 실패를 유발하며 오류 메시지가 패키지 손상처럼 보일 수 있으므로, 반드시 버전을 먼저 확인하십시오.
node -v
npx @deepseek-ai/dsh webnpx는 npm 레지스트리에서 패키지를 다운로드하고 http://127.0.0.1:3080에서 웹 UI를 시작합니다. 이 프로세스는 루프백 주소에 바인딩되므로, 방화벽에서 허용하더라도 다른 머신에서는 해당 포트에 접근할 수 없습니다. VPS를 사용하는 경우, 3080 포트를 인터넷에 개방하는 대신 SSH를 통해 포트 포워딩을 수행하십시오. 출력된 URL이 혼란스럽다면 dsh가 해당 주소에서 시작되는 이유를 참조하여 루프백 바인딩이 보호하는 범위와 그렇지 않은 범위를 확인하십시오.
ssh -N -L 3080:127.0.0.1:3080 you@your-server노트북에서 http://127.0.0.1:3080을 열고 Settings 및 Models로 이동합니다. DeepSeek 카드에는 API 키 입력 필드가 하나 있습니다. platform.deepseek.com에서 발급받은 키를 붙여넣고 저장합니다. 실행 중인 서버가 자격 증명을 저장하고 실시간으로 참조를 해결하므로, 서버를 재시작할 필요 없이 즉시 모델 경로를 사용할 수 있습니다. 원격 서버의 dsh 웹 UI에 접속하기에서는 터널링 및 리버스 프록시 설정을 다루며, VPS에 DeepSeek Harness 설치하기에서는 이 가이드가 전제로 하는 서버 준비 과정을 설명합니다.
저장 후 앱이 생성한 항목을 확인하십시오.
ls -la ~/.dsh
stat -c '%a %n' ~/.dsh/.credentials.yaml.credentials.yaml 및 profiles/가 생성되어야 하며, 웹 UI 설정은 profiles/web/cordis.patch.yml에 저장됩니다. 이전 빌드에서 생성된 홈 디렉터리에는 settings.yaml.imported이 포함되어 있을 수도 있습니다. stat가 600 이외의 모드를 출력한다면 chmod 600 ~/.dsh/.credentials.yaml를 실행하십시오. 그룹 읽기 권한이 있는 자격 증명 파일은 해당 그룹의 계정에 키를 노출하며, 전체 읽기 권한이 있는 파일은 서버의 모든 계정에 키를 노출합니다.
브라우저 없이 처음 실행할 때는 다음 명령 하나면 충분합니다.
npx @deepseek-ai/dsh --profile headless "summarise the files in this directory"헤드리스 프로필은 단일 세션을 실행하고 최종 답변을 출력합니다.
환경 변수 또는 설정 파일
dsh는 저장된 자격 증명이나 환경 변수 대체 값을 통해 키를 해석할 수 있습니다.
카탈로그 제공자(DeepSeek, Anthropic, OpenAI 및 기타 내장 목록)는 Models 페이지를 통해 키를 입력받거나, 저장된 자격 증명이 없을 경우 지원되는 환경 변수 대체 값을 사용합니다. 값은 ~/.dsh/.credentials.yaml에 저장되며, 설정에는 해당 값을 참조하는 정보만 유지됩니다. Web UI는 키를 저장한 후에는 다시 표시하지 않습니다.
사용자 지정 제공자는 apiKeyEnv를 사용하여 자격 증명 참조를 지정할 수 있으며, 이 또한 환경 변수 대체 값을 지원합니다. 이는 ~/.dsh/profiles/web/cordis.patch.yml과 같은 프로필 패치 항목에 대해 문서에서 제시하는 형식입니다.
- id: llm-pi-ai
config:
providers:
my-gateway:
apiKeyEnv: GATEWAY_API_KEY
api: openai-completions
baseURL: https://gateway.example/v1
models:
- id: legacy-chat
- id: vision-preview
input: [text, image]먼저 Web UI를 통해 제공자를 하나 추가한 다음, 프로필의 cordis.patch.yml을 열어 기록된 구조를 복사하십시오. 개발자 프리뷰 단계에서는 중첩 구조가 가장 자주 변경될 수 있으며, 애플리케이션이 방금 작성한 파일이 항상 최신 상태입니다.
apiKeyEnv은 자격 증명 저장소를 통해 해석됩니다. 저장된 파일이 우선순위를 가지며, 그 다음으로 실행 환경, 호출 디렉터리의 .env, 마지막으로 $DSH_HOME/.env 순으로 확인합니다. 대화형 세션에서만 export된 키는 systemd 유닛에서 볼 수 없으므로, 다른 자격 증명 소스가 없다면 수동으로 dsh web을 입력할 때 작동하던 설정이 서비스 환경에서는 MISSING_CREDENTIAL를 반환하게 됩니다. 유닛에 별도의 파일을 제공하십시오.
[Service]
EnvironmentFile=/etc/dsh/dsh.env해당 파일은 서비스가 실행되는 사용자의 소유로 설정하고 모드를 600으로 유지하십시오.
모델 선택 및 변경할 수 없는 ID
설정된 모든 공급자는 모델 선택기(model picker)에 표시됩니다. 모델을 선택하면 해당 모델이 새 세션의 기본값으로 설정됩니다. 이미 요청을 보낸 세션은 해당 모델을 기록으로 유지하므로, 모델을 전환해도 이전 대화 내용이 다시 작성되지는 않습니다.
공급자 ID는 영구적입니다. 요청, 저장된 세션, 모델 기본값 및 자격 증명 참조가 모두 이 ID를 가리키므로 이름 변경 버튼은 존재하지 않습니다. ID를 변경하려면 새 공급자를 생성하고 기존 공급자를 삭제해야 합니다. local-ollama와 같이 나중에 변경할 필요가 없는 이름을 선택하십시오. test2은 권장하지 않습니다.
상속된 이미지 기능이 없는 사용자 지정 모델은 별도로 선언하지 않는 한 텍스트 전용으로 작동합니다. 모델 항목에 input: [text, image]을 추가하여 이미지 지원을 선언하거나, 카탈로그에 설명되지 않은 모델을 위한 대체 설정으로 경로 수준에서 defaultInput을 설정하십시오. DeepSeek 자체 경로에서 모달리티(modality)가 선언되지 않은 모델은 텍스트 전용으로 간주되므로, 이미지를 첨부하기 전에 이미지 지원이 가능한 카탈로그 항목(기본값 deepseek-flash)을 선택하십시오. 이미지 지원을 선언하지 않은 모델에 이미지를 전송하면 전송이 시작되기 전에 요청이 거부됩니다.
dsh를 로컬 엔드포인트로 지정하여 코드를 서버 내부에 유지하기
Ollama는 http://127.0.0.1:11434/v1에서 OpenAI 호환 API를 제공합니다. dsh는 사용자 지정 공급자를 통해 모든 OpenAI 호환 기본 URL과 통신하므로, 두 서비스는 중간 매개체 없이 직접 연결됩니다. 먼저 모델 서버를 설정하십시오. Ollama를 사용하여 VPS에 LLM 자체 호스팅하기 문서에서 설치 및 모델 다운로드 방법을 다룹니다.
dsh를 설정하기 전에 엔드포인트가 응답하는지 확인하십시오.
ollama list
curl -s http://127.0.0.1:11434/v1/modelsollama list는 다운로드한 모든 모델의 정확한 태그를 출력합니다. 해당 문자열을 복사하십시오. curl은 동일한 모델 목록을 JSON 형식으로 반환합니다. 빈 목록이 출력된다면 Ollama가 실행 중이지만 다운로드된 모델이 없다는 의미입니다. Connection refused이 출력된다면 Ollama가 실행 중이지 않거나 11434 포트에서 대기하고 있지 않은 것입니다.
이 장비에서 실행 가능한 모델을 선택하십시오. 로그인된 Ollama 서버는 동일한 로컬 주소를 통해 클라우드 모델도 제공합니다. gemma4:cloud와 같은 클라우드 태그는 Ollama 서버에서 실행되므로, dsh가 127.0.0.1하고만 통신하더라도 프롬프트는 서버 외부로 전송됩니다.
이제 프로필 패치에 공급자를 추가하십시오. 이 설정에는 비어 있지 않은 API 키 값을 입력해야 합니다. 로컬 Ollama 서버는 이 값을 무시합니다.
- id: llm-pi-ai
config:
providers:
local-ollama:
apiKeyEnv: OLLAMA_API_KEY
api: openai-completions
baseURL: http://127.0.0.1:11434/v1
models:
- id: <the exact tag printed by ollama list>dsh 프로세스가 인식할 수 있도록 변수를 내보내십시오.
sudo install -d -m 700 /etc/dsh
printf 'OLLAMA_API_KEY=ollama\n' | sudo tee /etc/dsh/dsh.env
sudo chmod 600 /etc/dsh/dsh.env이 과정에서 발생하는 대부분의 오류는 다음 세 가지 경우에 해당합니다. MISSING_CREDENTIAL는 apiKeyEnv가 참조하는 값이 없음을 의미하므로, 터미널뿐만 아니라 저장된 자격 증명과 실행 환경을 확인하십시오. UNKNOWN_MODEL은 id이 구성된 모델과 일치하지 않음을 의미하므로, 콜론 뒤의 태그를 포함하여 ollama list과 한 글자씩 비교하십시오. 사용 가능한 모델을 가져오는 도중 발생하는 401 오류는 모델 검색 과정에서 발생하며, 이는 기본 URL에서 GET /models를 호출합니다. 해당 경로를 제공하지 않는 엔드포인트의 경우 모델 이름을 직접 입력해야 합니다.
또 다른 주의 사항은 기본 URL입니다. /v1을 생략하면 요청이 Ollama가 제공하지 않는 경로로 전달되어 404 오류가 발생하고 모델이 실행되지 않습니다. 해당 접미사는 OpenAI 호환 인터페이스의 일부이며 단순한 장식이 아닙니다.
Ollama가 다른 장비에서 실행 중이라면 해당 장비의 주소가 기본 URL이 되며, 프롬프트는 일반 HTTP를 통해 평문으로 네트워크를 통과하게 됩니다. 동일한 호스트에서 실행하거나 TLS(전송 계층 보안) 및 인증을 적용하십시오. 노출된 Ollama 엔드포인트 보안 강화하기를 참조하십시오.
각 모드에서 외부로 전송되는 데이터
DeepSeek 키와 기본 엔드포인트를 사용하면 모델 요청은 DeepSeek의 API로 전송됩니다. 해당 요청에는 프롬프트, 에이전트가 답변을 위해 읽은 파일 내용, 실행한 명령의 출력, 그리고 에이전트가 포함하기로 선택한 도구 결과가 포함됩니다. 에이전트가 파일을 열 때마다 소스 코드가 해당 페이로드에 포함됩니다. 이것이 호스팅된 모델의 작동 방식이며, 에이전트를 시작할 디렉터리를 신중하게 선택해야 하는 이유입니다.
현재 릴리스는 기본적으로 구성된 게이트웨이를 포함하여 네이티브 DeepSeek 어댑터를 통한 요청에 세션 이벤트 로그의 미전송 접미사를 별도의 dsh_session_log 필드로 첨부합니다. 모델은 이를 볼 수 없지만 요청 대상은 이를 수신합니다. 설정(Settings)의 일반(General) 메뉴에서 "Upload Session Log when using the official model API"를 끄거나 session-log-deepseek 플러그인에 enabled: false을 설정하십시오. 아래의 텔레메트리 스위치는 이 업로드를 제어하지 않습니다.
제공된 프로필은 활성 플러그인 패키지 이름과 버전을 별도의 dsh_plugin_packages 필드로 네이티브 DeepSeek 어댑터를 통해 전송합니다. 이 전송을 중단하려면 plugin-package-inventory-deepseek에 enabled: false를 설정하십시오.
다른 카탈로그 제공업체나 회사 게이트웨이를 사용하는 경우, 동일한 페이로드가 해당 공급업체로 전송됩니다. 기본 URL을 통해 정확한 전송 위치를 확인할 수 있습니다.
로컬 엔드포인트를 사용하면 모델 요청은 127.0.0.1:11434으로 전송되지만, 루프백 주소만으로는 데이터가 외부로 나가지 않는다고 보장할 수 없습니다. Ollama 문서에 따르면 "이 서버를 통해 클라우드 모델을 사용하려면 Ollama에 로그인하십시오"라고 명시되어 있으므로, 동일한 로컬 서버를 통해 선택된 클라우드 모델은 프롬프트와 코드를 Ollama 클라우드로 전송합니다. 모델 자체가 로컬에서 실행될 때만 모델 요청이 기기 내부에 머무릅니다. 그럼에도 불구하고 세 가지 요소는 여전히 네트워크를 통과합니다. npx은 npm 레지스트리에서 패키지를 다운로드합니다. 에이전트가 실행하는 모든 도구는 연결된 MCP(Model Context Protocol) 서버를 포함하여 자체적으로 인터넷에 연결할 수 있으며, 이에 대한 자세한 내용은 VPS에서 MCP 서버 실행하기에서 다룹니다. 플러그인도 같은 범주에 속합니다. 플러그인을 설치하면 에이전트의 권한으로 다른 작성자의 코드가 실행되므로 설치 전 플러그인의 접근 권한 확인하기를 수행하는 것이 좋습니다. 또한 텔레메트리는 로컬 모델을 사용할 때도 호스팅 모델과 동일하게 피드백을 제출할 때마다 DeepSeek으로 내보내도록 현재 릴리스에서 승인되어 있습니다.
텔레메트리는 기본적으로 피드백으로 제한됩니다. DSH_TELEMETRY_MODE이 모드를 선택하며, 현재 제공되는 기본 구성에서 값이 설정되지 않았거나 비어 있으면 FEEDBACK_ONLY로 결정됩니다. 이 모드에서는 일반적인 활동으로 텔레메트리가 수집되지 않습니다. 서면 피드백을 제출하거나, 평가를 생성/수정하거나, 메모를 편집하거나, 피드백을 철회할 때 dsh는 아직 내보내기 도구로 전달되지 않은 세션 로그 접두사를 해당 피드백 이벤트와 함께 상속된 컨텍스트를 포함하여 https://dsh-otel-collector.deepseeksvc.com/v1/logs으로 내보내도록 승인합니다. 전체 전달이 보장되지는 않습니다. 이벤트가 너무 크면 잘리지 않고 거부되며, 큰 접두사는 CLI 종료 시 부분적으로 전송되지 않은 상태로 남을 수 있습니다. 승인된 배치는 추가 상호 작용이나 모델 호출 없이 계속 전송될 수 있습니다. 텔레메트리 README에 따르면 이는 "모든 사용자 및 제공업체"에 적용되므로 로컬에서 모델을 실행한다고 해서 텔레메트리가 꺼지지 않습니다. DISABLED은 OpenTelemetry(OTel) 전송을 전혀 구성하지 않습니다. FULL는 더 이상 허용되지 않으며, 이 두 값 외의 다른 값은 unsupported mode과 함께 거부됩니다. 피드백 내보내기에는 메시지 텍스트, 도구 인수 및 결과, 작업 공간 경로가 포함될 수 있으므로 피드백 제출은 해당 세션 접두사를 DeepSeek으로 전송하는 것을 승인하는 것으로 간주하십시오.
모드 문자열을 정확히 설정하는 것에 의존하지 않는 확실한 차단을 원한다면 DSH_TELEMETRY_DISABLED=1를 설정하십시오. 비어 있지 않은 모든 값은 0 및 false을 포함하여 권한 있는 옵트아웃으로 간주됩니다. 이 설정은 실행 시작 전에 읽히므로 프로젝트 코드가 세션 중간에 이를 다시 켤 수 없습니다. 기본 수집기 주소는 dsh-otel-collector.deepseeksvc.com이며, DSH_TELEMETRY_OTLP_URL로 이를 재정의할 수 있습니다.
설정을 신뢰하는 대신 직접 확인하십시오. 작업이 실행 중일 때 프로세스가 유지하고 있는 아웃바운드 연결을 나열하십시오.
sudo ss -tnp | grep -i node로컬에서 모델을 실행할 때 모델 트래픽은 루프백 포트 11434를 사용하지만, 피드백을 제출하지 않아도 도구에서 공용 연결이 발생할 수 있습니다. 제공된 프로필에는 웹 검색 및 가져오기 기능이 포함되어 있으며, 기본 권한 사전 설정은 네트워크 액세스를 제한하지 않습니다. 연결을 텔레메트리로 간주하기 전에 각 공용 대상을 식별하십시오. 시간 정보만으로는 해당 연결이 피드백 내보내기인지 확인할 수 없습니다. 이 스냅샷은 수명이 짧은 연결을 놓칠 수도 있습니다. 이 확인은 dsh 프로세스만 다룹니다. 클라우드 모델의 트래픽은 Ollama 서버에서 나가므로 모델 id가 클라우드 태그인지도 함께 확인하십시오. 다른 모든 연결은 계속하기 전에 식별할 가치가 있습니다. 코딩 에이전트가 외부로 전송하는 데이터에서는 다른 하네스에 대해 동일한 확인을 수행하고 결과를 읽는 방법을 설명합니다.
시크릿을 저장하면 안 되는 위치
- 셸 기록.
export DEEPSEEK_API_KEY=sk-...은~/.bash_history에 평문으로 기록되며, 키를 교체한 뒤에도 오랫동안 남는다.HISTCONTROL=ignorespace가 설정되어 있다면 명령 앞에 공백을 넣는다. 또는 셸을 거치지 않고 값을 mode 600인 파일에 직접 기록한다. - 커밋된 dotfile. dotfile을 git으로 관리한다면
~/.bashrc또는~/.zshrc에 있는 키는git add만 거치면 public repository에 노출될 수 있다. push하기 전에 해당 repository에서git grep -I -n 'sk-'를 실행한다. - 프로필 patch 파일. 사용자 지정 provider에는
apiKeyEnv을 사용하여cordis.patch.yml에 시크릿 대신 변수 이름이 저장되게 한다. 설정 파일은 issue report와 support chat에 복사해 붙이는 경우가 많다. credentials 파일은 그렇게 사용하지 않는다. env의 출력과 터미널 스크린샷. 전체 환경을 출력하는 명령은 키도 함께 출력한다.- 백업.
~/.dsh은 백업할 가치가 있지만, 그 안의.credentials.yaml는 현재 사용 중인 시크릿이다. 해당 파일을 제외하거나 archive를 암호화한다.
이 규칙은 dsh에만 적용되지 않는다. Compose env 파일에서 시크릿을 제외하는 방법에서는 같은 서버의 컨테이너 측면에서 동일한 문제를 다룬다.
개발자 프리뷰 버전 운영
프리뷰 버전은 패치 릴리스에서도 설정 키가 변경될 수 있으며, 그러면 provider가 로드되지 않을 수 있으므로 테스트한 버전을 고정해야 한다. 버전을 고정해 설치한 뒤에도 시작되지 않거나 npx가 요청하지 않은 빌드를 계속 제공한다면, 프리뷰에서 발생하는 설치 및 버전 오류에서 npx 캐시와 Node에 포함된 npm을 다룬다. 자격 증명 파일은 제외하고 홈 cordis.patch.yml와 profiles/ 아래의 패치 파일을 버전 관리에 포함해야 한다. 그러면 업그레이드 후 변경된 내용을 확인할 수 있다.
프로필이 예상대로 동작하지 않을 때 유용한 플래그가 2개 있다. --dump-default-config은 시작하지 않고 조합된 기본 설정을 출력하며, --dump-config는 같은 방식으로 프로필에 대한 조합된 설정을 출력한다. 두 결과를 비교하면 패치 계층에서 실제로 변경한 내용을 확인할 수 있다. 계층을 직접 읽는 것보다 빠르다.
dsh --profile web --dump-config업그레이드 후 문제가 발생하면 먼저 이를 실행한다. 릴리스 사이에 이동한 키는 덤프에서 누락된 분기로 나타난다. 이 경우 재설치하지 않고 한 줄만 수정하면 된다.
FAQ
dsh는 DeepSeek API 키를 어디에 저장합니까?
DSH_HOME를 직접 설정하지 않았다면 ~/.dsh/.credentials.yaml인 $DSH_HOME/.credentials.yaml에 저장됩니다. 모델 페이지에서 키를 작성하면 해당 파일에 저장되며, 설정에는 참조값만 유지되므로 비밀 정보는 하나의 파일에만 존재합니다. stat -c '%a %n' ~/.dsh/.credentials.yaml으로 권한 모드를 확인하고, 600보다 느슨하다면 600으로 설정하십시오. 사용자 지정 공급자를 사용하면 apiKeyEnv로 환경 변수를 지정하여 파일 사용을 완전히 피할 수 있습니다.
DeepSeek API 대신 로컬 모델을 사용하려면 어떻게 합니까?
기본 URL이 로컬 OpenAI 호환 엔드포인트인 사용자 지정 공급자를 추가하십시오. Ollama의 경우 http://127.0.0.1:11434/v1를 사용하며, api: openai-completions과 ollama list에서 정확히 복사한 모델 id을 사용합니다. 이 설정에는 비어 있지 않은 API 키 값을 입력하십시오. 로컬 Ollama 서버는 이를 무시합니다. 엔드포인트가 죽어 있는 경우와 설정이 잘못된 경우 발생하는 오류가 비슷하므로, dsh 설정을 수정하기 전에 curl -s http://127.0.0.1:11434/v1/models로 엔드포인트 응답을 먼저 확인하십시오.
dsh는 기본적으로 내 코드를 외부로 전송합니까?
호스팅 모델을 사용하는 경우 그렇습니다. 프롬프트와 에이전트가 읽은 파일 내용은 해당 공급업체로 보내는 API 요청에 포함됩니다. 기본 DeepSeek 어댑터를 통한 요청(설정된 게이트웨이 포함)도 설정의 일반(General) 메뉴에서 업로드를 끄기 전까지는 기본적으로 세션 로그 접미사가 포함됩니다. Ollama로 로컬에서 실행하는 모델의 경우 요청은 루프백으로 전달되어 기기에 머물지만, gemma4:cloud과 같은 클라우드 모델은 동일한 루프백 주소를 통해 Ollama 클라우드로 전달합니다. 내장된 웹 검색, 가져오기, 기타 도구 및 플러그인은 피드백과 별개로 공용 서비스에 접속할 수 있습니다. 텔레메트리는 별도의 피드입니다. 현재 릴리스에서 DSH_TELEMETRY_MODE이 설정되지 않으면 FEEDBACK_ONLY로 해석되므로, 피드백은 로컬 모델을 포함한 모든 공급자에 대해 상속된 컨텍스트를 포함하여 해당 이벤트를 통해 세션 로그 접두사의 내보내기를 승인합니다. 전송이 보장되지는 않으며, 승인된 업로드는 피드백 상호작용 이후에도 계속될 수 있습니다. 내보내기를 하지 않으려면 DISABLED으로 설정하거나, 실행 시작 전에 읽히는 옵트아웃(opt-out)을 위해 DSH_TELEMETRY_DISABLED=1로 설정하십시오.
변수가 설정되어 있는데도 dsh가 MISSING_CREDENTIAL을 보고하는 이유는 무엇입니까?
apiKeyEnv가 가리키는 참조가 dsh의 자격 증명 소스에서 확인되어야 하기 때문입니다. 저장된 자격 증명이 실행 환경보다 우선하며, 그 다음으로 호출 디렉터리의 .env 및 $DSH_HOME/.env 순으로 확인합니다. 셸에서 내보낸(export) 변수는 systemd 서비스, 다른 사용자의 세션, 또는 내보내기 전에 시작된 프로세스에는 도달하지 않습니다. 유닛을 위해 모드 600인 EnvironmentFile에 값을 넣거나, dsh를 시작하는 동일한 셸에서 내보내십시오. 실행 중인 프로세스가 실제로 무엇을 가지고 있는지 sudo tr '\0' '\n' < /proc/$(pgrep -f dsh | head -1)/environ로 확인하십시오.
dsh는 어떤 Node.js 버전이 필요합니까?
2026년 11월 5일 기준 저장소의 package.json에 따르면 Node.js 24.9 이상이 필요합니다. 22 버전 계열은 더 이상 지원되지 않으며, Node 24.0에서 24.8 버전도 충분하지 않습니다. 지원되지 않는 런타임으로 인한 시작 실패는 설치가 깨진 것처럼 보여 사용자가 런타임 대신 패키지를 재설치하게 만들 수 있으므로, 다른 작업을 하기 전에 node -v을 실행하십시오.