Orca 삭제 후에도 Codex가 Orca를 찾은 이유: AI 코딩 도구 설치 전 꼭 확인할 것들

Orca를 설치해 잠깐 사용한 뒤 Windows에서 삭제했다. 그런데 이후 Codex Desktop에서 컴퓨터 제어 기능을 호출하자 예상 밖의 일이 발생했다.

Codex가 자체 컴퓨터 제어 기능을 사용하는 대신 다음 명령을 실행하려고 한 것이다.

orca status --json
orca computer capabilities --json

당연히 명령은 실패했다. Orca 프로그램은 이미 삭제했고, orca 실행 파일도 PATH에 존재하지 않았기 때문이다.

처음에는 단순히 “컴퓨터 제어 플러그인이 설치되지 않았다”고 생각했다. 하지만 실제 원인은 달랐다.

Orca 프로그램은 삭제됐지만, Orca용 에이전트 스킬과 외부 도구 연동 정보는 일부 남아 있었다.

이번 글에서는 원인을 확인한 과정과 Orca 같은 AI 코딩 도구를 설치할 때 주의해야 할 점을 정리한다.

TL;DR

핵심만 먼저 요약하면 다음과 같다.

• 프로그램 삭제와 AI 에이전트 스킬 삭제는 별개다.
• --global로 설치한 스킬은 앱 제거 후에도 사용자 설정 폴더에 남을 수 있다.
• Codex 기본 기능과 외부 도구가 같은 computer-use라는 이름을 사용하면 충돌할 수 있다.
• 삭제 전에는 Git 워크트리와 계정·터미널 기록이 남아 있는지 확인해야 한다.
• 폴더 이름만 보고 지우지 말고, 설치 출처와 파일 내용을 먼저 확인해야 한다.

문제의 시작: 왜 Codex가 Orca 명령을 실행했을까?

Codex에서 컴퓨터 제어 기능을 호출했을 때, 로드된 computer-use 스킬에는 다음과 같은 지침이 들어 있었다.

Use Orca's computer-use CLI

해당 스킬의 실제 위치는 다음과 같았다.

%USERPROFILE%\.agents\skills\computer-use\SKILL.md

설치 기록도 별도로 남아 있었다.

%USERPROFILE%\.agents\.skill-lock.json

잠금 파일에는 설치 출처가 명확히 기록돼 있었다.

{
  "computer-use": {
    "source": "stablyai/orca",
    "sourceType": "github",
    "sourceUrl": "https://github.com/stablyai/orca.git",
    "skillPath": "skills/computer-use/SKILL.md"
  }
}

PowerShell 기록을 확인해 보니 다음 명령으로 전역 설치한 흔적도 발견됐다.

npx skills add https://github.com/stablyai/orca --skill computer-use --global

Orca 공식 문서에서도 computer-use 스킬을 이 방식으로 설치하도록 안내한다. 즉, 이 스킬은 Orca 실행 파일에 포함된 단순 부속물이 아니라 별도의 전역 에이전트 스킬이었다. Orca skills registry & MCP

따라서 Windows에서 Orca 애플리케이션을 제거해도 .agents 아래에 설치된 전역 스킬은 자동으로 사라지지 않을 수 있다.

Codex에도 별도의 computer-use가 있었다

문제를 더 복잡하게 만든 것은 Codex Desktop에도 자체 computer-use 플러그인이 있다는 점이었다.

두 기능은 이름은 비슷하지만 완전히 다른 실행 구조를 사용한다.

구분	Orca 스킬	Codex 기본 플러그인
스킬 이름	computer-use	computer-use:computer-use
실행 방식	orca computer ...	OpenAI의 Windows UI 제어 런타임
주요 위치	.agents\skills\computer-use	.codex\plugins\cache\openai-bundled
실행 파일 예시	orca	codex-computer-use.exe

특히 다음과 같은 파일은 이름에 computer-use가 포함돼 있지만 Orca 파일이 아니다.

