harnsy
무료로 시작하기
KO

시작하기

harnsy를 설치하고 첫 팀을 만나 보세요. AI 프로그램과 컴퓨터를 고르면 단계가 하나씩 펼쳐집니다.

보면서 따라 하고 싶다면: 설치부터 완성까지 33분 동영상 ↓

또는 AI 프로그램에 맡기기

이 문장을 AI 프로그램에 붙여 넣으세요. AI 프로그램은 에이전트를 위해 쓰인 짧은 안내를 읽고, 설치가 무엇을 바꾸는지 알려 준 뒤, 당신이 “예”라고 할 때까지 기다립니다.

https://harnsy.dev/llms.txt 를 따라 harnsy를 설치해 줘

1. 설치

Linux용 Claude Code

시작하기 전에 (Anthropic 페이지, 2026년 11월 8일 읽음): Claude Code를 쓰려면 Pro, Max, Ultra, Team, Enterprise 또는 Console 계정이 필요합니다. 무료 claude.ai 요금제에는 포함되지 않습니다. Anthropic이 Claude Code를 제공하는 국가에 살아야 합니다. Ubuntu 20.04+/Debian 10+ (Alpine 3.19+), 메모리 4GB, 인터넷. 링크: Anthropic 설치 안내, 요금, 터미널 가이드. 가격은 여기에 적지 않습니다.

로그인 문장(모든 경로): 로그인은 제공업체의 페이지에서 합니다. 코드는 이 컴퓨터의 프로그램으로 바로 전달되고, 프로그램은 늘 보관하던 곳에 로그인을 보관합니다. harnsy는 로그인을 사용하려고 읽지 않으며 어디에도 보내지 않습니다. 프로그램에 로그인되어 있는지만 물어봅니다. 로그인이 함께 들어 있을 수 있는 프로그램의 설정 파일을 바꾸기 전에, harnsy는 그 파일의 백업 사본을 이 컴퓨터에 보관합니다(“Keys, logins and connections” 참고).

  1. 터미널 열기

    터미널은 명령을 입력하는 창입니다. Linux: 터미널 앱을 엽니다. 설치 프로그램은 관리자 권한을 요구하지 않습니다.

    보이는 화면: 커서가 깜박이는 창.

  2. Claude 계정을 만들고 요금제 고르기

    브라우저에서 claude.ai로 가서 계정을 만들고, Anthropic 요금 페이지에서 Claude Code가 포함된 요금제를 고른 뒤 그곳에서 결제하세요.

    보이는 화면: claude.ai에 로그인된 상태.

  3. Claude Code 설치하기

    Anthropic의 명령입니다(harnsy의 명령이 아닙니다. 브라우저에서 주소를 열어 스크립트를 먼저 읽을 수 있습니다):

    Shell
    curl -fsSL https://claude.ai/install.sh | bash

    보이는 화면: 내려받는 동안에는 아무것도 움직이지 않습니다. Alpine이거나 curl/bash가 없다면 Anthropic 페이지에 추가로 필요한 패키지가 나와 있습니다.

  4. 확인하기

    새 터미널을 열고 claude --version을 실행하세요.

    보이는 화면: 버전 번호. claude를 찾을 수 없다면 설치 폴더가 PATH에 없는 것입니다. 해결 방법은 Anthropic 설치 페이지에 있습니다.

  5. 로그인하기

    아무 폴더에서나 claude를 실행하고, 브라우저 안내에 따라 Claude 계정으로 로그인한 뒤 종료하세요(Ctrl+C 두 번).

    보이는 화면: Claude Code가 로그인을 요청한 뒤 열립니다.

  6. harnsy 설치하기

    방법은 두 가지입니다. 둘 다 같은 설치 프로그램으로 이어집니다.

    방법 A: AI 프로그램에 부탁하기. AI 프로그램을 열고(claude 또는 codex 입력) 이렇게 말하세요.

    Read https://harnsy.dev/llms.txt and help me install and set up harnsy.

    AI 프로그램은 에이전트를 위해 쓰인 짧은 안내를 읽습니다. 설치하기 전에 설치가 무엇을 바꾸는지 알려 주고(Claude Code와 Codex의 설정 파일: 훅, 그리고 에이전트가 매번 묻지 않고 harnsy를 호출할 수 있게 하는 “harnsy 허용” 항목이며, 이 컴퓨터의 모든 Claude Code 세션에 적용됩니다. 백업이 남습니다), 당신이 “예”라고 할 때까지 기다립니다. 그다음 harnsy를 대신 설치합니다. AI 프로그램에 내려받은 설치 프로그램을 실행할 권한이 없으면, 당신의 터미널에서 직접 명령을 실행해 달라고 합니다. 방법 B와 같은 명령이고, 아무것도 묻지 않습니다. 이것을 피해 갈 다른 방법을 찾지 마세요. AI 프로그램 자체의 안전장치입니다. 그다음 harnsy가 실행되는지 확인하고, 버튼으로 한 가지만 묻습니다. 어느 폴더에서 시작할지입니다. 회사와 첫 프로젝트를 만들고, 리드를 열고, 리드와의 채팅이 열린 브라우저를 띄웁니다.

    방법 B: 명령 입력하기. 실행하기 전에 스크립트를 읽어 볼 수 있습니다. 브라우저에서 다음 주소를 여세요: https://harnsy.dev/install.sh. 아래의 시험 실행은 아무것도 바꾸지 않고, 설치 프로그램이 무엇을 할지 보여 줍니다.

    Shell
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run

    보이는 화면: 설치 프로그램이 거칠 모든 단계. 아무것도 기록되지 않습니다.

    이제 설치합니다. harnsy를 한 번도 설치한 적 없는 컴퓨터라면 --first-run을 붙이세요.

    Shell
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --first-run

    보이는 화면: --first-run을 붙이면 설치 프로그램은 아무것도 묻지 않습니다. harnsy 자체 항목 묶음에 미리 “예”라고 답합니다. 에이전트가 각자 창에서 열릴 수 있고, 새 에이전트마다 harnsy에 관한 짧은 안내를 받고, 브라우저에서 에이전트의 질문에 답할 수 있고, 에이전트가 매번 묻지 않고 harnsy와 통신할 수 있습니다. 이 때문에 Claude Code와 Codex의 설정 파일(훅)이 바뀝니다. 바뀌는 내용은 하나하나 보여 주고, 백업이 남습니다. 트레이 아이콘과 상태 표시줄은 설정하지 않습니다. 마지막에 “What changed on this computer”(이 컴퓨터에서 바뀐 것)와 되돌리는 방법(harnsy uninstall)을 출력합니다. 이미 harnsy가 설치된 적 있는 컴퓨터(제거했지만 데이터가 남아 있는 컴퓨터 포함)에서는 --first-run이 무시되고, 설치 프로그램이 평소처럼 묻습니다.

    실행되는지 확인하기. 브라우저에서 http://127.0.0.1:7788을 여세요.

    보이는 화면: harnsy 대시보드. 아직 회사가 없는 컴퓨터에서는 “Choose your language”(언어 선택)부터 시작합니다. 이것이 다음 단계인 첫 실행입니다.

    에이전트는 tmux가 설치되어 있으면(3.1 이상) tmux에서, 없으면 harnsy 자체 터미널 호스트에서 실행됩니다. 설치할 것은 없고, 대시보드에서 각 에이전트를 실시간으로 볼 수 있습니다. --first-run은 묻지 않고 대신 골라 주며, 일반 설치는 한 번 묻고 답을 저장합니다.

macOS용 Claude Code

시작하기 전에 (Anthropic 페이지, 2026년 11월 8일 읽음): Claude Code를 쓰려면 Pro, Max, Ultra, Team, Enterprise 또는 Console 계정이 필요합니다. 무료 claude.ai 요금제에는 포함되지 않습니다. Anthropic이 Claude Code를 제공하는 국가에 살아야 합니다. macOS 13+, 메모리 4GB, 인터넷. 링크: Anthropic 설치 안내, 요금, 터미널 가이드. 가격은 여기에 적지 않습니다.

