DeepSeek의 Oh My Pi 가이드, 핵심은 "그냥 선택하면 안 된다"

AI 코딩 에이전트의 안정성은 모델 성능만으로 결정되지 않습니다. 파일을 읽고 수정하고, 명령을 실행하고, 도구 호출 결과를 다시 대화 흐름에 반영하는 과정이 제대로 맞물려야 합니다.

DeepSeek가 공개한 Oh My Pi 통합 가이드는 이 점을 잘 보여줍니다. Oh My Pi는 터미널 기반 AI 코딩 에이전트이며, v14.5부터 DeepSeek V4 모델 항목을 포함합니다.¹ 하지만 목록에 모델이 보인다고 해서 곧바로 안정적으로 쓸 수 있는 것은 아닙니다.

Oh My Pi에서 DeepSeek V4를 쓴다는 의미

Oh My Pi는 omp CLI로 실행하는 터미널 기반 코딩 에이전트입니다. 여러 AI 제공자를 하나의 인터페이스로 연결하고, 파일 수정과 코드 실행 같은 개발 작업을 에이전트 흐름 안에서 처리합니다.²

DeepSeek V4도 Oh My Pi에서 선택할 수 있습니다. 다만 DeepSeek 문서는 v14.5에 포함된 기본 DeepSeek V4 호환 설정이 불완전하다고 설명합니다. 안정적으로 사용하려면 사용자 정의 models.yml 파일을 별도로 구성해야 합니다.¹

즉, 이 통합의 핵심은 “DeepSeek V4를 선택할 수 있다”가 아니라 “DeepSeek V4가 Oh My Pi의 도구 호출 흐름과 맞게 설정되어야 한다”입니다.

왜 models.yml 설정이 필요한가

코딩 에이전트는 일반 챗봇보다 복잡한 대화 구조를 가집니다. 사용자의 요청에 답하는 데서 끝나지 않고, 도구를 호출하고, 그 결과를 다시 읽고, 다음 작업을 이어갑니다.

이 과정에서 thinking mode와 tool call 처리가 중요해집니다. DeepSeek V4 thinking mode에서는 일부 파라미터와 메시지 형식을 정확히 맞춰야 합니다. 예를 들어 tool_choice를 보내면 거부될 수 있고, 도구 호출 사이의 reasoning_content를 보존하지 않으면 400 오류가 발생할 수 있습니다.¹

DeepSeek 가이드가 강조하는 호환 필드는 다음과 같습니다.¹

• supportsToolChoice: false

• requiresReasoningContentForToolCalls: true

• requiresAssistantContentForToolCalls: true

이 설정들은 성능 최적화 옵션이라기보다, 에이전트가 중간에 실패하지 않도록 맞춰야 하는 기본 호환 조건에 가깝습니다.

실제 적용 시 확인할 것

먼저 DeepSeek API 키는 DeepSeek Platform에서 발급받아야 합니다. 발급한 키는 DEEPSEEK_API_KEY 환경 변수로 설정할 수 있습니다.¹

그다음에는 Oh My Pi의 기본 모델 항목만 사용할지, 사용자 정의 models.yml을 적용할지 판단해야 합니다. DeepSeek V4를 안정적으로 쓰려는 목적이라면 문서가 안내하는 대로 사용자 정의 설정을 두는 쪽이 안전합니다.¹

또한 공식 엔드포인트 사용 여부도 확인할 필요가 있습니다. 문서는 비공식 제공자의 OpenAI 호환 엔드포인트에서는 reasoning_content 재생 동작이 달라질 수 있어 호환성이 확정적이지 않다고 설명합니다.¹

결론: 모델 선택보다 호환 설정이 먼저다

DeepSeek V4를 Oh My Pi에서 쓸 때 중요한 것은 단순히 모델 목록에서 DeepSeek를 고르는 일이 아닙니다. 도구 호출, reasoning content, assistant content가 Oh My Pi의 에이전트 흐름 안에서 올바르게 유지되도록 설정하는 것이 핵심입니다.

작업이 길어지고 도구 호출이 많아질수록 작은 호환성 차이가 오류로 이어질 수 있습니다. 따라서 DeepSeek V4를 Oh My Pi에 연결하려는 사용자는 API 키 설정과 함께 사용자 정의 models.yml 구성을 우선 확인해야 합니다.

¹Using DeepSeek with Oh My Pi

²can1357/oh-my-pi | DeepWiki