OpenAI
ეს გვერდი მანქანური თარგმანის მეშვეობით ითარგმნა. სტატიის ინგლისური დედნის ნახვა.

Codex-ის კონფიგურაცია Amazon Bedrock-თან

გამართეთ Codex Amazon Bedrock-თან სამუშაოდ, მათ შორის მხარდაჭერილი მოდელები, AWS-ის ავტორიზაციის მონაცემები და ლოკალური კლიენტის პარამეტრები.

განახლებულია: 7 days ago

გამოიყენეთ ეს სახელმძღვანელო Codex-ის ისე კონფიგურაციისთვის, რომ მან Amazon Bedrock-ის მეშვეობით ხელმისაწვდომი OpenAI მოდელები გამოიყენოს.

ამ კონფიგურაციაში Codex იყენებს Amazon Bedrock-ის საკრედენციო მონაცემებს და მოდელის მოთხოვნებს აგზავნის Bedrock-ის Responses API-ის იმპლემენტაციის მეშვეობით. OpenAI-ზე განთავსებული API მოთხოვნის გზაში არ მონაწილეობს.

ეს დაყენება მხარს უჭერს ლოკალურ Codex სამუშაო ნაკადებს შემდეგში:

  • Codex CLI

  • Codex-ის დესკტოპის აპი

  • Codex VS Code გაფართოება

ეს სტატია არ ვრცელდება Codex-ზე, რომელიც კონფიგურირებულია ChatGPT-ით შესვლით ან OpenAI API გასაღებით.

დაწყებამდე

დარწმუნდით, რომ გაქვთ:

  • Codex CLI ვერსია 0.128.0 ან უფრო ახალი

  • Codex-ის დესკტოპის აპი ან VS Code გაფართოება, ვერსია 26.429.30905 ან უფრო ახალი

  • წვდომა Amazon Bedrock-ში მხარდაჭერილ OpenAI მოდელებზე

  • AWS რეგიონი, სადაც არჩეული მოდელი ხელმისაწვდომია

  • თქვენი AWS ანგარიშისთვის კონფიგურირებული, Bedrock-ის მიერ მხარდაჭერილი ავთენტიფიკაცია

მხარდაჭერილი მოდელები

გამოიყენეთ ამ ზუსტი მოდელის ID-ებიდან ერთ-ერთი:

openai.gpt-5.6-sol

openai.gpt-5.6-terra

openai.gpt-5.6-luna

openai.gpt-5.5

openai.gpt-5.4

რეკომენდებული ნაგულისხმევი:

openai.gpt-5.6-sol

Codex-ის კონფიგურაცია

დაამატეთ შემდეგი:

~/.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 შეცვალეთ იმ AWS რეგიონით, სადაც თქვენი არჩეული მოდელი ხელმისაწვდომია.

ავთენტიფიკაციის ვარიანტები

Codex მხარს უჭერს Amazon Bedrock-ის ავთენტიფიკაციის ორ გზას:

  1. Bedrock API გასაღები, რომელიც იყენებს AWS_BEARER_TOKEN_BEDROCK

  2. AWS SDK-ის საკრედენციო მონაცემების ჯაჭვი IAM-ით ხელმოწერილი მოთხოვნებისთვის

Codex ავთენტიფიკაციას ამ თანმიმდევრობით ამოწმებს:

  1. AWS_BEARER_TOKEN_BEDROCK

  2. AWS SDK-ის საკრედენციო მონაცემების ჯაჭვი

თუ AWS_BEARER_TOKEN_BEDROCK დაყენებულია, Codex მას პირველად იყენებს. წინააღმდეგ შემთხვევაში, Codex AWS SDK-ის საკრედენციო მონაცემების ჯაჭვზე გადადის.

ამ კონფიგურაციისთვის არ გამოიყენოთ OPENAI_API_KEY. Codex Amazon Bedrock-ის საკრედენციო მონაცემებს იყენებს, როცა model_provider დაყენებულია მნიშვნელობაზე amazon-bedrock.

გამოიყენეთ Bedrock API გასაღები, თუ თქვენი AWS ანგარიში მხარს უჭერს Bedrock API გასაღებებს. გამოიყენეთ AWS SDK-ის საკრედენციო მონაცემები, თუ თქვენი ორგანიზაცია Bedrock-ზე წვდომას მართავს IAM-ის, AWS-ის ერთიანი ავთენტიფიკაციით შესვლის, დასახელებული პროფილების ან ფედერაციული იდენტობის მეშვეობით.

ვარიანტი 1: გამოიყენეთ Bedrock API გასაღები

დააყენეთ თქვენი Bedrock API გასაღები იმ გარემოში, რომელსაც Codex წაიკითხავს:

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

შემდეგ დარწმუნდით, რომ თქვენი Codex-ის კონფიგურაცია Bedrock რეგიონს შეიცავს:

model = "openai.gpt-5.6-sol"

model_provider = "amazon-bedrock"

[model_providers.amazon-bedrock.aws]

wire_api = "responses"

region = "us-west-2"

Bedrock API გასაღებით ავთენტიფიკაციისას რეგიონი აუცილებელია.

ვარიანტი 2: AWS SDK-ის ავტორიზაციის მონაცემების გამოყენება

გამოიყენეთ ეს გზა, თუ გსურთ, რომ Codex-მა ავთენტიფიკაცია AWS IAM-ის ავტორიზაციის მონაცემებით გაიაროს.

Codex იყენებს AWS SDK-ის ავტორიზაციის მონაცემების ჯაჭვს, ამიტომ შეგიძლიათ გამოიყენოთ AWS-ის ავტორიზაციის მონაცემების სტანდარტული კონფიგურაციები, მათ შორის AWS-ის საზიარო კონფიგურაციის ფაილები, გარემოს ცვლადები, AWS-ის ერთიანი ავთენტიფიკაციით შესვლა და სახელდებული პროფილები.

