도움말

설정 가이드: Claude Code와 Codex를 HaryAI에 연결하기

연결 방법은 세 가지입니다: HaryAI 앱, CC Switch, 설정 파일 직접 수정. 모두 같은 주소와 같은 키를 쓰니 편한 방법 하나를 고르세요.

주소와 키

도구Base URL키
Claude Codehttps://api.xiaohongqiao.cnClaude 키
Codexhttps://api.xiaohongqiao.cn/v1Codex 키

키는 '내 계정'에서 확인하고 복사할 수 있습니다. Claude와 Codex는 키가 따로 있고 서로 바꿔 쓸 수 없습니다. 활성화 코드를 받으셨다면 그 코드가 키입니다.

한 가지 방법만 사용하세요. 두 가지를 동시에 쓰면 설정이 서로 덮어씁니다.

방법 1: HaryAI 앱 (추천)

  1. 앱을 내려받아 설치합니다. macOS와 Windows를 지원합니다. 다운로드
  2. HaryAI 계정으로 로그인하면 키가 자동으로 설정됩니다. 계정이 없다면 키를 붙여 넣어도 됩니다.
  3. Claude Code 또는 Codex 스위치를 켭니다.
  4. 터미널이나 Codex 앱을 다시 시작하면 적용됩니다.

주소와 키를 직접 입력할 필요가 없습니다. 스위치를 끄면 원래 설정이 그대로 돌아오고, Codex 대화 기록도 하나로 유지됩니다.

방법 2: CC Switch

이미 CC Switch로 공급자를 관리하고 있다면 사용자 지정 공급자를 하나 추가하면 됩니다. 항목 이름은 CC Switch 영어 UI 기준입니다.

Claude Code

  1. 상단에서 Claude를 선택하고 오른쪽 위의 +를 클릭합니다.
  2. Custom을 선택하고 공급자 이름을 HaryAI로 입력합니다.
  3. API Endpoint에 https://api.xiaohongqiao.cn, API Key에 Claude 키를 입력합니다.
  4. Add를 누르고 목록에서 HaryAI를 활성화한 뒤 Claude Code를 다시 시작합니다.

Codex

  1. 상단에서 Codex를 선택하고 오른쪽 위의 +를 클릭합니다.
  2. Custom을 선택하고 공급자 이름을 HaryAI로 입력합니다.
  3. API Request URL에 https://api.xiaohongqiao.cn/v1, API Key에 Codex 키를 입력합니다.
  4. Upstream Format은 Responses (native), Model Name은 gpt-5.6-sol로 설정합니다.
  5. Add를 누르고 목록에서 HaryAI를 활성화한 뒤 Codex를 다시 시작합니다.

방법 3: 설정 파일 직접 수정

아무것도 설치하고 싶지 않다면 Claude Code와 Codex의 설정 파일을 직접 수정하세요. 수정 전에 백업해 두세요.

Claude Code · ~/.claude/settings.json

settings.json에 다음 env 블록을 추가합니다. 다른 설정이 이미 있다면 합쳐 주세요:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.xiaohongqiao.cn",
    "ANTHROPIC_AUTH_TOKEN": "내 Claude 키"
  }
}

Codex · ~/.codex/config.toml

config.toml 맨 위에 다음 줄을 추가합니다(model이나 model_provider가 이미 있다면 아래 값으로 바꾸세요):

model = "gpt-5.6-sol"
model_provider = "haryai"

[model_providers.haryai]
name = "HaryAI"
base_url = "https://api.xiaohongqiao.cn/v1"
wire_api = "responses"
env_key = "HARYAI_API_KEY"

그다음 Codex 키를 환경 변수 HARYAI_API_KEY로 설정하고 터미널을 다시 시작합니다:

# macOS / Linux
echo 'export HARYAI_API_KEY="내 Codex 키"' >> ~/.zshrc

# Windows (PowerShell)
setx HARYAI_API_KEY "내 Codex 키"

Windows에서는 이 파일들이 %USERPROFILE%\.claude와 %USERPROFILE%\.codex에 있습니다. 공식 계정으로 돌아가려면 추가한 줄을 지우면 됩니다.

사용할 수 있는 모델

사용 가능한 모델은 업스트림 사정에 따라 바뀝니다. 키로 현재 목록을 확인하세요:

curl https://api.xiaohongqiao.cn/v1/models -H "Authorization: Bearer 내 키"

그 밖의 도구

Cline, Cursor처럼 사용자 지정 엔드포인트를 지원하는 도구에서도 쓸 수 있습니다. Anthropic API는 루트 주소와 Claude 키, OpenAI Responses API는 /v1 주소와 Codex 키를 넣으세요.

설정 가이드: Claude Code와 Codex를 HaryAI에 연결하기 | HaryAI