로그인 문장(모든 경로): 로그인은 제공업체의 페이지에서 합니다. 코드는 이 컴퓨터의 프로그램으로 바로 전달되고, 프로그램은 늘 보관하던 곳에 로그인을 보관합니다. harnsy는 로그인을 사용하려고 읽지 않으며 어디에도 보내지 않습니다. 프로그램에 로그인되어 있는지만 물어봅니다. 로그인이 함께 들어 있을 수 있는 프로그램의 설정 파일을 바꾸기 전에, harnsy는 그 파일의 백업 사본을 이 컴퓨터에 보관합니다(“Keys, logins and connections” 참고).

  1. 터미널 열기

    터미널은 명령을 입력하는 창입니다. macOS: Terminal을 엽니다(응용 프로그램 › 유틸리티 › Terminal). 설치 프로그램은 관리자 권한을 요구하지 않습니다.

    보이는 화면: 커서가 깜박이는 창.

  2. Claude 계정을 만들고 요금제 고르기

    브라우저에서 claude.ai로 가서 계정을 만들고, Anthropic 요금 페이지에서 Claude Code가 포함된 요금제를 고른 뒤 그곳에서 결제하세요.

    보이는 화면: claude.ai에 로그인된 상태.

  3. Claude Code 설치하기

    Anthropic의 명령입니다(harnsy의 명령이 아닙니다. 브라우저에서 주소를 열어 스크립트를 먼저 읽을 수 있습니다):

    Shell
    curl -fsSL https://claude.ai/install.sh | bash

    이미 Homebrew를 쓰고 있다면 대신 이 명령을 실행할 수 있습니다(macOS 13 이상 필요. 이것도 Anthropic의 명령입니다. Homebrew로 설치한 것은 스스로 업데이트되지 않으니, 업그레이드 방법은 Anthropic 페이지를 보세요):

    Shell
    brew install --cask claude-code

    보이는 화면: 내려받는 동안에는 아무것도 움직이지 않습니다. Alpine이거나 curl/bash가 없다면 Anthropic 페이지에 추가로 필요한 패키지가 나와 있습니다.

  4. 확인하기

    새 터미널을 열고 claude --version을 실행하세요.

    보이는 화면: 버전 번호. claude를 찾을 수 없다면 설치 폴더가 PATH에 없는 것입니다. 해결 방법은 Anthropic 설치 페이지에 있습니다.

  5. 로그인하기

    아무 폴더에서나 claude를 실행하고, 브라우저 안내에 따라 Claude 계정으로 로그인한 뒤 종료하세요(Ctrl+C 두 번).

    보이는 화면: Claude Code가 로그인을 요청한 뒤 열립니다.

  6. harnsy 설치하기

    방법은 두 가지입니다. 둘 다 같은 설치 프로그램으로 이어집니다.

    방법 A: AI 프로그램에 부탁하기. AI 프로그램을 열고(claude 또는 codex 입력) 이렇게 말하세요.

    Read https://harnsy.dev/llms.txt and help me install and set up harnsy.

    AI 프로그램은 에이전트를 위해 쓰인 짧은 안내를 읽습니다. 설치하기 전에 설치가 무엇을 바꾸는지 알려 주고(Claude Code와 Codex의 설정 파일: 훅, 그리고 에이전트가 매번 묻지 않고 harnsy를 호출할 수 있게 하는 “harnsy 허용” 항목이며, 이 컴퓨터의 모든 Claude Code 세션에 적용됩니다. 백업이 남습니다), 당신이 “예”라고 할 때까지 기다립니다. 그다음 harnsy를 대신 설치합니다. AI 프로그램에 내려받은 설치 프로그램을 실행할 권한이 없으면, 당신의 터미널에서 직접 명령을 실행해 달라고 합니다. 방법 B와 같은 명령이고, 아무것도 묻지 않습니다. 이것을 피해 갈 다른 방법을 찾지 마세요. AI 프로그램 자체의 안전장치입니다. 그다음 harnsy가 실행되는지 확인하고, 버튼으로 한 가지만 묻습니다. 어느 폴더에서 시작할지입니다. 회사와 첫 프로젝트를 만들고, 리드를 열고, 리드와의 채팅이 열린 브라우저를 띄웁니다.

    방법 B: 명령 입력하기. 실행하기 전에 스크립트를 읽어 볼 수 있습니다. 브라우저에서 다음 주소를 여세요: https://harnsy.dev/install.sh. 아래의 시험 실행은 아무것도 바꾸지 않고, 설치 프로그램이 무엇을 할지 보여 줍니다.

    Shell
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run

    보이는 화면: 설치 프로그램이 거칠 모든 단계. 아무것도 기록되지 않습니다.

    이제 설치합니다. harnsy를 한 번도 설치한 적 없는 컴퓨터라면 --first-run을 붙이세요.

    Shell
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --first-run

    보이는 화면: --first-run을 붙이면 설치 프로그램은 아무것도 묻지 않습니다. harnsy 자체 항목 묶음에 미리 “예”라고 답합니다. 에이전트가 각자 창에서 열릴 수 있고, 새 에이전트마다 harnsy에 관한 짧은 안내를 받고, 브라우저에서 에이전트의 질문에 답할 수 있고, 에이전트가 매번 묻지 않고 harnsy와 통신할 수 있습니다. 이 때문에 Claude Code와 Codex의 설정 파일(훅)이 바뀝니다. 바뀌는 내용은 하나하나 보여 주고, 백업이 남습니다. 트레이 아이콘과 상태 표시줄은 설정하지 않습니다. 마지막에 “What changed on this computer”(이 컴퓨터에서 바뀐 것)와 되돌리는 방법(harnsy uninstall)을 출력합니다. 이미 harnsy가 설치된 적 있는 컴퓨터(제거했지만 데이터가 남아 있는 컴퓨터 포함)에서는 --first-run이 무시되고, 설치 프로그램이 평소처럼 묻습니다.

    실행되는지 확인하기. 브라우저에서 http://127.0.0.1:7788을 여세요.

    보이는 화면: harnsy 대시보드. 아직 회사가 없는 컴퓨터에서는 “Choose your language”(언어 선택)부터 시작합니다. 이것이 다음 단계인 첫 실행입니다.

    참고: harnsy 자체 노트에 따르면 macOS 설치는 아직 실제 Mac에서 검증되지 않았습니다. 설치 프로그램은 PATH를 바꾸지 않습니다. ~/.local/bin이 PATH에 없으면 설치 프로그램이 알려 주니, 직접 추가하세요. 에이전트를 처음 시작할 때 macOS가 개발자 도구 설치 창을 띄우면 먼저 xcode-select --install을 실행하세요.

    에이전트는 tmux가 설치되어 있으면(3.1 이상) tmux에서, 없으면 harnsy 자체 터미널 호스트에서 실행됩니다. 설치할 것은 없고, 대시보드에서 각 에이전트를 실시간으로 볼 수 있습니다. --first-run은 묻지 않고 대신 골라 주며, 일반 설치는 한 번 묻고 답을 저장합니다.

Windows용 Claude Code

시작하기 전에 (Anthropic 페이지, 2026년 11월 8일 읽음): Claude Code를 쓰려면 Pro, Max, Ultra, Team, Enterprise 또는 Console 계정이 필요합니다. 무료 claude.ai 요금제에는 포함되지 않습니다. Anthropic이 Claude Code를 제공하는 국가에 살아야 합니다. Windows 10 1809+, 메모리 4GB, 인터넷. 링크: Anthropic 설치 안내, 요금, 터미널 가이드. 가격은 여기에 적지 않습니다.

로그인 문장(모든 경로): 로그인은 제공업체의 페이지에서 합니다. 코드는 이 컴퓨터의 프로그램으로 바로 전달되고, 프로그램은 늘 보관하던 곳에 로그인을 보관합니다. harnsy는 로그인을 사용하려고 읽지 않으며 어디에도 보내지 않습니다. 프로그램에 로그인되어 있는지만 물어봅니다. 로그인이 함께 들어 있을 수 있는 프로그램의 설정 파일을 바꾸기 전에, harnsy는 그 파일의 백업 사본을 이 컴퓨터에 보관합니다(“Keys, logins and connections” 참고).

  1. 터미널 열기

    터미널은 명령을 입력하는 창입니다. Windows: PowerShell을 엽니다(시작 메뉴에서 “PowerShell” 입력) (CMD가 아닙니다. 프롬프트에 PS C:\가 보입니다). 설치 프로그램은 관리자 권한을 요구하지 않습니다.

    보이는 화면: 커서가 깜박이는 창.

  2. Claude 계정을 만들고 요금제 고르기

    브라우저에서 claude.ai로 가서 계정을 만들고, Anthropic 요금 페이지에서 Claude Code가 포함된 요금제를 고른 뒤 그곳에서 결제하세요.

    보이는 화면: claude.ai에 로그인된 상태.

  3. Claude Code 설치하기

    Anthropic의 명령. Windows 10 1809 이상이 필요하고 관리자 권한은 필요 없습니다. Git for Windows는 선택 사항이며 Claude Code에 Bash 도구를 더해 줄 뿐입니다.

    PowerShell
    irm https://claude.ai/install.ps1 | iex

    보이는 화면: 내려받는 동안에는 아무것도 움직이지 않습니다. PowerShell이 The token '&&' is not a valid statement separator라고 하면 PowerShell에 있는 것이고, 이 명령에는 그게 맞습니다. 'irm' is not recognized라고 하면 CMD에 있는 것이니 PowerShell을 여세요.

  4. 확인하기

    새 PowerShell 창을 열고 claude --version을 실행합니다.

    보이는 화면: 버전 번호. claude를 찾을 수 없다면 설치 폴더가 PATH에 없는 것입니다. 해결 방법은 Anthropic 설치 페이지에 있습니다.

  5. 로그인하기

    아무 폴더에서나 claude를 실행하고, 브라우저 안내에 따라 Claude 계정으로 로그인한 뒤 종료하세요(Ctrl+C 두 번).

    보이는 화면: Claude Code가 로그인을 요청한 뒤 열립니다.

  6. harnsy 설치하기

    방법은 두 가지입니다. 둘 다 같은 설치 프로그램으로 이어집니다.

    방법 A: AI 프로그램에 부탁하기. AI 프로그램을 열고(claude 또는 codex 입력) 이렇게 말하세요.

    Read https://harnsy.dev/llms.txt and help me install and set up harnsy.

    AI 프로그램은 에이전트를 위해 쓰인 짧은 안내를 읽습니다. 설치하기 전에 설치가 무엇을 바꾸는지 알려 주고(Claude Code와 Codex의 설정 파일: 훅, 그리고 에이전트가 매번 묻지 않고 harnsy를 호출할 수 있게 하는 “harnsy 허용” 항목이며, 이 컴퓨터의 모든 Claude Code 세션에 적용됩니다. 백업이 남습니다), 당신이 “예”라고 할 때까지 기다립니다. 그다음 harnsy를 대신 설치합니다. AI 프로그램에 내려받은 설치 프로그램을 실행할 권한이 없으면, 당신의 터미널에서 직접 명령을 실행해 달라고 합니다. 방법 B와 같은 명령이고, 아무것도 묻지 않습니다. 이것을 피해 갈 다른 방법을 찾지 마세요. AI 프로그램 자체의 안전장치입니다. 그다음 harnsy가 실행되는지 확인하고, 버튼으로 한 가지만 묻습니다. 어느 폴더에서 시작할지입니다. 회사와 첫 프로젝트를 만들고, 리드를 열고, 리드와의 채팅이 열린 브라우저를 띄웁니다.

    방법 B: 명령 입력하기. 실행하기 전에 스크립트를 읽어 볼 수 있습니다. 브라우저에서 다음 주소를 여세요: https://harnsy.dev/install.ps1. 아래의 시험 실행은 아무것도 바꾸지 않고, 설치 프로그램이 무엇을 할지 보여 줍니다.

    PowerShell
    $env:HARNSY_INSTALL_ARGS = "--dry-run"; irm https://harnsy.dev/install.ps1 | iex

    보이는 화면: 설치 프로그램이 거칠 모든 단계. 아무것도 기록되지 않습니다.

    이제 설치합니다. harnsy를 한 번도 설치한 적 없는 컴퓨터라면 --first-run을 붙이세요.

    PowerShell
    $env:HARNSY_INSTALL_ARGS = "--first-run"; irm https://harnsy.dev/install.ps1 | iex

    보이는 화면: --first-run을 붙이면 설치 프로그램은 아무것도 묻지 않습니다. harnsy 자체 항목 묶음에 미리 “예”라고 답합니다. 에이전트가 각자 창에서 열릴 수 있고, 새 에이전트마다 harnsy에 관한 짧은 안내를 받고, 브라우저에서 에이전트의 질문에 답할 수 있고, 에이전트가 매번 묻지 않고 harnsy와 통신할 수 있습니다. 이 때문에 Claude Code와 Codex의 설정 파일(훅)이 바뀝니다. 바뀌는 내용은 하나하나 보여 주고, 백업이 남습니다. 트레이 아이콘과 상태 표시줄은 설정하지 않습니다. 마지막에 “What changed on this computer”(이 컴퓨터에서 바뀐 것)와 되돌리는 방법(harnsy uninstall)을 출력합니다. 이미 harnsy가 설치된 적 있는 컴퓨터(제거했지만 데이터가 남아 있는 컴퓨터 포함)에서는 --first-run이 무시되고, 설치 프로그램이 평소처럼 묻습니다.

    실행되는지 확인하기. 브라우저에서 http://127.0.0.1:7788을 여세요.

    보이는 화면: harnsy 대시보드. 아직 회사가 없는 컴퓨터에서는 “Choose your language”(언어 선택)부터 시작합니다. 이것이 다음 단계인 첫 실행입니다.

    참고: 설치 프로그램은 자신의 폴더를 사용자 PATH에 추가합니다. 새 PowerShell 창에서 harnsy를 입력하세요. Windows Security가 가끔 harnsy.exe를 위협으로 표시합니다. 저희는 오탐이라고 생각합니다(문제 해결 참고).

    에이전트는 harnsy 자체 터미널 호스트(ConPTY)에서 실행됩니다. 설치할 것은 없고, 대시보드에서 각 에이전트를 실시간으로 볼 수 있습니다. --first-run은 묻지 않고 대신 골라 주며, 일반 설치는 한 번 묻고 답을 저장합니다.

