claude-smart 环境变量调优指南:20+ 配置项全解,精准控制 AI 学习行为

发布时间:2026/10/27 9:40:03

claude-smart 环境变量调优指南:20+ 配置项全解,精准控制 AI 学习行为 【免费下载链接】claude-smartTurns corrections into Preferences, Project-specific skills, and Shared skills for Claude Code, Codex, and OpenCode.项目地址https://gitcode.com/gh_mirrors/cl/claude-smart点击查看免费下载claude-smart是一款面向 Claude Code、Codex 和 OpenCode 的学习型插件它会把你的纠正和反馈自动沉淀为 Preferences、项目技能和共享技能。本文带你全解 20 个claude-smart 环境变量通过编辑~/.claude-smart/.env一个文件即可精准控制它的学习行为、服务启动、引用展示与数据存储方式。环境变量都写在哪个文件claude-smart 的所有运行配置集中在~/.claude-smart/.env中由安装器自动初始化文件权限为 0600仅本人可读因为可能存放 API Key。解析逻辑见 env_config.pyshell 侧的加载规则见 _lib.sh。两类变量要区分清楚持久型写进.env如CLAUDE_SMART_USE_LOCAL_CLI、CLAUDE_SMART_READ_ONLY安装器和 Dashboard 的 Configure 页面会直接写入会话型hook 进程环境如CLAUDE_SMART_CITATIONS、CLAUDE_SMART_ENABLE_OPTIMIZER需要设置在 Claude Code 的settings.local.json的env块中因为 hook 进程不读取 Reflexio 后端的环境文件。 完整的官方变量表可查阅 DEVELOPER.md 的 Environment variables 一节。学习行为调优决定谁来学、用什么模型学这一组变量控制学习循环的核心——谁负责把交互提炼成规则、用哪个模型。变量默认值作用CLAUDE_SMART_USE_LOCAL_CLI安装后为1通过当前宿主 CLIclaude/codex执行生成无需任何云端 API KeyCLAUDE_SMART_USE_LOCAL_EMBEDDING安装后为1使用本地 ONNX 向量模型做语义检索免 API KeyCLAUDE_SMART_LEARNING_PROVIDER未设置回退宿主指定后台学习提供方claude-code、codex或opencodeCLAUDE_SMART_LEARNING_MODEL未设置提供方默认指定学习用的模型 ID会透传给提取、优化器等调用CLAUDE_SMART_CLI_PATH按宿主自动解析覆盖 Reflexio 实际调用的可执行文件CLAUDE_SMART_OPENCODE_PATH自动探测OpenCode 可执行文件不在 PATH 中时手动指定CLAUDE_SMART_CLI_TIMEOUT120本地 CLI 调用超时秒数长思考模型可调大关键源码逻辑在 optimizer_assistant.py当CLAUDE_SMART_LEARNING_MODEL有值时会作为--model参数追加到 CLI 调用中。常见调优场景想让学习完全离线、零额外成本 → 保持两个USE_LOCAL_*为1默认即如此想换更便宜的模型做提取 → 设置CLAUDE_SMART_LEARNING_MODEL公司网络下 CLI 响应慢 → 调大CLAUDE_SMART_CLI_TIMEOUT。下面是插件学习成果在 Dashboard 中的呈现——Profiles 页面展示的正是从你的交互中提取出的项目级偏好服务与端口控制后端怎么起、什么时候停claude-smart 会在本地启动 Reflexio 后端默认localhost:8071和共享向量服务localhost:8072全部可通过变量控制变量默认值作用BACKEND_PORT8071Reflexio 后端端口REFLEXIO_URL会随之推导EMBEDDING_PORT8072本地向量守护进程端口CLAUDE_SMART_BACKEND_AUTOSTART1设为0可禁止 SessionStart hook 拉起后端CLAUDE_SMART_DASHBOARD_AUTOSTART1设为0可禁止自动拉起 DashboardCLAUDE_SMART_BACKEND_STOP_ON_END0设为1让后端在 SessionEnd 时自动退出不再长驻CLAUDE_SMART_BACKEND_WORKERS1后端工作进程数并发场景可加大CLAUDE_SMART_BACKEND_HOST127.0.0.1后端绑定地址REFLEXIO_URLhttp://localhost:8071/指向远程或自定义 Reflexio 后端REFLEXIO_API_KEY空远程后端的鉴权密钥托管模式使用端口和 worker 的读取逻辑见 backend-service.sh。常见调优场景后端端口冲突 → 改BACKEND_PORT不想让 AI 助手顺手拉起服务如 CI 环境→ 两个AUTOSTART置0团队共享一套后端 → 设置REFLEXIO_URLREFLEXIO_API_KEY指向远程地址。注入与展示调优引用、链接与优化器学习到的规则会在会话中被自动注入。以下变量控制注入什么、怎么显示变量默认值作用CLAUDE_SMART_CITATIONSon开启后注入引用规则提示让模型标注哪些规则影响了回答off关闭并清理标记行CLAUDE_SMART_CITATION_LINK_STYLEmarkdown引用链接样式markdown或终端原生osc8超链接CLAUDE_SMART_DASHBOARD_URLhttp://localhost:3001引用链接指向的 Dashboard 地址CLAUDE_SMART_ENABLE_OPTIMIZER自动仅本地模式1强制开启共享技能优化器0全局关闭实现位于 context_format.py 与 events/session_start.py。常见调优场景觉得每次回答末尾的✨ claude-smart rule applied标记干扰阅读 →CLAUDE_SMART_CITATIONSoff终端支持 OSC 8 → 设CLAUDE_SMART_CITATION_LINK_STYLEosc8点击标题即可直达规则详情页无需显示冗长 URL。技能的沉淀结果Playbooks即跨会话学习规则在 Dashboard 中的样子如下每条规则都标注了CURRENT状态与来源项目数据与状态管理存在哪、谁能写变量默认值作用CLAUDE_SMART_READ_ONLY0设为1后完全跳过发布publish只读注入不学习CLAUDE_SMART_STATE_DIR~/.claude-smart/sessions/会话 JSONL 缓冲区目录LOCAL_STORAGE_PATH~/.reflexio/dataReflexio 本地 SQLite 存储位置REFLEXIO_USER_ID自动项目 ID覆盖学习归属的用户 IDCLAUDE_SMART_HOSTclaude-code当前安装的宿主标识安装时自动写入其中CLAUDE_SMART_READ_ONLY是先看看效果模式的关键开关只想体验规则注入、暂时不想产生新学习数据时把它设为1即可。相关逻辑见 state.py 和 env_config.py。调试与运维进阶变量变量默认值作用CLAUDE_SMART_HOOK_LOG默认写~/.claude-smart/hook.log布尔值开启日志或设为路径重定向日志文件CLAUDE_SMART_REFLEXIO_DIR仓库内 vendor 目录指定 Reflexio 运行时位置CLAUDE_SMART_NODE_LTS_MAJOR22私有 Node.js 运行时的大版本号CLAUDE_SMART_NODE_BASE_URL官方源覆盖 Node 下载地址适合离线/镜像环境CLAUDE_SMART_SERVICE_LOCK_STALE_SECONDS60服务锁判死的超时秒数REFLEXIO_EMBEDDING_PROVIDERlocal_service向量模式cloud/local_service/inprocess等CLAUDE_SMART_INTERNAL未设置内部调用标记1一般无需手动设置排查问题时最值得开的是CLAUDE_SMART_HOOK_LOG——它的解析规则在 hook_log.py 中日志里包含每次发布publish的目标地址与状态对照.env中的REFLEXIO_URL即可快速定位手动命令正常但自动发布失败这类问题详见 TROUBLESHOOTING.md。怎么改这些变量三种方式按推荐程度排序Dashboard Configure 页面运行/claude-smart:dashboard打开面板后进入 Configure图形化编辑REFLEXIO_URL、CLAUDE_SMART_CLI_TIMEOUT等常用项保存时直接写回.env读写逻辑见 config-file.ts直接编辑~/.claude-smart/.env适合一次改多个变量改完执行/claude-smart:restart让服务重新加载会话级覆盖在项目的.claude/settings.local.json的env块中设置 hook 侧变量只对当前项目生效适合临时实验。总结一张表快速上手需求改什么完全离线、零 API Key 学习默认即可USE_LOCAL_CLI1USE_LOCAL_EMBEDDING1换学习模型CLAUDE_SMART_LEARNING_MODEL只注入不学习CLAUDE_SMART_READ_ONLY1隐藏规则引用标记CLAUDE_SMART_CITATIONSoff端口冲突BACKEND_PORT/EMBEDDING_PORTCI 中禁止自动起服务CLAUDE_SMART_BACKEND_AUTOSTART0CLAUDE_SMART_DASHBOARD_AUTOSTART0排查问题CLAUDE_SMART_HOOK_LOG1claude-smart 的设计原则是默认全本地、零配置可用上述 20 变量更像是给进阶用户的精调旋钮。日常使用只需理解READ_ONLY、CITATIONS和端口三组其余变量在需要时查阅 DEVELOPER.md 的完整表格即可。赞分享【免费下载链接】claude-smartTurns corrections into Preferences, Project-specific skills, and Shared skills for Claude Code, Codex, and OpenCode.项目地址https://gitcode.com/gh_mirrors/cl/claude-smart点击查看免费下载相关推荐3 步搞定把 QQ 空间说说历史全部存进 Excel 的 GetQzonehistory 教程3 步搞定把 QQ 空间说说历史全部存进 Excel 的 GetQzonehistory 教程 QQ 空间里的说说翻手机才能看到想备份到电脑上却懒得一条条网页爬虫数据分析终极指南BuildKit环境变量配置与运行时行为控制终极指南BuildKit环境变量配置与运行时行为控制 你是否曾因BuildKit构建速度慢、缓存策略混乱而头疼本文将系统梳理BuildKit环境变量体系通云原生后端构建工具容器运行时wechat-go源码解析从登录流程到消息分发的完整实现wechat go源码解析从登录流程到消息分发的完整实现 wechat go是一个基于Go语言的微信网页版API和消息框架专为构建微信机器人设计。本文将深入上一篇Tsuru容器网络策略审计10个关键安全检查点确保合规性下一篇深度学习新范式awesome-tensorflow最完整的TensorFlow生态指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/10/27 9:29:24

