본문으로 건너뛰기
원포트 AI

Codex CLI

~/.codex/config.toml 에 몇 줄이면 돼요.

AI 에게 넘기기ChatGPT 에서 열기 (새 창)Claude 에서 열기 (새 창)원문 열기

OpenAI 의 코딩 에이전트예요. 아직 안 깔려 있으면 먼저 설치하세요. 지금 Codex 는 OPENAI_BASE_URL · OPENAI_API_KEY 환경변수를 읽지 않아요 — 그 둘만 바꾸면 원래 가던 곳(ChatGPT 로그인 · OpenAI)으로 그대로 가요. ~/.codex/config.toml 에 원포트를 공급자로 적어 주세요. ChatGPT 로그인은 건드리지 않아요.

설치
npm install -g @openai/codex

Node.js 16 이상이 있어야 깔려요(10-31 @openai/codex 0.166.0 기준 · Codex 동작). Windows PowerShell 에서 npm · codex 가 「이 시스템에서 스크립트를 실행할 수 없으므로 …」로 막히면 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned 를 한 번 치거나, npm.cmd · codex.cmd 로 부르세요(Windows 동작).

~/.codex/config.toml (Windows 는 %USERPROFILE%\.codex\config.toml)
model = "gpt-6-sol"
model_provider = "oneport"

[model_providers.oneport]
name = "Oneport"
base_url = "https://oneport.kr/v1"
env_key = "ONEPORT_API_KEY"
wire_api = "responses"
키는 환경변수로 — config.toml 에 키를 적지 마세요
export ONEPORT_API_KEY="sk-so-..."

codex
Windows PowerShell — 넣은 뒤 창을 새로 여세요
[Environment]::SetEnvironmentVariable("ONEPORT_API_KEY", "sk-so-...", "User")

# 새 창에서 — 앞 여섯 글자만 보여요
$env:ONEPORT_API_KEY.Substring(0, 6)
codex

env_key 에 적은 이름의 환경변수를 Codex 가 Authorization: Bearer 로 실어 보내요. 이미 config.toml 이 있으면 model · model_provider 두 줄은 파일 맨 위(어떤 [표] 보다 앞)에, [model_providers.oneport] 표는 맨 아래에 더하세요 — 표 아래에 적은 줄은 그 표의 칸으로 읽혀요. 한 번만 원포트로 쓰려면 맨 위 두 줄(model · model_provider)을 빼 두고 codex -c model_provider=oneport -m gpt-6-sol 로 켜셔도 돼요 — 학생 키면 -c web_search=disabled 도 같이 주세요(아래 「무엇이 되나」 · Codex 동작). 평소 codex 는 ChatGPT 로그인 그대로예요.

잘 붙었는지 확인#

요금 없이 확인
curl https://oneport.kr/v1/key -H "Authorization: Bearer $ONEPORT_API_KEY"
curl https://oneport.kr/v1/models -H "Authorization: Bearer $ONEPORT_API_KEY"
Windows PowerShell 에서 (curl 이 아니라 curl.exe)
curl.exe https://oneport.kr/v1/key -H "Authorization: Bearer $env:ONEPORT_API_KEY"

# 틀린 키로 Codex 가 저희에게 오는지 보기 — 이 창의 키만 바뀌니 본 뒤 창을 닫으세요
$env:ONEPORT_API_KEY = "sk-so-test"; codex exec "hi"

