快速开始
兼容 OpenAI SDK，也支持 Hermes Agent、Codex CLI、Claude Code 等 AI 编码工具（Key 由管理员审批后发放）：
# pip install openai
from openai import OpenAI
client = OpenAI(
api_key="sk-dsgw-xxx", # 管理员发放的 Key
base_url="https://llm.xiaokangai.cn/v1"
)
resp = client.chat.completions.create(
model="deepseek-flash",
messages=[{"role": "user", "content": "你好"}]
)
print(resp.choices[0].message.content)
支持流式（stream=True）、工具调用、Thinking 思考模式，用法与官方 DeepSeek API 完全一致。
📘 第一次配置？看这个图文指引：llm.xiaokangai.cn/guide —— 含一键脚本、手动改法、报错排查。
# 一键配置（推荐，不用手改文件）：复制下面命令执行，按提示粘贴 Key
curl -sO https://llm.xiaokangai.cn/configure_hermes.py && python3 configure_hermes.py
# 已有 Key 直接一条命令（把 sk-dsgw-xxx 换成你的 Key）：
curl -sO https://llm.xiaokangai.cn/configure_hermes.py && python3 configure_hermes.py sk-dsgw-xxx
# 手动配置（可选）：1) 编辑 ~/.hermes/config.yaml，加入以下配置
model:
provider: llm-gw
default: deepseek-flash
providers:
llm-gw: llm-gw
custom_providers:
- name: llm-gw
model: deepseek-flash
base_url: "https://llm.xiaokangai.cn/v1"
api_key: "sk-dsgw-xxx" # 管理员发放的 Key
# 2) 同样内容同步补到 ~/.hermes/skills/config.yaml
# 和 ~/.hermes/skills/_setup/config.yaml（否则 skills 模块会报配置不一致）
# 3) 重启 hermes 后验证（确认流量真实走网关）：
hermes -z "回复OK" -m deepseek-flash --provider llm-gw
保存后重启 hermes 即生效，AI 编码、自动化任务直接使用 llm-gw 网关（已实测可用）。
# 方式一：手动编辑 ~/.codex/config.toml
model = "deepseek-flash"
model_provider = "llm-gw"
[model_providers.llm-gw]
name = "DeepSeek via LLM Gateway"
base_url = "https://llm.xiaokangai.cn/v1"
wire_api = "chat"
env_key = "LLM_GW_API_KEY"
# 设置 Key 环境变量（写入 ~/.bashrc 持久化）
export LLM_GW_API_KEY="sk-dsgw-xxx"
# 方式二：CC Switch 图形化管理（推荐）—— 官方 / 网关一键切换
# 1) 安装：macOS brew install --cask cc-switch
# Windows 官网下载 .msi；Linux 下载 .AppImage
# 2) 打开 CC Switch → 顶部应用选 Codex → 右上角 + 添加 Provider：
名称: DeepSeek 网关（公司）
Base URL: https://llm.xiaokangai.cn/v1
API Key: sk-dsgw-xxx # 管理员发放的 Key
模型: deepseek-flash
API 格式: OpenAI（Chat Completions 兼容格式）
# 3) 保存后选中该 Provider 点「启用」，自动写入 Codex 配置
# 4) 重启终端后运行 codex 即生效（Codex 切换后需重启）
配置完成后直接运行 codex 即可使用。用 CC Switch 可同时管理官方与公司网关，一键切换。
# 方式一：环境变量（临时生效，或写入 ~/.bashrc 持久化）
export ANTHROPIC_BASE_URL="https://llm.xiaokangai.cn" # ⚠️ Anthropic 格式勿带 /v1，Claude Code 会自动拼 /v1/messages（带 /v1 会 404）
export ANTHROPIC_AUTH_TOKEN="sk-dsgw-xxx" # 管理员发放的 Key
export ANTHROPIC_MODEL="deepseek-flash"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek-flash"
# 写入 ~/.bashrc 可持久化，然后启动：
claude
# 方式二：CC Switch 图形化管理（推荐）—— 官方 / 网关一键切换，无需改配置
# 1) 安装：macOS brew install --cask cc-switch
# Windows 官网下载 .msi；Linux 下载 .AppImage
# 2) 打开 CC Switch → 顶部应用选 Claude Code → 右上角 + 添加 Provider：
名称: DeepSeek 网关（公司）
Base URL: https://llm.xiaokangai.cn # ⚠️ Anthropic 格式勿带 /v1（Claude Code 自动拼 /v1/messages，带 /v1 报 404）；用 IP 则填 http://123.57.173.219/llm-gw 同样不带 /v1
API Key: sk-dsgw-xxx # 管理员发放的 Key
模型: deepseek-flash
API 格式: Anthropic（Messages 原生格式）
# 3) 保存后选中该 Provider 点「启用」，自动写入 ~/.claude/settings.json
# 4) 直接运行 claude 即生效；想切回官方 Claude 时再点一下切换，无需重启终端
网关自动将 Anthropic 请求转为 OpenAI 格式转发，流式 / 工具调用 / Thinking 全部支持。用 CC Switch 可同时管理官方与公司网关，随时一键切换。
# Cursor（AI 代码编辑器）接入
# 1) Cursor → Settings（Cmd/Ctrl+,）→ 左侧 Models
# 2) 开启「OpenAI API Key」开关（自定义 API），填写：
API Key: sk-dsgw-xxx # 管理员发放的 Key
Base URL: https://llm.xiaokangai.cn/v1
# 3) 点 Add model，添加：deepseek-flash
# 4) 回到对话窗口，模型选择器选中 deepseek-flash 即可使用
# （对话、Agent、Tab 补全均可走网关）
Cursor 支持自定义 OpenAI 兼容 API，填 Key 和 Base URL 即可，无需改任何文件。