# 4SToken 编辑器接入总览

4SToken 是企业级 AI 模型网关，提供 OpenAI / Anthropic 兼容 API。本文档说明如何将常见编程工具接入网关。

## 前置条件

1. 在 Portal 创建 Client Key（格式 `sk-...`）。
2. API Base URL：`https://api.4stoken.cn/api`
3. OpenAI 兼容前缀：`https://api.4stoken.cn/api/v1`
4. 验证：`curl -sS '{API_BASE}/v1/models' -H 'Authorization: Bearer sk-你的Key'`

## 核心工具

| 工具 | 脚本 | Portal 页面 |
|------|------|-------------|
| Codex CLI | codex.sh | /tools/codex |
| Claude Code | claude-code.sh | /tools/claude-code |
| Cursor | cursor.sh（半自动） | /tools/cursor |
| Claude VS Code | claude-vscode.sh | /tools/claude-vscode |

脚本目录：`/docs/scripts/`（Portal 公网根路径下）。

## 模型命名

- GPT 系列：客户端填写的 modelCode 与 Portal 一致（Cursor 中 `gpt-` 改为 `spt-`）。
- OpenRouter 免费：`openrouter-free`
- Claude Code：`sonnet` / `opus` / `haiku` 默认映射到 `claude-sonnet-4-6` / `claude-opus-4-8` / `claude-haiku-4-5-20251001`

## API 端点

| 工具类型 | Gateway 路径 |
|----------|--------------|
| OpenAI Chat | POST /v1/chat/completions |
| Codex Responses | POST /v1/responses |
| Claude Messages | POST /v1/messages |

更多工具见 Portal `/tools` 与 OpenAPI：`/openapi/gateway-v1.yaml`