技能介绍

要解决什么问题

Claude Code 是 Anthropic 官方的命令行 AI 编程助手，可以直接在终端里完成编码、调试和重构。但它在国内落地时有三道坎：默认连接的 Anthropic 官方 API 无法直接访问；Pro/Max 订阅需要海外信用卡，每月成本 20–100 美元；而且 Claude Code 本身不原生支持 OpenAI 兼容接口。想用上这个工具，要么折腾代理，要么放弃。

技能如何工作

这个技能的关键发现是：DeepSeek 提供了 Anthropic Messages API 兼容端点。Claude Code 发出的请求本来就是 /v1/messages 格式，因此不需要改任何代码，也不需要自建代理做格式转换，只需配置一组环境变量：

ANTHROPIC_BASE_URL：指向 https://api.deepseek.com/anthropic
ANTHROPIC_AUTH_TOKEN：填入 DeepSeek API Key
ANTHROPIC_MODEL 及各角色模型变量：统一映射到 deepseek-chat

技能自带一键配置脚本 scripts/setup.sh，会自动把环境变量写入 ~/.zshrc，免去手写配置的麻烦；references/alternatives.md 则对比了自建代理、CC-Switch、ccproxy 等替代方案。模型层面可在 deepseek-chat（日常编程，推荐）和 deepseek-reasoner（复杂问题分析）之间切换，典型单次对话成本约 ¥0.01–0.05。

适用边界与注意点

这套方案依赖云端兼容端点，适合网络可达 DeepSeek 的环境；在受限沙箱容器里自建 Python 或 Node 代理，反而容易因外网访问限制和依赖加载失败而不可行。配置后遇到 authentication failed，先确认新终端窗口已加载环境变量；出现 Claude isn't available in your region 说明请求仍发往 Anthropic 官方，需检查 ANTHROPIC_BASE_URL 是否生效。需要回退到官方 Anthropic API 时，只需改回对应变量即可。macOS 上 npm 全局安装的权限与缓存问题也是常见坑，建议配置自定义 prefix 避开系统目录。