Claude Code + Raims
A terminal agent for planning and reviewing your Raims API integration.
Quick start
Prepare the agent
Install Claude Code using the official quickstart for your operating system. Start a session and complete the agent's sign-in flow.
Open your project
Open a terminal at the root of the application you are connecting to Raims and run:
ShellclaudeAdd the documentation
Ask the agent to read Raims' documentation index and open the relevant guides. llms-full.txt provides the consolidated content. Start with authentication and charges.
Try a prompt
Read https://docs.raims.com/llms.txt and the authentication and charges guides. Inspect this application's backend and propose a plan to retrieve an existing Sandbox charge with GET /v1/charges/{id}. Prepare an example using protected server configuration for the key. Do not send requests or use real credentials. Show the sources and the files you would change before editing.
Project context
Add the instructions below to CLAUDE.md at your project root. Preserve any existing guidance. Claude Code loads this file as context in project sessions.
# Raims integration
- Read https://docs.raims.com/llms.txt before choosing endpoints and fields.
- Use https://docs.raims.com/llms-full.txt for the consolidated documentation.
- API base URL: https://api.raims.com.
- In Raims product installation examples, select the latest stable version
through the package manager (`latest` where supported).
- Prepare examples for Sandbox, with Bearer authentication in the backend.
- Keep the key in protected server configuration. Never put secrets in code,
prompts, logs, or browser applications.
- Explain the plan and request authorization before sending API requests.Verify the setup
Ask the agent to identify the guides it read, the API base URL, and the place in your backend where the key will be loaded. It should prepare the plan and example without asking you to paste a real credential.
Reading the documentation does not authenticate the application. Requests use a Raims API key for the intended company and environment.
Common issues
Check that the terminal is in the correct folder and that CLAUDE.md is at
that project's root. Ask Claude Code to read the file before continuing.
Open the relevant guide in your browser and provide the public excerpt as context. Ask the agent to identify any missing information before suggesting code.
Ask the agent to review the authentication guide. The backend sends the Raims key with Bearer authentication; an AI provider credential does not replace it.