DeepSeek Harness

이 가이드는 오픈 소스 DeepSeek Harness에서 Felo API Platform 모델을 사용하는 방법을 설명합니다. 권장 방식은 Harness에 기본 포함된 deepseek-official adapter를 재사용합니다. Web UI에서 Felo를 별도의 custom OpenAI-compatible provider로 추가할 수도 있습니다.

DeepSeek Harness는 현재 developer preview 단계이며 호환성을 깨는 변경이 생길 수 있습니다. 옵션이나 화면이 이 문서와 다르면 upstream 프로젝트의 최신 release note도 확인하세요.

시작하기 전에

Node.js와 Felo API Platform key가 필요합니다. key를 소스 관리에 commit하지 마세요.

export FELO_API_KEY="YOUR_API_KEY"

예제에서는 deepseek-v4-flash를 사용합니다. 다른 모델 ID를 선택하기 전에 모델 및 가격을 확인하세요.

권장 설정: 기본 DeepSeek Adapter

DeepSeek Harness 기본 adapter는 DEEPSEEK_API_KEY에서 credential을 읽고 DEEPSEEK_BASE_URL에서 endpoint를 읽습니다.

export DEEPSEEK_API_KEY="$FELO_API_KEY"
export DEEPSEEK_BASE_URL="https://openapi.felo.ai/api/v1"
npx @deepseek-ai/dsh web

http://127.0.0.1:3080을 연 뒤 다음 단계를 진행하세요.

1. 프로젝트 workspace를 추가하거나 선택합니다.
2. 설정 → 모델을 엽니다.
3. deepseek-official provider와 deepseek-v4-flash 모델을 선택합니다.
4. 새 session을 만들고 간단한 repository 작업을 보냅니다.

Base URL 뒤에 /chat/completions를 추가하지 마세요. 기본 adapter가 {DEEPSEEK_BASE_URL}/chat/completions로 직접 요청합니다.

환경 변수 저장

DeepSeek Harness는 시작 디렉터리의 .env 파일을 읽을 수 있습니다. 매번 export하지 않으려면 버전 관리에서 제외된 .env 파일에 다음 값을 저장하세요.

DEEPSEEK_API_KEY=YOUR_API_KEY
DEEPSEEK_BASE_URL=https://openapi.felo.ai/api/v1

이 파일을 commit하지 마세요. 사용자 수준 설정이 필요하면 $DSH_HOME 아래의 Harness credential 및 settings 파일도 사용할 수 있습니다.

대안 설정: Custom OpenAI-compatible Provider

기본 DeepSeek 연결을 덮어쓰지 않고 Felo를 별도의 provider로 표시하려면 이 방식을 사용하세요.

1. npx @deepseek-ai/dsh web으로 Web UI를 시작합니다.
2. 설정 → 모델을 엽니다.
3. Custom provider 추가를 선택합니다.
4. 다음 값을 입력하고 저장합니다.

모델 검색이 실패하면 모델 ID를 직접 추가하세요. Provider의 사용 가능한 모델 가져오기 기능은 OpenAI-compatible GET /models route에 의존하지만 수동 설정에 필수는 아닙니다.

설정 확인

새 session을 만들고 다음 prompt를 보내세요.

이 repository를 요약하고 주요 package를 알려 주세요.

deepseek-v4-flash가 선택된 session이 인증 또는 unknown-model 오류 없이 완료되면 설정이 준비된 것입니다.

권장 adapter의 비대화형 smoke test는 대상 workspace에서 다음 명령으로 실행할 수 있습니다.

npx @deepseek-ai/dsh --profile headless "이 workspace의 최상위 파일을 나열하세요."

Web Search 참고

이 설정은 모델 요청만 Felo로 라우팅합니다. DeepSeek Harness의 기본 web_search provider는 별도의 endpoint 요구 사항을 가지며, 기본 credential 변수가 동일한 DEEPSEEK_API_KEY여도 설정은 독립적입니다. 명시적으로 호환되는 search endpoint를 사용하는 경우가 아니라면 DEEPSEEK_SEARCH_BASE_URL을 Felo로 지정하지 마세요. Felo 검색이 필요한 경우 Chat API 또는 해당 Felo Skills를 별도로 사용하세요.

문제 해결

다음 단계

• DeepSeek Harness repository
• LLM API 레퍼런스
• Chat API 레퍼런스
• AI Agent용 Felo Skills