처음 시작하기: 첫 지시부터 작업 트리 읽기까지

CLI 코딩 에이전트란

CLI 코딩 에이전트는 터미널에서 돌아가는 AI 프로그램입니다. "로그인 화면에 비밀번호 보기 버튼을 넣어 줘"처럼 말로 지시하면, 코드를 읽고 파일을 고치고 명령을 실행해 결과를 알려 줍니다. 대표적인 것이 Anthropic의 Claude Code와 OpenAI의 Codex CLI입니다.

TiniaCode는 에이전트를 대신하지 않습니다. 여러분이 설치한 에이전트를 실행하고, 그들이 한 일을 작업 트리·기록·메모로 정리해 다음 날에도 한눈에 보이게 합니다. 에이전트 이용 요금과 계정은 각 제공사에서 따로 관리합니다.

1. 에이전트 설치하고 로그인하기

첫 실행 설정의 "에이전트" 단계(또는 설정의 에이전트 항목)에서 합니다. 둘 중 하나만 있어도 됩니다.

1. "설치되어 있지 않음"이라고 나오면 설치를 누릅니다. 터미널이 열리고 제공사의 공식 설치 명령이 실행됩니다.
2. "로그인 필요"라고 나오면 로그인을 누릅니다. 터미널과 브라우저에서 제공사 계정으로 로그인하세요.
3. 다시 확인을 눌러 "로그인됨"으로 바뀌었는지 봅니다.

# Claude Code
curl -fsSL https://claude.ai/install.sh | bash

# Codex CLI
npm install -g @openai/codex

2. 프로젝트 열기

• 폴더 열기…(Ctrl+K 다음 Ctrl+O)로 프로젝트 폴더를 고릅니다. 한 번 연 폴더는 "최근 프로젝트"에서 한 번에 다시 열 수 있습니다.
• Windows에서는 WSL 안의 폴더가 가장 빠릅니다.
• Git 저장소가 아닌 폴더라면 첫 지시 때 TiniaCode가 저장소를 만들어, 끝난 작업을 자동으로 저장합니다.

3. 첫 지시 내리기

대화 칸에 할 일을 문장으로 적고 보냅니다. 좋은 지시에는 세 가지가 들어 있습니다: 무엇을, 어디에, 어떻게 되면 끝인지.

README.md 맨 위에 프로젝트를 한 문장으로 소개하는 줄을 넣어 줘.
다른 내용은 바꾸지 말고, 끝나면 바꾼 줄을 보여 줘.

에이전트가 일을 마치면 무엇을 했는지 한 줄로 정리해 보여 주고, 기본 설정에서는 소리로도 알려 줍니다. 소리가 필요 없으면 설정의 "일감 시작·완료를 말로 알림"을 끄세요.

4. 에이전트가 한 일 읽기

• 작업 트리 — 첫 번째 열입니다. 작업 → 세션 → 지시 순서로 쌓이고, 줄을 누르면 그 대화로 바로 갑니다. 다음 날 와서 어제 무엇을 했는지 여기서 봅니다.
• 기록 탭 — "할 일·기록·메모" 열에 있습니다. "요청 기록 검색"에 단어를 넣으면 예전에 내린 지시를 본문·모델·세션·폴더로 찾을 수 있습니다.
• 할 일 탭 — 프로젝트의 .tiniacode/TODO.md를 여러분과 에이전트가 함께 씁니다. - [ ] 할 일, - [>] 하는 중, - [x] 끝남. 에이전트가 스스로 세운 계획은 "에이전트 할 일"로 따로 보입니다.
• 메모 탭 — 생각과 결정을 남깁니다. 새 메모는 Ctrl+N, 이전 버전과 지운 메모도 되살릴 수 있습니다.

5. Pro 체험하기

Core는 계정 없이 무료로 씁니다. 여러 기기에서 이어 하기(멀티디바이스 데이터 싱크), 내장 메신저 협업, 통합 등록한 여러 프로젝트의 메모를 한곳에서 보고 고치기는 Pro 기능입니다. 앱에서 계정을 만들면 Pro 14일 무료 체험이 시작되고, 카드는 필요 없습니다.

1. 대화 열 가장자리의 메신저 버튼을 누릅니다.
2. 계정 만들기를 누르고 이메일, 이름, 비밀번호(8자 이상)를 넣습니다.
3. 보안 질문 두 개에 답합니다. 비밀번호를 잊었을 때 이 두 답으로만 계정을 되찾을 수 있으니 꼭 기억해 두세요.

체험이 끝나면 Core로 돌아가고 데이터는 지우지 않습니다. 계속 쓰려면 Pro 구매에서 같은 계정으로 결제하세요(연간 USD 30, 30일 안에 전액 환불).