Anthropic

Claude მოდელებზე (Opus, Sonnet, Haiku) წვდომა Anthropic Messages API-ით, მშობლიური ინსტრუმენტების გამოყენებით, ვიზუალური ანალიზით, პრომპტ ქეშირებითა და OAuth ტოკენის ავტომატური განახლებით.

წინაპირობები

• Anthropic API გასაღები console.anthropic.com-დან, ან
• Claude Code OAuth ტოკენი (ავტომატურად ამოიცნობა ~/.claude/.credentials.json-დან)

სწრაფი დაყენება

1. API გასაღების მიღება

1. დარეგისტრირდით console.anthropic.com-ზე
2. გადახვიდეთ API Keys განყოფილებაში სამართავ პანელზე
3. დააჭირეთ Create Key-ს და დააკოპირეთ გასაღები (იწყება sk-ant--ით)

2. კონფიგურაცია

[default]
provider = "anthropic"
model = "claude-sonnet-4-20250514"

[providers.anthropic]
api_key = "${ANTHROPIC_API_KEY}"

ან დააყენეთ გარემოს ცვლადი:

export ANTHROPIC_API_KEY="sk-ant-..."

3. შემოწმება

prx doctor models

ხელმისაწვდომი მოდელები

მოდელი	კონტექსტი	ვიზუალი	ინსტრუმენტები	შენიშვნები
claude-opus-4-20250514	200K	დიახ	დიახ	ყველაზე შეძლებული, საუკეთესო რთული მსჯელობისთვის
claude-sonnet-4-20250514	200K	დიახ	დიახ	სიჩქარისა და შესაძლებლობების საუკეთესო ბალანსი
claude-haiku-3-5-20241022	200K	დიახ	დიახ	ყველაზე სწრაფი, ყველაზე ეკონომიური
claude-sonnet-4-6	200K	დიახ	დიახ	უახლესი Sonnet რელიზი
claude-opus-4-6	200K	დიახ	დიახ	უახლესი Opus რელიზი

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

ველი	ტიპი	ნაგულისხმევი	აღწერა
api_key	string	სავალდებულო	Anthropic API გასაღები (sk-ant-...) ან OAuth ტოკენი
api_url	string	https://api.anthropic.com	მორგებული API საბაზისო URL (პროქსებისთვის)
model	string	claude-sonnet-4-20250514	ნაგულისხმევი მოდელი

ფუნქციები

მშობლიური ინსტრუმენტების გამოძახება

PRX ინსტრუმენტების განსაზღვრებებს Anthropic-ის მშობლიურ ფორმატში აგზავნის input_schema-ით, რაც OpenAI-დან Anthropic-ის ფორმატში კონვერტაციისას ინფორმაციის დაკარგვას თავიდან აიცილებს. ინსტრუმენტის შედეგები სათანადოდ არის შეფუთული როგორც tool_result კონტენტ ბლოკები.

ვიზუალი (სურათების ანალიზი)

შეტყობინებებში ჩაშენებული სურათები [IMAGE:data:image/png;base64,...] მარკერებით ავტომატურად გარდაიქმნება Anthropic-ის მშობლიურ image კონტენტ ბლოკებად სათანადო media_type და source_type ველებით. მხარდაჭერილია 20 MB-მდე სურათები (ამ ზომის გადამეტებისას გაფრთხილება ჩაიწერება ჟურნალში).

პრომპტ ქეშირება

PRX ავტომატურად იყენებს Anthropic-ის ეფემერულ პრომპტ ქეშირებას ხარჯებისა და დაყოვნების შესამცირებლად:

• სისტემური პრომპტები, რომლებიც ~1024 ტოკენზე (3 KB) მეტია, იღებენ cache_control ბლოკს
• საუბრები 4-ზე მეტი არა-სისტემური შეტყობინებით — ბოლო შეტყობინება ქეშირდება
• ინსტრუმენტების განსაზღვრებები — ბოლო ინსტრუმენტი მოინიშნება cache_control: ephemeral-ით

კონფიგურაცია არ არის საჭირო; ქეშირება გამჭვირვალედ გამოიყენება.

OAuth ტოკენის ავტომატური განახლება

Claude Code-ის ავტორიზაციის მონაცემების გამოყენებისას, PRX ავტომატურად:

1. ამოიცნობს ქეშირებულ OAuth ტოკენებს ~/.claude/.credentials.json-დან
2. პროაქტიულად ანახლებს ტოკენებს ვადის ამოწურვამდე 90 წამით ადრე
3. 401 პასუხების შემთხვევაში ცდას იმეორებს ახალი ტოკენით
4. განახლებულ ავტორიზაციის მონაცემებს ინახავს დისკზე

ეს ნიშნავს, რომ prx-ს შეუძლია არსებული Claude Code შესვლის გამოყენება ყოველგვარი დამატებითი კონფიგურაციის გარეშე.

Claude Code ინტეგრაცია

PRX შემდეგ წყაროებს ცნობს როგორც Anthropic ავტენტიფიკაციას:

წყარო	ამოცნობა
პირდაპირი API გასაღები	sk-ant-api-... პრეფიქსი, იგზავნება x-api-key ჰედერით
OAuth დაყენების ტოკენი	sk-ant-oat01-... პრეფიქსი, იგზავნება Authorization: Bearer-ით anthropic-beta ჰედერით
Claude Code ქეშირებული ავტორიზაცია	~/.claude/.credentials.json access_token + refresh_token-ით
გარემოს ცვლადი	ANTHROPIC_API_KEY

მორგებული საბაზისო URL

პროქსის ან ალტერნატიული ენდფოინთის გავლით მარშრუტიზაციისთვის:

[providers.anthropic]
api_key = "${ANTHROPIC_API_KEY}"
api_url = "https://my-proxy.example.com"

პროვაიდერის მეტსახელები

შემდეგი სახელები ყველა Anthropic პროვაიდერზე მიუთითებს:

• anthropic
• claude-code
• claude-cli

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

"Anthropic credentials not set"

PRX ვერ იპოვა ავტენტიფიკაცია. დარწმუნდით, რომ ერთ-ერთი კონფიგურირებულია:

1. ANTHROPIC_API_KEY გარემოს ცვლადი
2. api_key config.toml-ში [providers.anthropic] სექციაში
3. ვალიდური ~/.claude/.credentials.json Claude Code-დან

401 Unauthorized

• API გასაღები: დარწმუნდით, რომ იწყება sk-ant-api--ით და ვადა არ ამოწურულა
• OAuth ტოკენი: გაუშვით prx auth login --provider anthropic ხელახალი ავტენტიფიკაციისთვის, ან გადატვირთეთ Claude Code ტოკენის განახლებისთვის
• პროქსის პრობლემა: თუ მორგებულ api_url-ს იყენებთ, დარწმუნდით, რომ პროქსი x-api-key ან Authorization ჰედერს სწორად გადამისამართებს

სურათის payload ზედმეტად დიდია

Anthropic რეკომენდაციას უწევს 20 MB-ზე ნაკლებ სურათებს base64 კოდირებულ ფორმატში. დიდი სურათების გაგზავნამდე შეამცირეთ ზომა ან შეკუმშეთ ისინი.

პრომპტ ქეშირება არ მუშაობს

ქეშირება ავტომატურია, მაგრამ მოითხოვს:

• სისტემური პრომპტი > 3 KB სისტემის დონეზე ქეშირების გასააქტიურებლად
• 4-ზე მეტი არა-სისტემური შეტყობინება საუბრის ქეშირების გასააქტიურებლად
• API ვერსია 2023-06-01 (ავტომატურად დაყენებულია PRX-ის მიერ)