Linux용 Codex

시작하기 전에 (OpenAI 페이지, 2026년 11월 8일 읽음): OpenAI 요금 페이지에 따르면 Codex는 ChatGPT Free, Go, Plus, Pro, Business, Edu, Enterprise 요금제에 포함되어 있고(요금제마다 기능이 다르며 사용 한도가 있습니다), 대신 API 키로 API 사용량만큼 낼 수도 있습니다. 링크: Codex CLI, 요금, 로그인 방법. 가격은 여기에 적지 않습니다. 또한 OpenAI가 ChatGPT와 Codex를 제공하는 국가에 살아야 합니다(목록은 OpenAI 페이지에 있습니다).

로그인 문장(모든 경로): 로그인은 제공업체의 페이지에서 합니다. 코드는 이 컴퓨터의 프로그램으로 바로 전달되고, 프로그램은 늘 보관하던 곳에 로그인을 보관합니다. harnsy는 로그인을 사용하려고 읽지 않으며 어디에도 보내지 않습니다. 프로그램에 로그인되어 있는지만 물어봅니다. 로그인이 함께 들어 있을 수 있는 프로그램의 설정 파일을 바꾸기 전에, harnsy는 그 파일의 백업 사본을 이 컴퓨터에 보관합니다(“Keys, logins and connections” 참고).

  1. 터미널 열기

    터미널은 명령을 입력하는 창입니다. Linux: 터미널 앱을 엽니다. 설치 프로그램은 관리자 권한을 요구하지 않습니다.

    보이는 화면: 커서가 깜박이는 창.

  2. Codex가 포함된 요금제의 ChatGPT 계정 준비하기

    브라우저에서 chatgpt.com으로 가서, 계정이 없으면 만들고, OpenAI 요금 페이지에서 요금제를 고르세요(Codex는 Free, Go, Plus, Pro, Business, Edu, Enterprise에 포함되어 있으며 사용 한도가 있습니다). 또는 API 키를 쓰고 API 사용량만큼 낼 수도 있습니다(OpenAI 요금 페이지). API 키는 비밀입니다. 자신의 환경에 보관하세요(예: OPENAI_API_KEY). 프롬프트, 파일, 에이전트에게 보내는 메시지에 넣지 말고, harnsy에도 붙여 넣지 마세요.

    보이는 화면: chatgpt.com에 로그인된 상태.

  3. Codex 설치하기

    OpenAI의 명령입니다(harnsy의 명령이 아닙니다. 브라우저에서 주소를 열어 스크립트를 먼저 읽을 수 있습니다):

    Shell
    curl -fsSL https://chatgpt.com/codex/install.sh | sh

    OpenAI 페이지에는 npm과 Homebrew 탭도 있으니 그곳에서 읽으세요.

    보이는 화면: 설치 프로그램이 끝나고, 새 터미널에서 codex를 시작할 수 있습니다.

  4. 로그인하기

    프로젝트 폴더에서 codex를 실행하세요. 처음 실행할 때 “Sign in with ChatGPT”를 고르고 브라우저에서 마칩니다. 브라우저가 없는 컴퓨터에서는 OpenAI가 codex login --device-auth를 권합니다(베타. OpenAI 페이지에 코드를 입력합니다). API 키로는: printenv OPENAI_API_KEY | codex login --with-api-key. 확인하려면: codex login status.

    보이는 화면: 로그인용 브라우저 페이지가 열리고, 그다음 Codex가 열립니다. 로그인되면 Codex를 닫으세요.

  5. harnsy 설치하기

    “AI 프로그램에 부탁하기” 방법은 Claude Code용으로 쓰였고 Codex로는 시험해 보지 않았습니다. 이 방법을 쓰다가 Codex가 명령 승인을 요청하면 먼저 명령을 읽어 보세요.

    방법 B: 명령 입력하기. 실행하기 전에 스크립트를 읽어 볼 수 있습니다. 브라우저에서 다음 주소를 여세요: https://harnsy.dev/install.sh. 아래의 시험 실행은 아무것도 바꾸지 않고, 설치 프로그램이 무엇을 할지 보여 줍니다.

    Shell
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run

    보이는 화면: 설치 프로그램이 거칠 모든 단계. 아무것도 기록되지 않습니다.

    이제 설치합니다. harnsy를 한 번도 설치한 적 없는 컴퓨터라면 --first-run을 붙이세요.

    Shell
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --first-run

    보이는 화면: --first-run을 붙이면 설치 프로그램은 아무것도 묻지 않습니다. harnsy 자체 항목 묶음에 미리 “예”라고 답합니다. 에이전트가 각자 창에서 열릴 수 있고, 새 에이전트마다 harnsy에 관한 짧은 안내를 받고, 브라우저에서 에이전트의 질문에 답할 수 있고, 에이전트가 매번 묻지 않고 harnsy와 통신할 수 있습니다. 이 때문에 Claude Code와 Codex의 설정 파일(훅)이 바뀝니다. 바뀌는 내용은 하나하나 보여 주고, 백업이 남습니다. 트레이 아이콘과 상태 표시줄은 설정하지 않습니다. 마지막에 “What changed on this computer”(이 컴퓨터에서 바뀐 것)와 되돌리는 방법(harnsy uninstall)을 출력합니다. 이미 harnsy가 설치된 적 있는 컴퓨터(제거했지만 데이터가 남아 있는 컴퓨터 포함)에서는 --first-run이 무시되고, 설치 프로그램이 평소처럼 묻습니다.

    실행되는지 확인하기. 브라우저에서 http://127.0.0.1:7788을 여세요.

    보이는 화면: harnsy 대시보드. 아직 회사가 없는 컴퓨터에서는 “Choose your language”(언어 선택)부터 시작합니다. 이것이 다음 단계인 첫 실행입니다.

    에이전트는 tmux가 설치되어 있으면(3.1 이상) tmux에서, 없으면 harnsy 자체 터미널 호스트에서 실행됩니다. 설치할 것은 없고, 대시보드에서 각 에이전트를 실시간으로 볼 수 있습니다. --first-run은 묻지 않고 대신 골라 주며, 일반 설치는 한 번 묻고 답을 저장합니다.

macOS용 Codex

시작하기 전에 (OpenAI 페이지, 2026년 11월 8일 읽음): OpenAI 요금 페이지에 따르면 Codex는 ChatGPT Free, Go, Plus, Pro, Business, Edu, Enterprise 요금제에 포함되어 있고(요금제마다 기능이 다르며 사용 한도가 있습니다), 대신 API 키로 API 사용량만큼 낼 수도 있습니다. 링크: Codex CLI, 요금, 로그인 방법. 가격은 여기에 적지 않습니다. 또한 OpenAI가 ChatGPT와 Codex를 제공하는 국가에 살아야 합니다(목록은 OpenAI 페이지에 있습니다).