AWS-ის საზიარო ავტორიზაციის მონაცემები

aws configure

გარემოს ცვლადები

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-ის ავტორიზაციის მონაცემები

aws login

AWS-ის ერთიანი ავთენტიფიკაციით შესვლა ან სახელდებული პროფილი

aws sso login --profile <profile-name>

export AWS_PROFILE=<profile-name>

პროფილი ასევე შეგიძლიათ პირდაპირ ~/.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"

თუ model_providers.amazon-bedrock.aws.region მითითებულია, Codex უპირველესად მას იყენებს. წინააღმდეგ შემთხვევაში, SDK-ით ავთენტიფიკაციისას Codex რეგიონის განსაზღვრას AWS SDK-ის ნაგულისხმევი კონფიგურაციის ჯაჭვს გადასცემს, მათ შორის AWS_REGION-ს, AWS_DEFAULT_REGION-სა და არჩეულ AWS პროფილს.

  • ~/.codex/config.toml

  • AWS_REGION

  • AWS_DEFAULT_REGION

  • არჩეული AWS პროფილი

რეგიონის ~/.codex/config.toml-ში მითითება ყველაზე ცალსახა ვარიანტია.

ფედერაციული იდენტობა credential_process-ით

კორპორაციული ერთიანი ავთენტიფიკაციით შესვლის ან OIDC ფედერაციისთვის AWS პროფილი Codex-ის გარეთ დააკონფიგურირეთ და AWS SDK-ს მისცეთ საშუალება, სერტიფიკატები თვითონ განსაზღვროს.

~/.aws/config ჩანაწერის მაგალითი:

[profile codex-bedrock]

region = us-west-2

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

შემდეგ Codex-ს მიუთითეთ ეს პროფილი ~/.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"

დესკტოპის აპი და VS Code გაფართოება

დესკტოპის აპებმა და IDE გაფართოებებმა შესაძლოა თქვენი shell-იდან გარემოს ცვლადები არ მიიღონ.

თუ Codex-ს სჭირდება გარემოს ცვლადები, როგორიცაა AWS_BEARER_TOKEN_BEDROCK, დაამატეთ ისინი აქ:

~/.codex/.env

მაგალითი:

AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>

AWS_REGION=us-west-2

~/.codex/config.toml ან ~/.codex/.env შეცვლის შემდეგ გადატვირთეთ Codex-ის დესკტოპის აპი ან VS Code გაფართოება.

კონფიგურაციის შემოწმება

კონფიგურაციის შემდეგ:

  • Codex CLI-ში გახსენით /status და დაადასტურეთ, რომ Codex იყენებს amazon-bedrock მოდელის პროვაიდერს.

  • Codex-ის დესკტოპის აპში ან VS Code გაფართოებაში აპის გადატვირთვის შემდეგ ახალი სესია დაიწყეთ.

ცნობილი შეზღუდვები

ამ კონფიგურაციაში ამჟამად ხელმისაწვდომი არ არის შემდეგი ფუნქციები:

  • სურათის გენერირება

  • ხმოვანი შეყვანის ტრანსკრიფცია

  • ღრუბლოვანი პლაგინების მაღაზია

  • ღრუბლოვანი კონფიგურაცია და პოლიტიკები

  • ღრუბლოვანი აგენტები, მათ შორის მიმოხილვის, უსაფრთხოების და ვებ-აგენტები

ფუნქციების ხელმისაწვდომობა შეიძლება განსხვავდებოდეს ChatGPT-ით შესვლით კონფიგურირებულ Codex-ს, OpenAI API გასაღებით კონფიგურირებულ Codex-სა და Amazon Bedrock API გასაღებით კონფიგურირებულ Codex-ს შორის.

პრობლემების მოგვარება

თუ დაყენება ვერ მოხერხდა, შეამოწმეთ შემდეგი:

  • თქვენი Codex ვერსია აკმაყოფილებს მინიმალურ მოთხოვნას.

  • თქვენი მოდელის ID ზუსტად ემთხვევა მხარდაჭერილ მოდელს.

  • თქვენი AWS რეგიონი დაყენებულია და არჩეული მოდელი ხელმისაწვდომია ამ რეგიონში.

  • თქვენი AWS საკრედენციო მონაცემები ან Bedrock API გასაღები ვალიდურია და ვადა არ გასვლია.

  • თქვენს AWS იდენტობას აქვს არჩეულ Bedrock მოდელზე წვდომის ნებართვა.

  • AWS_BEARER_TOKEN_BEDROCK არ არის დაყენებული ვადაგასულ ან არასასურველ გასაღებზე.

  • თუ AWS SDK-ის საკრედენციო მონაცემებს იყენებთ, თქვენი არჩეული AWS პროფილი ვალიდურია.

  • დესკტოპის აპის ან VS Code გაფართოების გამოყენებისას საჭირო გარემოს ცვლადები არსებობს ~/.codex/.env-ში.

  • კონფიგურაციის ან გარემოს ფაილების შეცვლის შემდეგ აპი ან გაფართოება გადატვირთეთ.

AWS საკრედენციო მონაცემების, IAM ნებართვების, Bedrock მოდელზე წვდომის, კვოტების, ბილინგის, რეგიონული ხელმისაწვდომობის ან Bedrock სერვისის შეცდომებისთვის დაუკავშირდით თქვენს AWS ადმინისტრატორს ან AWS Support-ს.

OpenAI Support დაგეხმარებათ Codex კლიენტის დაყენებაში, კონფიგურაციასა და Codex-ის ლოკალურ ქცევასთან დაკავშირებულ საკითხებში.

სასარგებლო იყო ეს სტატია?