Codex’i Amazon Bedrock ile yapılandırın

Codex’i Amazon Bedrock üzerinden kullanılabilen OpenAI modellerini kullanacak şekilde yapılandırmak için bu kılavuzu kullanın.

Bu yapılandırmada Codex, Amazon Bedrock kimlik bilgilerini kullanır ve model isteklerini Bedrock’ın Responses API uygulaması üzerinden gönderir. OpenAI tarafından barındırılan API, istek yolunda değildir.

Bu kurulum, yerel Codex iş akışlarını şuralarda destekler:

• Codex CLI

• Codex masaüstü uygulaması

• Codex VS Code uzantısı

Bu makale, ChatGPT oturum açması veya OpenAI API anahtarıyla yapılandırılmış Codex için geçerli değildir.

Başlamadan önce

Şunlara sahip olduğunuzdan emin olun:

• Codex CLI sürüm 0.128.0 veya üzeri

• Codex masaüstü uygulaması veya VS Code uzantısı sürüm 26.429.30905 veya üzeri

• Amazon Bedrock’ta desteklenen OpenAI modellerine erişim

• Seçili modelin kullanılabildiği bir AWS Bölgesi

• AWS hesabınız için yapılandırılmış Bedrock destekli kimlik doğrulama

Desteklenen modeller

Şu tam model kimliklerinden birini kullanın:

openai.gpt-5.6-sol

openai.gpt-5.6-terra

openai.gpt-5.6-luna

openai.gpt-5.5

openai.gpt-5.4

Önerilen varsayılan:

openai.gpt-5.6-sol

Codex’i yapılandırma

Aşağıdakileri şuraya ekleyin:

~/.codex/config.toml

model = "openai.gpt-5.6-sol"

model_provider = "amazon-bedrock"

[model_providers.amazon-bedrock.aws]

region = "us-west-2"

wire_api = "responses"

# Optional for AWS SDK auth. If omitted, the AWS SDK uses AWS_PROFILE or the default profile.

# profile = "codex-bedrock"

us-west-2 değerini, seçtiğiniz modelin kullanılabildiği AWS Bölgesiyle değiştirin.

Kimlik doğrulama seçenekleri

Codex, iki Amazon Bedrock kimlik doğrulama yolunu destekler:

1. AWS_BEARER_TOKEN_BEDROCK kullanan Bedrock API anahtarı

2. IAM imzalı istekler için AWS SDK kimlik bilgisi zinciri

Codex, kimlik doğrulamayı şu sırayla kontrol eder:

1. AWS_BEARER_TOKEN_BEDROCK

2. AWS SDK kimlik bilgisi zinciri

AWS_BEARER_TOKEN_BEDROCK ayarlanmışsa Codex önce bunu kullanır. Aksi takdirde Codex, AWS SDK kimlik bilgisi zincirine geri döner.

Bu yapılandırma için OPENAI_API_KEY kullanmayın. model_provider, amazon-bedrock olarak ayarlandığında Codex Amazon Bedrock kimlik bilgilerini kullanır.

AWS hesabınız Bedrock API anahtarlarını destekliyorsa bir Bedrock API anahtarı kullanın. Kuruluşunuz Bedrock erişimini IAM, AWS SSO, adlandırılmış profiller veya birleşik kimlik üzerinden yönetiyorsa AWS SDK kimlik bilgilerini kullanın.

Seçenek 1: Bedrock API anahtarı kullanın

Bedrock API anahtarınızı Codex’in okuyacağı ortamda ayarlayın:

export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>

Ardından Codex yapılandırmanızın bir Bedrock Bölgesi içerdiğinden emin olun:

model = "openai.gpt-5.6-sol"

model_provider = "amazon-bedrock"

[model_providers.amazon-bedrock.aws]

wire_api = "responses"

region = "us-west-2"

Bedrock API anahtarıyla kimlik doğrulaması kullanılırken Bölge gereklidir.

2. Seçenek: AWS SDK kimlik bilgilerini kullanma

Codex'in AWS IAM kimlik bilgileriyle kimlik doğrulaması yapmasını istiyorsanız bu yöntemi kullanın.

Codex, AWS SDK kimlik bilgisi zincirini kullanır. Bu nedenle paylaşılan AWS yapılandırma dosyaları, ortam değişkenleri, AWS SSO (çoklu oturum açma) ve adlandırılmış profiller dâhil standart AWS kimlik bilgisi yapılandırmaları kullanılabilir.

Paylaşılan AWS kimlik bilgileri

aws configure

Ortam değişkenleri

export AWS_ACCESS_KEY_ID=<your-access-key-id>

export AWS_SECRET_ACCESS_KEY=<your-secret-access-key>

export AWS_SESSION_TOKEN=<your-session-token>

AWS Yönetim Konsolu kimlik bilgileri