로그인 문장(모든 경로): 로그인은 제공업체의 페이지에서 합니다. 코드는 이 컴퓨터의 프로그램으로 바로 전달되고, 프로그램은 늘 보관하던 곳에 로그인을 보관합니다. harnsy는 로그인을 사용하려고 읽지 않으며 어디에도 보내지 않습니다. 프로그램에 로그인되어 있는지만 물어봅니다. 로그인이 함께 들어 있을 수 있는 프로그램의 설정 파일을 바꾸기 전에, harnsy는 그 파일의 백업 사본을 이 컴퓨터에 보관합니다(“Keys, logins and connections” 참고).

  1. 터미널 열기

    터미널은 명령을 입력하는 창입니다. macOS: Terminal을 엽니다(응용 프로그램 › 유틸리티 › Terminal). 설치 프로그램은 관리자 권한을 요구하지 않습니다.

    보이는 화면: 커서가 깜박이는 창.

  2. Codex가 포함된 요금제의 ChatGPT 계정 준비하기

    브라우저에서 chatgpt.com으로 가서, 계정이 없으면 만들고, OpenAI 요금 페이지에서 요금제를 고르세요(Codex는 Free, Go, Plus, Pro, Business, Edu, Enterprise에 포함되어 있으며 사용 한도가 있습니다). 또는 API 키를 쓰고 API 사용량만큼 낼 수도 있습니다(OpenAI 요금 페이지). API 키는 비밀입니다. 자신의 환경에 보관하세요(예: OPENAI_API_KEY). 프롬프트, 파일, 에이전트에게 보내는 메시지에 넣지 말고, harnsy에도 붙여 넣지 마세요.

    보이는 화면: chatgpt.com에 로그인된 상태.

  3. Codex 설치하기

    OpenAI의 명령입니다(harnsy의 명령이 아닙니다. 브라우저에서 주소를 열어 스크립트를 먼저 읽을 수 있습니다):

    Shell
    curl -fsSL https://chatgpt.com/codex/install.sh | sh

    OpenAI 페이지에는 npm과 Homebrew 탭도 있으니 그곳에서 읽으세요.

    보이는 화면: 설치 프로그램이 끝나고, 새 터미널에서 codex를 시작할 수 있습니다.

  4. 로그인하기

    프로젝트 폴더에서 codex를 실행하세요. 처음 실행할 때 “Sign in with ChatGPT”를 고르고 브라우저에서 마칩니다. 브라우저가 없는 컴퓨터에서는 OpenAI가 codex login --device-auth를 권합니다(베타. OpenAI 페이지에 코드를 입력합니다). API 키로는: printenv OPENAI_API_KEY | codex login --with-api-key. 확인하려면: codex login status.

    보이는 화면: 로그인용 브라우저 페이지가 열리고, 그다음 Codex가 열립니다. 로그인되면 Codex를 닫으세요.

  5. harnsy 설치하기

    “AI 프로그램에 부탁하기” 방법은 Claude Code용으로 쓰였고 Codex로는 시험해 보지 않았습니다. 이 방법을 쓰다가 Codex가 명령 승인을 요청하면 먼저 명령을 읽어 보세요.

    방법 B: 명령 입력하기. 실행하기 전에 스크립트를 읽어 볼 수 있습니다. 브라우저에서 다음 주소를 여세요: https://harnsy.dev/install.sh. 아래의 시험 실행은 아무것도 바꾸지 않고, 설치 프로그램이 무엇을 할지 보여 줍니다.

    Shell
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run

    보이는 화면: 설치 프로그램이 거칠 모든 단계. 아무것도 기록되지 않습니다.

    이제 설치합니다. harnsy를 한 번도 설치한 적 없는 컴퓨터라면 --first-run을 붙이세요.

    Shell
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --first-run

    보이는 화면: --first-run을 붙이면 설치 프로그램은 아무것도 묻지 않습니다. harnsy 자체 항목 묶음에 미리 “예”라고 답합니다. 에이전트가 각자 창에서 열릴 수 있고, 새 에이전트마다 harnsy에 관한 짧은 안내를 받고, 브라우저에서 에이전트의 질문에 답할 수 있고, 에이전트가 매번 묻지 않고 harnsy와 통신할 수 있습니다. 이 때문에 Claude Code와 Codex의 설정 파일(훅)이 바뀝니다. 바뀌는 내용은 하나하나 보여 주고, 백업이 남습니다. 트레이 아이콘과 상태 표시줄은 설정하지 않습니다. 마지막에 “What changed on this computer”(이 컴퓨터에서 바뀐 것)와 되돌리는 방법(harnsy uninstall)을 출력합니다. 이미 harnsy가 설치된 적 있는 컴퓨터(제거했지만 데이터가 남아 있는 컴퓨터 포함)에서는 --first-run이 무시되고, 설치 프로그램이 평소처럼 묻습니다.

    실행되는지 확인하기. 브라우저에서 http://127.0.0.1:7788을 여세요.

    보이는 화면: harnsy 대시보드. 아직 회사가 없는 컴퓨터에서는 “Choose your language”(언어 선택)부터 시작합니다. 이것이 다음 단계인 첫 실행입니다.

    참고: harnsy 자체 노트에 따르면 macOS 설치는 아직 실제 Mac에서 검증되지 않았습니다. 설치 프로그램은 PATH를 바꾸지 않습니다. ~/.local/bin이 PATH에 없으면 설치 프로그램이 알려 주니, 직접 추가하세요. 에이전트를 처음 시작할 때 macOS가 개발자 도구 설치 창을 띄우면 먼저 xcode-select --install을 실행하세요.

    에이전트는 tmux가 설치되어 있으면(3.1 이상) tmux에서, 없으면 harnsy 자체 터미널 호스트에서 실행됩니다. 설치할 것은 없고, 대시보드에서 각 에이전트를 실시간으로 볼 수 있습니다. --first-run은 묻지 않고 대신 골라 주며, 일반 설치는 한 번 묻고 답을 저장합니다.

Windows용 Codex

시작하기 전에 (OpenAI 페이지, 2026년 11월 8일 읽음): OpenAI 요금 페이지에 따르면 Codex는 ChatGPT Free, Go, Plus, Pro, Business, Edu, Enterprise 요금제에 포함되어 있고(요금제마다 기능이 다르며 사용 한도가 있습니다), 대신 API 키로 API 사용량만큼 낼 수도 있습니다. 링크: Codex CLI, 요금, 로그인 방법. 가격은 여기에 적지 않습니다. 또한 OpenAI가 ChatGPT와 Codex를 제공하는 국가에 살아야 합니다(목록은 OpenAI 페이지에 있습니다).

로그인 문장(모든 경로): 로그인은 제공업체의 페이지에서 합니다. 코드는 이 컴퓨터의 프로그램으로 바로 전달되고, 프로그램은 늘 보관하던 곳에 로그인을 보관합니다. harnsy는 로그인을 사용하려고 읽지 않으며 어디에도 보내지 않습니다. 프로그램에 로그인되어 있는지만 물어봅니다. 로그인이 함께 들어 있을 수 있는 프로그램의 설정 파일을 바꾸기 전에, harnsy는 그 파일의 백업 사본을 이 컴퓨터에 보관합니다(“Keys, logins and connections” 참고).

  1. 터미널 열기

    터미널은 명령을 입력하는 창입니다. Windows: PowerShell을 엽니다(시작 메뉴에서 “PowerShell” 입력) (CMD가 아닙니다. 프롬프트에 PS C:\가 보입니다). 설치 프로그램은 관리자 권한을 요구하지 않습니다.

    보이는 화면: 커서가 깜박이는 창.

  2. Codex가 포함된 요금제의 ChatGPT 계정 준비하기

    브라우저에서 chatgpt.com으로 가서, 계정이 없으면 만들고, OpenAI 요금 페이지에서 요금제를 고르세요(Codex는 Free, Go, Plus, Pro, Business, Edu, Enterprise에 포함되어 있으며 사용 한도가 있습니다). 또는 API 키를 쓰고 API 사용량만큼 낼 수도 있습니다(OpenAI 요금 페이지). API 키는 비밀입니다. 자신의 환경에 보관하세요(예: OPENAI_API_KEY). 프롬프트, 파일, 에이전트에게 보내는 메시지에 넣지 말고, harnsy에도 붙여 넣지 마세요.

    보이는 화면: chatgpt.com에 로그인된 상태.

  3. Codex 설치하기

    Windows 자체에 Codex를 설치하세요. OpenAI의 Codex CLI 페이지의 Windows 탭을 따라, PowerShell에서 codex가 동작하도록 합니다. WSL 안에만 설치한 Codex는 harnsy가 찾지 못합니다: PATH와 홈 폴더가 다르기 때문입니다. (OpenAI는 WSL 경로를 따로 설명하지만, 이는 WSL 안에서 일하기 위한 것이며 이 가이드용이 아닙니다.)

  4. 로그인하기

    프로젝트 폴더에서 codex를 실행하세요. 처음 실행할 때 “Sign in with ChatGPT”를 고르고 브라우저에서 마칩니다. 브라우저가 없는 컴퓨터에서는 OpenAI가 codex login --device-auth를 권합니다(베타. OpenAI 페이지에 코드를 입력합니다). API 키로는: printenv OPENAI_API_KEY | codex login --with-api-key. 확인하려면: codex login status.

    보이는 화면: 로그인용 브라우저 페이지가 열리고, 그다음 Codex가 열립니다. 로그인되면 Codex를 닫으세요.

  5. harnsy 설치하기

    “AI 프로그램에 부탁하기” 방법은 Claude Code용으로 쓰였고 Codex로는 시험해 보지 않았습니다. 이 방법을 쓰다가 Codex가 명령 승인을 요청하면 먼저 명령을 읽어 보세요.

    방법 B: 명령 입력하기. 실행하기 전에 스크립트를 읽어 볼 수 있습니다. 브라우저에서 다음 주소를 여세요: https://harnsy.dev/install.ps1. 아래의 시험 실행은 아무것도 바꾸지 않고, 설치 프로그램이 무엇을 할지 보여 줍니다.

    PowerShell
    $env:HARNSY_INSTALL_ARGS = "--dry-run"; irm https://harnsy.dev/install.ps1 | iex

    보이는 화면: 설치 프로그램이 거칠 모든 단계. 아무것도 기록되지 않습니다.

    이제 설치합니다. harnsy를 한 번도 설치한 적 없는 컴퓨터라면 --first-run을 붙이세요.

    PowerShell
    $env:HARNSY_INSTALL_ARGS = "--first-run"; irm https://harnsy.dev/install.ps1 | iex

    보이는 화면: --first-run을 붙이면 설치 프로그램은 아무것도 묻지 않습니다. harnsy 자체 항목 묶음에 미리 “예”라고 답합니다. 에이전트가 각자 창에서 열릴 수 있고, 새 에이전트마다 harnsy에 관한 짧은 안내를 받고, 브라우저에서 에이전트의 질문에 답할 수 있고, 에이전트가 매번 묻지 않고 harnsy와 통신할 수 있습니다. 이 때문에 Claude Code와 Codex의 설정 파일(훅)이 바뀝니다. 바뀌는 내용은 하나하나 보여 주고, 백업이 남습니다. 트레이 아이콘과 상태 표시줄은 설정하지 않습니다. 마지막에 “What changed on this computer”(이 컴퓨터에서 바뀐 것)와 되돌리는 방법(harnsy uninstall)을 출력합니다. 이미 harnsy가 설치된 적 있는 컴퓨터(제거했지만 데이터가 남아 있는 컴퓨터 포함)에서는 --first-run이 무시되고, 설치 프로그램이 평소처럼 묻습니다.

    실행되는지 확인하기. 브라우저에서 http://127.0.0.1:7788을 여세요.

    보이는 화면: harnsy 대시보드. 아직 회사가 없는 컴퓨터에서는 “Choose your language”(언어 선택)부터 시작합니다. 이것이 다음 단계인 첫 실행입니다.

    참고: 설치 프로그램은 자신의 폴더를 사용자 PATH에 추가합니다. 새 PowerShell 창에서 harnsy를 입력하세요. Windows Security가 가끔 harnsy.exe를 위협으로 표시합니다. 저희는 오탐이라고 생각합니다(문제 해결 참고).

    에이전트는 harnsy 자체 터미널 호스트(ConPTY)에서 실행됩니다. 설치할 것은 없고, 대시보드에서 각 에이전트를 실시간으로 볼 수 있습니다. --first-run은 묻지 않고 대신 골라 주며, 일반 설치는 한 번 묻고 답을 저장합니다.

