Foundation 리서치 팀 코드 에이전트

Foundation 리서치 팀을 위한 VS Code 코딩 에이전트입니다. 사내 OpenAI 호환 모델 서버를 사용하며 스트리밍 채팅, 작업 공간 파일 도구, 병렬 모델 검토, 승인 기반 파일 변경, 채팅 기록을 제공합니다.

Marketplace에 게시하면 확장 패키지와 설명은 누구나 찾아 설치할 수 있습니다. 팀 전용 사용을 보장하는 설치 제한은 아닙니다. 실제 모델 사용에는 사내 모델 네트워크 연결과 API 키가 필요합니다.

요구 사항

• VS Code 1.106 이상
• 사내 모델 서버에 연결할 수 있는 네트워크
• 첫 사용 시 본인 API 키 등록

빠른 사용법

1. Marketplace에서 설치하거나 전달받은 VSIX를 설치합니다. 이 빌드는 inhouse-code-agent-fr-0.7.10.vsix입니다. VS Code의 Extensions 화면에서 ... → **Install from VSIX...**를 선택하거나 터미널에서 code --install-extension inhouse-code-agent-fr-0.7.10.vsix를 실행하세요. Windows와 Linux에서 같은 명령을 사용할 수 있습니다.
2. Ctrl+Shift+P를 누르고 Code Agent: Set API Key를 실행해 본인에게 발급된 키를 입력합니다. 키는 VS Code SecretStorage에 저장됩니다. .env 방식은 개발용이며, 공유하거나 저장소에 올리지 마세요.
3. 사내 모델 네트워크에 연결합니다. 필요하면 Activity Bar의 Code Agent 대시보드에서 Wi-Fi 연결을 선택하세요.
4. Code Agent 채팅을 열고 요청을 입력합니다. 기본 모델은 GLM-5.3-Flash입니다. 에이전트는 진행 설명과 현재 작업을 표시하고, 파일 변경·명령·웹 검색·MCP 호출 등 승인이 필요한 작업은 실행 전에 확인을 요청합니다.
5. 답변 아래의 View changes를 열어 변경 파일과 diff를 확인할 수 있습니다. 승인된 파일 변경은 Undo로 되돌릴 수 있습니다.

Marketplace 자동 배포가 설정되기 전에는 VSIX 파일을 각 사용자에게 전달해야 합니다. VSIX를 설치한 사용자는 새 버전을 받을 때 새 파일을 다시 설치해야 합니다.

설치

VS Code Marketplace

Marketplace 게시가 완료되면 VS Code의 Extensions에서 Foundation 리서치 팀 코드 에이전트를 검색해 설치하세요. Marketplace에서 설치한 확장은 VS Code가 새 버전을 확인하고 자동으로 업데이트할 수 있습니다. 업데이트 후 extension host를 다시 시작하라는 알림이 표시될 수 있습니다.

현재 VSIX 파일로 설치한 경우 VS Code가 그 설치본을 Marketplace에서 자동 업데이트하지 않습니다. Marketplace 게시 후 Extensions에서 기존 확장을 제거하고 Marketplace 항목으로 다시 설치해야 합니다.

Windows에서 VSIX로 설치

VSIX와 install-windows.bat를 같은 폴더에 둔 뒤 install-windows.bat를 더블 클릭합니다. 설치 후 VS Code에서 Developer: Reload Window를 실행하세요.

Linux에서 VSIX로 설치

VSIX와 install-linux.sh를 같은 폴더에 둡니다. 터미널에서 해당 폴더로 이동한 뒤 다음을 실행하세요.

chmod +x install-linux.sh
./install-linux.sh

설치 후 VS Code에서 Developer: Reload Window를 실행하세요. 스크립트는 VS Code의 code 명령이 PATH에 등록되어 있어야 합니다. GUI 설치는 Extensions(Ctrl+Shift+X)의 ... 메뉴에서 **Install from VSIX...**를 선택하면 됩니다.

