API Key 설정

Claude Code, Codex, OpenCode, Hermes용 설정을 생성하거나 한 번의 클릭으로 CC Switch에 가져오세요.

AI 도구 선택

사용 방식

모델

운영체제

Codex 로컬 설정

DeepSeek V4 Flash Vision Exp · 명령줄 · macOS

시작하기 전에Codex CLI 0.134+ · 명령줄 모드: 먼저 터미널에서 Codex CLI 버전을 확인하세요.codex --version설치 안내 ↗

1설정 파일 저장

홈 디렉터리의 .codex 폴더에 hiapi.config.toml을 새로 만들고 아래 설정을 붙여 넣은 뒤 저장하세요. 폴더가 없으면 먼저 만드세요.

저장 위치~/.codex/hiapi.config.toml

~는 홈 디렉터리를 뜻합니다. .codex는 그 안의 숨김 폴더입니다.

설정 파일에 쓸 내용

model_provider = "hiapi"
model = "deepseek-v4-flash-vision-exp"

[model_providers.hiapi]
name = "HiAPI"
base_url = "https://api.hiapi.ai/v1"
env_key = "HIAPI_API_KEY"
wire_api = "responses"

이 파일이 이미 있나요?

config.toml은 그대로 두세요. hiapi.config.toml이 이미 있으면 최상위 model, model_provider, [model_providers.hiapi]의 해당 필드를 업데이트하고 다른 설정은 유지하세요. 같은 키나 테이블을 중복해서 추가하지 마세요.

2터미널에서 API Key 설정

터미널(bash / zsh)을 열고 YOUR_HIAPI_API_KEY를 실제 Key로 바꾼 뒤 아래 명령을 실행하세요. 이 명령은 설정 파일에 넣지 마세요. API Key 관리 ↗

명령 복사

export HIAPI_API_KEY="YOUR_HIAPI_API_KEY"

3같은 터미널에서 에이전트 시작

Key를 설정한 터미널에서 작업할 프로젝트 디렉터리로 이동한 뒤 아래 명령을 실행하세요. hiapi.config.toml을 불러오며 기존 기본 설정은 유지됩니다. 터미널을 닫았다면 새 터미널에서 Key를 다시 설정해야 합니다. 시작한 뒤 메시지를 보내고 요청 기록에서 결과를 확인하세요.

시작 명령

codex --profile hiapi

4첫 메시지로 연결 확인

시작한 뒤 같은 에이전트 대화에서 다음을 보내세요:

HIAPI_OK만 답하세요. 파일을 읽거나 수정하지 마세요.

답변을 받은 뒤 요청 기록에서 모델과 상태를 확인하세요. 이 프롬프트를 복사하는 것만으로는 연결이 확인되지 않습니다. 요청 기록 보기 ↗

응답이 없나요?

먼저 API Key, 요청 기록, 모델, CLI 버전을 확인하세요. 추론 모델은 더 오래 걸릴 수 있습니다. 출력 한도를 아주 낮게 설정하거나 추론을 강제로 끄거나 기존 설정을 바꾸지 마세요.

프로토콜: Responses API공식 설정 안내 ↗