전체 가이드 · 33분

설치부터 작동하는 웹사이트까지, 한 번에.

테스트용 컴퓨터에서 실제로 실행한 모습입니다. harnsy 설치, 첫 프로젝트, 리드에게 작업 맡기기, 디자이너 채용, 작은 가게의 완성된 사이트까지 담았습니다. 챕터로 필요한 장면으로 바로 이동할 수 있습니다.

실제 실행을 빠르게 재생한 영상입니다. 음성은 생성된 음성(영어)이고 자막(영어)은 처음부터 켜져 있으며, 플레이어에서 끌 수 있습니다. 영상 속 의뢰인과 작업은 예시 데이터입니다.

2. 첫 팀

  1. 언어 고르기

    보이는 화면: “Choose your language”(언어 선택). 그 아래에 English, Русский, Español이 있고, 추측한 언어에는 “your browser's language”(브라우저 언어) 표시가 붙습니다. “The dashboard will be in this language, and your team's lead will talk to you in it.”(대시보드가 이 언어로 표시되고, 팀의 리드도 이 언어로 말합니다.)

    고를 것: 언어를 고르고 Continue를 누릅니다.

    다음: 프로그램 화면.

  2. 팀이 쓸 프로그램 고르기

    보이는 화면: “Choose a program for your team”(팀이 쓸 프로그램 선택), Claude Code 카드(“from Anthropic”)와 Codex 카드(“from OpenAI”). harnsy가 살펴보는 동안 카드마다 “Checking this computer…”(이 컴퓨터 확인 중)가 보이고, 그다음 “Installed”(설치됨) 또는 “Not found on this computer”(이 컴퓨터에서 찾을 수 없음), 그리고 “Signed in”(로그인됨) 또는 “Sign-in needed”(로그인 필요)가 표시됩니다. 제목 아래: “Your team is a group of AI helpers that work together. You decide what they work on.”(팀은 함께 일하는 AI 도우미들입니다. 무슨 일을 할지는 당신이 정합니다.)

    고를 것: 설치한 프로그램. 찾을 수 없다고 나오면 Install Claude(또는 Install Codex)를 누르세요. 그 프로그램 자체의 설치 안내가 열립니다. 로그인이 필요하면 Sign in to Claude(또는 Sign in to Codex)를 누르고 3단계를 따르세요. 그다음 Check again을 누릅니다. 다른 프로그램을 쓰려면 Use Codex instead / Choose another program을 누릅니다.

    다음: 카드에 “Claude is ready”(또는 “Codex is ready”)가 보이면 계속합니다.

  3. 로그인하기(필요할 때만)

    Claude: “Sign in to Claude”, 두 단계입니다. “Open Anthropic’s sign-in page”(Anthropic 로그인 페이지 열기. “Sign in there with your Claude account.”: 그곳에서 Claude 계정으로 로그인하세요), 그다음 “Paste the code from that page”(그 페이지의 코드 붙여 넣기. “After you sign in, the page shows a code — paste it here.”: 로그인하면 페이지에 코드가 나옵니다. 여기에 붙여 넣으세요). 코드가 맞지 않으면: “This code did not fit. Copy the whole code from the page and paste it again.”(코드가 맞지 않습니다. 페이지의 코드를 전부 복사해 다시 붙여 넣으세요.)

    Codex: harnsy가 Codex 자체의 기기 코드 로그인을 대신 실행합니다. “Open OpenAI’s page”(OpenAI 페이지 열기. “Any device will do.”: 어떤 기기든 됩니다), “Type this code there”(그곳에 이 코드 입력. WQT2-BZDCE 같은 코드), “The code is valid for up to 15 minutes.”(코드는 최대 15분 동안 유효합니다.) 끝나지 않으면: “Sign-in to Codex did not finish. Press “Sign in to Codex” again.”(Codex 로그인이 끝나지 않았습니다. “Sign in to Codex”를 다시 누르세요.)

    로그인이 보관되는 곳: 이 컴퓨터에서 그 프로그램 자체의 보관 장소입니다. Claude Code의 경우: harnsy는 로그인을 사용하려고 읽지 않으며 어디에도 보내지 않습니다. Claude Code에 로그인되어 있는지만 물어봅니다. 로그인이 함께 들어 있을 수 있는 Claude Code의 설정 파일을 바꾸기 전에, harnsy는 그 파일의 백업 사본을 이 컴퓨터에 보관합니다(“Keys, logins and connections” 참고). Codex의 경우: harnsy는 Codex 자체의 로그인 파일에서 저장된 로그인이 있는지 살펴보거나(있는지 여부만 읽고, 복사하거나 보관하거나 보내지 않습니다), OPENAI_API_KEY가 설정되어 있는지 확인합니다.

    다음: 2단계로 돌아갑니다. “… is ready”.

  4. 회사 이름 정하기

    보이는 화면: “You’re the CEO now.”(이제 당신이 CEO입니다.) “What should we call your company?”(회사 이름을 무엇으로 할까요?) 칸에는 “My First Company”가 채워져 있습니다. “Your company will have teams, leads and AI employees. You set the direction. They handle the work.”(회사에는 팀, 리드, AI 직원이 생깁니다. 방향은 당신이 정하고, 일은 그들이 맡습니다.)

    고를 것: 이름을 그대로 두거나 직접 입력한 뒤 Continue를 누릅니다.

    알아 두기: 첫 실행에서는 “company”(회사)라고 하고, 그 뒤 대시보드에서는 “Organization”(조직)이라고 합니다. 같은 것입니다.

  5. 첫 프로젝트와 그 종류

    보이는 화면: “Every company starts with a project.”(모든 회사는 프로젝트에서 시작합니다.) “Project name”(프로젝트 이름) 칸에는 “My First Project”가 채워져 있습니다. “Projects organize work. Each project has its own team, tasks and goals.”(프로젝트는 일을 정리합니다. 프로젝트마다 자체 팀, 태스크, 목표가 있습니다.) “What kind of project”(어떤 프로젝트인가요) 아래에 선택지가 두 개 있습니다. New project(“Start from scratch. We create an empty folder for it.”: 처음부터 시작합니다. 빈 폴더를 만들어 드립니다)와 My project(“Work in a folder you already have — a website, an app, your documents.”: 이미 있는 폴더에서 일합니다. 웹사이트, 앱, 문서 등).

    고를 것: New project → 6단계로. My project → 5b단계로.

  6. 폴더 알려 주기

    보이는 화면: “Your project’s folder”(프로젝트 폴더. 예시 ~/code/my-project). 입력하는 동안 “Checking the folder…”(폴더 확인 중), 그다음 “Folder found: <folder>”(폴더를 찾았습니다)가 보입니다.

    고를 것: 전체 경로를 입력하고(/ 또는 ~로 시작), Look through my project를 누릅니다.

    거부될 때: “There is no such folder on this computer. Check the path.”(이 컴퓨터에 그런 폴더가 없습니다. 경로를 확인하세요.) · “This folder is outside your home folder. harnsy works only with folders inside it.”(홈 폴더 밖에 있는 폴더입니다. harnsy는 홈 폴더 안의 폴더만 다룹니다.) · “This is your whole home folder. Type the path to your project’s folder inside it.”(홈 폴더 전체입니다. 그 안에 있는 프로젝트 폴더의 경로를 입력하세요.) · “harnsy cannot use this folder: it is hidden, temporary, or holds harnsy's own data. Choose a project folder of your own.”(숨김 폴더, 임시 폴더, 또는 harnsy 자체 데이터가 든 폴더라서 쓸 수 없습니다. 당신의 프로젝트 폴더를 고르세요.)

    다음: “Looking through your project”(프로젝트를 살펴보는 중): “Your lead opens it to read only. Nothing in your folder is changed.”(리드는 읽기 전용으로 엽니다. 폴더 안의 어떤 것도 바뀌지 않습니다.) (리드는 읽기 전용으로 실행됩니다.) 그다음 “Plan ready”(계획 준비됨) 카드가 나옵니다. 수락하기 전까지는 “Agents on this computer change nothing.”(이 컴퓨터의 에이전트는 아무것도 바꾸지 않습니다.) Accept the plan(또는 Stop)을 누르세요. 그 뒤 리드가 일을 시작합니다. 8단계로 건너뛰세요.

  7. 팀이 무슨 일을 할까요?

    보이는 화면: “What will your team work on?”(팀이 무슨 일을 할까요?) 선택지 네 개: Software development(“Making websites and computer programs.”: 웹사이트와 컴퓨터 프로그램 만들기), Marketing & content(“Writing texts and helping people learn about your work.”: 글을 쓰고 사람들이 당신의 일을 알도록 돕기), Business operations(“Organizing everyday work, such as reports and lists.”: 보고서나 목록 같은 일상 업무 정리), Something else(“Choose this if none of the other choices fits.”: 다른 선택지가 맞지 않을 때). 아래에는 “What do you want to accomplish?”(무엇을 이루고 싶나요?)와 예시 “a website for my bakery with the menu and opening hours”(메뉴와 영업시간이 있는 우리 빵집 웹사이트)가 있습니다. “We'll suggest the right AI employees for your project.”(프로젝트에 맞는 AI 직원을 제안해 드립니다.)

    고를 것: 일의 종류를 고르고, 목표를 자신의 말로 적습니다.

  8. 첫 팀 만나기

    보이는 화면: “Meet your first team.”(첫 팀을 만나 보세요.) “Proposed team for “<project>”, from the harnsy catalog. Remove anyone or hire more.”(harnsy 카탈로그에서 고른 “<project>”의 제안 팀입니다. 누구든 빼거나 더 고용할 수 있습니다.) 리드에는 “you talk to this one”(당신이 대화할 상대) 표시가 붙습니다. 사람마다 기술이 적힌 카드가 있습니다.

    고를 것: 원하지 않는 사람은 Remove <name>, 카탈로그를 열려면 + Hire more specialists, 그다음 Create my team(숫자가 붙습니다: “Create my team (2)”)을 누릅니다. 카탈로그가 응답하지 않으면: “The catalog did not answer, so this is the built-in team.”(카탈로그가 응답하지 않아 기본 팀을 보여 줍니다.) 첫 실행에는 한도가 있습니다: “That is the most for the first run: hire the rest later in Roles.”(첫 실행에서는 여기까지입니다. 나머지는 나중에 Roles에서 고용하세요.)

    알아 두기: “Every change you accept is saved to git, so you can go back. You can turn it off in the project’s settings.”(수락한 변경은 모두 git에 저장되므로 되돌릴 수 있습니다. 프로젝트 설정에서 끌 수 있습니다.)

  9. 팀 꾸리기

    보이는 화면: “Putting your team together.”(팀을 꾸리는 중) 세 줄이 차례로 체크됩니다: “Saving your company, project and team”(회사, 프로젝트, 팀 저장 중), “Opening your lead’s window”(리드 창 여는 중. “Claude in a new terminal window”: 새 터미널 창의 Claude), “Your lead is reading its role”(리드가 역할을 읽는 중. “Usually 10–30 seconds”: 보통 10~30초). “Your lead is starting in its own window. The chat opens as soon as it is in.”(리드가 자기 창에서 시작하고 있습니다. 리드가 들어오면 바로 채팅이 열립니다.) 끝나면: “Company, project and team saved”, “Lead’s window opened”, “Your lead is in”.

    실패하면: “Your lead did not start. Your company, project and team are saved. Only starting the lead failed.”(리드가 시작되지 않았습니다. 회사, 프로젝트, 팀은 저장되었습니다. 리드를 시작하는 것만 실패했습니다.) Open the lead’s window 또는 Try again을 누르세요. “문제가 생겼을 때”를 참고하세요.

    다음: 리드와의 채팅이 열립니다.

  10. 리드와 대화하고 첫 태스크 주기

    일어나는 일: 리드가 당신의 언어로 인사하고, 무엇을 이해했는지 한 줄로 말한 뒤, 첫 목표를 한 문장으로 제안하고 시작합니다. 한 시간 안에 끝낼 수 있을 만큼 작고 당신 눈에 보이는 첫 태스크를 고르고, 그 일을 위한 가장 작은 팀을 카탈로그에서 고용합니다(보통 역할 한두 개. 고용 카드는 채팅에 나오고 당신이 눌러야 고용되므로, 당신 없이 합류하는 사람은 없습니다). 그다음 누가 맡았는지, 어떤 태스크인지, 어디를 보면 되는지(“Tasks”), 앞으로 일이 어떻게 진행되는지 알려 줍니다. 채팅으로 리드에게 쓰거나 카드에 댓글을 다세요. 리드가 그것을 팀의 태스크로 나눕니다. 무언가 맞지 않으면 말하세요. 리드가 다시 합니다.

    보이는 화면: 가이드 바 “First run · step n of 6”(첫 실행 · 6단계 중 n단계): Program and sign-in · Company and project · The lead hires the team · Talk with the lead · First task · Check the result. 당신이 확인할 목표 카드. 리드는 일에 답이 필요할 때만, 선택지와 함께 한 번에 한 가지씩 묻습니다.

    고를 것: 리드의 질문에 답하고, 목표를 확인하고, 고용 카드를 누릅니다.

    다음: 태스크 보드 “Tasks”: 카드 하나가 일 하나입니다. 첫 태스크가 Review에 도착하면 열어서 Accept를 누르세요(또는 Return…을 누르고 고칠 점을 적으세요). 그다음 리드에게 다음 일을 부탁하세요. Show the whole dashboard를 누르면 가이드가 끝납니다.

