Claude Code 수동 설정(settings.json)
직접 제어하는 것을 선호하거나, CC-Switch가 사용 환경에 맞지 않으신가요? 아래 단계에 따라 설정 파일을 직접 생성하면 됩니다.
설정 단계
1. Claude Code 설정 폴더 열기
'터미널'을 열고 운영체제에 맞는 명령어를 실행하세요:
bat
start "" "%USERPROFILE%\.claude"bash
open "$HOME/.claude"2. settings.json을 새로 만들고 설정 작성
열린 폴더 안에 새 파일을 만들고 이름을 settings.json으로 지정한 뒤, 다음 내용을 입력하세요(CC 공식 채널 기준):
json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "당신의 ApiKey를 여기에 붙여넣으세요",
"ANTHROPIC_BASE_URL": "https://api.nexthub.cc",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}엔드포인트 주소
NextHub 엔드포인트 주소는 https://api.nexthub.cc입니다(끝에 /v1을 붙이지 마세요). Claude Code는 그 뒤에 자동으로 /v1/messages를 붙이며, /v1을 잘못 추가하면 실제 요청이 /v1/v1/messages가 되어 바로 404가 발생합니다.
선택 사항: 추가를 권장하는 환경 변수
위 세 항목은 동작에 필요한 최소 설정입니다. 더 편하게 사용하고 싶다면 필요에 따라 추가할 수 있습니다(모두 선택 사항이며, 입력하지 않아도 사용할 수 있습니다):
| 환경 변수 | 권장 값 | 용도 |
|---|---|---|
CLAUDE_CODE_DISABLE_TERMINAL_TITLE | "1" | 터미널 제목 변경 금지 |
DISABLE_TELEMETRY | "1" | 텔레메트리 전송 해제 |
DISABLE_ERROR_REPORTING | "1" | 오류 자동 신고 해제 |
DISABLE_BUG_COMMAND | "1" | 내장 버그 신고 명령을 비활성화 |
DISABLE_AUTOUPDATER | "1" | 자동 업데이트 확인 해제 |
3. ApiKey 입력 후 파일 저장
ANTHROPIC_AUTH_TOKEN 값을 ApiKey 관리에서 생성한 ApiKey로 교체하고 파일을 저장하세요.
4. claude를 실행하여 검증
bash
claude설정 성공!
Claude가 정상적으로 응답하나요? 축하합니다! Claude Code가 NextHub에 성공적으로 연동되었습니다. 🎉