Files
Hermit/docs/env_openai.md
T
WHCandCursor 1f1fcba7ad Initial CST-Agent: portable Linux/Termux/Windows coding agent.
Vendored sashidown, OpenAI-compatible env (OPENAI_*), and bootstrap scripts.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-07 22:42:32 +08:00

2.0 KiB
Raw Blame History

OpenAI 兼容 API 环境变量

CST-Agent 使用 OpenAI Chat Completions 协议(POST {base}/chat/completions), 可对接官方 OpenAI、MiniMax、以及其它兼容网关。

必填 / 常用

变量 别名 说明 示例
CST_API_KEY OPENAI_API_KEY、MINIMAX_API_KEY API Key(按此优先级读取) sk-...
CST_API_BASE OPENAI_BASE_URL、OPENAI_API_BASE API 根路径,须含 /v1(不要带 /chat/completions) https://api.openai.com/v1
CST_MODEL OPENAI_MODEL 模型名 gpt-4.1-mini / MiniMax-M2.7

未设置 key 时:读配置文件 →(Linux)zenity / 控制台输入。

配置文件:

  • Linux/Termux:~/.config/cst-agent/credentials
  • Windows:%APPDATA%\cst-agent\credentials

示例

OpenAI 官方

export OPENAI_API_KEY='sk-...'
export OPENAI_BASE_URL='https://api.openai.com/v1'
export OPENAI_MODEL='gpt-4.1-mini'
./cst-agent --workspace .

等价 CST 前缀:

export CST_API_KEY='sk-...'
export CST_API_BASE='https://api.openai.com/v1'
export CST_MODEL='gpt-4.1-mini'

MiniMax(默认)

export CST_API_KEY='...'          # 或 MINIMAX_API_KEY
# 默认 base=https://api.minimax.cn/v1  model=MiniMax-M2.7
./cst-agent --workspace .

任意兼容网关

export OPENAI_API_KEY='...'
export OPENAI_BASE_URL='https://your-gateway.example/v1'
export OPENAI_MODEL='your-model'
./cst-agent --headless --prompt 'ping' --workspace .

命令行也可覆盖:--api-base / --api-key / --model。

其它环境变量

变量 说明
CST_MODELS /model 可选列表,: 或 , 分隔
CST_AUTO_APPROVE=1 自动允许 shell/写文件(headless 常用)
CST_SHELL shell 解释器路径(覆盖 busybox/sh)
CST_EXE_DIR 可执行文件目录(Termux 旁路 busybox 时有用)

CLI 对照

--api-base URL   ← CST_API_BASE / OPENAI_BASE_URL
--api-key KEY    ← CST_API_KEY / OPENAI_API_KEY
--model NAME     ← CST_MODEL / OPENAI_MODEL