조직과 프로젝트

첫 실행에서는 “company”(회사)라고 하고, 그 뒤 대시보드에서는 “Organization”(조직)이라고 합니다. 같은 것입니다.

  • 조직은 당신의 회사, 즉 프로젝트를 담는 묶음입니다.
  • 프로젝트는 자체 리드, 팀, 태스크, 목표를 가진 폴더 하나입니다.

예시. 작은 스튜디오 “Acme Studio”를 운영한다고 해 봅시다. 이것이 조직 하나입니다. 그 안에 프로젝트 두 개, “웹사이트”와 “모바일 앱”이 있습니다. 폴더 두 개, 리드 두 명, 팀 두 개입니다. 두 번째 조직은 사람, 목표, 역할이 섞이면 안 되는 다른 고객이나 사업을 위해서만 만듭니다.

더 추가하려면. “Organizations” 페이지에서 “New organization”과 “Add organization”을, 또는 “New project in <organization>”을 누르세요.

한도. 무료 harnsy에서는 조직 1개와 프로젝트 2개를 쓸 수 있고, 에이전트 수에는 제한이 없습니다. harnsy Max에서는 조직과 프로젝트를 더 늘릴 수 있습니다. 한도에 도달하면 메시지가 알려 주고, 조직은 계속 동작합니다.

두 번째 프로젝트

안내형 첫 실행은 노드에 회사가 하나도 없을 때만 나타납니다. 나중에 새 프로젝트를 만들려면 “Organizations” 페이지에서 “New project in <organization>”을 누르세요. 그 프로젝트의 리드가 당신과 따로 첫 만남을 가집니다. 투어는 없습니다.

Claude Code 경로와 Codex 경로의 차이

  • 메시지: harnsy는 자체 대기열을 통해 Codex에 메시지를 전달합니다. 실행 중인 Codex는 자기 차례가 끝날 때 메시지를 받습니다. 에이전트의 질문에 대한 사람의 답도 대기열의 메시지 하나로 전달됩니다.
  • 질문과 권한: Codex 자체의 질문은 대시보드에 나타날 수 있습니다(질문마다 선택 하나, 직접 입력한 답도 가능). Codex의 승인 요청은 대시보드에 오지 않습니다. Codex의 터미널 창에 남습니다. Claude Code는 둘 다 대시보드에 옵니다.
  • 훅: 설치 프로그램은 ~/.codex가 있을 때만 ~/.codex/hooks.json에 브리핑 훅을 추가합니다. 다음에 Codex를 시작할 때 Codex가 새 훅을 신뢰할지 물을 수 있습니다. harnsy가 여는 Codex는 폴더 신뢰를 명령줄 플래그로 받고, 업데이트 확인은 꺼져 있습니다.
  • 휴대폰: harnsy의 휴대폰 접속은 harnsy 자체 대시보드 접속입니다.
  • 리드: 리드는 Claude Code나 Codex에서 실행될 수 있으며, 첫 화면에서 고릅니다.