첫 줄은 키가 사는지와 이 키의 남은 몫(month · day)을, 둘째 줄은 이 키로 부를 수 있는 모델을 보여요. 키가 맞는지는 첫 줄로 보세요 — 200 에 "object": "key" 면 살아 있어요. 틀린 키면 두 줄 다 401 과 이유가 와요. Codex 자체가 저희에게 오는지는 틀린 키로 한 번 불러 보면 돼요 — ONEPORT_API_KEY=sk-so-test codex exec "hi" 에서 401 「없는 키예요」가 보이면 붙은 거예요(상태 코드로 끝난 실패라 요금이 없어요 · Codex 동작). 맨 위 두 줄을 빼고 -c 로 켜는 분은 ONEPORT_API_KEY=sk-so-test codex -c model_provider=oneport exec "hi" 로 보세요 — 플래그 없이 부르면 ChatGPT 로그인으로 가서 확인이 안 돼요. PowerShell 은 위 블록 끝 줄이에요(-c 로 켜는 분은 그 줄의 codex exec 를 codex -c model_provider=oneport exec 로). git 저장소가 아닌 폴더에서는 codex exec 가 저희에게 보내기 전에 멈출 수 있어요 — 그땐 codex exec --skip-git-repo-check "hi" 로 보세요(Codex 동작). 잔액이 최소치보다 적은 진짜 키로 부르면 402 below_minimum_balance 가 와요 — 그것도 저희에게 닿은 거고 요금은 없어요.

실제로 시켜보기 (이건 크레딧을 사용해요)
codex -m gpt-6-sol "이 저장소의 테스트를 돌리고 실패한 것만 정리해줘"

사람마다 쓴 양과 한도#

사람마다 키를 따로 만들면(대시보드 AI API 화면) 각자 그 키로 GET /v1/key 의 month.used_credits · day.used_credits 를 보면 돼요(요금 없음). 한꺼번에 보려면 관리 키(sk-som-)로 GET /v1/keys 를 부르세요 — 키마다 name · month_used_credits · day_used_credits 가 와요. 사람마다 한도는 대시보드 키 목록의 「한도 수정」이나 관리 키로 PATCH /v1/keys/{id} 에 monthly_limit_credits · daily_limit_credits 를 보내 걸어요(「키 관리」 장). 대시보드의 키 만들기 · 한도 수정 · 새로 받기 · 폐기 · 관리 키는 지갑 주인만 돼요(다른 분이 누르면 「지갑 주인만 할 수 있어요.」). 넘으면 429 key_limit_exceeded 예요(아래 「안 될 때」). CI 에는 사람 키 말고 따로 만든 키를 쓰세요. 사용량은 답이 끝난 뒤에 반영돼요 — 긴 작업에 드는 값은 시작 전과 15~20분 뒤에 month.used_credits 를 보면 그 차이로 어림해요(1 크레딧 아래를 올린 정수예요). month 는 한국 시간 매달 1일 0시에 새로 세요(resets_at). 한 키로 창 여러 개를 돌리면 그 키에 건 월 한도는 그 창들이 지금 잡아 둔 몫까지 더해 재요(GET /v1/key 의 month.held_credits) — 한도를 안 건 키는 상관없어요. 창마다 키를 따로 쓰면 한도도 따로지만, 지갑 잔액(402)은 같이 써요. 초·중·고 학교 지갑의 학생 키는 월 150 크레딧 한도로 만들어져요. 월 한도는 이번 달 쓴 몫에 이 요청이 미리 잡는 몫(아래 「무엇이 되나」 끝 문단)까지 더해 재서, gpt-6-sol 이면 몇 번 만에 GET /v1/key 에 남은 몫이 보여도 429 가 와요(key_month_limit · 기록이 길어지면 hold_exceeds_key_limit — 아래 「안 될 때」). 학생에겐 gpt-5-nano · gpt-6-luna 처럼 가벼운 모델(단가가 gpt-6-sol 의 20분의 1 이하 — 10월 기준 100만 토큰당 출력 gpt-6-luna 459.9 · gpt-5-nano 367.92 크레딧)을 쓰게 하거나, 키를 준 분이 「한도 수정」에서 월 한도를 올려요.

CI(GitHub Actions)에서 codex exec#

CI 에서도 같아요. 러너에서 ~/.codex/config.toml 에 위 공급자 줄을 쓰고, 저장소 비밀에 넣은 키를 ONEPORT_API_KEY 환경변수로 넘긴 뒤 codex exec "…" 로 돌려요. 돌리기 전에 curl -f https://oneport.kr/v1/key -H "Authorization: Bearer $ONEPORT_API_KEY" 를 한 줄 두면 키가 틀릴 때 요금 없이 401 로 멈춰요. 승인 · 샌드박스 플래그는 Codex 버전마다 달라서 codex exec --help 로 보세요(Codex 동작).