%LOCALAPPDATA%\OpenAI\Codex\runtimes\cua_node\...\codex-computer-use.exe

이 파일은 OpenAI Codex의 컴퓨터 제어 런타임이다. Orca를 정리한다고 이 파일까지 삭제하면 Codex 기본 기능이 손상될 수 있다.

내 환경에서는 Codex 플러그인 자체는 활성화돼 있었지만, 플러그인의 스킬은 별도 설정으로 비활성화돼 있었다.

[[skills.config]]
name = "computer-use:computer-use"
enabled = false

이 설정은 이전 백업에도 존재했기 때문에 Orca가 변경했다고 단정할 수 없었다. 다만 다음 조건이 함께 발생하면서 문제가 드러났다.

1. Codex 기본 computer-use 스킬은 비활성화돼 있었다.
2. Orca의 동명 computer-use 스킬은 전역 폴더에 남아 있었다.
3. Codex가 남아 있던 Orca 스킬을 선택했다.
4. 삭제된 orca 실행 파일을 호출하면서 실패했다.

결국 문제의 본질은 실행 파일 잔재보다 동명 스킬 충돌과 전역 설정 잔재에 가까웠다.

실제로 발견된 Orca 잔여 항목

환경에 따라 다르겠지만, 이번 점검에서는 다음 위치에서 Orca 관련 항목이 발견됐다.

%USERPROFILE%\.agents\skills\computer-use
%USERPROFILE%\.agents\.skill-lock.json
%USERPROFILE%\.config\amp\plugins\orca-agent-status.ts

%USERPROFILE%\.orca
%USERPROFILE%\orca

%LOCALAPPDATA%\Orca
%LOCALAPPDATA%\orca-updater
%APPDATA%\orca

사용자 PATH에도 다음 항목이 남아 있었다.

%LOCALAPPDATA%\Programs\orca\resources\bin

Codex 설정에는 Orca가 생성한 워크트리 경로가 신뢰 프로젝트로 등록돼 있었다.

[projects."C:\\Users\\...\\orca\\workspaces\\..."]
trust_level = "trusted"

Amp 플러그인 폴더에는 Orca 상태 전달용 훅도 존재했다.

%USERPROFILE%\.config\amp\plugins\orca-agent-status.ts

Orca는 에이전트 상태를 추적하기 위해 훅 엔드포인트를 파일로 관리할 수 있다. 따라서 앱 데이터뿐 아니라 각 에이전트의 설정 폴더도 함께 확인할 필요가 있다. Agent hooks & memory

Orca 흔적을 확인하는 PowerShell 명령

1. 실행 파일과 프로세스 확인

Get-Command orca, orca-dev, orca-ide -ErrorAction SilentlyContinue

Get-Process -ErrorAction SilentlyContinue |
    Where-Object { $_.ProcessName -match 'orca|stably' }

아무것도 출력되지 않으면 현재 PATH에서 실행 파일을 찾지 못했고, 관련 프로세스도 실행 중이지 않다는 의미다.

2. 전역 스킬의 출처 확인

Select-String `
    -Path "$env:USERPROFILE\.agents\.skill-lock.json" `
    -Pattern 'stablyai/orca|computer-use' `
    -Context 2, 5

스킬 파일 자체도 확인한다.

Get-Content `
    "$env:USERPROFILE\.agents\skills\computer-use\SKILL.md" `
    -TotalCount 30

여기에서 Use Orca's computer-use CLI 또는 orca computer가 발견되면 Orca용 스킬이다.

3. PATH 잔재 확인

[Environment]::GetEnvironmentVariable('Path', 'User') -split ';' |
    Where-Object { $_ -match 'orca|stably' }

현재 터미널의 PATH뿐 아니라 사용자 환경 변수에 저장된 PATH를 확인하는 것이 중요하다.

4. 관련 폴더 확인

$targets = @(
    "$env:USERPROFILE\.orca",
    "$env:USERPROFILE\orca",
    "$env:LOCALAPPDATA\Orca",
    "$env:LOCALAPPDATA\orca-updater",
    "$env:APPDATA\orca"
)

$targets | ForEach-Object {
    [PSCustomObject]@{
        Path   = $_
        Exists = Test-Path -LiteralPath $_
    }
}

5. Codex 설정에 남은 Orca 경로 확인

Select-String `
    -Path "$env:USERPROFILE\.codex\config.toml*" `
    -Pattern '\\orca\\workspaces|stablyai/orca|ORCA_' `
    -ErrorAction SilentlyContinue

