Stilla Codex með Amazon Bedrock

Notaðu þessa leiðbeiningu til að stilla Codex til að nota OpenAI-líkön sem eru í boði í gegnum Amazon Bedrock.

Í þessari uppsetningu notar Codex Amazon Bedrock-skilríki og sendir líkansbeiðnir í gegnum útfærslu Bedrock á Responses API. API sem hýst er hjá OpenAI er ekki hluti af beiðnaleiðinni.

Þessi uppsetning styður staðbundin Codex-vinnuferli í:

• Codex CLI

• Codex skjáborðsforriti

• Codex VS Code-viðbót

Þessi grein á ekki við um Codex sem er stillt með ChatGPT-innskráningu eða OpenAI API-lykli.

Áður en þú byrjar

Gakktu úr skugga um að þú hafir:

• Codex CLI útgáfu 0.128.0 eða nýrri

• Codex skjáborðsforrit eða VS Code-viðbót útgáfu 26.429.30905 eða nýrri

• Aðgang að studdum OpenAI-líkönum í Amazon Bedrock

• AWS-svæði þar sem valda líkanið er í boði

• Bedrock-studda auðkenningu stillta fyrir AWS-reikninginn þinn

Studd líkön

Notaðu eitt af þessum nákvæmu auðkennum líkana:

openai.gpt-5.6-sol

openai.gpt-5.6-terra

openai.gpt-5.6-luna

openai.gpt-5.5

openai.gpt-5.4

Ráðgefið sjálfgefið val:

openai.gpt-5.6-sol

Stilla Codex

Bættu eftirfarandi við:

~/.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"

Skiptu us-west-2 út fyrir AWS-svæðið þar sem valda líkanið þitt er tiltækt.

Auðkenningarvalkostir

Codex styður tvær auðkenningarleiðir fyrir Amazon Bedrock:

1. Bedrock API-lykill með AWS_BEARER_TOKEN_BEDROCK

2. AWS SDK-skilríkjakeðja fyrir IAM-undirritaðar beiðnir

Codex athugar auðkenningu í þessari röð:

1. AWS_BEARER_TOKEN_BEDROCK

2. AWS SDK-skilríkjakeðja

Ef AWS_BEARER_TOKEN_BEDROCK er stillt notar Codex það fyrst. Annars grípur Codex til AWS SDK-skilríkjakeðjunnar.

Ekki nota OPENAI_API_KEY fyrir þessa uppsetningu. Codex notar Amazon Bedrock-skilríki þegar model_provider er stillt á amazon-bedrock.

Notaðu Bedrock API-lykil ef AWS-reikningurinn þinn styður Bedrock API-lykla. Notaðu AWS SDK-skilríki ef fyrirtækið þitt stýrir aðgangi að Bedrock með IAM, AWS SSO-vefslóð, nafngreindum prófílum eða sambandsauðkenni.

Valkostur 1: Nota Bedrock API-lykil

Stilltu Bedrock API-lykilinn þinn í umhverfinu sem Codex les:

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

Gakktu síðan úr skugga um að Codex-stillingarnar innihaldi Bedrock-svæði:

model = "openai.gpt-5.6-sol"

model_provider = "amazon-bedrock"

[model_providers.amazon-bedrock.aws]

wire_api = "responses"

region = "us-west-2"

Svæðið er áskilið þegar Bedrock API-lykilsauðkenning er notuð.

Valkostur 2: Nota AWS SDK-skilríki

Veldu þessa leið þegar þú vilt að Codex auðkenni sig með AWS IAM-skilríkjum.

Codex notar skilríkjakeðju AWS SDK og því virka hefðbundnar uppsetningar AWS-skilríkja, svo sem sameiginlegar AWS-stillingaskrár, umhverfisbreytur, AWS SSO-vefslóð og nafngreind snið.

Sameiginleg AWS-skilríki

aws configure

Umhverfisbreytur

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 Management Console-skilríki

aws login

AWS SSO-vefslóð eða nafngreint snið

aws sso login --profile <profile-name>

