多彩编程 多彩编程MZPH · CODE BLOG
ARTICLE DETAIL

文章详情

深耕前端与后端开发技术的一线实战笔记与踩坑复盘。

一条命令搞定 A 股技术分析:Claude Code Skill---stock-analysis 实战体验

一条命令搞定 A 股技术分析:Claude Code Skill---stock-analysis 实战体验 1. 从手动翻指标到一条命令A 股技术分析的真实痛点先说结论Claude Code Skill 机制允许你把一套固定的分析流程封装成斜杠命令/stock-analysis 002957敲下去行情抓取、指标计算、五维分析、报告落盘全部自动跑完。stock-analysis 就是这样一个专门做 A 股技术分析的技能适合平时用 Claude Code 写代码、同时又想快速拿到一只票技术面概览的人。我以前分析一只股票是这样的打开行情软件切到技术分析页MA、MACD、KDJ、RSI、成交量、资金流向挨个看一遍看到关键数值就手动记到备忘录里再凭经验判断买点卖点。单只票十分钟起步想横向对比三只票一个下午就没了。更别扭的是不同软件的指标参数和计算口径不完全一致同一只票在两个软件里 MACD 的数值能差一点想统一标准很麻烦。真正的痛点不是指标看不懂而是重复劳动太多。均线金叉死叉、MACD 背离、KDJ 超买超卖这些判断逻辑其实是固定的每次都要人肉执行一遍既慢又容易漏。把这套流程交给 Claude Code Skill本质上是把机械采集 固定计算交给脚本把综合判断交给模型人只需要看结论。这篇就按我实际跑通的流程写先讲清楚 Skill 机制和前置准备再给可复制的配置片段然后是命令调用和结果验证最后把几个常见报错逐个拆掉。你照着做能在自己的 Claude Code 环境里复现同一套分析流程。需要说明的是技术分析只是参考维度之一不构成任何投资建议最终决策还是得自己拿。2. Claude Code Skill 机制与 TaoToken 接入前置准备2.1 Skill 到底是什么Claude Code 的 Skill 可以理解成给模型加一个专用工具箱。平时 Claude 只会聊天和读写文件你给它装一个 Skill它就多了一项特定能力并且这项能力通过斜杠命令触发。stock-analysis 这个 Skill 干的事很明确接收一个 6 位股票代码调用数据接口拉行情算出 30 多项技术指标再让模型从趋势、动量、成交量、资金、波动五个维度做综合分析最后把报告写到当前目录。Skill 的目录结构一般是这样的一个SKILL.md描述技能用途和触发方式配套的脚本负责实际的数据抓取和计算。Claude Code 启动时会扫描技能目录把可用的 Skill 注册成斜杠命令。所以你敲/stock-analysis的时候模型知道该调用哪个脚本、传什么参数。2.2 为什么需要先解决模型接入Skill 跑起来要调用大模型做分析这一步需要能稳定访问模型 API。我自己的做法是通过 TaoToken 这类兼容 Anthropic 接口的服务来接入好处是 Base URL 和 Key 配一次Claude Code 里所有 Skill 都能复用同一套凭证不用每个技能单独折腾。TaoToken 的定位是模型 API 接入服务官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。它兼容 Anthropic 的接口格式所以 Claude Code 里改一下ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN就能用。这里要强调一点接入配置是一次配好、长期复用的事。很多人卡在第一步就是因为环境变量没设对导致 Skill 触发后模型请求直接 401。下面第 3 节我会给出完整的可复制配置。2.3 前置依赖清单跑 stock-analysis 之前环境里需要这几样东西依赖项作用检查命令Claude Code运行 Skill 的宿主claude --versionPython 3.9跑数据脚本python3 --versionTA-Lib技术指标计算核心库python3 -c import talibakshareA 股行情数据源python3 -c import akshare模型 API 凭证让模型做五维分析见第 3 节配置TA-Lib 是最容易装崩的一个它在 Windows 上需要先装 C 库再装 Python 包macOS 上brew install ta-lib之后再pip install TA-Lib。如果你在import talib时报ModuleNotFoundError或者cannot find -lta-lib那就是 C 库没装好回到这一步补上。akshare 是纯 Python 包pip install akshare就行它负责从公开数据源拉 A 股行情。stock-analysis 的脚本会调用它拿最新价、成交量、资金流向这些原始数据。3. 可复制的 Skill 配置与模型接入片段这一节是全文最该照着抄的部分。配置分两块一块是 Claude Code 接入模型 API 的环境变量一块是 stock-analysis Skill 本身的安装。3.1 模型接入配置Claude Code 读取的是环境变量。在 macOS/Linux 上把下面这段加到~/.zshrc或~/.bashrc在 Windows 上用系统环境变量面板或者 PowerShell 的$env:设置。# Claude Code 模型接入配置 export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKEN你的_API_Key export ANTHROPIC_MODELclaude-sonnet-4-20250514三个变量的作用分别是ANTHROPIC_BASE_URL指向接口地址ANTHROPIC_AUTH_TOKEN放你的 KeyANTHROPIC_MODEL指定默认模型。Key 在 TaoToken 控制台的 API Keys 页面创建地址是 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。改完环境变量记得重新加载source ~/.zshrc echo $ANTHROPIC_BASE_URL第二条命令能打印出地址说明变量生效了。如果打印为空检查是不是写到了错误的配置文件里。3.2 安装 stock-analysis SkillSkill 仓库地址是 https://github.com/chaofanat/skills 。克隆到 Claude Code 的技能目录# 进入 Claude Code 技能目录按你的实际安装路径调整 cd ~/.claude/skills # 克隆技能仓库 git clone https://github.com/chaofanat/skills.git # 确认 stock-analysis 目录存在 ls skills/stock-analysis目录里应该能看到SKILL.md和配套脚本。Claude Code 下次启动时会自动扫描这个目录把/stock-analysis注册成可用命令。3.3 依赖安装# 安装 Python 依赖 pip install akshare TA-Lib # 验证 TA-Lib 可用 python3 -c import talib; print(talib.__version__)如果 TA-Lib 装不上先装系统级 C 库# macOS brew install ta-lib # Ubuntu/Debian sudo apt-get install ta-lib装完 C 库再pip install TA-Lib顺序不能反。3.4 一个容易忽略的 settings 片段如果你用 Claude Code 的项目级配置可以在项目根目录建.claude/settings.json把模型和权限固化下来{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的_API_Key, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, permissions: { allow: [ Bash(python3:*), Read, Write ] } }这个片段的好处是项目级隔离不同项目可以用不同的 Key 和模型不会互相干扰。permissions.allow里放开Bash(python3:*)是因为 Skill 要跑 Python 脚本不放开的话每次都会弹权限确认。配置三件套记住Base URL、Key、Model ID缺一个都跑不起来。4. 命令调用与结果验证从 002957 到完整报告4.1 触发命令配置好之后在 Claude Code 里直接敲/stock-analysis 002957就这一条。模型会识别出这是 stock-analysis 技能把002957作为参数传给脚本。脚本在后台做三件事从 akshare 拉最新行情、用 TA-Lib 算 30 多项技术指标、生成原始数据报告。这个过程大概 10 秒左右取决于网络和数据源响应速度。4.2 脚本阶段输出脚本跑完当前目录会生成原始数据文件。你会看到类似这样的文件名stock_report_002957_20250612.txt stock_data_002957_20250612.json.txt是给人看的指标汇总.json是给程序处理的结构化数据。这两个文件是模型做五维分析的输入。4.3 模型五维分析脚本跑完模型开始分析。它从五个维度展开趋势维度看均线排列和多空排列判断当前处于上升、下降还是震荡动量维度看 MACD、KDJ、RSI 的数值和背离情况成交量维度看量价配合放量上涨还是缩量下跌资金维度看主力资金流向这是很多散户容易忽略的一块波动维度算波动率给出参考的止损位、目标位和仓位建议。分析完成后模型会问你是否把综合报告保存到当前工作目录。确认后生成002957_科瑞技术_技术分析.md打开这个 Markdown 文件能看到完整的五维分析结论。4.4 验证请求是否真的走通了怎么确认模型请求确实通过你配置的接口发出去了两个办法。第一看 Claude Code 的启动日志。启动时会打印当前使用的 Base URL 和模型确认和你配置的一致。第二故意把 Key 改错一位再跑一次如果报 401说明请求确实打到了你配置的地址如果还能跑通说明它走了别的凭证配置没生效。验证模型连通性也可以直接用模型对话页面测一下 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 能正常对话说明 Key 和地址没问题。4.5 批量对比想对比多只票把代码依次敲进去就行/stock-analysis 000001 /stock-analysis 600036 /stock-analysis 603259每只票生成一套报告横向对比趋势和资金维度比手动翻软件快得多。我试过一次性跑五只票从敲命令到五份报告齐活大概一杯咖啡的时间。5. 常见报错排查401、TA-Lib 缺失与 OAuth 问题这一节按真实报错来拆每个都给出定位方法和修复步骤。5.1 401 Unauthorized报错长这样API Error: 401 {error:{type:authentication_error,message:invalid x-api-key}}原因就三类Key 写错、Key 过期、环境变量没生效。排查顺序先echo $ANTHROPIC_AUTH_TOKEN确认变量有值再确认 Key 没有多余空格复制时经常带尾随空格然后去控制台确认 Key 状态正常。如果用的是项目级settings.json注意它的优先级高于 shell 环境变量两边不一致时以settings.json为准。5.2 local proxy failed / connection refusedError: connect ECONNREFUSED 127.0.0.1:xxxx这个报错说明 Claude Code 在尝试连本地某个端口通常是你之前配过本地转发工具环境变量里残留了HTTP_PROXY或HTTPS_PROXY。检查env | grep -i proxy如果有输出把这些变量清掉再试。Claude Code 应该直连你配置的 Base URL不需要经过任何本地端口。5.3 reading choices of undefinedTypeError: Cannot read properties of undefined (reading choices)这个报错一般出现在接口返回格式和预期不一致的时候。常见原因是 Base URL 配错了比如把/api漏掉或者多写了一层路径。确认ANTHROPIC_BASE_URL是https://taotoken.net/api结尾不要带斜杠。还有一种可能是模型 ID 写错了接口返回了错误结构客户端解析choices字段时拿到 undefined。核对ANTHROPIC_MODEL的值和控制台里可用的模型列表一致。5.4 TA-Lib 相关报错ModuleNotFoundError: No module named talib或者ImportError: libta-lib.so.0: cannot open shared object file第一个是 Python 包没装pip install TA-Lib。第二个是系统 C 库没装或路径不对回到 3.3 节装系统级库。macOS 上如果 brew 装了还是找不到试试export LDFLAGS-L$(brew --prefix ta-lib)/lib再重装 Python 包。5.5 OAuth 相关报错OAuth error: invalid_grant如果你之前用 OAuth 方式登录过 Claude Code环境变量里的 API Key 和 OAuth 凭证可能冲突。解决办法是清掉 OAuth 缓存强制走 API Keyrm -rf ~/.claude/credentials.json然后重新启动 Claude Code它会读取环境变量里的 Key。注意这一步会清掉本地登录态确认你手上有可用的 API Key 再操作。5.6 Skill 命令不识别敲/stock-analysis提示命令不存在说明 Skill 没被扫描到。检查三件事技能目录路径对不对~/.claude/skills/skills/stock-analysis这种嵌套容易搞错、SKILL.md是否存在、Claude Code 是否重启过。Skill 是启动时扫描的装完要重启才生效。6. 把这条命令用进你的日常复盘流程配置跑通之后stock-analysis 最舒服的用法是嵌进盘后复盘。收盘后把自选池里的代码依次敲一遍每只票一份五维报告重点看资金维度和波动维度给出的参考位。趋势和动量维度用来快速筛掉明显不符合预期的票剩下的再细看。如果你还想把这套流程做得更自动化可以了解下 Coding Plan 这类长期方案 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 适合需要长期跑 Agent 和批量任务的场景。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有更细的接口说明。最后提醒一句Skill 输出的是技术面数据和分析不是买卖信号。资金流向能看到机构态度波动率能给出参考止损位但这些都只是决策的输入之一不是决策本身。把工具用顺判断还是自己下。
返回列表