← 返回主页
从零到精通 · 2026

# Claude Code 完整指南

安装 · 接入国产模型 · 全局规范部署 · Skill 配置 · 权限白名单
Windows / macOS 双平台，有魔法没魔法都有方案

⚡ Claude Code 是开源 Agent 框架。接入 DeepSeek 后无需 Claude 账号、无需魔法、不封号。

## 0 Claude Code 是什么

Claude Code 是 Anthropic 的终端版 AI Agent 框架。不是网页聊天——它在终端里直接读/写文件、执行命令、管理项目，是真正能帮你干活的 AI。

🤖

### Agent 框架

终端里帮你写代码、改文件、执行命令的智能助手

🔌

### 模型自由

可接入 Claude / DeepSeek / GLM 等任意模型

🛡️

### 国内可用

搭配国产模型不需要魔法、不需要外国手机号

📁

### 本地运行

代码在你电脑执行，不经过第三方服务器

核心概念：Agent 框架 = 身体，模型 = 脑子。Claude Code 是身体，你可以装国产模型的脑子（如 DeepSeek），效果依然很好。

## 1 安装 Claude Code

### ▎macOS 安装

### 打开终端 无需魔法

按 Command + 空格 搜索「终端」，打开终端 App。窗口末尾有 `$` 符号在闪烁。

### 推荐 用 Homebrew 安装 无需魔法

如果没装过 Homebrew，先执行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后，安装 Claude Code：

brew install claude-code

### 备选：官方脚本安装 需要魔法

curl -fsSL https://claude.ai/install.sh | bash

看到 "Claude Code installed successfully" 即成功。

### ▎Windows 安装

### 先装 Git 无需魔法

Claude Code 在 Windows 依赖 Git Bash。按 Win + R 输入 `wt` 打开终端：

winget install Git.Git

### 推荐 用 WinGet 安装 无需魔法

winget install Anthropic.ClaudeCode

### 备选：官方脚本安装 需要魔法

irm https://claude.ai/install.ps1 | iex
安装后终端输入 `claude --version` 验证，输出版本号即成功。

## 2 接入 AI 模型（DeepSeek / GLM / 任意模型）

Claude Code 装好只是空壳，需要接模型。有 Claude 账号可以直接 `claude` 登录。这里教接 DeepSeek（国产，有免费额度），不需要 Claude 账号、不需要魔法。

准备工作：去 platform.deepseek.com 注册 → API Keys → 创建 Key → 复制保存（以 `sk-` 开头）。

### ▎方法一（极力推荐⭐⭐）：CC Switch 一键切换

CC Switch 是专为 Claude Code 打造的模型切换工具，图形化界面，一键添加/切换模型，再也不用手动改配置文件。

### 安装 CC Switch

macOS：终端执行

brew tap farion1231/ccswitch && brew install --cask cc-switch

Windows：去 GitHub Releases 下载安装包，双击运行（需魔法）。也可用 CCS 一键启动器 国内直链下载。

### 添加 DeepSeek 模型

打开 CC Switch → 点 "+" 按钮 → 填入以下信息：

名称：DeepSeek API Key：sk-你的deepseek_api_key Base URL：https://api.deepseek.com/anthropic 模型名：deepseek-v4-pro

点「保存」即完成。也可以添加 GLM、Qwen 等其他模型，随时切换。

### 切换模型

在 Claude Code 终端中输入 `/model`，上下键选择想要的模型，回车即切换。无需重启、无需改文件。

CC Switch 自动管理 settings.json，不用手动编辑任何配置文件。添加多个模型后，`/model` 命令随时秒切。
CC Switch 的核心优势：① 图形界面，不写一行配置；② 支持同时添加多个模型（DeepSeek / GLM / Qwen / Claude），`/model` 一键切换；③ 自动管理 settings.json，不会因手误导致配置错误；④ 支持不同项目用不同模型。

### ▎方法二（备选）：手动配置 settings.json

如果你不想安装额外工具，也可以直接编辑配置文件。

### 找到配置文件 无需魔法

macOS：终端输入 `open ~/.claude/settings.json`

