Forge: 모델 불문 AI 코딩 harness 및 CLI, 첫 사용 전 의사결정 가이드

누구에게 적합한가

• 터미널에서 네이티브 CLI/TUI 하나로 코딩 작업을 처리하고, 각 작업이 자동으로 「비용 × 능력」 기준 최적 모델로 라우팅되기를 원하는 개발자에게 적합합니다. Rust로 작성된 모델 불문(model-agnostic) AI 코딩 harness로, 단일 네이티브 바이너리이며 Node, Python, Bun 런타임이 필요 없습니다.
• 데스크톱 앱, iOS/Android/Web 컴패니언 앱 또는 OpenAI 호환 로컬 API를 통해 사용하고 싶다면, 공식 설명에 따르면 이러한 형태들도 함께 제공됩니다.
• 적합하지 않은 경우: 그래픽 설정 마법사 외의 설치 방식이 필요하거나 특정 플러그인/확장 생태계에 의존하는 경우입니다. 이런 세부 사항은 근거가 제공되지 않아 확인할 수 없습니다. 어떤 구체적인 agent를 지원하는지, 어떤 언어 환경을 지원하는지도 공식 근거가 없으므로 미확인 사항이며, 임의로 추정해서는 안 됩니다.
• 사용 전제 조건: 접근 가능한 모델 자격 증명이 필요합니다. forge setup은 모델 연결, 보안 및 비용 설정, 검색, 가져오기, 백그라운드 서비스를 안내하며, API 키는 OS keyring에 저장됩니다.

3분 만에 첫 시도 완료하기

권장 기본 경로는 단 하나입니다: 공식 한 줄 셸 설치 스크립트.

1. 전제 조건: 셸을 실행할 수 있는 터미널, GitHub 접근 가능.
2. 터미널에서 실행:

curl -fsSL https://raw.githubusercontent.com/Adulari/forge/main/install.sh | sh

이 스크립트는 일치하는 release 바이너리를 다운로드해 ~/.local/bin에 설치합니다.

1. 부작용 확인 지점: 대화형 설치는 기본적으로 Forge 데스크톱 앱도 함께 설치합니다. 필요 없다면 프롬프트에서 n으로 답하거나(또는 FORGE_DESKTOP=0을 설정해 건너뛰세요). 이는 원격 스크립트를 파이프로 실행하는 설치 방식이므로, 실행 전에 신뢰할 수 있는 출처인지 직접 확인하십시오.
2. 설치 후 forge를 실행하면 첫 실행 시 forge setup 안내 흐름이 자동으로 열리며, 안내에 따라 모델과 보안/비용 설정을 연결합니다.
3. 첫 작업은 위험도가 낮은 분석 유형 작업을 권합니다. 예를 들어 현재 코드 저장소에서 특정 코드를 설명하거나 프로젝트 구조를 요약하게 하는 것입니다. 관찰 가능한 성공 신호: 작업이 분배되고 터미널 UI에 모델의 답변/분석 결과가 반환되는 것입니다. 이 과정에서 파일을 읽고 쓰거나 명령을 실행하거나 네트워크에 접근하는지에 대해서는 근거가 설명되지 않았으므로, 변경 유형 작업을 실행하기 전에 직접 확인하고 확인 지점을 통제하십시오.

기타 방법(참고 수준): 클론한 저장소에서 .forge/ 안의 hooks, MCP servers, temper 및 allow 규칙은 forge trust를 실행하기 전까지는 활성화되지 않습니다.

사용 사례

사례 1: 낮은 비용으로 낯선 저장소 빠르게 이해하기. 상황: 익숙하지 않은 코드 프로젝트를 인수한 경우. 방법: 저장소 디렉터리에서 forge의 터미널 UI를 실행하고, 읽기 전용 분석 작업을 요청합니다. 예: 「이 프로젝트의 구조와 진입점을 요약해줘」. forge는 자체 라우팅 메커니즘에 따라 작업을 적합한 모델에 넘기고, TUI에서 결과를 바로 볼 수 있습니다. 기대할 수 있는 결과: 프로젝트 개요를 얻는 것. 이는 분석 유형 작업이며 파일 수정은 포함되지 않습니다.

사례 2: 단일 코딩 요청을 일회성(headless)으로 실행하기. 상황: 스크립트로 처리하거나 대화형 화면에 들어가고 싶지 않은 경우. 방법: one-shot/headless CLI 방식으로 forge를 호출해 명확한 코딩 작업을 제출합니다(구체적인 명령줄 인자 형식은 근거가 제공되지 않으며, 「해당 형태가 존재한다」는 수준까지 확인 가능). 기대할 수 있는 결과: 작업이 비용 × 능력 기준으로 선택된 최적 모델로 라우팅되어 출력을 반환합니다. 파일 수정이나 명령 실행이 포함된 코딩 작업은 제출 전에 변경 범위를 명확히 하십시오. 부작용 동작에 대한 근거가 없으므로 환경 수준에서 직접 통제해야 합니다.

사용 경계

• 설치 부작용: 한 줄 설치 스크립트는 기본적으로 데스크톱 앱을 함께 설치합니다(대화형 기본값은 yes). n 또는 FORGE_DESKTOP=0으로 거부할 수 있습니다.
• 저장소 수준 신뢰 경계: 클론한 저장소의 .forge/ hooks, MCP servers, temper/allow 규칙은 기본적으로 비활성 상태이며, 명시적으로 forge trust를 실행해야만 활성화됩니다. 이는 공식이 명확히 안내하는 보안 확인 지점입니다.
• 실행 환경: 단일 네이티브 Rust 바이너리, Node/Python/Bun/Electron 의존성 없음. API 키는 OS keyring에 저장됩니다.
• 공식이 명시한 제한 외에 아래 정보는 근거가 제공되지 않아 미확인 사항입니다: 어떤 구체적인 agent 클라이언트를 지원하는지, 어떤 자연어/프로그래밍 언어 범위를 지원하는지, 검토 또는 진단 유형 작업이 파일을 읽고 쓰거나 명령을 실행하거나 네트워크에 접근하는지. 미확인 사항을 「무위험」으로 간주하지 마십시오. 파일을 변경하거나 명령을 실행하거나 외부 서비스를 호출하는 모든 작업은 부작용을 먼저 확인한 뒤 실행하십시오.