CLI 구성 가이드
Starsg에서 두 개의 터미널 기반 보조자(Claude Code 및 OpenAI Codex)를 지정하여 하나의 게이트웨이, 하나의 API 키 세트 및 하나의 사용 보기를 공유합니다.
중요시작하기 전에 콘솔에서 만든 API 키를 준비하세요. 아직 없다면 링크를 열어 생성하세요.
1. 환경점검
터미널에서 npm list -g --depth-0 명령을 실행해 Node.js 설치 여부를 확인하세요. "command not found"가 표시되면 이 가이드에 따라 Claude Code / Codex에 필요한 Node.js 환경을 설치한 후 명령을 다시 실행하세요.
npm list -g --depth-0
두 CLI를 한 번에 설치하세요:
npm i -g @anthropic-ai/claude-code@latest npm i -g @openai/codex@latest
중요: 아래의 각 명령을 한 번 실행하여 설치를 확인하세요. 첫 번째 실행은 홈 폴더 아래에 각 CLI의 구성 디렉터리를 생성하는 것이기도 합니다. 이후의 모든 단계는 해당 디렉터리에 따라 다르므로 이 단계를 건너뛰지 마십시오.
claude codex
터미널이 채팅 프롬프트를 열거나 환영 배너를 인쇄하거나 선택 메뉴를 표시하면 CLI가 올바르게 설치된 것입니다.
중요: clude 보고서를 실행하면 Anthropic 서비스에 연결할 수 없습니다. Claude Code는 Anthropic에 연결할 수 없습니다. 먼저 추가 설정 명령을 실행한 다음 돌아와서 아래의 CLI별 구성 섹션을 계속 진행하세요.
2. Claude Code
설정 파일 ~/.claude/settings.json을 열고 다음 내용을 입력하세요. 파일이 없으면 새로 만드세요.
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.starsg.ai",
"ANTHROPIC_AUTH_TOKEN": "sk-abc...xyz",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"CLAUDE_CODE_DISABLE_TERMINAL_TITLE": "1"
}
}설정 예제의 sk-abc...xyz를 콘솔에서 만든 키로 바꾸세요. 터미널에서 claude를 실행해 채팅 응답을 받으면 연결된 것입니다.
참고: 구성 후에도 여전히 오류가 발생하고 CLI에서 로그인하라는 메시지가 표시되면 다음을 따르세요. Claude Code는 Anthropic에 연결할 수 없습니다. 그것을 해결하기 위해.
3. Codex
설정 파일 ~/.codex/config.toml을 편집하세요. 게이트웨이 주소, 기본 모델 및 추론 강도를 설정하는 파일입니다.
disable_response_storage = true model = "gpt-5.5" model_provider = "novamaas" model_reasoning_effort = "high" model_verbosity = "high" [features] web_search_request = true [model_providers.novamaas] base_url = "https://api.starsg.ai/v1" name = "novamaas" requires_openai_auth = true wire_api = "responses"
다음으로 ~/.codex/auth.json에 API 키를 입력하세요.
{
"OPENAI_API_KEY": "sk-abc...xyz"
}참고: 이 세 파일은 설치 직후 존재하지 않는 경우가 많습니다. 수동으로 생성하고 위의 내용을 붙여넣어야 합니다.
4. 확인
터미널에서 claude 또는 codex를 실행해 채팅 응답을 받으면 연동이 완료된 것입니다.