Sanidi Codex kwa Amazon Bedrock

Tumia mwongozo huu kusanidi Codex itumie miundo ya OpenAI inayopatikana kupitia Amazon Bedrock.

Katika usanidi huu, Codex hutumia vitambulisho vya Amazon Bedrock na hutuma maombi ya muundo kupitia utekelezaji wa Responses API wa Bedrock. API inayopangishwa na OpenAI haipo kwenye njia ya ombi.

Usanidi huu unaauni mitiririko ya kazi ya ndani ya Codex katika:

• Codex CLI

• Programu ya mezani ya Codex

• Kiendelezi cha Codex cha VS Code

Makala haya hayatumiki kwa Codex iliyosanidiwa kwa kuingia kwa ChatGPT au ufunguo wa OpenAI API.

Kabla ya kuanza

Hakikisha una:

• Toleo la Codex CLI 0.128.0 au jipya zaidi

• Programu ya mezani ya Codex au kiendelezi cha VS Code toleo la 26.429.30905 au jipya zaidi

• Ufikiaji wa miundo ya OpenAI inayotumika katika Amazon Bedrock

• Eneo la AWS ambako muundo uliochaguliwa unapatikana

• Uthibitishaji unaotumika na Bedrock uliosanidiwa kwa akaunti yako ya AWS

Miundo inayotumika

Tumia mojawapo ya vitambulisho hivi halisi vya muundo:

openai.gpt-5.6-sol

openai.gpt-5.6-terra

openai.gpt-5.6-luna

openai.gpt-5.5

openai.gpt-5.4

Chaguomsingi inayopendekezwa:

openai.gpt-5.6-sol

Sanidi Codex

Ongeza yafuatayo kwenye:

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

Badilisha us-west-2 na Eneo la AWS ambako muundo uliouchagua unapatikana.

Chaguo za uthibitishaji

Codex inatumia njia mbili za uthibitishaji za Amazon Bedrock:

1. Ufunguo wa Bedrock API unaotumia AWS_BEARER_TOKEN_BEDROCK

2. Msururu wa vitambulisho vya AWS SDK kwa maombi yaliyosainiwa na IAM

Codex hukagua uthibitishaji kwa mpangilio huu:

1. AWS_BEARER_TOKEN_BEDROCK

2. Msururu wa vitambulisho vya AWS SDK

Ikiwa AWS_BEARER_TOKEN_BEDROCK imewekwa, Codex huitumia kwanza. Vinginevyo, Codex hutumia msururu wa vitambulisho vya AWS SDK kama mbadala.

Usitumie OPENAI_API_KEY kwa usanidi huu. Codex hutumia vitambulisho vya Amazon Bedrock wakati model_provider imewekwa kuwa amazon-bedrock.

Tumia ufunguo wa Bedrock API ikiwa akaunti yako ya AWS inatumia funguo za Bedrock API. Tumia vitambulisho vya AWS SDK ikiwa shirika lako hudhibiti ufikiaji wa Bedrock kupitia IAM, AWS SSO, wasifu uliopewa majina, au utambulisho shirikishi.

Chaguo la 1: Tumia ufunguo wa API wa Bedrock

Weka ufunguo wako wa API wa Bedrock katika mazingira ambayo Codex itasoma:

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

Kisha hakikisha usanidi wako wa Codex unajumuisha Eneo la Bedrock:

model = "openai.gpt-5.6-sol"

model_provider = "amazon-bedrock"

[model_providers.amazon-bedrock.aws]

wire_api = "responses"

region = "us-west-2"

Eneo linahitajika unapotumia uthibitishaji kwa ufunguo wa API wa Bedrock.

Chaguo la 2: Tumia vitambulisho vya AWS SDK

Tumia njia hii unapotaka Codex ithibitishe utambulisho kwa vitambulisho vya AWS IAM.

Codex hutumia msururu wa vitambulisho vya AWS SDK, kwa hivyo mipangilio ya kawaida ya vitambulisho vya AWS inaweza kufanya kazi, ikiwemo faili za usanidi wa AWS zinazoshirikiwa, vigeu vya mazingira, AWS SSO na wasifu wenye majina.

Vitambulisho vya AWS vinavyoshirikiwa

aws configure

Vigeu vya mazingira

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>

Vitambulisho vya Dashibodi ya Usimamizi ya AWS

aws login

