로컬 Claude Code 및 Codex 하네스 프로필을 통한 Interlock 관리형 Agent 실행

What they did

작성자는 연결된 채팅이 할당을 발견하기를 기다리는 대신, 로컬에 설치된 Claude Code 및 Codex CLI를 통해 Agent 할당을 자동으로 실행할 수 있도록 기존 Interlock 서버를 확장했습니다. 작성자는 설치된 실행 파일, 작업 디렉터리, 모델, 사고 노력(thinking effort) 및 네이티브 권한을 구성하는 기본 비활성화 로컬 프로필을 추가했습니다. Harnesses 페이지 상단의 앱 전체 할당 설정은 기본값이 3인 Limit to / Unlimited 드롭다운을 제공하며, 프로필별 제한이나 숨겨진 4개 작업 상한은 없습니다. 값을 높이면 대기 중인 작업이 허용되고, 낮추면 활성 할당은 완료될 수 있습니다. 설정은 리비전 보호와 함께 로컬에 유지됩니다. Harnesses는 기본적으로 Standard 권한을 사용하며 Read only 및 Full access 옵션이 있고, 워크플로 Agent 권한은 harness 기본값을 상속하거나 재정의할 수 있으며 적용 모드와 출처가 캡처됩니다. 모델 설정은 커스텀 ID, 새로고침, CLI 기본값 선택을 갖춘 네이티브 카탈로그를 사용하며, 모델과 노력은 Agent, 그다음 워크플로, 그다음 프로필 기본값 및 네이티브 구성 순으로 해석됩니다. 카탈로그 검색은 Agent 턴을 시작하거나 작업을 선점하지 않고 Claude SDK 초기화 메타데이터와 Codex model/list를 사용합니다. 그룹화된 manage_executors MCP 도구는 리비전 검사가 적용된 구성, 검사, 사람 응답, 중지 및 조정을 처리합니다. 작성자는 전체 스위트(102개 파일 / 1,215개 테스트), 패키지 테스트, 빌드, 포맷 검사, ship을 반환한 범위 지정 Impeccable 리뷰, 그리고 설치된 CLI와 기존 계정을 사용한 실제 Codex 텍스트 전용 실행을 수행했습니다.

How it went

전체 스위트가 1,215개 테스트와 함께 통과했으며, 빌드, 패키지, 포맷 검사도 통과했습니다. 범위가 한정된 Impeccable 데스크톱/모바일 리뷰는 권한 및 모델 설정에 대해 ship을 반환했습니다. 실제 Codex 실행은 워크플로 설정에서 상속된 gpt-6-luna/low와 노드에서 선택된 gpt-6.1-sol/medium을 사용하여 텍스트 전용 Agents 두 개를 첫 시도에 완료했으며, 네이티브 사용량 보고에서 예상된 모델과 최종 출력 {"message":"INTERLOCK WORKS","wordCount":2}이 확인되었습니다. run inspector를 통한 실제 Codex Allow once 명령 승인도 장시간의 사람 대기를 포함하여 통과했습니다. 남은 작업에는 run inspector 승인/복구 UI 점검, 실제 Codex 중지/복구 점검, 그리고 릴리스 후 Lucy에게 이관된 실제 Claude Code 검증이 포함됩니다.

Worth knowing

Claude가 로컬에 설치되어 있지 않아 실제 Claude Code 검증은 수행되지 않았습니다. 계정, 엔터프라이즈 정책 및 CLI 호환성은 설치 환경에 따라 달라집니다. 실제 Codex 실행은 기본 관리 경로만 검증했으며, 승인, 복구 또는 연속성 동작은 검증하지 않았습니다. 범위 지정 실행이 지원될 때까지 관리형 로컬 Git 시험은 차단된 상태로 유지됩니다. OpenCode, Channels, 원격 워커 및 자동 설치는 보류되었습니다. 이는 운영체제 샌드박스를 제공하지 않습니다. 일상적인 테스트에서는 유료 모델 호출을 수행하지 않으므로, 네이티브 동작은 대체 구현에 의존합니다.

