Setup Guide

Claude Code CLI

Recommended

Official Anthropic terminal-based AI coding assistant

1

Install Claude Code

Install the CLI globally via npm:

Terminal
npm install -g @anthropic-ai/claude-code
2

Run Setup & Start Coding

Run our one-liner — it will ask for your API key, configure everything automatically, and you're ready to go:

Recommended
Terminal (All Platforms)
npx codemax-code
Alternative: PowerShell script
PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm https://api.codemax.pro/setup.ps1 | iex

After setup completes, just run claude in any project directory to start coding.

What the setup script does
Validates your API key with Codemax servers
Configures Claude Code environment variables
Sets up ~/.claude/settings.json
Installs CodeMax MCP tools (web_search, understand_image)
Configures MCP server in ~/.claude.json
Installs Claude Code CLI if missing

Automatic Setup

Recommended

One command to configure everything

Run one command and you're done. Requires Node.js.

Recommended
Terminal (All Platforms)
npx codemax-code
Alternative: PowerShell script
PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm https://api.codemax.pro/setup.ps1 | iex
Download setup-codemax.ps1
What the script does
Validates your API key
Sets Claude Code environment
Configures ~/.claude/settings.json
Installs CodeMax MCP tools
Configures MCP in ~/.claude.json
Installs Claude Code CLI
Idempotent

Re-run anytime to update your key or reconfigure. The script safely merges settings without overwriting your existing config.

Manual Configuration

Step-by-step manual setup if you prefer full control

1

Install MCP Tools

Terminal
npm install -g codemax-mcp-server
2

Configure Environment

Create or edit %USERPROFILE%\.claude\settings.json:

settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-cm-your-api-key",
    "ANTHROPIC_BASE_URL": "https://api.codemax.pro",
    "ANTHROPIC_MODEL": "claude-opus-4-6",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5-20250929",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
3

Configure MCP Server

Create or edit %USERPROFILE%\.claude.json:

.claude.json
{
  "hasCompletedOnboarding": true,
  "mcpServers": {
    "CodeMax": {
      "command": "npx",
      "args": ["-y", "codemax-mcp-server"],
      "env": {
        "CodeMax_API_KEY": "sk-cm-your-api-key",
        "CodeMax_URL": "https://api.codemax.pro"
      }
    }
  }
}
4

Restart

Restart Claude Code or your IDE to apply settings.

Included MCP Tools

Extended capabilities added to your Claude Code session

web_search

Search the web for real-time information — documentation, news, APIs, current events, pricing, and anything requiring up-to-date data.

→query: string
→num_results?: number
understand_image

Analyze images with AI vision — screenshots, diagrams, UI mockups, error messages, charts, and photos. Supports JPEG, PNG, WebP, GIF.

→image_url: string
→question?: string

Available Models

All Claude models available through the Codemax API

Opus 4.6
Default
claude-opus-4-6

Most capable model for complex tasks

Sonnet 4.6
Balanced
claude-sonnet-4-6

Best balance of speed and intelligence

Sonnet 4.5
Balanced
claude-sonnet-4-5-20250929

Previous generation balanced model

Haiku 4.5
Fast
claude-haiku-4-5-20251001

Fastest model for simple tasks

API Reference

Endpoint details for direct API integration

Base URL
https://api.codemax.pro
Endpoints
POST/v1/messages
POST/v1/chat/completions
GET/v1/models