Coding Agent 설정

Codex VS Code 확장: API 및 공식 로그인

Codex VS Code 확장의 config.toml에 BetterToken Responses를 설정하세요. 공식 로그인, 플러그인, Remote Control을 유지할 수 있습니다.

Codex VS Code Extension은 Codex CLI/App와 ~/.codex/config.toml을 공유합니다. official login, plugins 또는 Remote Control을 유지해야 할 때 이 페이지를 사용하세요.

주요 설정

필드	값
API Key	`experimental_bearer_token = "YOUR_API_KEY"`
Base URL	`https://bettertoken.ai/v1`
Model	`gpt-6-astra`

사전 요구 사항

최신 Codex VS Code Extension 설치
Extension 또는 Codex App에서 official login 완료
BetterToken API Key 생성
모델 광장 또는 key Setup dialog에서 Model ID 복사

가입하고 BetterToken API Key 받기

이미 계정이 있나요? 로그인하고 잔액을 충전한 다음 콘솔에서 키를 만드세요.

설치

VS Code Marketplace에서 extension을 설치한 다음 VS Code를 다시 시작하세요.

수동 설정

사용자 지정 CODEX_HOME이 설정되어 있으면 해당 디렉터리의 config.toml을 편집하세요. 그렇지 않으면 macOS / Linux에서는 ~/.codex/config.toml, Windows에서는 %USERPROFILE%\.codex\config.toml을 사용합니다.

Codex를 완전히 종료한 다음 기존 config.toml과 auth.json을 백업하세요. 제공업체 테이블을 중복으로 추가하지 말고 기존 제공업체 설정을 업데이트하세요.

Extension 구성

~/.codex/config.toml을 편집하세요.

model_provider = "bettertoken"
model = "gpt-6-astra"

[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://bettertoken.ai/v1"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "YOUR_API_KEY"
supports_websockets = false

설정 매개변수

매개변수	역할과 위치	기본값과 예시
`model_provider`	사용자 설정 최상위; 아래에 정의한 ID를 선택합니다.	기본값 `openai`; 여기서는 `bettertoken`.
`model`	최상위; 모델 광장의 전체 Model ID.	예시 `gpt-6-astra`; 필요에 따라 변경합니다.
`name`	provider 테이블; 표시 이름만 지정합니다.	`BetterToken`은 Model ID가 아닙니다.
`base_url`	provider 테이블; 모델 API의 Base URL.	`https://bettertoken.ai/v1`을 사용하면 Codex가 `/responses`를 붙입니다.
`wire_api`	provider 테이블; 요청 프로토콜.	현재 `responses`만 지원하며 생략 시 기본값도 같습니다.
`requires_openai_auth`	provider 테이블; OpenAI 인증과 인증 정보 저장소를 사용합니다.	기본값 `false`; 여기서는 `true`. 로그인 파일 유지 스위치가 아닙니다.
`experimental_bearer_token`	제공자 테이블 내부. 타사 요청의 Bearer Key입니다.	BetterToken API Key를 사용하며 공식 로그인 캐시를 덮어쓰지 않습니다. 평문으로 저장되며 OpenAI는 이 필드를 권장하지 않습니다.
`supports_websockets`	provider 테이블; Responses WebSocket 지원.	기본값 `false`; 여기서는 HTTP/SSE를 유지합니다.

공식 로그인으로 생성한 인증 정보를 유지하고 API Key JSON으로 바꾸지 마세요. requires_openai_auth = true는 공식 인증 절차를 사용하며 현재 provider의 experimental_bearer_token이 모델 요청용 타사 Key를 제공합니다. 전자가 활성화되면 Codex는 env_key를 무시하므로 Bearer Key를 직접 대체하지 마세요. Key가 있는 설정 파일을 공유하지 마세요.

다른 인증 정보 설정 방식은 OpenAI의 환경 변수 및 명령 기반 인증 안내를 참고하세요. 각 방식은 별도의 인증 모드입니다. 제공자 auth 테이블을 env_key, experimental_bearer_token, requires_openai_auth와 함께 사용하지 마세요. 공식 로그인을 유지하는 이 예제에서 env_key로 대체하지 마세요.

설정 계층과 이전 키

모델과 추론 설정을 [projects."<path>"]에 넣지 마세요. 프로젝트별 모델은 신뢰한 프로젝트의 .codex/config.toml 최상위에 둘 수 있지만 provider와 인증은 사용자 설정에 둡니다. 현재 profile은 CODEX_HOME의 NAME.config.toml을 codex --profile NAME으로 선택합니다. 이전 [profiles.NAME] 테이블이나 최상위 profile 선택자는 사용하지 않습니다.

파일을 저장하고 VS Code에서 Developer: Reload Window를 실행한 다음 Codex panel을 다시 여세요.

연결 확인

새 Extension session을 만들고 짧은 task를 보내세요. plugins와 Remote Control이 계속 사용 가능한 상태에서 gpt-6-astra의 response를 받으면 설정이 확인됩니다.

모델 전환

model 및 필요하면 review_model을 바꾼 다음 Developer: Reload Window를 실행하세요. Setup dialog 또는 모델 광장의 Model ID를 사용하세요.

일반적인 오류

오류	해결 방법
Extension이 다시 sign in을 요청함	official login을 복구하고 `requires_openai_auth = true`를 유지하세요.
`401` 또는 `403`	`experimental_bearer_token`을 다시 복사하고 `auth.json`을 덮어쓰지 마세요.
Duplicate table	다른 `[model_providers.bettertoken]` table을 제거하고 authentication mode 하나만 유지하세요.
Model not found	`gpt-6-astra`를 현재의 완전한 Model ID로 바꾸세요.
Configuration이 적용되지 않음	파일을 저장하고 Developer: Reload Window를 실행하세요.