원격 푸시 후 자동 업데이트

Marketplace 설치 사용자는 VS Code가 게시된 새 버전을 자동으로 설치할 수 있습니다. 이 저장소의 main에 변경 사항을 푸시하면 GitHub Actions가 패치 버전을 올리고 Marketplace에 게시합니다. Marketplace 게시자 ID는 YoungminSeo입니다. GitHub 저장소에는 VSCE_PAT Actions secret과 MARKETPLACE_PUBLISH_ENABLED=true 저장소 변수를 설정해야 합니다. 인증 정보는 저장소 코드에 포함하지 마세요.

현재 Azure DevOps 전역 PAT는 2026년 12월 1일 종료 예정이므로, 장기 운영을 위해서는 그 전에 Microsoft Entra ID 기반 인증으로 워크플로를 전환해야 합니다. Marketplace에 첫 버전을 게시하고 위 설정을 완료하기 전까지는 푸시해도 사용자에게 자동 배포되지 않습니다. GitHub Actions가 게시한 버전은 Marketplace에서 설치한 사용자에게 자동 업데이트됩니다.

일반 VSIX 설치본은 업데이트 대상으로 등록되지 않습니다. Marketplace 배포 후 기존 설치본을 제거하고 Marketplace에서 한 번 다시 설치하세요. Marketplace 항목은 공개로 검색 및 다운로드할 수 있습니다. 설명은 Foundation 리서치 팀용으로 표시하지만 설치 자체를 팀원으로 제한하지는 않습니다.

푸시 후 Marketplace 자동 업데이트 설정

이 저장소에는 main 브랜치에 코드 변경을 푸시할 때 패치 버전을 올리고 Marketplace에 게시하는 GitHub Actions 워크플로가 있습니다. 게시자 인증이 아직 설정되지 않아 현재 자동 게시 기능은 꺼져 있습니다.

최초 설정은 게시자 계정 소유자가 해야 합니다.

1. Marketplace Publisher 관리에서 YoungminSeo 게시자를 만들거나 해당 게시자 권한을 확보합니다.
2. Azure DevOps Personal Access Token을 만들고 Marketplace (Manage) 권한만 부여합니다. 이 토큰을 채팅이나 Git 저장소에 올리지 마세요.
3. GitHub 저장소의 Settings > Secrets and variables > Actions에서 VSCE_PAT 이름으로 secret을 추가합니다.
4. 같은 화면의 Variables에서 MARKETPLACE_PUBLISH_ENABLED 값을 true로 설정합니다.
5. GitHub Actions 탭에서 Publish VS Code Marketplace update 워크플로를 선택하고 Run workflow를 실행해 첫 버전을 게시합니다. 이후 main에 코드 변경을 푸시하면 새 패치 버전이 자동 게시됩니다.

VS Code는 Marketplace에서 설치한 확장을 자동 업데이트합니다(사용자 설정에서 자동 업데이트가 켜져 있어야 합니다). Azure DevOps 전역 PAT는 2026년 12월 1일 종료 예정이므로 그 전에 워크플로를 Microsoft Entra ID 인증으로 전환해야 합니다. Marketplace 첫 게시와 위 설정을 마치기 전에는 코드 푸시만으로 새 버전이 사용자에게 배포되지 않습니다.

공개 Marketplace는 Foundation 리서치 팀원만 설치하도록 제한하지 않습니다. 설명은 팀용으로 표시하되, 실제 모델 접근은 사내 네트워크와 별도로 배포한 API 키로 제어됩니다. API 키는 확장 설치 권한을 제한하지 않습니다.\n\n## 설정 및 API 키

기본 엔드포인트와 모델은 이 프로젝트에 제공된 사내 서버 정보에 맞춰져 있습니다. Settings > Extensions > In-house Code Agent에서 변경하거나 settings.json에 지정할 수 있습니다.

