Coding-klient

komplais coding-klient forbinder et kodeværktøj på din computer med Coding Beta, API'et til kodemodeller på https://api.komplai.dk/v1/coding. Klienten består af kommandoen komplai-code og et plugin til OpenCode 2.0.28. Dit kodeværktøj læser og retter filer og kører kommandoer, når du godkender det. komplai svarer med tekst, ræsonnement og funktionskald og kører aldrig selv et værktøj.

Klienten er ikke udgivet offentligt på npm. Den ansvarlige for jeres organisations opsætning leverer den godkendte version og installationen. Har ingen gjort det, så kontakt os.

Før du går i gang

Node.js 22.14 eller nyere og en browser på samme computer.
Coding er slået til for jeres organisation. Coding følger Chat: organisationens Chat kører i komplais EU-cloud med godkendt behandling og et loft for AI-forbrug, og en administrator har givet dig adgang til Chat under Adgang til værktøjer (/settings/apps).

Log ind

Shell

komplai-code login

Kommandoen skriver en adresse til login og åbner den i din browser.
Log ind med din komplai-konto, som du gør i hubben.
Connect your coding tool viser hver organisation, hvor du kan bruge Coding, med dens vilkår for behandling: hvor data behandles, udbyderens vilkår for træning og opbevaring, hvad komplai gemmer, datatilstanden, de godkendte modeller med udbyderens priser i DKK, og hvor meget der er tilbage under organisationens loft for AI-forbrug.
Under den organisation, du vælger, sætter du flueben ved, at du har gennemgået vilkårene, og at dine kodeforespørgsler tæller med i organisationens loft for AI-forbrug. Sæt flueben ved, at nøglen må gemmes på denne computer.
Vælg Connect to efterfulgt af organisationens navn. Terminalen skriver organisationen, og hvornår adgangen udløber.

Der sendes ingen kodeforespørgsel, mens du logger ind, og der oprettes ingen konto. Har ingen organisation slået Coding til for dig, står det på siden. Siden og klientens beskeder er på engelsk.

Forbindelsen er en personlig API-nøgle (kp_live_...) med coding:read og coding:complete, der udløber efter 30 dage. Den står under API-nøgler (/api-access) i hubben, hvor du kan tilbagekalde den. Dit login-token bruges kun, mens du forbinder, og gemmes aldrig.

Nøglen gemmes uden for dit projekt, i denne mappe:

Text

macOS    ~/Library/Application Support/Komplai/coding/
Linux    ~/.local/share/komplai/coding/
Windows  %USERPROFILE%\AppData\Local\Komplai\coding\

På macOS og Linux kan kun du læse mappen og filen; det er en privat fil, ikke en krypteret nøglering. På Windows kan kun din Windows-konto åbne filen, og den er krypteret med Windows DPAPI. Klienten nægter at gemme nøglen i et repository eller i en mappe, som andre kan læse.

Kommandoer

Kommando	Det gør den
`komplai-code status`	Viser organisationen, hvornår adgangen udløber, de aktuelle vilkår (`contract`), loftet for AI-forbrug og månedens forbrug (`balance`) og vilkårene for data som JSON
`komplai-code models`	Viser de godkendte kodemodeller med deres grænser og udbyderens priser i DKK som JSON
`komplai-code logout`	Tilbagekalder nøglen i komplai og fjerner den derefter fra computeren

logout tilbagekalder også en udløbet nøgle. Fejler netværket, bliver nøglen på computeren, så du kan køre logout igen. Vil du forbinde en computer, der allerede er forbundet, skal du køre logout først.

Brug klienten i OpenCode

Pluginnet virker med OpenCode 2.0.28 og afviser andre versioner.

Føj pluginfilen opencode.js fra klienten til plugins i din egen OpenCode-konfiguration med dens absolutte sti.
Vælg komplais coding-integration og dens login under integrationer i OpenCode. Browseren åbner samme login og vilkår som komplai-code login, på samme computer som OpenCode.
Vælg en af de godkendte modeller.

OpenCode-konfiguration

{
  "plugins": ["/sti/til/komplai-coding-client/dist/opencode.js"]
}

Nøglen bliver i klientens private fil. OpenCode gemmer kun en markering uden nøglen, og en forbindelse, du har lavet med komplai-code login, virker også i OpenCode. Pluginnet tilføjer kommandoerne komplai-status, komplai-models og komplai-logout.

OpenCode tilbyder kun de godkendte modeller. Pluginnet sender de aktuelle vilkår og et nyt forespørgsels-id med hvert kald, og det slår OpenCodes automatiske genforsøg fra, fordi et genforsøg med et nyt id ville blive afregnet som et nyt kald. OpenCodes felter for omkostninger er i amerikanske dollar, så pluginnet lader dem stå tomme; priserne i DKK vises ved login og med komplai-models.

Når vilkårene ændres

Vilkårene omfatter udbyderen, dennes vilkår for data, datatilstanden, aftalen og de godkendte modeller med priser. Ændres noget af det, stopper klienten og beder dig logge ind igen og gennemgå de nye vilkår (terms_changed). Almindeligt forbrug ændrer ikke vilkårene.

Hvor din kode behandles

Prompts, kode og værktøjsresultater går gennem komplais API hos Hetzner i Tyskland til den godkendte kodemodel i komplais EU-cloud i Frankrig.
komplai gemmer ingen prompts, svar eller værktøjsresultater. Metadata om adgang og forbrug registreres og opbevares, som organisationens aftale fastsætter.
Udbyderen bruger ikke indholdet til træning og gemmer det som udgangspunkt ikke, bortset fra en midlertidig, projektisoleret cache af mellemresultater. Ved en fejlfinding eller en sikkerhedshændelse kan hele forespørgslen gemmes i op til to uger, og samlede forbrugstal, der ikke kan føres tilbage til personer, i op til seks måneder. Siden ved login viser vilkårene, og hvornår komplai sidst har kontrolleret dem.
Forbruget måles til udbyderens pris og tæller med i organisationens loft for AI-forbrug. Før hvert kald reserveres det mest, kaldet kan koste, under loftet. Kaldene stopper, når loftet, organisationens egen grænse eller din personlige grænse er nået, og klienten skifter aldrig til en anden model.
Når datatilstanden er testdata, må du kun bruge testdata.

Fejl

Klienten viser en kort besked for hver fejl. Dem, du oftest møder:

Kode	Det gør du
coding_not_enabled	Bed jeres administrator om adgang til Chat. komplai slår Coding til for organisationen; jeres administrator kan kontakte os.
terms_changed	Kør `komplai-code logout`, log ind igen, og gennemgå de nye vilkår.
ai_credit_exhausted	Organisationens loft for AI-forbrug er nået. Spørg administratoren.
person_ai_credit_exhausted	Din personlige grænse er nået. Spørg administratoren.
invalid_api_key	Adgangen er udløbet eller tilbagekaldt. Kør `komplai-code logout`, og log ind igen.

Byg din egen klient

Vil du forbinde et andet kodeværktøj, opretter du en personlig API-nøgle med coding:read og coding:complete under API-nøgler i hubben. Læs GET /v1/coding/account, og vis personen vilkårene før det første kald. Send derefter hvert kald til POST /v1/coding/chat/completions med de aktuelle vilkår i X-Komplai-Contract og et nyt UUID i X-Request-Id for hver handling. Coding forklarer API'et, og Coding-referencen har alle felter.