작성자 주: Claude Code v2.1.318 업데이트 노트를 바탕으로 공유 네트워크 home 디렉터리에서 발생하는 Claude Code 설정 유실, “Not logged in”, 로그인 만료 등 7가지 문제의 원인과 해결 절차를 정리했어요.
대학 전산실, HPC 클러스터, 회사 점프 서버 같은 환경에서는 사용자 home 디렉터리가 NFS나 다른 네트워크 파일 시스템에 마운트되어 여러 호스트가 같은 ~를 공유하는 경우가 많아요. 이런 환경에서 Claude Code를 사용하면 MCP 서버 설정이 다음 날 사라지거나, 로그아웃 직후 자동으로 다시 로그인되거나, 백그라운드 작업에서 갑자기 Not logged in 오류가 발생하거나, ~/.claude.json이 비워지는 문제가 생길 수 있어요. 이 글에서는 공유 네트워크 home 디렉터리에서 Claude Code 설정과 로그인 문제를 해결하는 방법을 살펴보고, 원인이 버전인지, 파일 시스템인지, 자격 증명 자체인지 판단하도록 도와드려요.
경험만으로 짜 맞춘 근거 없는 체크리스트가 아니에요. 2026년 11월 4일에 발표된 Claude Code v2.1.318은 업데이트 노트에서 ‘공유 네트워크 home 디렉터리’와 관련된 여러 문제를 수정했어요. 이 글의 문제 해결 절차는 모두 해당 업데이트 노트를 기반으로 해요.
핵심 내용: 이 글을 읽으면 증상에 따라 공유 home 환경에서 발생한 Claude Code 설정이나 로그인 문제의 원인을 찾고, 업그레이드가 필요한지, 백업을 복원해야 하는지, 다른 인증 방식을 사용해야 하는지 판단할 수 있어요.
공유 네트워크 home 디렉터리에서 Claude Code 설정과 로그인 핵심 사항
먼저 전체 구조를 살펴볼게요. Claude Code는 home 디렉터리에서 주로 세 가지 상태를 관리해요. 전역 설정 파일 ~/.claude.json(MCP 서버, 신뢰할 수 있는 디렉터리 등), settings 설정 파일, 저장된 로그인 자격 증명이에요. 공유 네트워크 home에서는 여러 프로세스와 호스트가 이 파일들을 동시에 읽고 써요. 네트워크 파일 시스템의 잠금, 캐시, 할당량 동작도 로컬 디스크와 달라요. 아래 표는 v2.1.318에서 이와 직접 관련된 변경 사항을 정리한 것이에요.
| 핵심 사항 | 설명 | 기대 효과 |
|---|---|---|
| 쓰기 실패 시 더 이상 “성공”으로 표시하지 않음 | 공유 home에서 설정을 업데이트할 수 없으면 /logout, claude auth logout, claude mcp remove가 더 이상 성공을 보고하지 않음 |
로그아웃됐다고 생각했지만 실제로는 안 된 상황 방지 |
| 다른 호스트에서 다시 로그인해도 작업이 중단되지 않음 | 같은 home을 사용하는 다른 터미널이나 호스트에서 같은 계정과 조직으로 다시 로그인해도 실행 중인 작업이 Not logged in 오류로 종료되지 않음 | 여러 호스트에서 병렬 작업을 더 안정적으로 실행 |
| MCP 설정 쓰기에 잠금 적용 | claude mcp add/remove가 설정 잠금을 기다리며, 잠금을 얻지 못하면 종료 코드 1로 종료됨 |
동시 쓰기로 인한 설정 손상 감소 |
| 로그인 만료 시각 확인 가능 | claude auth status에 loginExpiresAt이 추가되고, claude -p의 JSON 결과에 credential_expires_at이 추가됨 |
만료가 임박한 로그인을 미리 확인 |
| 설정 파일의 손상 가능성 감소 | 공유 home에 ~/.claude.json, 설정 파일, 로그인 자격 증명을 저장할 때 파일이 삭제되거나 잠시 비워지거나 오래된 사본으로 덮어써지는 일이 줄어듦 |
설정이 “갑자기 사라질” 가능성 감소 |
공유 home에서 Claude Code 설정에 문제가 생기기 쉬운 이유
로컬 디스크에서 Claude Code가 설정을 저장하는 과정은 사실상 원자적 작업으로 볼 수 있어요. 반면 네트워크 파일 시스템에서는 ‘임시 파일을 쓴 뒤 교체하기’나 ‘파일 존재 여부 확인하기’ 같은 작업이 클라이언트 캐시의 영향을 받을 수 있어요. 예를 들어 파일이 실제로 존재하는데도 없다고 보고될 수 있죠. 이전 버전은 이 경우 설정이 없다고 판단해, 시작할 때 MCP 서버와 신뢰할 수 있는 디렉터리가 모두 사라질 수 있었어요. v2.1.318에서는 설정 파일이 없다고 잘못 보고되면 다시 확인하도록 개선해, 빈 설정으로 시작하는 경우를 줄였어요.
디스크 할당량도 주의해야 해요. 업데이트 설명에는 네트워크 home에 데이터를 쓸 공간은 없지만 새 파일 생성은 여전히 허용되는 경우가 나와 있어요. 이때 로그인 자격 증명을 저장하면 기존 자격 증명 파일이 빈 파일로 교체되어 사용자가 곧바로 로그아웃될 수 있었어요. 새 버전에서는 이 문제가 수정됐어요. 그래도 클러스터의 home 할당량이 빡빡하다면 df나 클러스터에서 제공하는 quota 명령으로 남은 공간을 정기적으로 확인하는 것이 좋아요.
공유 home에서 발생하는 Claude Code 로그인 동시성 문제
로그인 상태도 문제가 자주 발생하는 부분이에요. 여러 호스트가 같은 home을 공유할 때, A 머신에서 claude auth login으로 다시 로그인하면 B 머신에서 실행 중인 claude -p 배치 작업이 이전에는 Not logged in 오류와 함께 바로 종료될 수 있었어요. v2.1.318에서는 같은 계정과 조직을 사용하는 경우 이 문제가 수정됐어요. 또한 claude plugin 계열 명령이 오래 걸리는 토큰 갱신이 저장되기 전에 종료되어, 다음 실행 때 로그아웃된 상태가 되는 문제도 수정됐어요.
좀 더 발견하기 어려운 문제도 있어요. 같은 머신의 다른 로그인에서 allowedProviders 목록을 저장하면, 세션을 시작할 때 이 목록 때문에 접근이 거부될 수 있었어요. 여러 사람이 점프 서버를 함께 사용하거나 한 사용자가 서로 다른 조직으로 전환해 로그인할 때 발생하기 쉬운 문제였는데, 새 버전에서는 이런 잘못된 거부가 발생하지 않아요.
공유 home 디렉터리에서 Claude Code 문제 해결 빠른 시작
이 글에서는 코드 블록 없이 명령어와 필드를 모두 인라인으로 표시해요. 문제 해결 과정은 네 단계로 나뉘며, 순서대로 진행하는 것을 권장해요.
1단계: Claude Code 버전과 로그인 상태 확인
먼저 claude --version을 실행해 버전을 확인하세요. v2.1.318보다 낮다면 claude update나 기존 설치 방식을 사용해 업그레이드하는 것이 좋아요. 이 글에서 다루는 여러 문제는 이전 버전에서 우회만 가능하고 근본적으로 해결할 수 없기 때문이에요. 업그레이드 후에는 claude auth status를 실행해 현재 계정과 조직, 새로 추가된 loginExpiresAt 필드를 확인하세요.
스크립트에서 주로 claude -p를 호출한다면 JSON 결과를 출력하도록 설정하고, 파이프라인에서 credential_expires_at 필드를 읽어 만료 전에 알림을 받을 수 있어요. 텍스트 출력 모드에서는 새 버전이 저장된 claude.ai 로그인의 만료 10일 전부터 stderr에 한 줄 경고를 출력하므로 로그를 확인하세요.
| 명령어/필드 | 용도 | 문제 해결 시 확인할 사항 |
|---|---|---|
claude --version |
현재 버전 확인 | ≥ v2.1.318인지 확인 |
claude auth status |
로그인 상태 확인 | loginExpiresAt이 임박했는지 확인 |
claude -p（JSON 출력） |
무인 호출 | credential_expires_at 필드 |
claude auth login |
claude.ai 계정에 다시 로그인 | 로그인 만료 후 안내에 따라 실행 |
claude setup-token |
무인 실행에 사용할 토큰 생성 | CI와 배치 처리에 적합 |
claude mcp add / claude mcp remove |
MCP 서버 관리 | 종료 코드 1은 설정 잠금을 획득하지 못했음을 의미 |
두 번째 단계: ~/.claude.json이 정상인지 확인하기
공유 home에서 ~/.claude.json이 손상되면 설정이 모두 사라진 것처럼 보이는 경우가 많아요. v2.1.318에서는 관련 동작이 바뀌었어요. 비대화형으로 시작할 때 이 파일이 유효한 JSON이 아니면 기본값으로 덮어쓰지 않고, 원본을 보존한 채 시작을 중단하고 복구 방법을 안내해요(issue #87551). 파일이 비어 있고 백업도 없다면 손상된 것으로 처리하지 않고 파일이 없는 것처럼 정상적으로 시작해요.
새 버전에서 출력하는 복구 명령도 더 안정적이에요. 이전에는 복구 명령이 비어 있거나 잘린 백업을 가리키거나, 파일이 읽기 전용일 때 실패할 수 있었는데 이 문제가 수정됐어요. 또한 claude -p만 실행하는 home에서는 보존 기간에 따른 정리 과정에서 마지막 ~/.claude.json 백업까지 삭제될 수 있었지만, 이제는 새 백업을 먼저 생성한 뒤 이전 백업을 삭제해요.
세 번째 단계: 로그인 실패와 자격 증명 만료 해결하기
로그인에 실패했다면 오류 메시지에 “저장된 claude.ai 로그인이 만료됐다”는 안내가 있는지 먼저 확인하세요. 새 버전은 이 상황을 명확히 알리고, claude -p 환경에서는 claude auth login과 claude setup-token 두 가지 해결 방법을 함께 제시해요. 대화형으로 사용할 때는 전자를, 백그라운드에서 장기간 실행하는 작업에는 일반적으로 후자를 선택하면 돼요.
forceLoginOrgUUID(지정된 조직으로 로그인 강제)가 활성화된 환경에서는 이전 버전에 문제가 있었어요. 토큰이 허용된 조직에 속해 있어도 setup-token으로 생성한 토큰을 사용해 시작하면 거부되는 문제였는데요. v2.1.318에서 수정됐으므로 기업 환경에서 이런 현상을 겪는다면 대개 업그레이드로 해결할 수 있어요.
4단계: 동시 쓰기 위험 줄이기
여러 호스트가 동시에 MCP 설정을 수정하면 공유 home에서 충돌이 발생할 수 있어요. 최신 버전의 claude mcp add와 claude mcp remove는 설정 잠금이 해제될 때까지 기다리며, 잠금을 얻지 못하면 종료 코드 1로 끝나요. 더 이상 잠금 없이 쓰지 않아요. 다만 업데이트 안내에 따르면 다른 작업이 설정을 저장할 때 방금 저장한 서버 항목을 덮어쓸 가능성은 여전히 있어요. 따라서 MCP 설정을 일괄 변경할 때는 가급적 한 대의 호스트에서 순차적으로 실행하세요.
또한 무인 실행(claude -p와 SDK 애플리케이션) 시 설정 내용이 바뀌지 않았다면 ~/.claude.json을 매번 다시 쓰지 않아요. 덕분에 대규모 병렬 작업으로 인한 설정 파일 쓰기 부담이 크게 줄었어요. 클러스터에서 아직 이전 버전으로 대규모 작업을 실행한다면, 이 점도 업그레이드를 고려할 이유가 돼요.
🚀 빠른 시작: 팀에서 클러스터의 Claude Code로 배치 작업을 실행하면서 claude.ai 계정 로그인 만료의 영향을 피하고 싶다면 API 방식으로 전환할 수 있어요. APIYI apiyi.com은 Claude 시리즈 모델의 API 호출을 제공하며, OpenAI와 Anthropic 두 가지 인터페이스 형식을 지원해요. 연동 방법은 문서 센터 docs.apiyi.com에서 확인하세요.
공유 home에서 자주 발생하는 Claude Code 문제
아래 표에서 증상별로 가능한 원인과 해결 방법을 확인할 수 있어요.
| 증상 | 가능한 원인 | 해결 방법 |
|---|---|---|
/logout이 성공했다고 표시되지만 다음 실행 시에도 로그인 상태임 |
이전 버전에서 공유 home에 설정을 쓰지 못해도 성공으로 보고함 | v2.1.318로 업그레이드한 뒤 claude auth logout을 실행하고 결과 확인 |
| 백그라운드 작업에서 갑자기 Not logged in 오류가 발생함 | 다른 터미널이나 호스트에서 같은 home으로 다시 로그인함 | 업그레이드. 같은 계정과 조직을 사용하는 경우 수정됨 |
| 실행 후 MCP 서버와 신뢰할 수 있는 디렉터리가 모두 사라짐 | 네트워크 파일 시스템이 설정 파일이 없다고 잘못 보고함 | 업그레이드해 재확인 로직을 활성화하고, 필요하면 백업에서 복원 |
| 로그인 자격 증명 파일이 빈 파일로 바뀜 | home 공간이 가득 찼지만 새 파일은 생성할 수 있음 | 할당량을 확보한 뒤 다시 로그인하고 업그레이드 |
| 비대화형 실행이 곧바로 실패하고 복구 안내가 표시됨 | ~/.claude.json이 유효한 JSON이 아님 |
안내된 복구 명령을 실행하고 수동으로 덮어쓰지 않기 |
| 실행 시 allowedProviders에 의해 거부됨 | 같은 기기의 다른 로그인에서 저장한 목록이 영향을 줌 | 업그레이드 후 재시도 |
| 모든 네트워크 연결이 실패함 | NODE_EXTRA_CA_CERTS가 빈 파일이나 PEM이 아닌 파일을 가리킴 | 최신 버전은 읽을 수 있는 인증서를 사용하고 stderr에 경고를 표시하므로, 인증서 파일도 수정 |
사용자가 다른 경우에도 주의할 점이 있어요. 누군가 sudo claude를 실행해 다른 사용자 소유의 프로세스가 남아 있으면, 이전 버전의 버전 정리 기능은 해당 프로세스가 종료된 것으로 잘못 판단해 사용 중인 실행 파일을 삭제할 수 있었어요. 또한 업데이트나 버전 정리 과정에서 실행 중인 프로세스의 바이너리가 삭제되면, remote-control 호스트와 백그라운드 데몬, 자체 호스팅 runner가 새 세션을 시작할 때 spawn ENOENT 오류가 발생했어요. 두 문제는 v2.1.318에서 모두 수정됐어요. 그래도 공유 환경에서는 sudo로 Claude Code를 실행하지 않는 것이 좋아요.
Claude Code v2.1.318 전후 비교: home 공유 환경
| 상황 | v2.1.318 이전 | v2.1.318부터 |
|---|---|---|
| 공유 home 설정 쓰기 실패 | 로그아웃과 MCP 제거가 여전히 성공으로 보고되고, 신뢰 및 MCP 설정 변경 사항은 알림 없이 사라짐 | 더 이상 성공으로 잘못 보고하지 않음 |
유효하지 않은 JSON이 담긴 ~/.claude.json |
비대화형 시작 시 기본값으로 덮어씀 | 시작에 실패하고 복구 방법을 안내하며 원본 파일을 보존 |
비어 있는 ~/.claude.json과 백업이 없는 경우 |
손상된 것으로 보고됨 | 파일이 없는 것으로 간주하고 정상 시작 |
| 로그인 만료 | 로그인 실패라는 포괄적인 메시지만 표시 | 만료 사실을 명확히 알리고 claude auth login과 claude setup-token을 안내 |
| 만료 사전 경고 | 없음 | 10일 전 stderr로 경고하며, 상태 명령에서 만료 시간 확인 가능 |
| 무인 실행 | 실행할 때마다 ~/.claude.json을 다시 씀 |
내용이 바뀌지 않으면 다시 쓰지 않음 |
표에서 볼 수 있듯이 v2.1.318은 실패를 정확히 알리고, 설정이 손상됐을 때 사용자 데이터를 최대한 보존하는 방향으로 수정됐어요. 운영자 입장에서는 “겉보기에는 정상이지만 실제로는 오류가 발생한” 상황이 줄어들어, 문제를 더 일찍 발견하고 조사 비용도 줄일 수 있어요.
공유 클러스터에서 대규모 배치 작업을 실행한다면, 대화형 개발에는 계정 로그인을 계속 사용하고 배치 작업에는 setup-token으로 생성한 토큰이나 API 인증을 사용하는 편이 안전해요. 이렇게 하면 두 환경의 인증 정보가 서로 영향을 주지 않아요.
API로 Claude Code에 연결해 공유 home의 계정 로그인 문제 우회하기
공유 home에서 발생하는 로그인 문제는 대부분 여러 곳에서 같은 claude.ai 로그인 자격 증명을 공유하기 때문이에요. 배치 작업에 API 키 인증을 사용하면 환경 변수로 자격 증명을 주입하므로 home 디렉터리에 저장된 로그인 파일에 의존하지 않아요. 앞서 살펴본 호스트 간 로그인 해제나 로그인 만료 문제도 대부분 피할 수 있어요. Claude Code는 ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN 등의 환경 변수로 API 엔드포인트와 키를 지정할 수 있어요. 정확한 변수 이름과 적용 버전은 공식 문서를 확인하세요.
🎯 기술 제안: APIYI apiyi.com은 Claude 계열 모델의 API 호출을 제공하며, Anthropic 네이티브 인터페이스와 OpenAI 인터페이스 형식을 모두 지원해요. Claude Code와 다른 도구에 하나의 엔드포인트를 통일해 설정할 때 유용해요. Base URL, 키 발급 방법, 도구별 설정 예시는 APIYI 문서 센터 docs.apiyi.com을 확인하세요.
| 비교 항목 | claude.ai 계정 로그인 | API 키 연결(예: APIYI) |
|---|---|---|
| 자격 증명 저장 위치 | home 디렉터리에 저장된 로그인 정보 | 환경 변수 또는 비밀 관리 시스템 |
| 공유 home의 영향 | 여러 기기가 공유하므로 동시 접속 및 만료 문제 발생 가능 | 작업마다 별도로 주입하므로 서로 영향을 주지 않음 |
| 만료 관리 | loginExpiresAt 확인 필요 | 키 자체의 유효 기간과 할당량에 따라 결정 |
| 인터페이스 형식 | Claude Code에 내장 | Anthropic 및 OpenAI 형식과 호환 |
| 요금 기준 | 계정 구독 및 사용량 규칙에 따름 | APIYI 가격 페이지 docs.apiyi.com/models의 실제 데이터에 따름 |
💰 비용 안내: 모델 가격, 입력 및 출력 단가, 캐시 가격 등 요금 관련 내용은 APIYI 가격 페이지 docs.apiyi.com/models의 실시간 데이터를 확인하세요. 가격 변동으로 인한 오해를 방지하기 위해 이 글에는 구체적인 금액을 기재하지 않았어요.
자주 묻는 질문 FAQ
Q1: ‘공유 네트워크 home 디렉터리’란 무엇이며, 여기서 Claude Code에 문제가 더 쉽게 생기는 이유는 무엇인가요?
공유 네트워크 home 디렉터리는 NFS 같은 네트워크 파일 시스템으로 마운트해 여러 호스트가 함께 사용하는 사용자 홈 디렉터리예요. Claude Code는 전역 구성, 설정, 로그인 자격 증명을 모두 home에 저장해요. 여러 프로세스의 동시 쓰기, 파일 시스템 캐시의 잘못된 보고, 할당량 초과 시 비정상적인 쓰기 동작으로 인해 구성이 유실되거나 로그인이 풀릴 수 있어요.
Q2: v2.1.318 이전과 이후, 공유 home에서 Claude Code를 사용할 때 어떤 차이가 있나요?
이전 버전은 쓰기에 실패해도 오류 없이 성공으로 보고하거나, 손상된 구성을 기본값으로 덮어쓸 수 있었어요. v2.1.318부터는 오류를 알리고 원본 파일을 보존하며 복구 방법을 안내해요. 공유 home에서 구성 파일을 저장하는 안정성도 높이고 로그인 만료 시간 필드도 추가했어요.
Q3: 이 수정 사항은 언제 출시됐나요?
관련 수정 사항은 Claude Code v2.1.318에 포함됐으며, GitHub Release에 표시된 출시일은 11월 4일이에요. `claude –version`으로 현재 버전을 확인하고, 이보다 낮다면 문제를 해결하기 전에 먼저 업그레이드하는 것이 좋아요.
Q4: 백그라운드 작업에서 계속 Not logged in 오류가 발생하면 어떻게 해야 하나요?
먼저 다른 터미널이나 호스트에서 같은 home을 사용해 동일 계정으로 다시 로그인했는지 확인하세요. v2.1.318에서는 같은 계정과 조직을 사용하는 경우의 문제가 수정됐어요. 조직을 바꿔 로그인했거나 자격 증명이 만료됐다면, 장시간 실행되는 작업에는 `claude setup-token`으로 생성한 토큰이나 API 키 인증을 사용하는 것이 좋아요.
Q5: 계정 로그인 없이 Claude Code에서 API로 모델을 호출하려면 어떻게 해야 하나요?
환경 변수로 Claude Code의 API 엔드포인트와 키를 지정할 수 있어요. APIYI apiyi.com은 Claude 시리즈 모델의 API 호출을 제공하고 Anthropic 및 OpenAI 인터페이스 형식과 호환되어 통합 엔드포인트로 사용할 수 있어요. 구체적인 설정 방법은 docs.apiyi.com 문서를, 요금은 가격 페이지 docs.apiyi.com/models를 확인하세요.
Q6: ~/.claude.json이 손상됐는데, 바로 삭제하고 다시 만들어도 되나요?
바로 삭제하는 것은 권장하지 않아요. 새 버전은 유효하지 않은 JSON을 발견하면 시작을 중단하고 복구 명령을 안내하므로, 먼저 안내에 따라 백업에서 복구하세요. 파일이 비어 있고 백업도 없다면 파일이 없는 것처럼 정상 시작하지만, 이전에 설정한 MCP 서버와 신뢰할 수 있는 디렉터리는 다시 추가해야 해요.
Q7: v2.1.318로 업그레이드한 후에도 공유 home에서 알려진 제한 사항이 있나요?
업데이트 안내에 따르면 `claude mcp add/remove`에 잠금이 추가됐지만, 다른 작업이 구성을 저장할 때 방금 저장한 서버 항목을 덮어쓸 가능성은 여전히 있어요. 할당량 부족이나 과도한 파일 시스템 캐싱 문제도 일부만 완화돼요. 동시 작업이 많은 환경에서는 구성을 순차적으로 관리하거나 배치 작업과 대화형 사용의 자격 증명을 분리하는 것이 좋아요.
공유 home 디렉터리에서 Claude Code 문제 해결 핵심 요약
- 먼저 버전 확인: 문제를 해결하기 전에 Claude Code가 v2.1.318 이상인지 확인하세요. 공유 home 문제는 대부분 업그레이드로 해결할 수 있어요.
- 로그인 만료 사전 확인:
claude auth status의 loginExpiresAt 필드로 로그인 만료가 임박했는지 확인하세요. - 설정을 무작정 삭제하지 않기:
~/.claude.json에 문제가 생기면 최신 버전에서 안내하는 복구 명령을 사용해 기존 설정을 보존하세요. - 동시 작업은 순차적으로: MCP 설정 변경은 한 컴퓨터에서 수행해 호스트 간 설정을 덮어쓰지 않도록 하세요.
- 할당량 확인: home 공간이 가득 차면 인증 정보가 지워질 수 있으므로 정기적으로 확인하세요.
- 배치 작업의 인증 정보 분리: 장시간 실행되는 작업에는 setup-token으로 생성한 토큰이나 API 키를 사용해 대화형 로그인과 분리하세요.
- API 연동도 가능: APIYI는 Anthropic과 OpenAI 형식을 지원하며, 요금은 docs.apiyi.com/models를 기준으로 확인하세요.
정리
공유 네트워크 home 디렉터리에서 Claude Code 설정과 로그인 문제를 해결할 때는 다음 사항이 중요해요.
- 버전부터 확인: v2.1.318은 로그아웃이 성공한 것처럼 표시되는 문제, 다른 호스트의 로그인으로 작업이 중단되는 문제, 설정이 덮어써지거나 비워지는 문제 등을 수정했어요. 먼저 업그레이드하세요.
- 증상별 원인 파악: 설정이 사라졌다면
~/.claude.json과 백업부터 확인하세요. 로그인이 만료됐다면 만료 시간과 인증 정보 파일을, 작업이 중단됐다면 동시 쓰기와 디스크 할당량을 확인하세요. - 인증 정보 분리: 대화형 개발에는 계정 로그인을, 배치 작업에는 토큰이나 API 키를 사용해 공유 home으로 인한 충돌을 줄이세요.
팀이 공유 클러스터에서 Claude Code를 대규모로 사용한다면 인증 방식을 명확히 구분해 두는 것이 좋아요. 통합 API 엔드포인트가 필요하다면 APIYI apiyi.com의 연동 문서 docs.apiyi.com을 참고해 검토할 수 있어요. 요금은 가격 페이지 docs.apiyi.com/models의 실제 정보를 확인하세요.
📚 참고 자료
- Claude Code v2.1.318 Release Notes: 이 글에서 다룬 모든 수정 사항의 출처
- 링크:
github.com/anthropics/claude-code/releases/tag/v2.1.318 -
설명: 공유 네트워크 홈 디렉터리, 로그인 만료,
~/.claude.json복구 등을 포함한 전체 업데이트 내역 -
APIYI 문서 센터: API 연동 및 도구 설정 안내
- 링크:
docs.apiyi.com -
설명: Base URL, API 키 발급, Anthropic 및 OpenAI 형식의 연동 방법
-
APIYI 모델 가격 페이지: 모델 요금의 공식 데이터 출처
- 링크:
docs.apiyi.com/models - 설명: 입력 및 출력 단가, 캐시 가격 등 요금 정보는 이 페이지의 실시간 데이터를 참고하세요.
작성자: APIYI 기술팀
기술 문의: 공유 환경에 Claude Code를 배포하다 문제가 생기면 APIYI 홈페이지 apiyi.com을 통해 문의해 주세요. 더 자세한 연동 자료는 docs.apiyi.com 문서 센터에서 확인할 수 있어요.