문제가 생겼을 때

  • “The lead did not open: Claude not found.”(리드가 열리지 않음: Claude를 찾을 수 없음) harnsy가 Claude Code를 찾지 못합니다. Claude Code를 설치하고 로그인하세요. 이미 설치되어 있다면 claude가 동작하는 터미널에서 harnsy install을 실행하고(그 PATH를 저장합니다), harnsy를 재시작한 뒤 “Try again”을 누르세요.
  • “The lead did not open: no terminal.”(리드가 열리지 않음: 터미널 없음) 터미널이 선택되지 않았습니다. “Choose a terminal”을 누르거나 ~/.harnsy/config.yaml에 terminal.driver: tmux를 설정하고, 재시작한 뒤 “Try again”을 누르세요.
  • Claude에서 로그아웃되었습니다. 리드의 페이지가 다시 로그인하라고 합니다(링크와 코드). 그 뒤에는 harnsy가 리드에게 첫 메시지를 직접 보냅니다.
  • “My project”가 폴더를 거부합니다. / 또는 ~로 시작하는 전체 경로를 입력하세요. 폴더가 실제로 있어야 하고 홈 폴더 안에 있어야 합니다. 숨김 폴더, 임시 폴더, harnsy 자체 폴더, 그리고 홈 폴더 자체는 거부됩니다.
  • Claude Code가 두 개 설치되어 있고, 오래된 쪽이 먼저 잡힙니다. claude --version(Windows에서는 where.exe claude)을 실행하고 하나만 남기세요.
  • 회사 프록시 뒤에서 아무것도 연결되지 않습니다. Settings › Reach from outside › Proxy에서 “Check”를 누르세요.
  • 더 보기: 문제 해결 (영어).

Troubleshooting (English)

업데이트

업그레이드

harnsy는 스스로 업데이트를 확인하지 않습니다. 확인한 다음 업데이트하세요.

Shell
harnsy update --check
harnsy update

대시보드에서는 “Check for updates”(업데이트 확인)와 “Update”(업데이트) 버튼이 같은 일을 합니다. 설치 명령을 다시 실행해도 됩니다. ~/.harnsy의 데이터는 그대로 남습니다. 노드는 몇 초 동안 재시작되고, 에이전트 세션은 계속 실행됩니다.

참고: 그 몇 초 사이에 보낸 메시지는 실패하니 다시 보내세요. Windows에서는 설치 프로그램이 노드를 재시작하기 전에 묻습니다.

이전 버전으로 되돌리기

업데이트한 뒤:

Shell
harnsy update --rollback --yes

또는 새 릴리스 위에 이전 릴리스를 설치합니다(변수는 curl이 아니라 sh에 줍니다).

Shell
curl -fsSL https://harnsy.dev/install.sh | HARNSY_VERSION=<tag> sh -s -- --allow-older

제거

Shell
harnsy uninstall --dry-run
harnsy uninstall

diff를 보여 주고 물은 뒤, 서비스, 트레이, 프로그램, 그리고 설치가 직접 추가한 설정 항목만 제거합니다(브리핑 훅과 답변 훅, 자동 모드 항목, 상태 표시줄. 설치가 당신의 상태 표시줄을 감쌌다면 원래 것을 되돌려 놓습니다).

참고: 이전 백업은 복원되지 않습니다. ~/.harnsy의 데이터, 백업, 직접 고른 터미널 설정은 남습니다. Claude Code에 준 권한 규칙이나 폴더 신뢰는 되돌리지 않습니다. 터미널 없이 실행하면 아무것도 묻지 않고 설정 항목을 그대로 둡니다.

설치 프로그램 더 알아보기

설치 프로그램이 하는 일

설치 프로그램이 쓰는 모든 것, 묻는 모든 것, 건드리지 않는 것. harnsy install --dry-run은 모든 단계, 바꿀 파일마다의 diff, 만들 파일마다의 경로를 출력하고 아무것도 바꾸지 않습니다.

사용자 계정 안에서만 움직입니다.

모든 것은 사용자 본인의 디렉터리에 들어갑니다. sudo도 관리자 권한도 필요 없습니다. Linux와 macOS에서는 PATH나 셸 프로필을 바꾸지 않습니다. ~/.local/bin이 PATH에 없으면 그렇게 알려 주니, 직접 추가하거나 전체 경로로 harnsy를 호출하세요. Windows에서는 %LOCALAPPDATA%\harnsy\bin을 사용자 PATH에 추가합니다(한 번만, 관리자 권한 없이). 이미 열려 있던 창은 예전 PATH를 유지하므로 새 창에서 harnsy를 입력하세요. 사용자 PATH를 읽거나 바꿀 수 없으면 그렇게 알리고 폴더를 직접 추가하라고 안내합니다(설정 → 환경 변수). harnsy uninstall이 이 항목을 다시 제거합니다.

내려받은 파일을 확인합니다.

한 줄 설치 프로그램은 내 OS와 CPU에 맞는 릴리스를 GitHub에서 HTTPS로 내려받고, 파일이 릴리스의 SHA256SUMS에 없거나 일치하지 않으면 멈춥니다. Linux와 macOS에서는 임시 폴더에 풀어 거기서 harnsy install을 실행하고, 끝나면 폴더를 지웁니다. 이 확인은 깨졌거나 중간에 끊긴 다운로드를 잡아냅니다. 체크섬은 같은 릴리스에서 가져옵니다.

묻지 않고 세 가지를 설정합니다.

프로그램, 설치 기록, 내 사용자만을 위한 백그라운드 서비스입니다. 서비스는 지금 시작되고 로그인할 때마다 시작됩니다.

새로 설치할 때 묻지 않고 쓰는 것
LinuxmacOSWindows
프로그램 (사본)~/.local/bin/harnsy와 링크 ~/.local/bin/ccbusLinux와 같음%LOCALAPPDATA%\harnsy\bin\harnsy.exe
설치 기록~/.local/share/harnsy/install.json과 hooks/harnsy-introduce.pyLinux와 같음%LOCALAPPDATA%\harnsy\install.json
서비스: 지금과 로그인할 때 시작되고, 충돌 후 재시작됩니다systemd 사용자 유닛 ~/.config/systemd/user/harnsy.serviceLaunchAgent ~/Library/LaunchAgents/com.github.butschster.harnsy.plist, 로그는 ~/Library/Logs/harnsy/작업 스케줄러 작업 harnsy, 최소 권한. Windows가 거부하면 HKCU\Software\Microsoft\Windows\CurrentVersion\Run의 값 harnsy(충돌 후 재시작 없음)

다른 서비스 파일이나 작업이 이미 있으면 그것을 보여 주고, 예라고 답한 뒤에만 교체합니다. 이미 있는 ~/.local/bin/ccbus 파일은 ccbus.pre-harnsy로 옮겨집니다.

직접 실행하면 나머지는 모두 먼저 묻습니다.

아래 항목은 각각 [y/N] 질문입니다. y 또는 yes만 인정됩니다. 답이 없거나 터미널이 없거나 --dry-run이면 아니요입니다. 0.8.0부터는 미리 예라고 답하지 않은 경우에만 터미널이 없을 때 아니요로 처리됩니다("미리 예라고 답하기" 참고). --dry-run은 언제나 아니요입니다.

  • 아직 아무것도 선택되지 않았을 때 터미널에서 에이전트를 실행할지(tmux가 설치되어 있으면 tmux, 없으면 harnsy 자체 터미널 호스트, Windows에서는 자체 호스트). 답은 harnsy의 config.yaml에 terminal.driver로 저장됩니다.
  • 트레이 아이콘(Linux 및 Windows): Linux에서는 ~/.local/bin/harnsy-tray. 로그인 시 시작하는 것은 별도의 질문입니다.
  • ~/.claude/settings.json과 ~/.codex/hooks.json의 새 세션용 시작 훅. ~/.claude 또는 ~/.codex가 있을 때만 해당합니다(Windows는 제외).
  • ~/.claude/settings.json의 상태 표시줄. 상태 표시줄이 없을 때만 해당합니다.

설정 파일마다 먼저 정확한 변경 내용을 보여 줍니다. 이미 있는 파일은 먼저 ~/.local/share/harnsy/backups/(Windows는 %LOCALAPPDATA%\harnsy\backups\)에 복사합니다. --accept와 --yes는 직접 줄 때만 대신 예라고 답합니다(0.8.0 이상). --no-tray, --no-hooks, --no-statusline은 해당 단계를 건너뜁니다.

내 컴퓨터 안에만 머뭅니다.

127.0.0.1:7788의 대시보드와 127.0.0.1:7790의 에이전트 포트는 이 컴퓨터에서만 연결을 받습니다. 서비스에는 다른 노드를 위한 127.0.0.1:7789도 주어지지만, 이 포트는 노드 토큰을 발급한 뒤에만 열리고 harnsy Max 키 없이는 절대 열리지 않습니다. harnsy에는 텔레메트리가 없고 업데이트도 확인하지 않습니다. 기본적으로는 이 컴퓨터의 하네스와, 연결한 노드와만 통신합니다. 키를 추가하거나 기능을 켰을 때 접속할 수 있는 서비스는 FAQ "내 데이터는 어디로 가나요?"에 나와 있습니다. 키가 설치되어 있는 동안 harnsy는 하루에 한 번쯤 라이선스 서비스(lic.harnsy.dev)로 키를 확인하며, 전체 키, 머신 ID의 해시(ID 자체는 머신 밖으로 나가지 않습니다), 일회용 무작위 값, 라이선스 패널에 표시된 머신 이름, OS와 아키텍처, harnsy 버전과 빌드 날짜를 보냅니다.

건드리지 않는 것:

  • MCP 서버: 선택 사항인 claude mcp add 줄을 출력해 줄 뿐, 직접 실행하지 않습니다
  • ~/.claude.json
  • Codex의 ~/.codex/config.toml
  • OpenCode의 설정

이후 실행 중에: config.yaml에 claude.auto_trust: true가 있을 때만(기본은 꺼짐) harnsy가 Claude Code를 열기 전에 ~/.claude.json에서 프로젝트 폴더를 신뢰함으로 표시하며, 그 전에 파일을 ~/.harnsy의 claude.json.bak로 복사합니다. harnsy가 연 Codex는 폴더 신뢰를 명령줄 플래그로 받으며, 파일은 쓰지 않습니다.

특정 릴리스, 또는 이전 릴리스로 되돌리기