context-mode深度解析:多轮对话上下文管理的策略与工程实践

1. 为什么我会盯上 context-mode 这个功能事情得从一次让我印象深刻的线上故障说起。那天我正在排查一个奇怪的问题——同一个 Prompt,在本地测试环境跑得好好的,结果一上生产,经常性的出现指标陡降。翻了一下午日志,最后发现原因…

2026/10/27 9:29:24

营销技能的底层逻辑:从因果链拆解到数据驱动增长

做营销这些年,我最大的体会是:营销技能这词儿,被很多人误解了。市面上有大量课程在教"怎么写爆款标题""怎么剪出高完播视频""怎么搭建私域SOP",这些当然有用,但它们只是营销技能的边角料…

2026/10/27 9:29:24

AI智能体Office套件:让Word/Excel/PPT具备自主推理与业务执行能力

1. 这不是又一个“AIOffice”概念包装,而是把Word、Excel、PPT真正变成会思考的协作者我去年在给一家中型制造企业做数字化办公升级时,被客户一句问话卡住了:“你们说的AI Office,能不能在我写完技术方案初稿后,自动检…

2026/10/27 10:20:14

旧改换窗服务一般包含哪些,先把这些弄清楚

准备做旧窗改造,最先要搞清楚的就是:这项服务到底包含什么,钱花在哪些环节。一套完整的旧改换窗服务,通常含上门测量、方案设计、拆旧、安装、收口、验收几个阶段,环环相扣,缺一段都可能留下隐患。上门测量…

