에이전틱 코딩

원문 보기 위키 갱신 2026.10.11

AgentFS 샌드박스로 Claude Code, Codex, OpenCode 같은 AI 코딩 에이전트를 파일 변경이 원본 소스 트리와 격리된 환경에서 안전하게 실행할 수 있어요.

출처: 문서

본문

일반적인 에이전틱 코딩 워크플로예요. 예제는 Claude Code를 사용하지만, OpenCode나 Codex 등에서도 워크플로는 동일해요.

git 저장소를 호스트 디렉터리에 클론하세요. 이 소스 트리는 빌드 산출물 없이 깨끗하게 유지해요. main에 머지가 있으면 이 저장소에 pull해서 최신 상태로 유지해요.

git clone https://github.com/tursodatabase/agentfs.git
cd agentfs

--session 플래그와 함께 agentfs run을 사용해 세션을 시작해요. 나중에 git 브랜치 이름이 될 수 있는 이름을 고르세요.

Claude Code:

agentfs run --session fix-bug-123 claude

Codex:

agentfs run --session fix-bug-123 codex

OpenCode:

agentfs run --session fix-bug-123 opencode

이제 에이전트는 copy-on-write 환경에서 실행돼요. 에이전트가 작동하는 동안 원본 소스 트리는 그대로 유지돼요.

에이전트가 뭔가 특이한 동작을 하면 다른 터미널을 열어 같은 세션에 합류해서 조사할 수 있어요:

agentfs run --session fix-bug-123 bash

파일시스템은 셸과 에이전트 사이에 공유돼요. 에이전트가 작업하는 동안 파일을 살펴보거나, 테스트를 실행하거나, 상황을 확인할 수 있어요.

에이전트가 작업을 마치면 브랜치를 만들고 커밋하고 푸시하도록 요청하세요:

"fix-bug-123이라는 브랜치를 만들고, 이 변경을 커밋하고, origin에 푸시해 줘"

그다음 푸시된 브랜치에서 수동으로 PR을 만들면 돼요.