분류 전체보기86 CLAUDE.md 만들기 — Claude Code에 프로젝트를 알려주는 법 CLAUDE.md 파일이 필요한 이유Claude Code는 터미널에서 코드를 읽고 수정해 주는 AI 도구입니다. 그런데 처음 실행하면 한 가지 문제가 생깁니다. Claude Code가 이 프로젝트가 무엇인지 전혀 모른다는 점입니다.어떤 언어를 쓰는지, 폴더 구조가 어떤지, 코딩 규칙이 뭔지 아무 정보가 없습니다. 그래서 매번 대화할 때마다 같은 설명을 반복해야 합니다. "이 프로젝트는 Python이고, 테스트는 pytest로 돌리고, 변수명은 snake_case로 써줘"처럼 말입니다.CLAUDE.md는 이 문제를 해결하는 파일입니다. 프로젝트 루트에 이 파일을 하나 만들어 두면, Claude Code가 대화를 시작할 때 자동으로 읽습니다. 매번 설명을 반복할 필요가 없어지는 겁니다. 사람으로 치면 프로젝.. 2026. 4. 10. Claude Code 컨텍스트 윈도우 초과 오류 해결법 컨텍스트 윈도우 초과 오류가 발생하는 이유Claude Code로 작업하다 보면 갑자기 대화가 더 이상 진행되지 않거나 이전 내용을 기억하지 못하는 상황을 만날 수 있어요. 이 현상은 컨텍스트 윈도우(context window) 초과 오류 때문에 발생해요.컨텍스트 윈도우란 AI가 한 번의 대화에서 기억할 수 있는 텍스트의 최대 크기예요. 사람으로 비유하면 책상 위에 올려놓을 수 있는 서류의 양이라고 생각하면 돼요. 책상이 가득 차면 새 서류를 올리기 위해 기존 서류를 치워야 하듯이, Claude Code도 컨텍스트 윈도우가 가득 차면 이전 대화 내용을 제대로 참조할 수 없게 돼요. 이 오류가 자주 발생하는 상황은 크게 세 가지예요.첫째, 한 대화에서 너무 많은 파일을 읽거나 수정할 때예요. 프로젝트 파일 .. 2026. 4. 10. Claude Code API 키 인증 실패 오류 해결법 API 키 인증 오류가 발생하는 주요 원인Claude Code를 처음 설치하고 실행했는데 "Invalid API Key"나 "Authentication failed" 같은 메시지가 뜨면 당황스러워요. 이 오류는 대부분 API 키가 올바르게 설정되지 않았을 때 발생해요. 구체적으로는 몇 가지 원인이 있어요.첫 번째는 API 키를 아예 설정하지 않은 경우예요. Claude Code는 Anthropic에서 발급받은 API 키가 있어야 동작하는데, 설치만 하고 키 설정을 건너뛰면 인증 오류가 바로 나타나요. 두 번째는 키를 복사할 때 앞뒤에 공백이 포함된 경우예요. 눈에 보이지 않는 공백 문자 하나 때문에 전체 인증이 실패할 수 있어요. 세 번째는 이미 만료되었거나 비활성화된 키를 사용하는 경우예요. Anthr.. 2026. 4. 10. 클로드 코드로 에이전트 실행할 때 토큰 아끼는 방법 Claude Code에서 토큰이 빨리 늘어나는 가장 흔한 이유는 긴 컨텍스트다클로드 코드에서 토큰을 아끼는 첫 번째 방법은 “더 짧게 말하기”가 아니라 “불필요한 문맥을 오래 끌고 가지 않기”다. 공식 문서도 비용은 코드베이스 크기, 질의 복잡도, 대화 길이에 따라 달라지며, 특히 컨텍스트가 커질수록 메시지당 토큰 비용이 커진다고 설명한다. 그래서 전혀 다른 작업으로 넘어갈 때는 같은 세션을 질질 끌기보다 /clear로 문맥을 비우고, 나중에 다시 돌아올 일은 /rename과 /resume으로 관리하는 편이 낫다. 자동 요약과 프롬프트 캐싱이 어느 정도 비용을 줄여주긴 하지만, 결국 가장 큰 절약은 “지금 작업과 상관없는 과거 대화를 계속 먹이지 않는 것”에서 나온다. 스크립트성 실행이라면 --bare를.. 2026. 4. 9. ChatGPT가 갑자기 느려지거나 멈춘 것처럼 보일 때 먼저 확인할 것들 ChatGPT가 느릴 때 먼저 서비스 장애 여부부터 확인해야 하는 이유ChatGPT가 갑자기 느려지거나 멈춘 것처럼 보일 때 많은 사람은 바로 브라우저를 껐다 켜거나, 계정 문제라고 단정해버린다. 그런데 이럴 때 가장 먼저 해야 할 일은 원인을 두 갈래로 나누는 것이다. 하나는 OpenAI 쪽 서비스 지연이나 장애이고, 다른 하나는 내 브라우저·네트워크·기기 환경 문제다. OpenAI 도움말도 “Something went wrong” 같은 일반 오류는 일시적인 서버 문제일 수도 있고, 로컬 환경 문제일 수도 있다고 설명한다. 실제로 OpenAI 상태 페이지에는 대화 로딩 문제, 지연 증가, 빈 응답 같은 이슈가 주기적으로 기록된다. 그러니 ChatGPT가 멎은 것처럼 보이면 가장 먼저 상태 페이지를 보고.. 2026. 4. 9. AI 툴 Voice Clone 탭이 안 열릴 때 원인별 해결 방법 AI 툴 실행 오류 점검: Voice Clone 탭이 안 열려도 실제로는 멈춘 것이 아닐 수 있다Voice Clone 탭이 안 열릴 때 많은 사용자는 버튼 자체가 고장 났다고 생각한다. 하지만 로컬 AI 음성 툴에서는 겉으로 탭이 반응이 없어 보여도, 실제로는 첫 진입 시 필요한 구성 요소를 뒤에서 준비하고 있는 경우가 적지 않다. 최근 Qwen3-TTS 계열 Web UI 문서들을 보면 Voice Clone 탭을 포함한 여러 기능이 한 화면에 보이더라도, 아직 내려받지 않은 모델은 처음 사용할 때 자동 다운로드될 수 있다고 안내한다. 즉 탭을 눌렀는데 아무 일도 없는 것처럼 보여도, 내부에서는 모델 준비나 초기 로딩이 먼저 일어나는 상황일 수 있다. 이럴 때 초보자는 브라우저 문제나 프로그램 오류로 단정.. 2026. 4. 9. 이전 1 ··· 11 12 13 14 15 다음
