> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cogfoundry.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure credentials

> Connect the LoomLoom CLI to the current ShengSuanYun service safely.

The current actionable LoomLoom service is provided through ShengSuanYun. Create an API key in the [ShengSuanYun Console](https://console.shengsuanyun.com/user/keys), then configure the CLI with the matching server and token.

## macOS and Linux

```bash theme={null}
export LOOMLOOM_SERVER="https://loomloom.shengsuanyun.com/loom/v1"
export LOOMLOOM_TOKEN="<your-api-key>"
```

Add the exports to your shell profile, such as `~/.zshrc` or `~/.bashrc`, only if you want them to persist across terminal sessions.

## Windows PowerShell

```powershell theme={null}
$env:LOOMLOOM_SERVER = "https://loomloom.shengsuanyun.com/loom/v1"
$env:LOOMLOOM_TOKEN  = "<your-api-key>"
```

Add the values to your PowerShell profile if you want them to persist.

## Verify the connection

```bash theme={null}
loomloom doctor
```

`doctor` checks the CLI configuration, server connectivity, token wiring, and version information. It does not create a run or generate billable model usage.

## Keep the server and token paired

An API key is issued for a particular service environment. Do not reuse it with a different host.

<Warning>
  Send `LOOMLOOM_TOKEN` only to the exact `LOOMLOOM_SERVER` you configured, and only over HTTPS. Do not place a real token in source control, documentation, screenshots, issue reports, or shared logs.
</Warning>

CogFoundry account, payment, and transaction capabilities for overseas users are not currently available. Do not substitute an unverified CogFoundry Console URL or send a ShengSuanYun token to a CogFoundry host.

If your balance is insufficient, use the [ShengSuanYun recharge page](https://console.shengsuanyun.com/user/recharge).