2026/10/27 10:20:14

MAP值的介绍

这张图非常直观地展示了目标检测中AP(Average Precision,平均精度)和mAP(mean Average Precision,平均精度均值)的计算原理,以及不同IoU阈值下的评估标准。第一句话解释:这里的“阈值…

2026/10/27 10:20:14

论文总结:Doesn‘t Stop Reasoning: Analysis of Spurious CoT Termination

# 论文总结:Doesnt Stop Reasoning: Analysis of Spurious CoT Termination> 论文arXiv:https://arxiv.org/abs/2609.03633> 会议:EMNLP 2026 Main Conference> 领域:大推理模型、思维链CoT、提前退出(Early‑Exit)推理终止 ## 一、文章主要内容思维链(CoT)可…

2026/10/27 10:20:14

Representational alignment yields generalizable safety in language models

> 说明:arXiv网页摘要接口仅公开**Abstract**,**Introduction、Conclusion**正文内容不在返回的元数据中,无法直接获取原文,因此仅完成摘要原文+翻译;文章主要内容、创新点基于摘要信息整理。 # Representational alignment yields generalizable safety in language …

2026/10/27 10:20:14

django大学生就业创业信息管理系统12636-计算机课程设计、毕业设计

前言 ✨ 博主介绍:一线全栈工程师,毕设实战引路人。技术栈覆盖Java、Python、C#、PHP、Node.js及UniApp跨端开发,擅长多语言项目落地与架构设计。持续分享毕设源码、开题报告、技术选型心得与职场踩坑经验。用工程化思维写代码,帮…