AWS SSO au wasifu wenye jina

aws sso login --profile <profile-name>

export AWS_PROFILE=<profile-name>

Unaweza pia kuweka wasifu moja kwa moja katika ~/.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 hutumia kwanza model_providers.amazon-bedrock.aws.region ikiwa imewekwa. Vinginevyo, kwa uthibitishaji wa SDK, Codex huachia msururu chaguomsingi wa usanidi wa AWS SDK kubainisha Eneo, ikiwemo AWS_REGION, AWS_DEFAULT_REGION na wasifu uliochaguliwa wa AWS.

• ~/.codex/config.toml

• AWS_REGION

• AWS_DEFAULT_REGION

• Wasifu wa AWS uliochaguliwa

Kuweka Eneo katika ~/.codex/config.toml ndilo chaguo lililo wazi zaidi.

Utambulisho shirikishi kwa credential_process

Kwa SSO ya shirika au ushirikishaji wa OIDC, sanidi profaili ya AWS nje ya Codex na uruhusu AWS SDK ibaini vitambulisho.

Mfano wa ingizo la ~/.aws/config:

[profile codex-bedrock]

region = us-west-2

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

Kisha elekeza Codex kwenye profaili hiyo katika ~/.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"

Programu ya mezani na kiendelezi cha VS Code

Programu za mezani na viendelezi vya IDE huenda visirithi vigeu vya mazingira kutoka kwenye shell yako.

Ikiwa Codex inahitaji vigeu vya mazingira kama AWS_BEARER_TOKEN_BEDROCK, viongeze kwenye:

~/.codex/.env

Mfano:

AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>

AWS_REGION=us-west-2

Baada ya kubadilisha ~/.codex/config.toml au ~/.codex/.env, anzisha upya programu ya mezani ya Codex au kiendelezi cha VS Code.

Thibitisha usanidi

Baada ya usanidi:

• Katika Codex CLI, fungua /status na uthibitishe kuwa Codex inatumia mtoa huduma wa muundo wa amazon-bedrock.

• Katika programu ya mezani ya Codex au kiendelezi cha VS Code, anzisha kipindi kipya baada ya kuanzisha upya programu.

Vikwazo vinavyojulikana

Vipengele vifuatavyo havipatikani kwa sasa katika usanidi huu:

• Uzalishaji wa picha

• Unukuzi wa sauti kwa ingizo

• Duka la programu-jalizi la cloud

• Usanidi na sera za cloud

• Mawakala wa cloud, ikijumuisha wakala wa ukaguzi, usalama, na wavuti

Upatikanaji wa vipengele unaweza kutofautiana kati ya Codex yenye kuingia kwa ChatGPT, Codex yenye ufunguo wa OpenAI API, na Codex yenye ufunguo wa Amazon Bedrock API.

Utatuzi wa matatizo

Ikiwa usanidi utashindwa, angalia yafuatayo:

• Toleo lako la Codex linatimiza hitaji la chini zaidi.

• Kitambulisho cha muundo wako kinalingana kikamilifu na muundo unaotumika.

• Eneo lako la AWS limewekwa na muundo uliochaguliwa unapatikana katika Eneo hilo.

• Vitambulisho vyako vya AWS au ufunguo wa Bedrock API ni halali na muda wake haujaisha.

• Utambulisho wako wa AWS una ruhusa ya kufikia muundo wa Bedrock uliochaguliwa.

• AWS_BEARER_TOKEN_BEDROCK haujawekwa kuwa ufunguo ambao muda wake umeisha au ambao haukukusudiwa.

• Ikiwa unatumia vitambulisho vya AWS SDK, wasifu wako wa AWS uliochaguliwa ni halali.

• Kwa matumizi ya programu ya mezani au kiendelezi cha VS Code, vigeu vya mazingira vinavyohitajika vipo katika ~/.codex/.env.

• Ulianzisha upya programu au kiendelezi baada ya kubadilisha faili za usanidi au mazingira.

Kwa vitambulisho vya AWS, ruhusa za IAM, ufikiaji wa muundo wa Bedrock, vikomo, utozaji, upatikanaji wa kikanda, au hitilafu za huduma ya Bedrock, wasiliana na msimamizi wako wa AWS au AWS Support.

OpenAI Support inaweza kusaidia kwa usanidi wa mteja wa Codex, mipangilio, na tabia ya ndani ya Codex.