aws login

AWS SSO (çoklu oturum açma) veya adlandırılmış profil

aws sso login --profile <profile-name>

export AWS_PROFILE=<profile-name>

Profili doğrudan ~/.codex/config.toml dosyasında da ayarlayabilirsiniz:

model = "openai.gpt-5.6-sol"

model_provider = "amazon-bedrock"

[model_providers.amazon-bedrock.aws]

profile = "codex-bedrock"

wire_api = "responses"

region = "us-west-2"

Codex, ayarlanmışsa önce model_providers.amazon-bedrock.aws.region değerini kullanır. Aksi takdirde Codex, SDK kimlik doğrulamasında Bölge çözümlemesini AWS_REGION, AWS_DEFAULT_REGION ve seçili AWS profilini içeren AWS SDK varsayılan yapılandırma zincirine devreder.

• ~/.codex/config.toml

• AWS_REGION

• AWS_DEFAULT_REGION

• Seçili AWS profili

Bölgeyi ~/.codex/config.toml dosyasında ayarlamak en açık seçenektir.

credential_process ile federasyonlu kimlik

Kurumsal SSO (çoklu oturum açma) veya OIDC federasyonu için AWS profilini Codex dışında yapılandırın ve kimlik bilgilerini AWS SDK’nin çözümlemesine izin verin.

Örnek ~/.aws/config girdisi:

[profile codex-bedrock]

region = us-west-2

credential_process = /path/to/your/idp-helper --profile codex-bedrock

Ardından ~/.codex/config.toml içinde Codex’i bu profile yönlendirin:

model = "openai.gpt-5.6-sol"

model_provider = "amazon-bedrock"

[model_providers.amazon-bedrock.aws]

profile = "codex-bedrock" wire_api = "responses"

region = "us-west-2"

Masaüstü uygulaması ve VS Code uzantısı

Masaüstü uygulamaları ve IDE uzantıları, kabuğunuzdaki ortam değişkenlerini devralmayabilir.

Codex’in AWS_BEARER_TOKEN_BEDROCK gibi ortam değişkenlerine ihtiyacı varsa bunları şuraya ekleyin:

~/.codex/.env

Örnek:

AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>

AWS_REGION=us-west-2

~/.codex/config.toml veya ~/.codex/.env dosyasını değiştirdikten sonra Codex masaüstü uygulamasını veya VS Code uzantısını yeniden başlatın.

Kurulumu doğrulayın

Yapılandırmadan sonra:

• Codex CLI’da /status öğesini açın ve Codex’in amazon-bedrock model sağlayıcısını kullandığını doğrulayın.

• Codex masaüstü uygulamasında veya VS Code uzantısında, uygulamayı yeniden başlattıktan sonra yeni bir oturum başlatın.

Bilinen sınırlamalar

Aşağıdaki özellikler şu anda bu yapılandırmada kullanılamaz:

• Görsel oluşturma

• Giriş için ses transkripsiyonu

• Bulut eklenti mağazası

• Bulut yapılandırması ve ilkeleri

• İnceleme, güvenlik ve web otonom ajanları dahil bulut otonom ajanları

Özellik kullanılabilirliği, ChatGPT oturum açmasıyla Codex, OpenAI API anahtarıyla Codex ve Amazon Bedrock API anahtarıyla Codex arasında farklılık gösterebilir.

Sorun giderme

Kurulum başarısız olursa şunları kontrol edin:

• Codex sürümünüz minimum gereksinimi karşılıyor.

• Model kimliğiniz desteklenen bir modelle tam olarak eşleşiyor.

• AWS Bölgeniz ayarlı ve seçili model o Bölgede kullanılabiliyor.

• AWS kimlik bilgileriniz veya Bedrock API anahtarınız geçerli ve süresi dolmamış.

• AWS kimliğinizin seçili Bedrock modeline erişim izni var.

• AWS_BEARER_TOKEN_BEDROCK, süresi dolmuş veya istenmeyen bir anahtara ayarlı değil.

• AWS SDK kimlik bilgileri kullanıyorsanız seçili AWS profiliniz geçerli.

• Masaüstü uygulaması veya VS Code uzantısı kullanımı için gerekli ortam değişkenleri ~/.codex/.env içinde mevcut.

• Yapılandırma veya ortam dosyalarını değiştirdikten sonra uygulamayı ya da uzantıyı yeniden başlattınız.

AWS kimlik bilgileri, IAM izinleri, Bedrock model erişimi, kotalar, faturalandırma, bölgesel kullanılabilirlik veya Bedrock hizmet hataları için AWS yöneticinizle ya da AWS Support ile iletişime geçin.

OpenAI Support, Codex istemci kurulumu, yapılandırması ve yerel Codex davranışı konusunda yardımcı olabilir.