{
  "inhouseCodeAgent.baseUrl": "http://192.168.219.100:8000/v1",
  "inhouseCodeAgent.model": "GLM-5.3-Flash",
  "inhouseCodeAgent.timeoutMs": 120000,
  "inhouseCodeAgent.maxRetries": 2,
  "inhouseCodeAgent.maxTokens": 4096,
  "inhouseCodeAgent.reasoningEffort": "max",
  "inhouseCodeAgent.stream": true,
  "inhouseCodeAgent.enableTools": true,
  "inhouseCodeAgent.enableCommands": false,
  "inhouseCodeAgent.commandTimeoutMs": 30000
}

Code Agent: Set API Key 명령으로 각자의 키를 VS Code SecretStorage에 저장하세요. 키를 공유 설정이나 Git에 넣지 마세요. 개발 시에는 활성 작업 공간의 .env에 INHOUSE_CODE_AGENT_API_KEY를 지정할 수도 있습니다. .env는 Git에서 제외됩니다. 확장 프로그램은 SecretStorage를 먼저 확인하고, 키가 없으면 작업 공간의 .env를 확인합니다.

Marketplace는 누구나 설치할 수 있으므로 API 키가 설치 권한을 제어하지는 않습니다. 모델 서버는 사내 네트워크에서만 접근 가능하게 유지하고 키를 안전하게 배포하세요.

동작 방식

병렬 검토는 기본으로 켜져 있습니다. 설정된 네 모델이 첫 검토를 동시에 수행하고 모두 응답에 참여합니다. inhouseCodeAgent.model 설정은 검토 결과를 종합해 도구 작업과 최종 답변을 이어갈 모델을 지정하며, 기본값은 GLM-5.3-Flash입니다. GLM 추론 강도 기본값은 max입니다. 병렬 요청은 지연 시간과 토큰 사용량을 늘릴 수 있으며 답변 향상을 보장하지 않습니다.

Code Agent: Test Model Connection은 /chat/completions 연결을 확인합니다. Code Agent: List Models는 /models에서 서버가 반환하는 모델 ID를 표시합니다. 서버가 /models를 지원하지 않아도 채팅은 사용할 수 있습니다.

확장은 로컬 에이전트 실행기 역할을 합니다. 모델 서버는 추론 응답만 반환하고, 파일 탐색·읽기·검색·ZIP 확인·승인된 수정은 각 사용자의 VS Code 확장 호스트에서 실행됩니다. 사용자 목표를 받으면 에이전트가 작업 공간과 언급한 경로를 조사하고, 도구를 반복 호출해 진행합니다. 진행 상태와 도구 호출을 채팅에 보여주며, 파일 변경은 정확한 diff를 확인하고 승인해야 반영됩니다. VS Code가 Restricted Mode라면 해당 작업 공간을 신뢰해야 파일 도구를 사용할 수 있습니다. 대화 기록은 작업 공간별로 최대 20개 세션까지 저장되며 History 버튼으로 다시 열거나 삭제할 수 있습니다.

작업 중에는 짧은 한국어 진행 문장을 대화에 이어서 보여주고, 활동 행 하나만 Thinking/현재 작업/Ran …으로 갱신합니다. 도구마다 활동 카드가 쌓이지 않습니다. 사용자 메시지는 오른쪽 말풍선으로 표시합니다. 답변이 끝나면 변경 파일 수와 추가·삭제 줄 수를 한 줄로 표시하고, View changes를 열어 파일별 diff를 확인할 수 있습니다. Agent 답변에는 최종 응답만 들어갑니다.

에이전트 단계나 도구 호출 횟수에 고정 상한을 두지 않습니다. 모델이 최종 답변을 내거나 사용자가 중지를 누를 때까지 진행합니다. 개별 모델 응답과 명령에는 각각 시간 제한이 적용됩니다.