2026/10/26 0:20:20

全国计算机二级C语言真题PDF高效刷题指南

简介:这份PDF是全国计算机二级C语言考试的试题与答案解析,专为备考二级C语言的考生准备。内容涵盖C语言特点与设计理念、程序基本组成单位、main函数执行流程、函数嵌套调用规则、标识符命名规范、整型实型字符型数据类型、八进制十六进制数合法形式、运…

2026/10/27 9:34:54

requests+BeautifulSoup:爬虫抓取h1标题的入门实战指南

简介:一份以实战为导向的Python爬虫入门资源,面向具备基本编程基础、希望快速掌握网络数据抓取的初学者,可解决从零编写简单爬虫的常见困惑。实例以requests库发送HTTP请求、BeautifulSoup解析HTML文档,完整演示从网页中提取 标题…

2026/10/27 0:59:21

递推最小二乘参数辨识MATLAB编程:二阶系统与渐消记忆实现

简介:这是一篇面向控制系统、信号处理与机器学习等领域学习者的最小二乘参数辨识程序说明文档。资源共包含一个docx格式文档,压缩包大小七十八KB,内容围绕递推最小二乘算法和渐消记忆最小二乘算法展开:先构造一个极点位于单位圆内…

2026/10/27 0:02:28

WorkBuddy_新建任务与工作模式19_“模式选错”的典型代价

“模式选错”的典型代价 摘要 在软件工程中,设计模式、架构模式、并发模式乃至团队协作模式的选择,往往在项目早期就决定了后续的开发效率和维护成本。本文通过多个真实场景,剖析“模式选错”带来的典型代价——包括返工成本、技术债务累积、…

2026/10/27 0:02:28

WorkBuddy_新建任务与工作模式20_新手推荐路径

新手推荐路径 摘要 在 AI 辅助开发工具快速普及的今天,新手面对最多的困惑往往不是"工具够不够强",而是"我该从哪一步开始用"。本文提出一条经过实践验证的三阶段学习路径:先从 Ask(问答式交互)起…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