export AWS_PROFILE=<profile-name>

Þú getur einnig tilgreint sniðið beint í ~/.codex/config.toml:

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 notar fyrst model_providers.amazon-bedrock.aws.region ef það er tilgreint. Annars lætur Codex sjálfgefna stillingakeðju AWS SDK ákvarða svæðið við SDK-auðkenningu, meðal annars út frá AWS_REGION, AWS_DEFAULT_REGION og völdu AWS-sniði.

• ~/.codex/config.toml

• AWS_REGION

• AWS_DEFAULT_REGION

• Valda AWS-sniðið

Skýrasti kosturinn er að tilgreina svæðið í ~/.codex/config.toml.

Sambandsauðkenni með credential_process

Fyrir fyrirtækja-SSO-vefslóð eða OIDC-samband skaltu stilla AWS-prófílinn utan Codex og láta AWS SDK leysa auðkennin.

Dæmi um færslu í ~/.aws/config:

[profile codex-bedrock]

region = us-west-2

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

Beindu síðan Codex á þann prófíl í ~/.codex/config.toml:

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"

Skjáborðsforrit og VS Code-viðbót

Skjáborðsforrit og IDE-viðbætur erfa ekki endilega umhverfisbreytur úr skelinni þinni.

Ef Codex þarf umhverfisbreytur á borð við AWS_BEARER_TOKEN_BEDROCK skaltu bæta þeim við:

~/.codex/.env

Dæmi:

AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>

AWS_REGION=us-west-2

Eftir að þú breytir ~/.codex/config.toml eða ~/.codex/.env skaltu endurræsa Codex skjáborðsforritið eða VS Code-viðbótina.

Staðfesta uppsetningu

Eftir uppsetningu:

• Í Codex CLI skaltu opna /status og staðfesta að Codex noti líkanaveituna amazon-bedrock.

• Í Codex skjáborðsforritinu eða VS Code-viðbótinni skaltu hefja nýja lotu eftir að forritið hefur verið endurræst.

Þekktar takmarkanir

Eftirfarandi eiginleikar eru ekki tiltækir eins og er í þessari uppsetningu:

• Myndun mynda

• Raddumritun fyrir inntak

• Skýjaverslun viðbóta

• Skýjastillingar og stefnur

• Skýjafulltrúar, þar á meðal yfirferðar-, öryggis- og vef-fulltrúar

Framboð eiginleika getur verið mismunandi milli Codex með ChatGPT-innskráningu, Codex með OpenAI API-lykli og Codex með Amazon Bedrock API-lykli.

Úrræðaleit

Ef uppsetningin mistekst skaltu athuga eftirfarandi:

• Codex-útgáfan þín uppfyllir lágmarkskröfuna.

• Auðkenni líkansins þíns samsvarar nákvæmlega studdu líkani.

• AWS-svæðið þitt er stillt og valda líkanið er í boði á því svæði.

• AWS-skilríkin þín eða Bedrock API-lykillinn eru gild og ekki útrunnin.

• AWS-auðkennið þitt hefur heimild til að fá aðgang að valda Bedrock-líkaninu.

• AWS_BEARER_TOKEN_BEDROCK er ekki stillt á útrunninn eða óviljandi lykil.

• Ef AWS SDK-skilríki eru notuð er valdi AWS-prófíllinn þinn gildur.

• Fyrir notkun með skjáborðsforriti eða VS Code-viðbót eru nauðsynlegar umhverfisbreytur til staðar í ~/.codex/.env.

• Þú endurræstir forritið eða viðbótina eftir að stillingar- eða umhverfisskrám var breytt.

Fyrir AWS-skilríki, IAM-heimildir, aðgang að Bedrock-líkani, kvóta, reikningsfærslu, svæðisbundið framboð eða Bedrock-þjónustuvillur skaltu hafa samband við AWS-kerfisstjórann þinn eða AWS Support.

OpenAI Support getur hjálpað með uppsetningu Codex-biðlara, stillingar og staðbundna hegðun Codex.