특정 릴리스, 또는 이전 릴리스로 되돌리기: curl -fsSL https://harnsy.dev/install.sh | HARNSY_VERSION=<tag> sh (변수는 파이프 뒤에 둡니다). 데이터베이스는 테이블과 열만 늘어나므로 이전 빌드도 열 수 있습니다.

harnsy version은 지금 쓰는 빌드를 보여 줍니다.

회사 프록시 뒤에서

회사 프록시 뒤에서 사용하기(0.9.1부터): HTTPS_PROXY(와 HTTP_PROXY)에 프록시를, NO_PROXY에 직접 연결할 호스트를 설정하고 NO_PROXY에 localhost,127.0.0.1,::1을 남겨 두세요. harnsy는 시작할 때 한 번만 이 값을 읽습니다. Windows에서는 사용자 변수로 설정한 뒤 로그아웃했다가 다시 로그인하고, Linux와 macOS에서는 harnsy 서비스(systemd 유닛이나 launchd plist)에 추가한 뒤 다시 시작하세요. 그러면 harnsy net check가 호스트별로 접속할 수 있는지, 안 되면 이유(프록시 로그인, TLS 검사, 경로 없음)를 알려 줍니다.

harnsy에서 에이전트 열기

harnsy는 각 에이전트를 자신이 다루는 창에서 에이전트마다 탭 하나씩 열기 때문에, 에이전트를 열고, 나열하고, 다시 열 수 있습니다. 터미널을 설치하거나 설정할 필요는 없습니다. harnsy가 시스템에 맞는 것을 고릅니다. 터미널이 없어도 메시지, 팀, 대시보드는 똑같이 동작합니다. harnsy가 에이전트를 열거나 다시 열 수 없을 뿐입니다.

~/.harnsy/config.yaml

terminal: driver: tmux # or: conpty

~/.harnsy/config.yaml에서 직접 설정합니다. 설치 프로그램이나 --first-run이 대신 설정해 줍니다.

설치에 관한 질문

시작하기 전에

무엇이 먼저 필요한가요? Linux, macOS 13 이상 또는 Windows 10(1809) 이상이 설치된 컴퓨터가 필요합니다. 그리고 Claude Code 또는 Codex를 설치하고 로그인해 두어야 하며, 그 프로그램을 쓸 수 있는 Anthropic 또는 OpenAI의 요금제나 API 키가 있어야 합니다. 위의 단계가 계정, 설치, 로그인을 차례로 안내합니다. harnsy가 Claude Code나 Codex를 대신 설치해 주지는 않습니다.

어떤 요금제가 필요한가요? 어떤 요금제에 Claude Code나 Codex가 포함되는지는 제공업체가 정하는 규칙이며, 그 규칙은 바뀝니다. 1단계에 링크된 Anthropic과 OpenAI의 요금 페이지를 직접 읽어 보세요. harnsy는 프로그램에 로그인되어 있는지만 물어봅니다.

특별한 터미널이 필요한가요? 아니요. harnsy는 자신이 다루는 터미널에서 에이전트를 실행하고, 시스템에 맞는 것을 고릅니다. Linux와 macOS에서는 tmux가 설치되어 있으면(3.1 이상) tmux, 없으면 harnsy 자체 터미널 호스트이고, Windows에서는 항상 harnsy 자체 터미널 호스트입니다. 이를 위해 설치할 것은 없고, 대시보드에서 각 에이전트를 실시간으로 볼 수 있습니다. 터미널이 없어도 메시지, 팀, 대시보드는 동작합니다. harnsy가 에이전트를 열거나 다시 열 수 없을 뿐입니다.

코딩을 할 줄 알아야 하나요? 아니요. 목표를 쉬운 말로 설명하면 팀이 계획하고 일을 합니다. 시작하려면 AI 프로그램과 harnsy를 설치하고(터미널에서 명령 한두 개) 로그인하면 되며, 방법은 위의 단계에 나와 있습니다. 코드 같은 기술적인 결과를 판단하는 일은 옆에 기술을 아는 사람이 있으면 더 쉽습니다.

설치

스크립트를 내려받는 명령을 실행하기 전에 무엇을 알아야 하나요? 스크립트는 먼저 읽어 볼 수 있습니다. 브라우저에서 그 주소를 여세요. --dry-run은 모든 단계와 모든 변경을 출력하고 아무것도 기록하지 않습니다. 설치 프로그램은 사용자 계정 안에서 동작하고 관리자 권한을 요구하지 않으며, 내려받은 파일을 릴리스의 SHA256SUMS와 대조합니다(이는 파일이 온전히 도착했다는 것을 보여 줄 뿐, 누가 만들었는지를 보여 주지는 않습니다). 내 설정 파일에 대한 모든 변경은 먼저 diff로 보여 주고, 백업을 남깁니다.

설치 프로그램은 내 컴퓨터에서 무엇을 바꾸나요? 프로그램을 사용자 폴더에 넣고, 내 계정용 백그라운드 서비스로 시작합니다. --first-run을 붙이면 harnsy 자체 항목 묶음에도 미리 “예”라고 답합니다(에이전트가 각자 창에서 열리고, 새 에이전트마다 harnsy에 관한 짧은 안내를 받고, 브라우저에서 에이전트의 질문에 답할 수 있고, 에이전트가 매번 묻지 않고 harnsy와 통신합니다). 이 때문에 Claude Code와 Codex의 설정 파일(훅)이 바뀝니다. 트레이 아이콘과 상태 표시줄은 설정하지 않습니다. 마지막에 “What changed on this computer”(이 컴퓨터에서 바뀐 것)와 되돌리는 방법을 출력합니다. 전체 목록은 아래의 “설치 프로그램이 하는 일”에 있습니다. 설치를 되돌리려면 harnsy uninstall을 실행하세요. harnsy가 설치한 프로그램, 서비스, 트레이를 제거하고, 각 변경을 보여 주고 물은 뒤 harnsy가 Claude Code 설정에 추가한 항목(harnsy의 훅, 자동 모드용 권한 항목, harnsy가 설정했다면 상태 표시줄)을 제거합니다. 먼저 백업을 만들며, 백업, ~/.harnsy의 데이터, 그리고 나중에 그 설정에 직접 추가한 것은 남습니다. 터미널 없이 실행하면 아무것도 묻지 않고 그 설정 항목을 그대로 둡니다.

Windows가 harnsy.exe를 위협이라고 합니다. 어떻게 하나요? Windows Security가 가끔 harnsy.exe를 위협으로 표시합니다. 저희는 오탐이라고 생각합니다. 먼저 내려받은 파일을 확인한 다음, harnsy 폴더만 제외하세요. 방법은 문제 해결에 있습니다.

설치 후 “harnsy: command not found”가 나옵니다. Linux와 macOS에서는 설치 프로그램이 PATH나 셸 프로필을 바꾸지 않습니다. ~/.local/bin이 PATH에 없으면 알려 주니, 직접 추가하세요. Windows에서는 %LOCALAPPDATA%\harnsy\bin을 사용자 PATH에 추가합니다(관리자 권한 없이, 한 번만). 그 전에 열린 창은 예전 PATH를 유지하므로 새 창에서 harnsy를 입력하세요. 사용자 PATH를 읽거나 바꿀 수 없으면 그렇게 알리고 폴더를 직접 추가하라고 안내합니다(설정 → 환경 변수). harnsy uninstall이 이 항목을 다시 제거합니다.

터미널 없이 설치할 수 있나요? harnsy는 명령으로 설치되므로, 그 한 단계에는 터미널이 필요합니다. AI 프로그램에 대신 해 달라고 부탁할 수도 있습니다(이 페이지 맨 위의 문장). AI 프로그램은 설치가 무엇을 바꾸는지 알려 주고 당신이 “예”라고 할 때까지 기다립니다. AI 프로그램에 설치 프로그램을 실행할 권한이 없으면, 직접 명령을 실행해 달라고 합니다.

첫 팀

첫 실행에서는 “company”, 대시보드에서는 “Organization”이라고 하는 이유는 무엇인가요? 같은 것입니다. 회사는 프로젝트를 담는 묶음입니다. 첫 실행에서는 더 쉬운 말을 씁니다.

리드는 항상 내 프로젝트를 먼저 살펴보나요? 이미 있는 폴더에서 시작할 때(“My project”)만 그렇습니다. 아무것도 바꾸지 않고 폴더를 읽은 뒤 계획을 보여 주고, 당신이 수락할 때까지 기다립니다. 새 프로젝트라면 몇 가지를 묻고, 첫 목표를 제안한 뒤 일을 시작합니다.

Claude Code 대신 Codex를 쓸 수 있나요? 네. Codex는 첫 화면의 또 다른 선택지이고, 리드는 둘 중 어느 쪽에서도 실행될 수 있습니다. Codex의 질문은 대시보드에 나타나지만, 승인 요청은 Codex 자체의 터미널 창에 남습니다.

harnsy가 내 Claude 로그인을 보나요? harnsy는 로그인을 사용하려고 읽지 않으며 어디에도 보내지 않습니다. Claude Code에 로그인되어 있는지 물어볼 뿐입니다. 로그인이 들어 있을 수 있는 Claude Code 설정 파일의 백업은 이 컴퓨터에 남습니다. “Keys, logins and connections”를 참고하세요. Codex의 경우에는 저장된 로그인이 있는지만 살펴보며, 복사하거나 보관하거나 보내지 않습니다.

세 번째 프로젝트를 추가할 수 없는 이유는 무엇인가요? 무료 harnsy에서는 조직 1개와 프로젝트 2개를 쓸 수 있고, 에이전트 수에는 제한이 없습니다. harnsy Max에서는 더 늘릴 수 있습니다. 한도에 도달하면 메시지가 알려 주고, 조직은 계속 동작합니다. (0.11.0부터.)

여기 없는 질문은 어디에 하나요? 질문하기.