6. 설치 명령 기록 확인

$history = (Get-PSReadLineOption).HistorySavePath

Select-String `
    -Path $history `
    -Pattern 'stablyai/orca|skills add|orca' `
    -ErrorAction SilentlyContinue

이 기록은 어떤 설치 명령을 사용했는지 확인하는 증거로 유용하다.

무작정 폴더를 삭제하면 안 되는 이유

이번 환경에서 %USERPROFILE%\orca 아래에는 단순 캐시가 아니라 Git 저장소와 워크트리가 존재했다.

orca
├─ projects
│  └─ Chat
└─ workspaces
   └─ Chat
      ├─ snailfish
      └─ sturgeon

이런 경로를 바로 재귀 삭제하면 커밋하지 않은 변경 사항을 잃을 수 있다.

삭제 전에는 반드시 Git 상태를 확인해야 한다.

git -C "<저장소 경로>" status --short --branch
git -C "<저장소 경로>" worktree list --porcelain

다음 중 하나라도 해당하면 삭제를 멈추는 것이 좋다.

• git status에 수정되거나 추적되지 않은 파일이 표시된다.
• 아직 병합하지 않은 로컬 브랜치가 있다.
• 터미널 기록이나 작업 세션을 보존해야 한다.
• AppData에 계정 또는 인증 프로필이 저장돼 있다.
• 폴더의 생성 주체가 Orca인지 확실하지 않다.

이번 사례에서는 워크트리의 변경 여부를 먼저 확인한 뒤 정리 범위를 결정했다.

권장 정리 순서

Orca 관련 항목을 정리할 때는 한 번에 거대한 삭제 명령을 실행하지 않는 편이 안전하다.

1단계: 외부 연결부터 제거한다

먼저 Orca가 다른 에이전트에 연결되는 지점을 제거한다.

• .agents의 Orca computer-use 스킬
• .skill-lock.json의 stablyai/orca 항목
• Amp의 orca-agent-status.ts
• 사용자 PATH의 Orca 경로
• Codex 설정의 Orca 워크트리 신뢰 항목

잠금 파일에는 다른 스킬 정보가 들어 있을 수 있으므로 파일 전체를 삭제하기보다 Orca 항목만 제거하는 것이 안전하다.

2단계: Git 변경 사항을 확인한다

Get-ChildItem "$env:USERPROFILE\orca" `
    -Recurse `
    -Force `
    -Filter .git `
    -ErrorAction SilentlyContinue

발견된 각 저장소와 워크트리에서 git status를 실행한다.

3단계: 삭제 대상을 미리 확인한다

PowerShell의 -WhatIf를 사용하면 실제로 삭제하지 않고 대상을 확인할 수 있다.

Remove-Item `
    -LiteralPath "$env:USERPROFILE\.orca" `
    -Recurse `
    -Force `
    -WhatIf

출력된 경로가 예상과 일치할 때만 실제 삭제 여부를 결정한다.

4단계: AppData를 마지막에 정리한다

%APPDATA%\orca에는 다음과 같은 데이터가 들어 있을 수 있다.

• Codex 런타임 복사본
• 계정 정보
• 터미널 기록
• 브라우저 프로필
• 캐시
• 에이전트 훅 정보

단순 캐시라고 생각하고 먼저 삭제하면 필요한 기록까지 잃을 수 있다. 필요한 데이터가 없는지 확인하거나 백업한 뒤 제거해야 한다.

5단계: Codex와 터미널을 재시작한다

스킬과 PATH 목록은 프로세스 시작 시 로드되는 경우가 많다. 디스크에서 파일을 제거했더라도 현재 열려 있는 Codex 작업에는 이전 스킬 정보가 남아 있을 수 있다.

정리 후에는 다음 순서로 다시 확인한다.

1. Codex Desktop 종료
2. PowerShell 또는 Windows Terminal 종료
3. Codex 재실행
4. 새 작업에서 사용 가능한 스킬 확인
5. Get-Command orca 재확인

설치 전 체크리스트

Orca뿐 아니라 전역 설정을 수정하는 AI 도구를 설치할 때도 적용할 수 있다.

• --global 옵션이 무엇을 변경하는지 확인한다.
• .agents, .codex, .config 중 어떤 폴더를 사용하는지 확인한다.
• 이미 같은 이름의 스킬이 설치돼 있는지 확인한다.
• 설치 전 사용자 PATH를 기록한다.
• 설치 전 주요 설정 파일을 백업한다.
• 작업 폴더와 워크트리 생성 위치를 확인한다.
• 에이전트 훅을 자동 설치하는지 확인한다.
• 제거 방법이 앱 삭제와 별도로 제공되는지 확인한다.
• 시험 목적이라면 전역 설치보다 격리된 환경을 우선한다.

설치 전 다음과 같이 간단한 스냅샷을 남겨도 좋다.

Get-ChildItem "$env:USERPROFILE\.agents" -Recurse -Force |
    Select-Object FullName, Length, LastWriteTime

[Environment]::GetEnvironmentVariable('Path', 'User')

설치 후 같은 명령을 실행하면 어떤 항목이 추가됐는지 비교하기 쉽다.

삭제 후 체크리스트

• Orca 실행 파일이 PATH에 남아 있지 않은가?
• stablyai/orca 스킬 기록이 남아 있지 않은가?
• .agents\skills에 Orca용 스킬이 남아 있지 않은가?
• Amp·Claude·Codex 등 다른 에이전트 설정에 Orca 훅이 남아 있지 않은가?
• Orca 워크트리에 커밋하지 않은 변경 사항이 없는가?
• AppData의 계정·터미널 기록을 삭제해도 되는가?
• Codex 기본 computer-use 파일을 Orca 파일로 오인하지 않았는가?
• 정리 후 Codex와 터미널을 재시작했는가?

이번 경험에서 얻은 교훈

첫 번째 교훈은 프로그램 삭제와 에이전트 통합 삭제는 다르다는 것이다.

AI 개발 도구는 실행 파일만 설치하지 않는다. 전역 스킬, 훅, PATH, 계정 프로필, 워크트리, 신뢰 프로젝트 설정 등 여러 지점에 연결 정보를 만들 수 있다.

두 번째 교훈은 파일 이름보다 출처를 먼저 확인해야 한다는 것이다.

computer-use라는 이름만 보고 삭제하면 Codex 기본 기능까지 손상할 수 있다. .skill-lock.json, 플러그인 경로, 파일 내용과 생성 시점을 함께 확인해야 한다.

마지막 교훈은 삭제 작업도 코드 변경처럼 검증해야 한다는 것이다.

먼저 읽기 전용 명령으로 범위를 확인하고, Git 상태를 검사하고, -WhatIf으로 대상을 검증한 뒤 최소 단위로 제거하는 편이 안전하다.

이번 문제는 Orca 실행 파일이 남아서 발생한 것이 아니었다. 삭제되지 않은 전역 스킬과 동명 기능의 충돌이 원인이었다. AI 코딩 도구를 자주 교체하거나 여러 도구를 함께 사용한다면, 이제는 앱 목록뿐 아니라 .agents, .codex, .config까지 함께 관리해야 한다.

```