클로드 프로젝트에 도구 넣기 — 넷이 다른 자리·끄면 계정 기본값이 바뀜

프로젝트에 일을 맡기면 갈래는 내 컴퓨터의 설정을 하나도 물려받지 않는다고 앞서 짚었습니다. 그럼 평소 쓰던 스킬·확장 묶음·연결기·명령줄 도구는 어떻게 넣을까요. 답은 넷이 각각 다른 자리에 들어간다는 것입니다.

특히 연결기는 규칙이 특이합니다. 계정에 한 번 붙여 두면 모든 갈래가 쓰는데, 정작 조율하는 대화에는 연결기가 없습니다. 게다가 갈래에서 하나를 끄면 그 갈래만 바뀌는 게 아닙니다.

📌 30초 요약

• 넷이 각각 다른 자리입니다.
• 스킬은 저장소에 커밋합니다.
• 조율 대화엔 연결기가 없습니다.
• 끄면 계정 기본값이 바뀝니다.
• 설정은 새 갈래부터 먹습니다.

1. 넷을 각각 어디에 넣나

갈래는 클라우드에서 도는 세션이라 제 기계에만 깔린 것은 전부 없는 셈입니다. 그래서 쓰고 싶은 것마다 들어가는 문이 다릅니다.

무엇을	어디에 넣나
스킬·하위 에이전트·명령	프로젝트 저장소에 커밋
확장 묶음	프로젝트 설정의 전용 자리
외부 도구 연결기	계정에 한 번 붙이면 전부 공유
명령줄 도구·패키지	환경의 준비 스크립트

첫째 줄이 편리한 대목입니다. 갈래는 프로젝트의 모든 저장소를 복제하면서 각각의 스킬·에이전트·명령 폴더를 읽어 옵니다. 그러니 한 저장소에 커밋해 둔 스킬이 새로 뜨는 모든 갈래에서 쓰입니다. 덧붙여 계정 쪽에서 켜 둔 스킬도 함께 실립니다.

넷째 줄은 준비 스크립트의 성질을 알아 두시면 쉽습니다. 클로드가 일을 시작하기 전에 도는 자리라, 여기서 깔아 두지 않은 명령은 갈래가 못 씁니다.

넷을 헷갈리지 않는 요령은 「누가 읽어 가느냐」를 떠올리는 것입니다. 스킬과 하위 에이전트, 명령은 갈래가 저장소를 복제한 뒤 그 안의 약속된 폴더를 뒤져 찾아냅니다. 그러니 저장소 밖에 만들어 두면 아무리 잘 짜 놨어도 보이지 않습니다. 반면 확장 묶음은 프로젝트 설정이 목록을 들고 있고, 저장소가 스스로 「이걸 쓰겠다」고 적어 둔 것도 함께 실립니다. 두 경로가 모두 살아 있으니, 팀이 같이 쓰는 것은 저장소에 적어 두고 저만 쓰는 것은 설정에 넣는 식으로 나눌 수 있습니다.

2. 연결기만 규칙이 다릅니다

외부 도구를 붙이는 연결기는 계정에 한 번만 연결해 두면 모든 갈래가 프로젝트별 설정 없이 전부 씁니다. 여기까지는 편한데, 바로 다음 문장이 함정입니다 — 조율하는 대화 자체에는 연결기가 없습니다.

그래서 외부 도구가 필요한 일은 조율 대화에 바로 시키면 안 되고 갈래로 보내야 합니다. 「이 일정 확인해 줘」처럼 툭 던지면 조율자는 그 도구가 없어 못 하죠. 참고로 저장소가 하나인 프로젝트라면 그 저장소에 적어 둔 서버 설정도 함께 실립니다.

이 성질은 일을 시키는 순서까지 바꿉니다. 조율 대화에서 이야기를 주고받다가 「그럼 이걸 그쪽에 올려 줘」처럼 외부 도구가 필요한 대목이 나오면, 그 자리에서는 안 되고 갈래가 하나 떠야 합니다. 처음부터 외부 도구가 끼는 일이라면 조율 대화에 설명을 길게 늘어놓기보다 곧장 작업으로 넘기는 편이 빠릅니다.

⚠️ 갈래에서 끄면 계정 기본값이 바뀝니다

돌고 있는 갈래가 어떤 연결기를 갖고 있는지는 그 갈래를 열고 입력창 옆 더하기 메뉴에서 볼 수 있습니다. 문제는 거기서 하나를 끌 때입니다 — 그 갈래에서 빠지는 데 그치지 않고 계정 기본값으로 저장됩니다. 그러면 앞으로 뜨는 갈래는 물론이고 평소 쓰던 대화까지 그것 없이 시작합니다. 다시 켤 때까지요. 「이번 작업에만 빼자」는 뜻으로 눌렀다가 범위가 훨씬 넓어지는 셈입니다. 반대로 새로 붙이거나 다시 연결한 연결기는 그 갈래에 메시지를 한 번 더 보내야 잡힙니다.

3. 환경이 정하는 네 가지