무엇이 되나#

Codex CLI 는 OpenAI 호환 주소의 /v1/responses 로 붙어요. OpenAI 모델을 부르실 때는 몸통을 거의 그대로 넘겨요 — reasoning 같은 칸도 그대로 가서 받을지는 OpenAI 가 정하고, 처리 등급(service_tier) 설정과 요금을 셀 수 없는 서버 도구만 저희가 400 으로 돌려드려요(아래 「안 될 때」). Codex 의 웹 검색도 돼요 — 검색 1회에 9.2 크레딧씩 토큰과 같이 빠져요 — 도구를 싣기만 해서는 안 빠지고, 모델이 실제로 검색한 횟수만큼만 사용해요. 다만 Codex 는 웹 검색 도구를 요청마다 실어 보내서, 초·중·고 학교 지갑 · 스페이스의 학생 키로 쓰시면 ~/.codex/config.toml 에 web_search = "disabled" 를 넣어 주세요 — 안 넣으면 매번 403 student_key_blocked 가 와요. 학생 키인지는 GET /v1/key 의 audience 가 "student" 인지로 보세요. 쓰임새를 「선생님」으로 고른 키는 audience 가 "teacher", 대학 · 회사 · 개인 지갑의 키는 null 이라 이 줄이 필요 없어요. 선생님이 쓰실 키가 "student" 로 나오면 대시보드 키 목록의 쓰임새 칩을 「선생님」으로 바꾸세요(키를 나눠 받으셨다면 키를 준 분께 부탁해요). web_search 줄도 model 줄처럼 파일 맨 위(어떤 [표] 보다 앞)에 넣어 주세요. 요금을 셀 수 없는 서버 도구는 code_interpreter · hosted shell · image_generation 이에요 — 모델과 단가의 「벤더 서버 도구 요금」을 보세요.

저희는 Codex 가 보내는 요청 한 번마다 첫 응답 120초 · 조각 사이 침묵 120초 · 저희가 모델 회사로 보내기 시작한 때부터 약 12분 50초에 끊어요(시계는 요청마다 새로 돌아요). Codex 는 답을 스트림으로 받는데(Codex 동작) /v1/responses 는 토큰 수가 끝 이벤트에만 와요. 그래서 그 전에 끊기면 그때까지 받은 글 · 도구 인자만큼만 출력으로 어림해 사용해요(받은 글이 없으면 0). 모델 회사로 보낸 뒤 첫 응답 전에 시간 초과 · 연결 실패 · 408 · 실행 전 거절이 확인되지 않은 5xx 로 끝나면 422 upstream_execution_unconfirmed 예요. 이 응답엔 요금이 안 붙지만 모델 회사에서는 실행됐을 수 있어요 — 같은 요청을 자동으로 다시 보내지 마세요. 끊긴 뒤 다시 시키면 새 요청이라, 대화 기록을 입력으로 다시 사용해요. pro 등급처럼 오래 생각하는 모델은 일을 작게 나눠 시키세요.

긴 작업은 한 요청의 입력(캐시 포함)이 272,000 토큰을 넘지 않게 단계마다 새 세션으로 시작하세요. GPT-6 · 6.1 · 6.2 모델은 입력이 그 수 이상인 요청 전체를 GET /v1/models 의 pricing.tier 단가로 세요(10월 기준 gpt-6-sol 이면 100만 토큰당 입력 1,839.6 → 3,679.21 · 출력 9,198.02 → 13,797.04 크레딧). 다시 보낸 기록 가운데 벤더 캐시에 걸린 앞부분은 cache_read 단가로 세요(gpt-6-sol 183.96 · 상위 구간 367.92) — 캐시가 걸릴지는 벤더가 정해요. 앞 요청에 없던 새 입력(도구 결과 · 앞 답)은 모델 회사가 대개 캐시에 써서 cache_write 단가로 세요(벤더 동작 · 응답 usage.input_tokens_details.cache_write_tokens · 10월 기준 100만 토큰당 gpt-6-sol 2,299.51 · 상위 구간 4,599.01 크레딧 — 입력 단가의 1.25배). 긴 작업 값은 (캐시 읽기 토큰 × cache_read + 새 입력 토큰 × cache_write + 출력 토큰 × output) ÷ 1,000,000 으로 어림하세요 — 생각한 토큰도 출력이에요. 값은 바뀌니 지금 값은 GET /v1/models 에서 보세요.