입력창의 ＋ 버튼으로 이미지, 코드, 텍스트, JSON/CSV, ZIP 파일을 첨부할 수 있습니다. 이미지 붙여넣기와 파일 드래그앤드롭도 지원합니다. 파일 경로를 메시지에 쓰면 에이전트가 작업 공간 도구로 해당 경로를 확인합니다. ZIP 경로는 압축을 풀지 않고 내부 파일 목록을 확인하고 필요한 텍스트 항목을 읽습니다. 첨부 ZIP은 안전 제한에 따라 텍스트 파일 일부만 읽어 모델에 전달합니다. 메시지당 최대 12개, 전체 20 MB이며 파일 하나는 최대 8 MB입니다.

처음 채팅을 보낼 때 공개 에이전트 스킬 저장소인 Superpowers, Vercel Agent Skills, GitHub Awesome Copilot에서 SKILL.md 지침을 사용자별 VS Code 저장소에 자동 설치합니다. 이후 7일마다 업데이트를 확인합니다. 설치 파일이나 실행 스크립트는 내려받지 않으며 스킬 문서만 로컬로 읽어 작업 종류에 맞춰 모델 요청에 포함합니다. 스킬 다운로드가 실패해도 내장 파일 도구는 계속 사용할 수 있습니다. 각 PC에서 최초 다운로드를 하려면 GitHub 접속이 필요합니다.

“에이전트를 더 써서” 또는 병렬 조사를 요청하면 하위 에이전트가 별도 모델 요청으로 독립 조사를 동시에 할 수 있습니다. 하위 에이전트는 파일을 읽기만 하며 수정과 명령 실행은 주 에이전트가 담당합니다. 하위 에이전트 조사에도 설정된 모델 서버 요청이 추가됩니다.

일반 로컬 명령 실행은 inhouseCodeAgent.enableCommands로 별도 활성화해야 하며 기본값은 꺼져 있습니다. 작업 공간 도구도 켜져 있어야 합니다. 실행 때마다 명령 정보를 확인하고 승인해야 하며 npm, node, 읽기 전용 git 일부만 허용됩니다. 일반 명령 경로에서는 패키지 설치·배포, Git 네트워크 또는 쓰기 작업, 임의의 셸 명령을 차단합니다. npm 의존성 하나를 추가할 때는 아래 전용 설치 도구를 사용할 수 있습니다. 이는 운영체제 수준의 격리 기능은 아닙니다.

웹 검색, MCP, 파일 다운로드 및 패키지 설치

웹 검색은 기본 활성화되어 있습니다. 에이전트가 검색을 제안하면 승인 카드에 검색어와 DuckDuckGo 전송 사실이 표시됩니다. 승인한 검색어만 전송하고, 검색 결과는 신뢰할 수 없는 참고 자료로 취급합니다.

MCP 서버는 inhouseCodeAgent.mcpServers 설정에 추가합니다. stdio 서버와 Streamable HTTP 서버를 지원합니다. 서버를 처음 연결할 때 서버 실행/접속 승인을 받고, 그 서버가 제공하는 각 도구를 호출할 때마다 별도 승인을 받습니다. 서버에 따라 로컬 파일·네트워크 접근이나 변경을 수행할 수 있으므로, 신뢰하는 서버만 등록하세요. 비밀 값은 설정에 직접 쓰지 말고 ${env:VARIABLE_NAME}으로 사용자 환경 변수에서 읽으세요.

stdio 예시:

{
  "inhouseCodeAgent.mcpServers": [
    {
      "name": "my-mcp",
      "transport": "stdio",
      "command": "npx",
      "args": ["-y", "@example/mcp-server"],
      "env": { "SERVICE_TOKEN": "${env:SERVICE_TOKEN}" }
    }
  ]
}

HTTP 예시는 transport: "http", url, 선택적 headers를 사용합니다. 헤더 비밀 값도 ${env:VARIABLE_NAME}으로 지정할 수 있습니다. 서버 설정은 VS Code settings.json에 저장되므로 토큰을 평문으로 넣지 마세요.