Wiring

이 기능은 기존 Interlock 서버 내부에 있습니다. 로컬 하네스 프로필은 데이터베이스 포맷 마이그레이션 없이 문서 저장소에 저장되며 비활성화 상태로 시작합니다. 앱 전체에 적용되는 단일 할당 설정은 리비전 보호와 함께 영속화되고, 공유 용량 스케줄러가 이를 읽어 용량이 확보될 때까지 추가 할당을 큐에 넣습니다. 워크플로 설정은 공유 한도를 참조하고 관리 화면으로 연결됩니다. 모델 및 effort 해석은 Agent model/effort, 그다음 workflow agentModel/agentEffort, 그다음 프로필 기본값, 그다음 네이티브 구성을 순서로 실행합니다. 생략된 effort는 상속되고, 명시적 null은 네이티브 기본값을 사용합니다. 카탈로그 탐색은 Agent 턴을 시작하거나 작업을 선점하지 않고 Claude SDK 초기화 메타데이터와 Codex model/list를 호출하며, 캐시되고 범위가 제한됩니다. 그룹화된 manage_executors MCP 도구는 HTTP와 stdio를 통해 settings/save_settings, models, inspection, human responses, stop 및 reconciliation 작업을 노출하며, 프로바이더별 도구는 추가하지 않습니다. 캡처된 설정, 네이티브 연속성 및 새 세션은 기존의 선점, 갱신, 예산/리소스, 사용량, 결과 검증 및 제한된 실패 경로를 재사용합니다. 공유 프로세스 그룹 정리는 두 어댑터 모두를 처리합니다.

Try it yourself

# Interlock 스타일 서버에 관리형 Agent 실행 추가

## 개요

opt-in 방식의 관리형 Agent 실행을 추가합니다. 기본값은 비활성화이며, 기존 connected-agent 실행 경로는 executor가 구성되지 않은 경우 그대로 유지됩니다.

## 로컬 하네스 프로필

Claude Code와 Codex용 로컬 하네스 프로필을 추가합니다. 각 프로필은 다음을 구성합니다.

- 설치된 실행 파일 경로
- 작업 디렉터리
- 모델
- thinking effort
- 네이티브 권한

프로필은 기본적으로 비활성화되어 있으며, 명시적으로 활성화해야 관리형 실행이 시작됩니다.

## 앱 전역 할당 제한

앱 전역 설정으로 `Limit to` / `Unlimited` 드롭다운을 추가합니다.

- 기본값: `Limit to 3`
- 로컬에 영속화하며 revision 보호를 적용합니다.
- 제한을 **올리면** 대기 중인 작업이 즉시 승인됩니다.
- 제한을 **내리면** 이미 활성화된 할당은 완료될 때까지 유지되고, 새 작업만 차단됩니다.

## 하네스 권한 기본값

하네스 권한 기본값은 `Standard`이며, 다음 옵션을 제공합니다.

- `Read only`
- `Standard`
- `Full access`

워크플로우의 Agent 권한은 하네스 기본값을 **상속**하거나 **재정의**할 수 있습니다. 이때 유효 모드(effective mode)와 그 출처(source)를 함께 기록합니다.

## 모델 및 effort 해석 우선순위

모델과 effort는 다음 순서로 해석합니다.

1. Agent 수준 설정
2. 워크플로우 수준 설정
3. 프로필 기본값 및 네이티브 구성

네이티브 카탈로그를 사용하며, 커스텀 ID, 새로고침, CLI 기본값 선택을 지원합니다.

## MCP 도구

단일 그룹화된 `manage_executors` MCP 도구를 노출합니다. 이 도구는 다음을 처리합니다.

- 구성
- 검사(inspection)
- 사람 응답(human responses)
- 중지(stop)
- 조정(reconciliation)

## 회귀 테스트

다음에 대한 회귀 테스트를 추가합니다.

- 우선순위(precedence) 해석
- 권한 상속 및 재정의
- 공유 할당 제한
- 영속화 및 revision 보호