# Set up with an AI agent

> Ready-to-paste prompts so your coding agent reads the Vikey docs and configures its own connection.

Coding agents can read these docs themselves. Paste one of the prompts below into your agent (Claude Code, Codex, opencode or another), and it will write the config and tell you what is left for you to do.

**You still provide the API key**

The prompts ask the agent to use the `VIKEY_API_KEY` environment variable instead of writing the key into a file that could be committed. Set the variable yourself in the terminal: `export VIKEY_API_KEY=YOUR_API_KEY`.

## General prompt

```text
Read https://docs.vikey.ai/llms.txt and the docs page for the tool you are running
(add ".md" to a page URL for its Markdown version, English pages are under /en/).
Then configure this tool to use Vikey:
- The API key is in the VIKEY_API_KEY environment variable. Do not write the key
  into any file inside the repository.
- Main model: vikey/agent-coding.
- Follow the config in the docs exactly, including the model for background tasks.
When you are done, show me the files you changed and a command to test the connection.
```

## Prompt per tool

If you already know the tool, point the agent straight at its page. It is faster and uses fewer tokens.

| Tool | Page for the agent |
| --- | --- |
| Claude Code | `https://docs.vikey.ai/en/agents/claude-code.md` |
| Codex CLI and Codex Desktop | `https://docs.vikey.ai/en/agents/codex.md` |
| opencode | `https://docs.vikey.ai/en/agents/opencode.md` |
| Cline, Roo Code, Kilo Code | `https://docs.vikey.ai/en/agents/cline.md` |
| OpenClaw | `https://docs.vikey.ai/en/agents/openclaw.md` |
| Hermes | `https://docs.vikey.ai/en/agents/hermes.md` |

Example:

```text
Read https://docs.vikey.ai/en/agents/codex.md and set up Codex on this machine to
use Vikey with the model vikey/agent-gpt. The API key is in VIKEY_API_KEY.
```

## Files for AI

| URL | Contents |
| --- | --- |
| [`/llms.txt`](/llms.txt) | Every page with its summary (Indonesian edition) |
| [`/llms-full.txt`](/llms-full.txt) | All docs in one Markdown file (Indonesian edition) |
| `/en/` + page + `.md` | One English page as Markdown, for example `/en/models/vikey-auto.md` |

Source: https://docs.vikey.ai/en/setup-with-ai/