文档 - Gwarden AI

# macOS
brew install node
# Linux (Debian / Ubuntu)
sudo apt install -y nodejs npm
# Windows (PowerShell, admin)
winget install OpenJS.NodeJS.LTS

# all OS: Claude Code + Codex + opencode
npm install -g @anthropic-ai/claude-code @openai/codex opencode-ai

# aider (Python)
python -m pip install aider-install && aider-install

把 GWAR-XXXX 换成你的密钥，把 MODEL 换成任意模型。完整列表见 /v1/models 和主页的表格。示例：claude-fable-5-1、gpt-5.6-sol、grok-4.6、kimi-k3、glm-5.3。完整支持 tools / 智能体循环。

cli

Claude Code

一条命令 - 开箱即用

# macOS / Linux
export ANTHROPIC_BASE_URL="https://gwarden.su"
export ANTHROPIC_AUTH_TOKEN="GWAR-XXXX"
export ANTHROPIC_MODEL="MODEL"
claude

# Windows PowerShell
$env:ANTHROPIC_BASE_URL = "https://gwarden.su"
$env:ANTHROPIC_AUTH_TOKEN = "GWAR-XXXX"
$env:ANTHROPIC_MODEL = "MODEL"
claude

cli

Codex CLI (OpenAI)

~/.codex/config.toml
(Windows: C:/Users/you/.codex/config.toml)

model = "MODEL"
model_provider = "gwarden"

[model_providers.gwarden]
name = "Gwarden AI"
base_url = "https://gwarden.su/v1"
env_key = "GWARDEN_API_KEY"
wire_api = "responses"

export GWARDEN_API_KEY="GWAR-XXXX"   # Windows: setx GWARDEN_API_KEY "GWAR-XXXX"
codex

cli

opencode

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "gwarden": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Gwarden AI",
      "options": { "baseURL": "https://gwarden.su/v1", "apiKey": "GWAR-XXXX" },
      "models": { "MODEL": { "name": "Gwarden AI" } }
    }
  }
}

opencode --model gwarden/MODEL

cli

aider

# macOS / Linux
export OPENAI_API_BASE="https://gwarden.su/v1"
export OPENAI_API_KEY="GWAR-XXXX"
aider --model openai/MODEL

# Windows PowerShell
$env:OPENAI_API_BASE = "https://gwarden.su/v1"
$env:OPENAI_API_KEY = "GWAR-XXXX"
aider --model openai/MODEL

3

Chat Completions

curl https://gwarden.su/v1/chat/completions \
  -H "Authorization: Bearer KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "MODEL",
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": false}'

模型列表

curl https://gwarden.su/v1/models -H "Authorization: Bearer KEY"

流式

设置 stream: true。块中分别携带 reasoning_content（思考）和 content（回答）。

旧请求的 thinking: {{"type": "disabled"}} 会被改写为 {{"type": "enabled"}} + reasoning_effort: "low"。

4

Claude Code / Anthropic 兼容

同一 API 也以 Anthropic Messages 格式提供，Claude Code、Cursor 和 Cline 开箱即用。把地址指向这里并用你的密钥。

curl https://gwarden.su/v1/messages \
  -H "x-api-key: GWAR-XXXX" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL",
    "max_tokens": 4096,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

5

文档 API

选择你的工具

Claude Code

Codex

opencode

aider

REST API

Anthropic

获取密钥

CLI 编程智能体

Claude Code

Codex CLI (OpenAI)

opencode

aider

Chat Completions

模型列表

流式

Claude Code / Anthropic 兼容

订阅

Chat Completions / models