파일 다운로드와 npm 패키지 설치도 설정에서 각각 끌 수 있으며(inhouseCodeAgent.enableFileDownloads, inhouseCodeAgent.enablePackageInstall), 기본값은 켜짐입니다. 매번 URL·저장 경로 또는 정확한 패키지와 명령을 승인받습니다. 다운로드는 작업 공간의 새 경로에만 최대 20 MB까지 저장하고 자동 실행하지 않습니다. 패키지 설치는 npm 패키지 하나만 추가하고 lifecycle scripts를 비활성화합니다. 승인하지 않으면 네트워크 요청이나 설치를 시작하지 않습니다.

주요 기능

• 왼쪽 Activity Bar 대시보드에서 접속 상태, 이 장치의 월간 요청 수, 업데이트 확인 제공
• 대시보드에서 최근 에이전트 작업·도구·연결 확인 로그 조회 및 삭제
• 사내 Wi-Fi 연결은 네트워크 선택 후 각 PC에서 비밀번호를 입력하며, 비밀번호는 VS Code 보안 저장소에 보관
• Secondary Side Bar 채팅을 유지하며 대시보드에서 바로 열기 가능
• 네 모델 병렬 검토 및 결과 종합
• 전송 버튼 옆에서 기본 모델과 모델별 추론 강도 변경
• 목표 기반 로컬 에이전트 실행과 병렬 읽기 전용 하위 에이전트
• 이미지·파일 첨부, 이미지 붙여넣기 및 드래그앤드롭, ZIP 내용 확인
• 공개 Agent Skills 저장소 3곳의 사용자별 자동 설치와 주기적 갱신
• 응답 대기 중 진행 표시, 스트리밍, 중지 및 새 채팅
• 작업 공간별 채팅 기록
• 승인을 거치는 파일 변경과 diff 확인
• 승인 후 사용하는 웹 검색, MCP(stdio/HTTP), 작업 공간 파일 다운로드 및 npm 패키지 설치
• 제한된 작업 공간 파일 도구 및 별도로 제어되는 로컬 명령
• 연결 확인, 모델 목록 조회, 재시도 및 오류 안내

보안 및 제한 사항

채팅 메시지, 첨부 이미지/파일 내용, 하위 에이전트 조사 내용은 설정된 모델 엔드포인트로 전송됩니다. 민감한 자료를 보내기 전에 조직의 데이터 처리 정책을 확인하세요. 작업 공간 파일 도구 접근은 첫 번째 활성 작업 공간 안으로 제한됩니다. 명령 실행은 기본 비활성화이며, 켜더라도 개별 승인이 필요합니다. 웹 검색어는 승인 후 DuckDuckGo로 전송됩니다. MCP 서버 시작/접속과 각 도구 호출, 파일 다운로드, npm 설치는 각각 승인받습니다. MCP 서버와 설치된 패키지의 동작은 확장 밖에서 추가 권한을 가질 수 있으므로 신뢰 여부를 검토하세요. 다운로드 파일은 자동 실행되지 않습니다. Git 푸시는 지원하지 않습니다.

자세한 설정은 API_SETUP.md, 보안 통제와 남은 제한 사항은 SECURITY.md를 참고하세요.

버그 게시판

Activity Bar의 Code Agent를 열고 버그 게시판 뷰를 선택하면 Foundation Research 코드 에이전트 GitHub 저장소의 최근 이슈를 확인할 수 있습니다. 처음 사용할 때 GitHub 연결을 눌러 저장소 접근을 승인해야 합니다. GitHub 계정에는 비공개 저장소에 접근할 권한이 있어야 합니다.

보고서 제목과 상세 내용을 작성한 뒤 보고서 제출을 누르면 GitHub 이슈로 등록됩니다. 제출되는 정보는 입력한 제목과 설명뿐이며, 채팅 기록·코드·파일·API 키는 자동 첨부하지 않습니다. 제출된 이슈는 해당 비공개 저장소에 접근할 수 있는 팀원에게 표시됩니다.