Windows：文件管理器地址栏输入 `%USERPROFILE%\.claude\settings.json`

如果文件不存在，在该目录下新建 `settings.json`。

### 写入配置

用文本编辑器打开，粘贴以下内容（替换 Key）：

{ "env": { "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic", "ANTHROPIC_AUTH_TOKEN": "sk-你的deepseek_api_key", "ANTHROPIC_MODEL": "deepseek-v4-pro", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-pro", "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro", "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro" }, "theme": "dark" }
这六行把 Claude Code 内部所有模型都指向 DeepSeek，不管 Agent 请求哪个模型，实际走的都是 DeepSeek。

## 3 部署全局规范（一键配置所有偏好）

这是用好 Claude Code 最关键的一步。CLAUDE.md + settings.json + rules + skills 一次性部署，让 Claude Code 从此自动记住你的偏好。

### 3.1 拉取规范仓库

### Clone 到桌面

🍎 macOS

cd ~/Desktop && git clone https://github.com/LiHongwei-cn/lihongwei-cn.git

🪟 Windows

cd %USERPROFILE%\Desktop && git clone https://github.com/LiHongwei-cn/lihongwei-cn.git

进入 `global-specs/` 目录，里面有 CLAUDE.md、settings.json、rules/、skills/、memory/。

### 3.2 配置文件映射（一张表说清楚）

源文件 (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 | 项目级规范模板

### 3.3 极速版：一键部署（macOS）

已 clone 仓库并编辑好 settings.json 的 API Key 后，终端进入 global-specs/ 目录，复制粘贴以下全部：

cp settings.json ~/.claude/settings.json cp CLAUDE.md ~/.claude/CLAUDE.md cp settings.local.json ~/.claude/settings.local.json mkdir -p ~/.claude/rules ~/.claude/skills/neat-freak/references cp rules/*.md ~/.claude/rules/ && cp skills/neat-freak/*.md ~/.claude/skills/neat-freak/ && cp skills/neat-freak/references/*.md ~/.claude/skills/neat-freak/references/ cp project-CLAUDE.md ~/Desktop/lihongwei-cn/CLAUDE.md

### 3.4 极速版：一键部署（Windows PowerShell）

copy settings.json $env:USERPROFILE\.claude\settings.json copy CLAUDE.md $env:USERPROFILE\.claude\CLAUDE.md copy settings.local.json $env:USERPROFILE\.claude\settings.local.json mkdir $env:USERPROFILE\.claude\rules; copy rules\*.md $env:USERPROFILE\.claude\rules\ mkdir $env:USERPROFILE\.claude\skills\neat-freak\references; copy skills\neat-freak\SKILL.md $env:USERPROFILE\.claude\skills\neat-freak\; copy skills\neat-freak\references\*.md $env:USERPROFILE\.claude\skills\neat-freak\references\ copy project-CLAUDE.md $env:USERPROFILE\Desktop\lihongwei-cn\CLAUDE.md
部署后启动 Claude Code，输入 `/neat` 如果看到 skill 开始审查文件，说明全部部署成功。

## 4 桌面快捷启动

双击桌面图标启动 Claude Code，自动进入工作目录。

📂 查看完整教程 → 桌面快捷启动（Win / Mac）

## 5 搭建 Telegram AI 机器人

把 DeepSeek 接入 Telegram，发消息自动回复，支持文字对话 + 图片理解。已独立为完整项目页面。

🤖 查看完整教程 → Telegram AI 机器人（独立页面）

## 6 日常工作流

### 开始工作

进入项目目录 → 启动 Claude Code → 直接描述问题。全局规范和项目 CLAUDE.md 已告诉 Agent 一切。

### 收尾存档 关键

/neat

洁癖.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。新用户有免费额度，轻度使用足够。

### 🔗 相关链接

DeepSeek 平台platform.deepseek.com 无需魔法
规范仓库github.com/LiHongwei-cn/.../global-specs
洁癖.skill 上游github.com/KKKKhazix/khazix-skills
Python 下载python.org 无需魔法
本页被阅读 ... 次