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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_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 --version |
| Python 3.9+ | 跑数据脚本 | python3 --version |
| TA-Lib | 技术指标计算核心库 | python3 -c "import talib" |
| akshare | A 股行情数据源 | 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_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="你的_API_Key" export ANTHROPIC_MODEL="claude-sonnet-4-20250514"三个变量的作用分别是：ANTHROPIC_BASE_URL指向接口地址，ANTHROPIC_AUTH_TOKEN放你的 Key，ANTHROPIC_MODEL指定默认模型。Key 在 TaoToken 控制台的 API Keys 页面创建，地址是 https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 。
改完环境变量记得重新加载：
source ~/.zshrc echo $ANTHROPIC_BASE_URL第二条命令能打印出地址，说明变量生效了。如果打印为空，检查是不是写到了错误的配置文件里。
3.2 安装 stock-analysis Skill
Skill 仓库地址是 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_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite ，能正常对话说明 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 refused
Error: 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 undefined
TypeError: 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 Key：
rm -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_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite ，适合需要长期跑 Agent 和批量任务的场景。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面有更细的接口说明。
最后提醒一句：Skill 输出的是技术面数据和分析，不是买卖信号。资金流向能看到机构态度，波动率能给出参考止损位，但这些都只是决策的输入之一，不是决策本身。把工具用顺，判断还是自己下。
