코덱스를 구글 클라우드 버텍스 AI 모델로 돌리는 gcp 제공자 설정법

코덱스(Codex)에는 구글 클라우드 버텍스 AI(Vertex AI)용 기본 제공자 gcp가 있다. 내 구글 클라우드 프로젝트에서 쓸 수 있는 모델로 코덱스를 돌리고 싶을 때 쓴다.

1. 코덱스를 돌릴 컴퓨터에 구글 클라우드 CLI를 깔고 기본 인증 정보(ADC)로 로그인한다. 코덱스는 gcloud auth application-default print-access-token을 실행해 토큰을 받는다.

gcloud auth application-default login

1. ~/.codex/config.toml에 제공자를 넣는다.

model_provider = "gcp"

[model_providers.gcp]
project_id = "my-project"
location = "global"

project_id나 location을 빼면 각각 GOOGLE_CLOUD_PROJECT, GOOGLE_CLOUD_LOCATION 환경변수를 읽고, location 기본값은 global이다. 특정 ADC 파일을 쓰려면 [model_providers.gcp] 아래 credential_file에 절대 경로를 적는다.

1. 0.167.0부터는 설정 파일을 손대지 않고 로그인 화면의 설정 마법사로도 연결할 수 있다. 기본으로 꺼져 있으니 기능부터 켠다.

codex features enable gcp_setup_wizard

로그인 화면에서 "Sign in another way"를 고르면 API 키, 아마존 베드록 옆에 Google Cloud Vertex AI가 보인다. 프로젝트 ID, 위치, 인증 파일을 차례로 넣는다. 위치와 인증 파일은 비워도 되고, 인증 파일을 비우면 ADC를 쓴다.

1. 0.167.2부터는 버텍스 AI에서 도구 정보가 바뀔 때마다 조금씩 나눠 보내는 증분 전송이 기본으로 켜져 있다. 이 방식을 끄려면 config.toml의 [features] 아래에 한 줄을 넣는다.

[features]
incremental_tools_legacy_gcp = false