Codex 요청 하나를 보내기 전에 저희가 지갑에서 몫을 잡아 둬요 — 입력(보낸 몸통 3바이트를 1토큰 · 캐시 쓰기 단가가 있는 모델은 그 단가)과 출력(출력 상한이 안 실리면 8,192 토큰)을 그 모델 단가로 셈한 값이고, 끝나면 쓴 만큼 사용하고 남은 몫은 돌려드려요(셈은 「남은 한도」 장). 출력 상한이 안 실린 요청은 답이 8,192 토큰보다 길면 잡은 몫보다 더 쓸 수 있어요 — 키 월 한도는 보내기 전에만 맞대 봐서, 그런 답 하나로 한도를 넘길 수 있어요. 10월 기준 gpt-6-sol 이면 출력 몫이 약 75 크레딧이고, 몸통이 300,000바이트면 입력 몫이 약 230 크레딧이에요(입력 단가의 1.25배인 캐시 쓰기 단가로 잡아요). Codex 는 도구와 stream 을 늘 실어 보내서 출력 몫은 늘 8,192 토큰이에요 — 「남은 한도」 장의 출력 상한 없는 gpt-6-sol 몫(128,000 토큰)은 Codex 요청엔 안 붙어요. 몸통이 약 816,000바이트(÷ 3 이 272,000 토큰)를 넘으면 입력 · 출력 몫을 모두 상위 구간 단가로 잡아서 몫이 두 배쯤 뛰어요(gpt-6-sol 이면 815,000바이트에 약 700 · 816,000바이트에 약 1,364 크레딧) — 실제 입력이 272,000 토큰보다 적으면 정산은 보통 단가예요. 창 셋을 동시에 돌리면 셋 다 이 몫을 잡아요 — 줄이려면 세션을 짧게 두거나 더 싼 모델을 고르세요.

모델 고르기#

config.toml 의 model 이나 -m 에 우리 목록(GET /v1/models)의 OpenAI 모델 id 를 글자 그대로 넣으시면 돼요. 목록의 endpoint 가 POST /v1/chat/completions 인 GPT 모델도 돼요 — /v1/responses 는 OpenAI 의 보통 모델도 받아요. 아래 예시의 gpt-6-sol · gpt-5.6-sol 은 목록에 있는 실제 id 예요. endpoint 가 POST /v1/responses 인 모델(pro 등급 다섯 개 — o3-pro · gpt-5-pro · gpt-5.2-pro · gpt-5.4-pro · gpt-5.5-pro · 10월 기준 — 와 gpt-5.3-codex)도 Codex 로 불러요 — 다만 gpt-5.3-codex 는 pro 가 아니라 값이 중간이고, 2027년 4월 1일에 판매가 끝나요(후속 gpt-6-sol · 줄의 retirement 칸). owned_by 가 openai 여도 임베딩 · 그림 · 소리 모델(endpoint 가 다른 문)과 id 에 / 가 든 openai/gpt-oss-… 는 Codex 로 못 불러요.

