VS Code에서 자체 API 키를 AI 코딩 에이전트에 사용하는 방법

자체 API 키를 사용한다는 것은 세 가지 의미입니다. 모델을 직접 선택하고, 마크업 없이 제공업체의 가격으로 비용을 지불하며, 요청이 자신이 선택한 제공업체로 전송된다는 것입니다. 여기서는 Atlarix 확장을 사용하여 VS Code 또는 Cursor, Kiro, Windsurf에서 처음부터 끝까지 이를 설정하는 방법을 설명합니다.

1. 확장 프로그램 설치

에디터의 Extensions 보기에서 Atlarix를 검색하여 설치하세요. 이 확장은 VS Code에서는 Visual Studio Marketplace에서, Cursor, Kiro 및 Windsurf에서는 Open VSX에서 가져올 수 있습니다. 이 확장은 에이전트의 자체 복사본을 포함하고 있어 별도로 CLI나 런타임을 설치할 필요가 없습니다.

2. 한 번 로그인하기

Atlarix 보기(활동 표시줄의 개미 모양 아이콘, 또는 ⌘⌥A / Ctrl+Alt+A)를 열고 로그인합니다. Atlarix 계정은 무료이며, 에디터, 데스크톱 앱 및 CLI 전반에 걸쳐 채팅 기록, 설정 및 키를 동일하게 유지해 주는 역할을 합니다.

3. 제공업체 연결하기

채팅 상단의 ⋯ 메뉴를 열고 Account, usage and billing을 선택합니다. Your own keys 아래에서 **Connect a provider…**를 누르고, 원하는 제공업체(OpenAI, Anthropic, Google, DeepSeek, OpenRouter 또는 목록의 다른 제공업체)를 선택한 후 키를 붙여넣습니다. 프롬프트는 해당 제공업체가 키를 발급하는 페이지로 연결됩니다. 이 키는 Atlarix가 사용자의 컴퓨터에 저장하며, Atlarix 앱과 CLI도 같은 컴퓨터에서 이를 사용합니다.

4. 모델 선택하기

모델 선택기는 메시지 상자 바로 아래에 있습니다. 이제 사용자 키의 모델들이 Atlarix Auto 및 Atlarix Core 모델과 함께 여기에 표시됩니다. 원하는 것을 하나 선택하면 이 채팅에 적용됩니다. 다른 채팅에서는 질문을 위한 빠르고 저렴한 모델, 리팩토링을 위한 더 강력한 모델 등 서로 다른 모델을 사용할 수 있습니다.

5. 평소처럼 작업하기

Build, Explore, Plan, Debug 및 Review를 포함하여 모든 모드가 자체 키로 작동합니다. 수정 사항은 에디터의 diff에서 'Yes' 또는 'No'에 따라 열리고, 명령어는 승인을 기다리며, 계획은 구축됨에 따라 체크됩니다. 계정 패널에는 이 채팅이 사용자의 키에서 지금까지 얼마의 비용을 발생시켰는지 표시됩니다.

비용 및 요청 경로

Atlarix는 사용자의 API 키 사용량에 아무것도 추가하지 않습니다. 제공업체(provider)가 청구하는 금액을 사용자에게 정확하게 지불합니다. 사용자의 키를 이용한 요청은 Atlarix를 거치지 않고, 컴퓨터에서 제공업체로 직접 전송됩니다. 만약 제공업체가 해당 키를 거부할 경우—취소되었거나, 오타가 있거나, 크레딧이 소진된 경우—채팅창에 그 사실을 표시하여, 사용자가 재시도하기보다 키를 수정해야 한다는 것을 알 수 있습니다.

어떤 모델로 시작할까요

정답은 하나로 정해져 있지 않으며, 솔직한 조언은 두 가지를 모두 시도해보는 것입니다. OpenAI, Anthropic, Google의 최신(Frontier) 모델들은 길고 다단계적인 변경 사항 처리에서 가장 강력합니다. DeepSeek과 GLM은 토큰당 비용이 훨씬 저렴하며 대부분의 일상적인 작업에 매우 유능합니다. OpenRouter를 사용하면 여러 제공업체에 대해 하나의 키를 사용할 수 있습니다. 선택기는 채팅별로 작동하기 때문에, 사용자 자신의 코드로 비교하려면 추가적인 채팅 한 번이 필요합니다.

동일한 키는 Zed와 JetBrains IDE에서도 작동하며, 이들은 Agent Client Protocol을 통해 Atlarix를 실행합니다—에디터 가이드를 참고하세요. 만약 아예 키 관리를 하고 싶지 않다면, 같은 선택기에서 제공되는 Atlarix Auto가 각 단계별로 모델을 자동으로 선택해 줍니다.

원문은 atlarix.dev에 게시되었습니다.