Claude Code는 터미널에서 실행되며 파일을 편집하므로, 이미 Obsidian 보관함을 열어 그 안에서 찾은 마크다운 줄에 맞출 수 있습니다. TaskForge는 보관함에 정확한 형식을 명시하는 TaskForge/Settings/agents.md 파일을 더하므로, Claude Code를 보관함에 연결하는 것만으로 문법을 패턴 매칭하는 대신 첫 줄부터 정확히 맞춥니다. 기본 기능에는 플러그인도, API도, MCP 서버도 필요하지 않습니다.
Claude Code는 작업 디렉터리를 기준으로 동작합니다. 그 디렉터리를 보관함으로 두면 필요한 모든 것이 이미 디스크에 있습니다.
TaskForge 3.0 이상에서 보관함을 열고 설정 > AI 및 에이전트로 가서 ‘에이전트 파일 생성’을 켜 두세요. 그러면 TaskForge/Settings/agents.md와 TaskForge/Settings/dialect.json이 보관함에 기록됩니다. 나중에 상태 기호나 날짜 형식을 바꾸더라도 TaskForge가 다시 써서 어긋나지 않게 유지합니다.
터미널에서 보관함 폴더로 이동한 뒤 그곳에서 Claude Code를 시작하세요. 이제 보관함이 작업 디렉터리이므로 TaskForge/Settings/ 안내 파일을 포함한 모든 파일에 닿을 수 있습니다.
cd ~/Documents/MyVault claude
한 줄짜리 지시로 그것이 쓰는 모든 작업이 내 형식을 지키게 할 수 있습니다. 작업을 추가하거나 편집하기 전에 TaskForge/Settings/agents.md를 읽으라고 요청하세요. 같은 줄을 보관함 루트의 CLAUDE.md에 넣어두면 다시 반복할 필요가 없습니다.
TaskForge/Settings/agents.md를 읽고, 오늘 일일 노트의 할 일을 전부 tasks/this-week.md에 추가해 줘. 마감은 금요일로.
Claude Code는 MCP도 다룰 수 있습니다. taskforge 서버를 등록하면 데스크톱 앱이 쓰는 것과 같은 타입이 있는 add, query, complete 도구를 얻고, 스스로 고칠 수 있는 구조화된 오류도 함께 받습니다.
claude mcp add taskforge -- npx -y taskforge-md mcp --stdio
TaskForge/Settings/ 폴더야말로 Claude Code가 첫 시도부터 작업을 정확히 맞추는 이유입니다. 작업 트리의 다른 소스와 마찬가지로 이 파일들을 읽으므로, 이름이 바뀐 "due" 필드나 사용자 지정 "Waiting" 상태는 추측이 아니라 찾아보는 사실이 됩니다.
| TaskForge/Settings/agents.md | 평문 가이드입니다: 체크박스 표기, 상태 기호, 이름이 바뀐 필드, 날짜 형식, 새 작업이 들어갈 위치. |
| TaskForge/Settings/dialect.json | 같은 규칙을 구조화된 JSON으로 담아, Claude Code가 글보다 파싱을 선호할 때를 위한 것입니다. |
| TaskForge/Settings/spaces.json | 저장된 스페이스와 각 스페이스에 추가하는 방법을 담아, "이걸 Errands에 넣어줘"가 올바른 노트로 들어가게 합니다. |
이것은 데모가 아니라 실제 워크플로입니다. Claude Code가 디스크의 파일을 편집하면, 앱이 보관함을 읽는 순간 TaskForge에 결과가 나타나고, 다음 동기화 때 휴대폰도 따라옵니다.
입력하는 내용
“inbox.md를 읽고 아직 답하지 않은 질문을 전부 tasks/this-week.md의 작업으로 만들어 줘. 마감은 모두 금요일.”
Claude Code가 쓰는 내용
- [ ] Priya의 내보내기 형식 질문에 답하기 📅 2026-07-10
- [ ] Sam과 행사장 인원 확정하기 📅 2026-07-10
노트를 읽고 보관함의 문법으로 두 줄을 쓴 다음, 무엇을 추가했는지 알려줍니다. 복사 붙여넣기도, 형식 추측도 필요 없습니다.
입력하는 내용
“tasks/ 안에 #blocked 태그가 붙은 게 있는데 일주일 넘게 지났어? 우선순위를 높음으로 올려줘.”
Claude Code가 쓰는 내용
- [ ] 법무팀 승인 대기 중 ⏫ #blocked 📅 2026-07-02
Claude Code가 작업 파일을 grep해 오래된 것을 찾아 우선순위 표시를 그 자리에서 다시 씁니다. 편집 내용은 커밋 전에 검토할 수 있는 평범한 diff입니다.
Claude Code는 내 기기에서 실행되며 작업 디렉터리 안의 파일만 다룹니다. 작업이 일반 텍스트이므로 모든 변경은 읽을 수 있는 diff이고, git, iCloud, Obsidian Sync 등 보관함에 이미 있는 버전 기록 덕분에 잘못된 편집도 되돌리기 한 번이면 끝입니다. TaskForge 계정도 클라우드도 없습니다.
아니요. 기본 기능은 그냥 파일을 편집하는 것으로 충분합니다. 보관함을 작업 디렉터리로 열고 TaskForge/Settings/agents.md를 읽으라고 하면 내 형식으로 작업을 씁니다. 자유 형식 편집 대신 타입이 있는 도구를 쓰게 하고 싶다면 MCP 서버가 선택지입니다.
TaskForge가 보관함에 생성하는 안내 파일인 TaskForge/Settings/agents.md를 읽습니다. 그 파일은 정확한 표기 방식, 이름이 바뀐 필드, 상태 기호, 날짜 형식을 설명하므로, Claude Code는 다른 도구가 읽지 못하는 일반적인 작업 줄 대신 이를 그대로 맞춥니다.
네. TaskForge는 열릴 때 보관함을 다시 읽고, 실행 중에는 변경 사항을 계속 지켜봅니다. Claude Code가 밤사이 세션에서 쓴 작업도 다음에 앱을 열면 그대로 보입니다.
신경 쓰는 작업 노트만 가리키게 하고, 편집을 받아들이기 전에 diff를 검토하세요. 모든 것이 이미 버전 관리 중인 폴더 안의 일반 텍스트이므로, 그것이 하는 어떤 일도 숨겨지거나 되돌릴 수 없지는 않습니다.
네. Claude Code는 보관함의 로컬 사본을 편집하며, 이미 쓰고 있는 동기화가 Obsidian에서 한 편집을 전달하듯 그 변경 사항을 휴대폰과 다른 기기로 전달합니다.
Claude Code는 하나의 진입 방법일 뿐입니다. AI 개요 페이지는 전체 그림을 다루고, CLI와 MCP 페이지는 터미널과 도구 기반 방법을 자세히 다룹니다.
Claude Code가 읽고 쓸 수 있는 일반 마크다운. TaskForge는 iPhone, iPad, Mac, Android, Windows에서 무료로 다운로드할 수 있습니다.
