FAQ

남들은 어떻게 설치하고 뭐에 쓰는지, 2분이면 이해됩니다.

남들은 어떻게 설치하고 뭐에 쓰는지, 2분이면 이해됩니다.

Claude Code 설치 방법은?

기존：npm install -g @anthropic-ai/claude-code 후 ~/.claude/settings.json을 수동으로 편집해 API Key와 base URL 설정
PingAI Helper：이 페이지 상단의 명령 한 줄 실행 — Claude Code 자동 설치 및 ~/.claude/settings.json을 pingai.hk/anthropic로 지정
확인：터미널 재시작 후 claude --version 확인, 또는 claude "hi"로 연결 테스트

Codex CLI 설치 방법은?

기존：npm install -g @openai/codex 후 ~/.codex/config.toml을 수동으로 편집해 API Key와 base URL 설정
PingAI Helper：위 명령 한 줄로 Codex CLI 자동 설치 및 ~/.codex/config.toml을 pingai.hk/openai/v1로 지정
확인：터미널 재시작 후 codex --version 확인, 또는 codex "hi"로 연결 테스트

Gemini CLI 설치 방법은?

기존：npm install -g @google/gemini-cli 후 ~/.gemini/config.json을 수동으로 편집해 API Key와 base URL 설정
PingAI Helper：위 명령 한 줄로 Gemini CLI 자동 설치 및 ~/.gemini/config.json을 pingai.hk/gemini로 지정
확인：터미널 재시작 후 gemini --version 확인, 또는 gemini "hi"로 연결 테스트

겪은 오류를 골라 해결 방법을 확인하세요.

`claude` / `codex` / `gemini`: command not found

증상：터미널 재시작 후에도 명령어를 찾을 수 없음 = PATH가 반영되지 않았습니다.

해결 방법：Mac: `source ~/.zshrc` 실행. Windows: PowerShell을 완전히 종료 후 다시 열기. 그래도 안 되면 재부팅.

사용 시 401 Unauthorized

증상：API Key가 잘못됐거나, 만료됐거나, 설정되지 않음.

해결 방법：app.pingai.hk에서 새 Key 발급 후, 설치 명령을 다시 실행하고 "Key 재설정" 선택.

중국 본토 네트워크에서 설치 실패 / 느림

증상：`npm install`이 몇 분 동안 멈추거나 timeout.

해결 방법：스크립트는 자동으로 Taobao 미러로 전환. 수동으로: `npm config set registry https://registry.npmmirror.com`

Windows "스크립트를 실행할 수 없습니다"

증상：PowerShell 실행 정책 제한 오류 발생.

해결 방법：`install-win.cmd`를 더블 클릭하거나, 관리자로 PowerShell 열고 `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` 실행.

해결이 안 되면 WhatsApp / 이메일로 문의하세요. 담당자가 즉시 응답합니다.

API Key 가 아직 없나요?

가입 시 HK$5 체험 크레딧 제공. 대시보드에서 Key 생성.