10월 기준 Codex 에 넣을 수 있는 GPT 가운데 크레딧이 가장 적게 드는 건 gpt-5-nano, 그다음이 gpt-6-luna 예요. 가장 많이 드는 건 pro 등급 gpt-5.5-pro · gpt-5.4-pro 예요. pro 등급을 빼면 GPT-6.2 가운데 가장 높은 등급은 gpt-6.2-astra 예요 — 어려운 일에 고르실 땐 이 모델이고(채팅 화면의 「아주 어려운 질문」 추천도 GPT 가운데선 이 모델이에요), 입력 · 캐시 · 출력 단가가 모두 gpt-6.2-sol 의 4배예요(11월 기준 100만 토큰당 입력 7,358.42 · 출력 36,792.1 크레딧). gpt-6.2-astra 는 /v1/chat/completions 에선 도구를 못 받지만 Codex 가 쓰는 /v1/responses 에선 함수 도구를 받는 걸 저희가 재 봤어요. 다만 Codex 와 같이 끝까지 돌려 본 모델은 아니라서 처음엔 짧은 일로 한 번 시켜 보세요. 단가는 바뀌니 지금 값은 GET /v1/models(정본)에서 아래 명령으로 싼 순서대로 보세요 — 둘째 · 셋째 칸이 100만 토큰당 크레딧(입력 · 출력 — pricing.rates 의 input_text · output 줄과 같은 값)이에요. gpt-4o-mini · gpt-4.1-mini 는 Codex 에서 매번 400 이 와요 — Codex 가 늘 싣는 웹 검색을 이 두 모델에선 받지 않아요. 다른 GPT(예: 더 싼 gpt-5-nano)를 쓰시거나, 꼭 쓰셔야 하면 config.toml 에 web_search = "disabled" 를 넣으세요.