새로 뜨는 갈래는 모두 프로젝트의 클라우드 환경에서 출발합니다. 이 환경이 정하는 것은 갈래가 닿을 수 있는 주소, 갖는 환경 변수, 요청에 붙는 자격 증명, 그리고 클로드가 시작하기 전에 준비 스크립트가 깔아 두는 것입니다.

따로 고르기 전까지는 기본으로 마련된 환경을 씁니다. 그래서 갈래가 사내 API나 사설 패키지 저장소에 닿아야 하거나, 평소 제 기계가 들고 있던 토큰이 필요하다면 프로젝트가 아니라 환경 쪽을 바꿔야 합니다. 프로젝트 설정만 뒤지다 못 찾는 경우가 여기서 나옵니다.

클라우드 환경 자체를 관리할 때의 성질은 따로 정리해 둔 적이 있으니, 환경을 새로 만들거나 팀과 나눠 쓰실 계획이라면 함께 보시면 됩니다. 프로젝트 쪽에서는 이미 있는 환경 중 하나를 고르는 것이 전부입니다.

4. 바꾼 설정은 언제 먹히나

프로젝트 설정은 웹이나 데스크탑 앱에서 바꿉니다 — 설정 파일을 직접 고치는 방식이 아닙니다. 대부분 바꾸는 즉시 저장되고, 목표나 지시문처럼 글을 쓰는 칸만 「변경 저장」과 「버리기」가 뜹니다.

설정 화면에 무엇이 모여 있는지 한 번 훑어 두면 헤매는 시간이 줄어듭니다. 맨 위에 이름과 아이콘, 무엇을 하는 프로젝트인지 적는 칸이 있고, 그 아래로 조율자와 갈래가 각각 어떤 모델을 얼마만큼의 노력으로 쓸지 고르는 자리가 따로 놓입니다. 이어서 지시문 · 저장소 목록 · 클라우드 환경 · 연결기 · 확장 묶음이 차례로 나옵니다. 아래쪽에는 사용량과 기억을 보는 자리, 클로드를 다시 시작하는 단추, 프로젝트를 잠시 멈추거나 보관하거나 지우는 항목이 모여 있습니다.

무엇을 바꿨나	언제 먹히나
지시문·저장소	새로 뜨는 갈래부터
확장 묶음·환경	마찬가지로 새 갈래부터
이미 도는 갈래	영향을 받지 않습니다
연결기 끄기	그 갈래와 계정 전체에 바로

셋째 줄과 넷째 줄의 대비가 눈에 띕니다. 설정 화면에서 바꾼 것들은 돌고 있는 갈래를 건드리지 않는데, 갈래 안에서 끈 연결기는 계정 전체로 번집니다. 방향이 정반대죠. 무언가를 고쳤는데 지금 도는 갈래가 그대로라면 새 갈래를 띄워 확인하시는 편이 빠릅니다. 저장소를 둘 이상 묶으면 권한 규칙과 훅이 빠지는 것과 함께, 「어디에 넣느냐가 적용 범위를 정한다」는 점을 기억해 두시면 좋습니다.

자주 묻는 질문 (FAQ)

Q. 평소 쓰던 스킬을 갈래에서도 쓰고 싶습니다

프로젝트에 넣은 저장소에 커밋하세요. 갈래가 모든 저장소를 복제하며 스킬 폴더를 읽어 오므로, 한 곳에만 커밋해도 모든 새 갈래에서 쓰입니다. 계정에서 켜 둔 스킬도 함께 실립니다.

Q. 조율 대화에 시켰더니 도구가 없다고 합니다

정상입니다. 조율하는 대화 자체에는 연결기가 없습니다. 외부 도구가 필요한 일은 갈래로 보내는 작업으로 시키세요. 갈래들은 계정에 붙인 연결기를 전부 씁니다.

Q. 다른 대화에서도 연결기가 사라졌습니다

갈래 안에서 연결기를 끄면 계정 기본값으로 저장되기 때문입니다. 새 갈래와 평소 대화까지 그것 없이 시작하니, 다시 켜 주셔야 원래대로 돌아옵니다.

Q. 사내 API에 닿게 하려면 어디를 고치나요

프로젝트 설정이 아니라 클라우드 환경 쪽입니다. 닿을 주소·환경 변수·자격 증명·준비 스크립트가 모두 환경에 딸려 있습니다. 프로젝트에서는 어느 환경을 쓸지 고르는 것만 합니다.

정리하면

• 넷은 각각 다른 문입니다.
• 스킬은 커밋이 곧 설치입니다.
• 조율자는 외부 도구가 없습니다.
• 끄기는 계정까지 번집니다.
• 사내 접근은 환경에서 고치세요.

※ 공개된 프로젝트 문서의 환경·도구 절과 설정 참조를 읽고 정리했습니다. 화면 이름과 설정 항목은 우리말로 풀어 적었으니 실제 표기는 원문에서 확인하세요.

※ 이 기능은 베타 단계로 소개돼 있어 설정 위치와 적용 범위가 바뀔 수 있습니다. 원문과 대조해 확인하세요.