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

# Guia de Configuração do Kimi Code CLI

> AceDataCloud Coding Plan API guide - Ace Data Cloud

## 1. Obter a API Key

Abra a [lista de aplicações do Ace Data Cloud](https://platform.acedata.cloud/console/applications), entre em uma aplicação disponível e copie a API Key.

![Obter a API Key do Ace Data Cloud](https://cdn.acedata.cloud/dvc3cg.jpg)

## 2. Instalar o Kimi Code

macOS / Linux:

```bash theme={null}
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
```

Windows PowerShell:

```powershell theme={null}
irm https://code.kimi.com/kimi-code/install.ps1 | iex
```

Também pode ser instalado via npm:

```bash theme={null}
npm install -g @moonshot-ai/kimi-code
```

## 3. Configurar o AceDataCloud

Edite `~/.kimi/config.toml` e adicione a seguinte configuração:

```toml theme={null}
default_model = "acedatacloud/MODEL_ID"

[providers.acedatacloud]
type = "openai"
base_url = "https://api.acedata.cloud/v1"
api_key = "sua API Key"

[models."acedatacloud/MODEL_ID"]
provider = "acedatacloud"
model = "MODEL_ID"
```

Acesse o [catálogo de modelos](https://platform.acedata.cloud/models) para verificar os nomes dos modelos (por exemplo, `claude-opus-5`, `gpt-6-sol`) e substitua todos os `MODEL_ID` pelo mesmo nome; para validação precisa, use o valor de `id` na resposta de `/v1/models`. Esse valor é o nome do modelo usado pelo parâmetro `model` da API, não o UUID do serviço ou da API. `type = "openai"` usa o protocolo OpenAI Chat Completions.

O arquivo de configuração contém a Key; no macOS / Linux, recomenda-se restringir as permissões:

```bash theme={null}
chmod 600 ~/.kimi/config.toml
```

## 4. Verificar e iniciar

```bash theme={null}
kimi doctor
kimi provider list
kimi -p "Reply only OK"
```

Após entrar no projeto, execute `kimi` para começar a usar. Se retornar 401, verifique a API Key; se for exibido model not found, confirme que `default_model`, o nome do modelo na tabela e o campo `model` usam o mesmo ID.

## Referências oficiais

* [Kimi Code](https://www.kimi.com/code)
* [Configuração de Provider](https://moonshotai.github.io/kimi-code/zh/configuration/providers)
* [Arquivo de configuração](https://moonshotai.github.io/kimi-code/zh/configuration/config-files)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.