Codex 에 넣을 GPT 를 싼 순서대로 (jq 필요)
curl -s https://oneport.kr/v1/models | jq -r '[.data[] | select(.owned_by == "openai" and (.endpoint | test("chat/completions|responses")) and (.id | contains("/") | not))] | sort_by(.pricing.output_credits_per_mtok) | .[] | "\(.id)\t\(.pricing.input_credits_per_mtok)\t\(.pricing.output_credits_per_mtok)"'
Windows PowerShell 에서 (jq 없이)
(Invoke-RestMethod https://oneport.kr/v1/models).data | Where-Object { $_.owned_by -eq "openai" -and $_.endpoint -match "chat/completions|responses" -and $_.id -notlike "*/*" } | Sort-Object { $_.pricing.output_credits_per_mtok } | Format-Table id, @{n="input";e={$_.pricing.input_credits_per_mtok}}, @{n="output";e={$_.pricing.output_credits_per_mtok}}
모델 지정
codex -m gpt-6-sol
codex -m gpt-5.6-sol

안 될 때#

  • Codex 가 켜지자마자 「Missing environment variable: ONEPORT_API_KEY」로 멈춘다 — 지금 창에 키가 없어요. export 줄을 넣은 셸 설정 파일(macOS 는 대개 ~/.zshrc · Linux 는 ~/.bashrc · Windows 는 위 PowerShell 줄)을 다시 읽거나 새 터미널을 여세요(Codex 동작 · 문구는 버전마다 다를 수 있어요). 서버에서 cron · systemd · ssh 로 바로 돌리면 셸 설정 파일이 안 읽힐 수 있어요 — 그 작업의 환경에 ONEPORT_API_KEY 를 직접 넘기세요(셸 동작).
  • 오류 끝의 url 이 https://api.openai.com/… 이다(401 Missing bearer · Incorrect API key 등) — 원포트가 아니라 OpenAI 로 가고 있어요. config.toml 의 model_provider = "oneport" 가 빠졌거나 표 아래에 적혀 그 표의 칸으로 읽힌 거예요. 환경변수만으로는 저희에게 안 와요. Codex 는 오류 끝에 부른 주소(url: …)를 보여줘요.
  • 401 에 「sk-so- 로 시작하는 키가 아니에요」가 온다 — Codex 가 저희 키 대신 다른 값(ChatGPT 로그인 토큰 등)을 보내고 있어요. [model_providers.oneport] 에 env_key = "ONEPORT_API_KEY" 가 있는지, 지금 창에 그 키가 있는지(echo ${ONEPORT_API_KEY:0:6} — 앞 여섯 글자만 · 키 전체를 찍으면 화면 공유 · 기록에 남아요) 보세요. PowerShell 은 $env:ONEPORT_API_KEY.Substring(0, 6) 이에요 — 「null 값 식에서 메서드를 호출할 수 없습니다」가 나오면 이 창에 키가 없는 거라 창을 새로 여세요(PowerShell 동작).
  • 401 이 이유(다른 회사 키 · 없는 키 · 꺼진 키 · 기한 끝)를 말해요 — 그 문장대로 고쳐 주세요. 「OpenAI 키(sk-…)로 보여요」면 ONEPORT_API_KEY 에 OpenAI 키를 넣으신 거예요 — 원포트에서 받은 sk-so- 키로 바꿔 주세요.
  • 400 에 「이 문은 openai 모델만 받아요」가 온다 — 모델에 Claude · Gemini id 를 넣으셨어요. Codex 에선 OpenAI 모델만 돼요.
  • 400 에 「처리 등급(service_tier: …)은 아직 열려 있지 않아요」가 온다 — 빠른 처리 같은 처리 등급 설정을 켜셨어요. 그 설정을 끄면 표준 등급으로 답해요.
  • 404 가 난다 — base_url 끝의 /v1 이 빠졌는지 보세요. 모델을 못 찾는다고 하면 이름이 GET /v1/models 에 있는지 보세요(가까운 이름을 같이 알려 드려요).
  • 창을 여러 개 띄웠거나 같은 지갑을 다른 분도 쓰는데 402 가 온다 — Codex 가 보여 주는 오류 글에서 "reason" 을 보세요(Codex 동작). "held_by_others"(문장에 「다른 호출이 잡아 둔 몫」)면 잔액이 모자란 게 아니라 지금 도는 다른 호출이 잡아 둔 몫 때문이에요 — 충전하거나 기록을 줄이지 말고 몇 초 뒤(Retry-After 5초) Codex 에 같은 지시를 다시 입력하세요(요금은 안 붙었어요). GET /v1/credits 의 balance_credits 는 잡아 둔 몫을 빼지 않은 값이라 넉넉해 보여도 이 402 가 와요 — 자주 나면 잔액을 요청 하나 몫(위 「무엇이 되나」) × 동시에 도는 호출 수(같은 지갑의 다른 분 것까지)보다 넉넉히 두세요.
  • 402 "hold_exceeds_balance" 가 온다 — 이 요청 하나의 최대 몫이 잔액보다 커요. 문장에 「미리 잡는 몫 대부분이 입력」이 있으면 대화 기록이 긴 거라 새 세션으로 줄이세요 — 새 세션(/new)이 안전해요(Codex 동작). 없으면 더 싼 모델(-m)로 바꾸거나 충전하세요(키를 나눠 받으셨으면 아래 below_minimum_balance 줄). Codex 는 출력 상한(max_output_tokens)을 안 실어서(Codex 동작) 문장도 줄이라는 말 없이 충전과 새 대화를 말해요.
  • 402 "below_minimum_balance" 가 온다 — 잔액이 최소치보다 적어요(값은 「에러」 장). 충전하세요 — 키를 나눠 받으셨으면 키를 준 분께 넣어 달라고 하세요(다른 메일로 사면 다른 지갑에 들어가요).
  • 429 key_limit_exceeded 가 온다 — 화면엔 exceeded retry limit, last status: 429 Too Many Requests 한 줄만 떠요(Codex 동작). GET /v1/key 의 month · day 로 가르세요. reason 별로는 — "held_by_others" 면 같은 키의 다른 창이 잡아 둔 몫 때문이라(위 「사람마다 쓴 양과 한도」) 그 창의 요청이 끝나면 풀려요 — 몇 초 뒤(Retry-After 5초) 같은 지시를 다시 입력하세요. "key_month_limit" 이면 이 요청 하나로 이 키의 이번 달 남은 몫을 넘은 거라 기다려도 안 풀려요 — 새 세션으로 기록을 줄이거나 지갑 주인이 대시보드에서 키 한도를 올리거나 다음 달 1일(한국 시간)을 기다려요. "key_day_limit" 이면 오늘 쓴 몫이 하루 한도에 닿은 거라 기록을 줄여도 같아요 — 한국 시간 내일 0시에 다시 열려요. "hold_exceeds_key_limit" 이면 이 요청 하나의 몫이 학생 키 월 한도 전체보다 커서 다음 달에도 같아요 — 새 세션(/new)으로 기록을 줄이거나 더 가벼운 모델(-m)로 바꾸세요(위 「사람마다 쓴 양과 한도」). 이 값은 학교 지갑 학생 키에만 와요(그 밖엔 key_month_limit).
  • 422 upstream_execution_unconfirmed 가 온다 — 실행됐는지 모르는 실패예요(위 「무엇이 되나」). 같은 지시를 바로 되풀이하지 말고 다시 시킬지 직접 정하세요 — 문의는 요청 ID · 부른 시각 · 모델로 해 주세요.
  • 504 에 "timeout" 이 온다 — 모델 회사가 실행하기 전에 저희 처리 기한(4분)이 끝났어요. 요금은 없어요 — 몇 초 뒤 한 번 다시 시키세요.
  • 503 api_error 가 온다 — 저희 쪽 일시 실패예요(모델 회사가 실행하지 않았고 요금도 없어요). 2초쯤 뒤 다시 시키세요.
  • 429 rate_limit_error 가 온다 — 저희 한도가 아니라 모델 회사가 잠깐 몰려 거절한 거예요. Retry-After(1~60초)만큼 기다렸다 다시 시키세요.
  • /v1/responses/compact 로 404 가 온다 — 저희 문엔 그 주소가 없어요. 기록을 줄이려면 새 세션(/new)으로 시작하세요.

키 바꾸기#

키가 커밋 · 채팅방처럼 누가 가져갔는지 모를 곳에 찍혔으면 키 목록의 「폐기」로 바로 끄고 「키 만들기」로 새 키를 만들어 한도를 다시 걸어요. 혼자 쓰던 키가 화면에 잠깐 비쳤으면 「새로 받기」도 돼요(쓴 몫이 이어지고 id 는 새로 나와요). 나간 팀원의 키도 「폐기」(관리 키로는 DELETE /v1/keys/{id})예요 — 끈 키는 GET /v1/keys 에서 빠지고 GET /v1/keys/{id} 도 404 예요. 쓴 몫은 「사용 기록」 아래 「정산 원장 받기 (CSV)」에 남아요. 관리 키(sk-som-)엔 「새로 받기」가 없어 「관리 키」에서 폐기하고 새로 만들어요 — 샜다면 그 키로 만든 API 키는 안 꺼지니 키 목록의 모르는 키도 폐기해요. 안 샌 키를 끊김 없이 바꾸는 길은 「인증」 장 「키 관리」(https://oneport.kr/docs/authentication.md)예요. 켜 둔 Codex 창은 켤 때의 키를 쥐고 있어 다시 켜야 해요(셸 동작).

원래대로 되돌리기#

config.toml 의 model_provider = "oneport" 줄을 지우시면 원래 공급자(ChatGPT 로그인 · OpenAI)로 돌아가요. 맨 위 model = "gpt-6-sol" 줄도 지우거나 예전 값으로 돌려 두세요 — 남겨 두면 ChatGPT 로그인에서도 그 이름으로 불러요(Codex 동작). [model_providers.oneport] 표는 남겨 둬도 쓰이지 않아요. 셸 설정에 넣은 ONEPORT_API_KEY 도 필요 없으면 지우세요(Windows 는 아래 줄). web_search = "disabled" 줄을 넣으셨다면 그 줄도 지우세요 — 남겨 두면 ChatGPT 로그인으로 쓸 때도 웹 검색이 꺼져 있어요(Codex 동작). ChatGPT 로그인은 그대로라 다시 로그인할 필요 없어요 — 전에 codex login --with-api-key 로 키를 넣으신 적이 있거나 ChatGPT 로 로그인한 적이 없다면 codex login 으로 ChatGPT 에 로그인해 주세요.

Windows 사용자 환경변수에 넣으셨다면 (PowerShell · 지운 뒤 창을 새로 여세요)
[Environment]::SetEnvironmentVariable("ONEPORT_API_KEY", $null, "User")