入门
配置
所有配置都通过环境变量完成。密钥只放在 .env 文件或系统钥匙串里，绝不写进对话或源码。
配置从哪里读取
Vibe-Trading 按下面的顺序找第一个存在的文件，并且只读这一个：
~/.vibe-trading/.env——由vibe-trading init生成- 源码目录里的
agent/.env - 当前目录下的
.env
在 shell 里 export 的变量永远优先于文件。Web 界面的设置页可以直接修改模型和数据源配置。
模型服务商
| 变量 | 含义 |
|---|---|
LANGCHAIN_PROVIDER | 服务商名称：openrouter、deepseek、openai、anthropic、gemini、ollama……（内置 25 个） |
LANGCHAIN_MODEL_NAME | 模型 id，例如 deepseek-v4-pro |
<PROVIDER>_API_KEY | API key，例如 DEEPSEEK_API_KEY |
<PROVIDER>_BASE_URL | API 地址 |
LANGCHAIN_REASONING_EFFORT | 可选：none、low、medium、high 或 max |
LANGCHAIN_PROVIDER=deepseek
LANGCHAIN_MODEL_NAME=deepseek-v4-pro
DEEPSEEK_API_KEY=sk-xxx
DEEPSEEK_BASE_URL=https://api.deepseek.com/v1- ChatGPT 账号登录（Codex）：设
LANGCHAIN_PROVIDER=openai-codex，再执行vibe-trading provider login openai-codex。不使用OPENAI_API_KEY；默认模型是gpt-6-sol。 - GitHub Copilot：
pip install "vibe-trading-ai[copilot]"，再设LANGCHAIN_PROVIDER=copilot；它使用你的gh或 Copilot CLI 登录凭据。 - Ollama：不需要 key。
怎么选模型
智能体做的每件事都通过工具调用完成，所以模型决定了它是真去用工具，还是凭记忆作答。长时间研究、多智能体团队和多步回测，请用工具调用能力强的模型。避开 *-nano、*-flash-lite 和小型蒸馏模型：它们的工具调用不可靠，答案读起来很流畅，实际上一条数据都没取。
行情数据 key（可选）
A 股、港股、美股、加拿大、英国、印度、韩国、加密货币和外汇都能免 key 使用。key 用来增加数据源或数据深度：
TUSHARE_TOKEN——更丰富的 A 股、基金和宏观数据。GILDATA_TOKEN——恒生聚源商业 A 股数据。- Finnhub、Alpha Vantage、Tiingo、FMP 的 key——额外的美股数据源。
- 数据合作方：聚源。每项聚源功能均需 Token，并在设置中单独开启，默认全关。
哪个数据源服务哪个市场，见 数据源。
长任务与超时
| 变量 | 默认值 | 含义 |
|---|---|---|
VIBE_TRADING_CONTEXT_WINDOW | 见右 | 你所用模型的上下文窗口（token 数）。不设时，依次取：本次运行中服务商报错给出的上限、内置模型目录、128K。 |
VIBE_TRADING_CONTEXT_MAX_TOKENS | 200000 | 单次请求最多发送多少 token，与窗口大小无关，用来控制花费。 |
TIMEOUT_SECONDS | 120 | 单次模型请求的超时。 |
VIBE_TRADING_TOOL_TIMEOUT_SECONDS | 1800 | 只读工具或回测的硬超时；设为 0 表示不限。 |
TOKEN_THRESHOLD 已在 0.1.16 移除。设置了也会被忽略并提示警告，请从 .env 里删掉。
在本机以外访问
没有设置 API_AUTH_KEY 时，敏感接口只响应来自本机的请求。要从其他设备使用 Web 界面，请设置一个足够强的 API_AUTH_KEY，客户端请求带上 Authorization: Bearer <key>，并在 Web 界面的设置页填入同一个 key。VIBE_TRADING_EXTRA_CORS_ORIGINS 用于追加允许的浏览器来源。
Shell 类工具只在本机交互终端里开启。API 和 MCP 服务默认关闭它们，除非设置 VIBE_TRADING_ENABLE_SHELL_TOOLS=1。
文件与目录
VIBE_TRADING_HOME——运行记录、会话、记忆、连接器和审计账本的存放位置，默认~/.vibe-trading。VIBE_TRADING_ALLOWED_FILE_ROOTS——额外允许导入文档和交割单的目录，用逗号分隔。VIBE_TRADING_ALLOWED_RUN_ROOTS——额外允许运行生成的策略代码的目录。