安装 · 接入国产模型 · 全局规范部署 · Skill 配置 · 权限白名单
Windows / macOS 双平台，有魔法没魔法都有方案
Claude Code 是 Anthropic 的终端版 AI Agent 框架。不是网页聊天——它在终端里直接读/写文件、执行命令、管理项目，是真正能帮你干活的 AI。
终端里帮你写代码、改文件、执行命令的智能助手
可接入 Claude / DeepSeek / GLM 等任意模型
搭配国产模型不需要魔法、不需要外国手机号
代码在你电脑执行，不经过第三方服务器
按 Command + 空格 搜索「终端」，打开终端 App。窗口末尾有 $ 符号在闪烁。
如果没装过 Homebrew，先执行：
安装完成后，安装 Claude Code：
看到 "Claude Code installed successfully" 即成功。
Claude Code 在 Windows 依赖 Git Bash。按 Win + R 输入 wt 打开终端：
claude --version 验证，输出版本号即成功。Claude Code 装好只是空壳，需要接模型。有 Claude 账号可以直接 claude 登录。这里教接 DeepSeek（国产，有免费额度），不需要 Claude 账号、不需要魔法。
sk- 开头）。
CC Switch 是专为 Claude Code 打造的模型切换工具，图形化界面，一键添加/切换模型，再也不用手动改配置文件。
macOS：终端执行
Windows：去 GitHub Releases 下载安装包，双击运行（需魔法）。也可用 CCS 一键启动器 国内直链下载。
打开 CC Switch → 点 "+" 按钮 → 填入以下信息：
点「保存」即完成。也可以添加 GLM、Qwen 等其他模型，随时切换。
在 Claude Code 终端中输入 /model，上下键选择想要的模型，回车即切换。无需重启、无需改文件。
/model 命令随时秒切。/model 一键切换；③ 自动管理 settings.json，不会因手误导致配置错误；④ 支持不同项目用不同模型。
如果你不想安装额外工具，也可以直接编辑配置文件。
macOS：终端输入 open ~/.claude/settings.json
Windows：文件管理器地址栏输入 %USERPROFILE%\.claude\settings.json
如果文件不存在，在该目录下新建 settings.json。
用文本编辑器打开，粘贴以下内容（替换 Key）：
这是用好 Claude Code 最关键的一步。CLAUDE.md + settings.json + rules + skills 一次性部署，让 Claude Code 从此自动记住你的偏好。
🍎 macOS
🪟 Windows
进入 global-specs/ 目录，里面有 CLAUDE.md、settings.json、rules/、skills/、memory/。
| 源文件 (global-specs/) | macOS 目标 | Windows 目标 | 作用 |
|---|---|---|---|
| settings.json | ~/.claude/settings.json | %USERPROFILE%\.claude\settings.json | DeepSeek API 接入（需替换 Key） |
| CLAUDE.md | ~/.claude/CLAUDE.md | %USERPROFILE%\.claude\CLAUDE.md | 全局用户指令（你是谁、行为准则） |
| settings.local.json | ~/.claude/settings.local.json | %USERPROFILE%\.claude\settings.local.json | 命令权限白名单（不用反复点允许） |
| rules/*.md | ~/.claude/rules/ | %USERPROFILE%\.claude\rules\ | 6 份工程规范（代码/安全/测试等） |
| skills/neat-freak/ | ~/.claude/skills/neat-freak/ | %USERPROFILE%\.claude\skills\neat-freak\ | 洁癖.skill（自动文档审查） |
| memory/*.md | ~/.claude/projects/.../memory/ | %USERPROFILE%\.claude\projects\...\memory\ | 跨会话记忆（自动记住偏好） |
| project-CLAUDE.md | 项目目录/CLAUDE.md | 项目目录\CLAUDE.md | 项目级规范模板 |
已 clone 仓库并编辑好 settings.json 的 API Key 后，终端进入 global-specs/ 目录，复制粘贴以下全部：
/neat 如果看到 skill 开始审查文件，说明全部部署成功。把 DeepSeek 接入 Telegram，发消息自动回复，支持文字对话 + 图片理解。已独立为完整项目页面。
🤖 查看完整教程 → Telegram AI 机器人（独立页面）进入项目目录 → 启动 Claude Code → 直接描述问题。全局规范和项目 CLAUDE.md 已告诉 Agent 一切。
洁癖.skill 审查文档和记忆，确保代码迭代后文档也同步了。
新项目第一步永远先写 CLAUDE.md，约束先行，再写代码。
| 命令 | 作用 |
|---|---|
claude | 在当前目录启动 Claude Code |
claude --dangerously-skip-permissions | 跳过操作确认提示（推荐） |
claude --version | 查看版本 |
/model | 切换模型 |
/theme | 切换颜色主题 |
/neat | 洁癖.skill — 文档审查同步 |
cd 路径 && claude | 进入文件夹并启动（推荐） |
Q：需要 Claude 账号吗？会被封吗？
不需要。搭配 DeepSeek 等国产模型，不需要 Claude 账号、不需要魔法、不需要外国手机号、不封号。
Q：装好了但 claude 命令找不到？
macOS：echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc 然后重启终端。Windows：重启终端即可。
Q：API 连接失败？
检查 settings.json 中 ANTHROPIC_AUTH_TOKEN 是否为有效 Key、ANTHROPIC_BASE_URL 是否为正确的 DeepSeek 地址。
Q：DeepSeek API Key 怎么获取？要钱吗？
去 platform.deepseek.com 注册 → API Keys → 创建 Key。新用户有免费额度，轻度使用足够。