Hi,欢迎你来。上课之前,有几件事想提前跟你说。
我主业是企业服务、创业孵化,也是一个深度使用AI的人。课程是用业余时间做的,浓缩了我的思考和实践,但请别把我当"老师"——我是创业者,一个实干的人,我不是专职做培训的人。我教的不是理论,是我自己每天在用的东西。我也相信我的实战经验和社会网络能帮到你。
别人的课是花钱买一门课,上完就结束。我的课是花钱买一系列思路和实践,买持续的课程,每次课还不太一样 —— 因为AI在变,我的产品也在迭代,内容会持续更新。所以每次课我的产品都在更新、各种功能也都在不断完善。
说点私心:我希望能跟大家一起做点事,这也是我做课程和举办活动的初衷。
把你之前写过的东西收集到一个文件夹里——文章、笔记、随想、摘抄、日记、推文、小红书、视频脚本,什么都行。如果没有个人作品,就收集你想对标的:喜欢他们的内容、文风、风格。AI员工需要学习"你的味道",有素材会让AI更好的跟你深度融合。
不管你是 Mac 还是 Windows,下面都有详细的安装流程,经过多次安装验证的流程,非常详细、小白友好。
我会先给你一个 20 美金(一个月有效期)的额度体验,后续继续使用需要自行购买。
如果你实在装不上,提前联系我,我们可以当天早点到现场,我帮你装。提前装好是为了上课时能直接上手操作。
我希望你的学费能换来
一个全新的
AI使用方式
一个实在的
生产力提升
一个新的
社交网络
这份指南会手把手教你在 Mac 电脑上安装 Claude Code。
按照步骤一步一步来,每一步都有"验证是否成功"的方法,确保你不会走弯路。
你一共需要完成以下几件事:
| 步骤 | 要装什么 | 它是干什么的 | 大约耗时 |
|---|---|---|---|
| 第1步 | Homebrew + Node.js | Homebrew 是 Mac 的软件安装工具,Node.js 是 Claude Code 的运行环境 | 5分钟 |
| 第2步 | Claude Code 命令行工具 | Claude AI 的核心程序,装在你电脑里 | 3分钟 |
| 第3步 | 配置 API 连接 | 配置密钥、中转服务器地址和 Claude 配置文件 | 5分钟 |
| 第4步 | 验证 Claude Code 能用 | 确认前面的步骤都成功了 | 2分钟 |
| 第5步 | Obsidian + Claude Code 插件 | 在 Obsidian 里使用 Claude | 5分钟 |
💡 好消息:我们使用国内中转服务器连接 AI,所以整个安装和日常使用过程都不需要翻墙。
在这份指南中,几乎所有操作都在 "终端" 里完成。终端就是 Mac 电脑的"命令行工具",你可以把它理解为:一个用打字来操作电脑的窗口。你不需要害怕它,只需要按照指南复制粘贴命令就行。
1. 按键盘 Command + 空格键(Command 是键盘左下角带 ⌘ 符号的键)
2. 会弹出一个搜索框(叫"聚焦搜索")
3. 输入 Terminal(或者输入"终端")
4. 按回车,终端就打开了
📸【截图】用聚焦搜索打开终端的过程
💡 后面每次说"打开终端",都是指这个操作。建议你现在就打开,后面一直用。
这一步要装两个东西:Homebrew(Mac 的软件安装工具)和 Node.js(Claude Code 需要的运行环境)。你不需要理解它们是什么,只需要知道:它们是 Claude Code 运行的基础,就像手机 App 需要手机操作系统一样。
1. 打开终端(按上面教的方法)
2. 复制下面这一整行命令,粘贴到终端里,按回车:
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
💡 这条命令使用国内镜像源安装 Homebrew,不需要科学上网。安装过程中会让你选择镜像源,输入1(中科大源或清华大学)然后按回车即可。
3. 过程中可能会要求你输入 Mac 的开机密码(就是你开机/解锁屏幕时输入的密码)。输入时屏幕上不会显示任何字符,这是正常的,输完直接按回车。
4. 中间可能会提示你按一下 回车键(Enter/Return) 确认,按一下就行。
5. 等待安装完成,大约需要 2-5 分钟。看到终端重新出现可以输入的光标,说明装好了。
6. 重要! 安装完 Homebrew 后,终端可能会显示一段 "Next steps" 的提示,里面有几行命令需要你执行。如果看到了,按下面的方式一行一行执行:
第一行:复制下面这行,粘贴到终端里,按回车:
echo >> ~/.zprofile
按回车后不会有任何提示,这是正常的。
第二行:复制下面这行,粘贴到终端里,按回车:
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
按回车后同样不会有任何提示,这是正常的。
第三行:复制下面这行,粘贴到终端里,按回车:
eval "$(/opt/homebrew/bin/brew shellenv)"
按回车后同样不会有任何提示,这是正常的。
⚠️ 一定要一行一行复制执行。 每复制一行,按一次回车,再复制下一行。
💡 如果没有看到 "Next steps" 提示,说明不需要这一步,直接继续。
7. 现在用 Homebrew 安装 Node.js。在终端中输入以下命令,按回车:
brew install node
8. 等待安装完成,大约需要 1-3 分钟。
在终端中输入以下命令,按回车:
node -v
如果你看到类似 v24.x.x 的版本号(数字可能不同),说明 Node.js 安装成功 ✅
3. 再输入:
npm -v
如果你看到类似 10.x.x 的版本号,说明 npm 也安装成功 ✅
npm 是 Node.js 自带的"软件安装工具",下一步要用它来安装 Claude Code。
• 如果 brew 命令提示 command not found,说明 Homebrew 没装好。请检查上面第6步的 "Next steps" 是否执行了。
• 如果 node -v 提示 command not found,尝试关闭终端,重新打开,再试一次。
Claude Code 命令行工具是 Claude AI 的核心程序。装好它之后,你就可以在电脑上直接跟 Claude 对话了。
1. 打开终端(如果上一步已经打开了,就继续用)
2. 输入以下命令,然后按回车:
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
💡 这条命令使用国内镜像源(npmmirror)下载,不需要科学上网。
3. 等待安装完成。你会看到终端在滚动显示一些文字,这是正常的。安装过程大约需要 1-3 分钟。
4. 当终端不再滚动,重新出现可以输入的光标时,说明安装完成。
如果看到类似 EACCES 或 Permission denied 的错误,输入以下命令:
sudo npm install -g @anthropic-ai/claude-code
sudo的意思是"用管理员权限执行"。输入后会要求你输入 Mac 开机密码(输入时屏幕上不会显示任何字符,这是正常的,输完直接按回车)。
1. 在终端中输入:
claude --version
如果你看到一个版本号(比如 1.x.x),说明 Claude Code 安装成功 ✅
• 如果提示 command not found,尝试关闭终端,重新打开,再输入 claude --version
• 如果还是不行,重新执行安装命令
这一步要配置两样东西:
- API Key(密钥):就像一把"钥匙",大龙会单独私信给你
- 中转服务器地址:让 Claude Code 通过国内服务器连接 AI,不需要翻墙
1. 打开终端
2. 依次输入以下两条命令(每条输完按回车):
export ANTHROPIC_BASE_URL="https://api.ctok.ai"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
举个例子,如果你收到的密钥是 sk-ant-abc123xyz,那第二条命令就是:
export ANTHROPIC_AUTH_TOKEN="sk-ant-abc123xyz"
⚠️ 注意:等号=两边不要有空格,密钥前后不要有空格。
3. 按回车。不会有任何提示,这是正常的。
上面的命令只在当前终端窗口有效。关掉终端就失效了。我们需要把它写入配置文件,让它永久生效。
1. 在终端中依次输入以下两条命令,每条输完按回车:
echo 'export ANTHROPIC_BASE_URL="https://api.ctok.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
同样,把你的API密钥替换成你实际收到的密钥。
2. 然后输入以下命令,让配置立即生效:
source ~/.zshrc
⚠️ 这一步非常重要!Claude Code 首次启动时会尝试连接国外服务器验证,在国内会失败。我们需要提前写入一个配置文件,跳过这个验证步骤,并把 API Key 直接写进去。
在终端中输入以下命令,把 你的密钥 替换成大龙私信给你的密钥,然后按回车:
echo '{"hasCompletedOnboarding":true,"primaryApiKey":"你的密钥"}' > ~/.claude.json
比如大龙给你的密钥是sk-ant-abc123xyz,那你输入的就是:
```
echo '{"hasCompletedOnboarding":true,"primaryApiKey":"sk-ant-abc123xyz"}' > ~/.claude.json
```
按回车后不会有任何提示,这是正常的。
在终端中输入:
echo $ANTHROPIC_BASE_URL
如果显示 https://api.ctok.ai,说明中转服务器地址配置成功 ✅
再输入:
echo $ANTHROPIC_AUTH_TOKEN
如果显示你的密钥,说明 API Key 配置成功 ✅
• 如果什么都没显示,说明配置没生效。请重新执行上面的步骤。
• 检查是否有多余的空格或引号。
• 确认执行了 source ~/.zshrc 命令。
💡 这一步不需要科学上网,因为你已经配置了国内中转服务器。
1. 在终端中输入:
claude
2. 按回车后,Claude Code 会启动。
首次启动时,Claude Code 会显示一个安全提示,问你是否信任当前文件夹:
Quick safety check: Is this a project you created or one you trust?
> 1. Yes, I trust this folder
2. No, exit
用方向键选择 1. Yes, I trust this folder,然后按回车。
接下来 Claude Code 会检测到你配置的 API Key,显示以下提示:
ANTHROPIC_AUTH_TOKEN: sk-ant-...(你的密钥)
Do you want to use this API key?
1. Yes
> 2. No (recommended)
⚠️ 注意:默认选中的是第2个 No,但我们要选第1个 Yes! 用方向键 ↑ 切换到1. Yes,然后按回车。
如果不小心选了 No,不用慌,退出后重新执行第3步的 3.3(写入配置文件的那条命令),然后再输入 claude 启动即可。
如果你看到 Claude 的欢迎界面(显示版本号和 API Usage Billing),说明已经连接成功了。
试着输入一句话测试:
你好
如果 Claude 回复了你,恭喜!Claude Code 命令行工具安装配置全部完成 🎉
输入以下命令退出 Claude:
/exit
• 如果提示 Not logged in · Please run /login:说明你在上一步不小心选了 No。先输入 /exit 退出 Claude,然后在终端中重新执行第3步的 3.3(echo 那条写入 .claude.json 的命令),再输入 claude 重新启动即可
• 如果提示 Unable to connect to Anthropic services:说明第3步的 .claude.json 配置文件没有写入成功,回到第3步的 3.3 重新执行
• 如果提示 API Key 相关的错误,回到第3步检查 ANTHROPIC_AUTH_TOKEN 是否配置正确
• 如果提示网络错误或连接失败,回到第3步检查 ANTHROPIC_BASE_URL 是否配置正确(应该是 https://api.ctok.ai)
• 如果提示 command not found,回到第2步重新安装
Obsidian 是一款笔记软件,也是我们课程中使用的知识库工具。这一步教你怎么在 Obsidian 里面使用 Claude。
1. 访问 Obsidian 官网:https://obsidian.md
2. 点击 "Download" 下载 Mac 版本
3. 下载完成后,双击 .dmg 文件,将 Obsidian 拖到"应用程序"文件夹
4. 在"应用程序"文件夹中找到 Obsidian,双击打开
💡 第一次打开时,Mac 可能会提示"这是从网上下载的应用,确定要打开吗?",点"打开"即可。
1. 打开 Obsidian
2. 如果是第一次使用,选择 "Create new vault"(创建新仓库),给它起个名字,比如 我的AI知识库
3. 如果你已经有知识库,选择 "Open folder as vault"(打开文件夹作为仓库)
1. 点击 Obsidian 左下角的 设置图标(齿轮 ⚙️)
2. 在左侧菜单中选择 "Community plugins"(第三方插件/社区插件)
3. 如果看到 "Restricted mode"(安全模式/受限模式) 的提示,点击 "Turn on community plugins"(开启安全模式),然后在弹窗中点确认
💡 这一步只需要做一次,以后不用再开。
Claudian 是一个开源的 Obsidian 插件,它把 Claude Code 嵌入到 Obsidian 里面,让你可以在笔记软件中直接跟 AI 对话、读写文件、管理知识库。
我们直接让 Claude 帮你安装这个插件。
操作步骤:
1. 打开终端,启动 Claude(如果第4步退出了,重新输入 claude 启动)
2. 复制下面这段话,粘贴给 Claude,按回车:
帮我安装 Obsidian 的 Claudian 插件。
步骤:
1. 找到我的 Obsidian 知识库
2. 去 https://github.com/YishenTu/claudian/releases/latest 下载 main.js、manifest.json、styles.css 这三个文件
3. 在知识库的 .obsidian/plugins/claudian/ 文件夹里放这三个文件
如果有多个知识库,每个都装上。
3. Claude 执行过程中会弹出确认提示,一路选 Yes 即可。完成后输入 /exit 退出。
启用插件:
1. 回到 Obsidian
2. 打开 设置 → Community plugins(第三方插件/社区插件)
3. 点击右上角的 刷新按钮(🔄),刷新插件列表
4. 在列表中找到 "Claudian",打开右边的开关启用它
配置插件(重要!):
1. 在 Obsidian 设置中,找到左侧菜单的 "Claudian"(在 Community plugins 下面)
2. 在 "环境" / "自定义变量" 区域,输入以下两行:
ANTHROPIC_AUTH_TOKEN="你的API密钥"
ANTHROPIC_BASE_URL="https://api.ctok.ai"
把你的API密钥替换成大龙私信给你的密钥(和第3步配置的是同一个密钥)
3. 点击保存或关闭设置
启用插件后,你会在 Obsidian 左侧边栏看到一个 Claudian 的图标。点击它,会打开一个聊天侧边栏。
在对话框中输入:
你好
如果 Claude 正常回复了,说明 Obsidian + Claudian 插件配置成功 ✅
如果你走到了这里,说明你已经成功安装了 Claude Code。现在你可以:
• 在 终端 里直接跟 Claude 对话(输入 claude 启动)
• 在 Obsidian 里用 Claude 帮你管理知识库、整理笔记、生成内容
💡 日常使用提醒:因为我们使用了国内中转服务器,日常使用 Claude 不需要翻墙,直接打开就能用。
📌 如果按照以上步骤操作后仍然遇到问题,请截图发给大龙,他会帮你解决。
这份指南会手把手教你在 Windows 电脑上安装 Claude Code。
按照步骤一步一步来,每一步都有"验证是否成功"的方法,确保你不会走弯路。
你一共需要完成以下几件事:
| 步骤 | 要装什么 | 它是干什么的 | 大约耗时 |
|---|---|---|---|
| 第1步 | Node.js | 一个软件运行环境,Claude Code 需要它才能工作 | 3分钟 |
| 第2步 | Git for Windows | Claude Code 在 Windows 上需要的工具 | 2分钟 |
| 第3步 | Claude Code 命令行工具 | Claude AI 的核心程序,装在你电脑里 | 3分钟 |
| 第4步 | 配置 API 连接 | 配置密钥、中转服务器地址和 Claude 配置文件 | 5分钟 |
| 第5步 | 验证 Claude Code 能用 | 确认前面的步骤都成功了 | 2分钟 |
| 第6步 | Obsidian + Claude 插件 | 在 Obsidian 里使用 Claude | 5分钟 |
💡 好消息:我们使用国内中转服务器连接 AI,所以整个安装和日常使用过程都不需要翻墙。
Windows 系统的杀毒软件和防火墙可能会拦截安装过程,导致安装失败。为了顺利完成安装,建议先临时关闭它们。
1. Windows Defender(Windows 自带的杀毒软件)
• 打开 Windows 设置(按 Windows + I)
• 选择 "更新和安全" → "Windows 安全中心" → "病毒和威胁防护"
• 点击 "管理设置"
• 关闭 "实时保护"
2. 第三方杀毒软件(如果你装了的话)
如果你电脑上装了 360、腾讯电脑管家、火绒等杀毒软件,也建议临时关闭:
• 右键点击任务栏右下角的杀毒软件图标
• 选择 "退出" 或 "暂停保护"
3. Windows 防火墙(可选)
如果安装过程中仍然遇到网络问题,可以临时关闭防火墙:
• 打开 Windows 设置 → "更新和安全" → "Windows 安全中心" → "防火墙和网络保护"
• 点击当前活动的网络(通常是"专用网络"或"公用网络")
• 关闭 "Microsoft Defender 防火墙"
💡 安装完成后记得重新打开这些保护软件! 为了电脑安全,完成所有安装步骤后,按照上面的路径重新打开它们。
在这份指南中,很多操作需要在 PowerShell 里输入命令。PowerShell 就是 Windows 电脑的"命令行工具",你可以把它理解为:一个用打字来操作电脑的窗口。
1. 按键盘上的 Windows 键(键盘左下角,有 Windows 标志的那个键)
2. 直接输入 PowerShell
3. 在搜索结果中,你会看到 "Windows PowerShell"
4. 右键点击它,选择 "以管理员身份运行"(Run as Administrator)
5. 如果弹出提示"是否允许此应用对你的设备进行更改",点 "是"
💡 后面每次说"打开 PowerShell",都是指这个操作。建议你现在就打开,后面一直用。
Node.js 是一个软件运行环境。你不需要理解它是什么,只需要知道:Claude Code 需要它才能运行,就像手机 App 需要手机操作系统一样。
1. 打开 PowerShell(按上面教的方法,以管理员身份运行)
2. 复制下面这行命令,粘贴到 PowerShell 里,按回车:
winget install OpenJS.NodeJS.LTS
3. 过程中可能会提示你同意协议,输入 Y 然后按回车。
4. 等待安装完成,大约需要 1-3 分钟。
5. 安装完成后,关闭 PowerShell,然后重新打开一个新的 PowerShell。 这一步很重要,不然电脑可能找不到刚装好的 Node.js。
📸 截图示例:用 winget 安装 Node.js 的过程
如果你按回车后,PowerShell 显示了类似下面这样的红色/黄色提示:
winget : 无法将"winget"项识别为 cmdlet、函数、脚本文件或可运行程序的名称。
或者英文提示:
winget : The term 'winget' is not recognized as the name of a cmdlet...
这说明你的 Windows 版本较旧,没有自带 winget 这个工具。不用担心,换一种方式安装就行:
1. 打开浏览器,访问:https://nodejs.org
2. 点击绿色的 "LTS" 下载按钮
3. 双击下载的 .msi 文件,一路点 "Next" 完成安装
4. 安装完成后,关闭并重新打开 PowerShell
1. 打开一个新的 PowerShell 窗口,分别输入 node -v 和 npm -v,看到版本号就说明装好了 ✅
⚠️ 如果输入npm -v时出现红色报错"禁止运行脚本",其实并不意味着没有安装,先执行这条命令解锁:
```
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```
输入Y确认,然后再试npm -v就正常了。
Claude Code 在 Windows 上需要 Git Bash 才能运行。Git for Windows 是一个工具包,里面包含了 Git Bash。
在 PowerShell 中输入以下命令,按回车:
winget install Git.Git
等待安装完成(大约 1-2 分钟)。
⚠️ 如果 winget 安装过程中长时间没反应(超过 5 分钟),这是因为 winget 从 GitHub 下载,国内网络可能不稳定。可以按Ctrl + C取消,然后用下面的备用方法安装。
安装完成后,关闭 PowerShell,重新打开一个新的 PowerShell。 这一步很重要。
📸 截图示例:用 winget 安装 Git for Windows 的过程
winget 安装 Git 时需要从 GitHub 下载,国内网络可能很慢。如果等了很久都没反应,用国内镜像下载:
1. 打开浏览器,访问:https://mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/
2. 点击最新的版本文件夹(数字最大的那个,比如 v2.49.0.windows.1)
3. 下载文件名类似 Git-2.49.0-64-bit.exe 的文件(选 64-bit 的)
4. 双击下载的 .exe 文件,一路点 "Next" 完成安装(保持默认选项即可)
5. 安装完成后,关闭并重新打开 PowerShell
💡 这是清华大学的镜像站,下载速度很快,不需要科学上网。
跟第1步一样,如果 PowerShell 显示红色/黄色的 winget 无法识别 提示,换这种方式安装:
1. 打开浏览器,访问:https://git-scm.com/downloads/win
2. 点击下载按钮
3. 双击下载的 .exe 文件,一路点 "Next" 完成安装(保持默认选项即可)
4. 安装完成后,关闭并重新打开 PowerShell
在 PowerShell 中输入:
git --version
如果你看到类似 git version 2.x.x 的版本号,说明 Git for Windows 安装成功 ✅
Claude Code 命令行工具是 Claude AI 的核心程序。装好它之后,你就可以在电脑上直接跟 Claude 对话了。
1. 打开 PowerShell(如果上一步已经打开了,就继续用)
2. 输入以下命令,然后按回车:
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
💡 这条命令使用国内镜像源(npmmirror)下载,不需要科学上网。
3. 等待安装完成。你会看到 PowerShell 在滚动显示一些文字,这是正常的。安装过程大约需要 1-3 分钟。
4. 当 PowerShell 不再滚动,重新出现可以输入的光标时,说明安装完成。
📸 截图示例:安装 Claude Code 完成后的界面
在 PowerShell 中输入:
claude --version
如果你看到一个版本号(比如 1.x.x),说明 Claude Code 安装成功 ✅
• 如果提示 not recognized,尝试关闭 PowerShell,重新打开,再输入 claude --version
• 如果安装过程中报错,检查科学上网是否开启,然后重新执行安装命令
这一步要配置两样东西:
- API Key(密钥):就像一把"钥匙",大龙会单独私信给你
- 中转服务器地址:让 Claude Code 通过国内服务器连接 AI,不需要翻墙
打开 PowerShell(如果上一步已经打开了,就继续用),依次输入以下两条命令。
1. 复制下面这条命令,粘贴到 PowerShell 里,按回车:
setx ANTHROPIC_BASE_URL "https://api.ctok.ai"
这条命令告诉 Claude Code:通过国内中转服务器连接 AI,不走国外直连。
2. 再复制下面这条命令,把 你的密钥 替换成大龙私信给你的那串密钥,然后粘贴到 PowerShell 里,按回车:
setx ANTHROPIC_AUTH_TOKEN "你的密钥"
比如大龙给你的密钥是sk-ant-abc123xyz,那你输入的就是:setx ANTHROPIC_AUTH_TOKEN "sk-ant-abc123xyz"
3. 每条命令执行后,你会看到提示 "成功: 指定的值已经被保存。"(SUCCESS: Specified value was saved.)
4. 关闭所有已打开的 PowerShell 窗口,然后重新用管理员身份打开一个新的 PowerShell。 这一步很重要,新的配置需要重新打开 PowerShell 才能生效。
📸 截图示例:setx 命令执行成功后的提示
⚠️ 这一步非常重要!Claude Code 首次启动时会尝试连接国外服务器验证,在国内会失败。我们需要提前写入一个配置文件,跳过这个验证步骤,并把 API Key 直接写进去。
在新打开的 PowerShell 中,复制下面这条命令,把 你的密钥 替换成大龙私信给你的密钥,然后粘贴到 PowerShell 里,按回车:
Set-Content -Path "$env:USERPROFILE\.claude.json" -Value '{"hasCompletedOnboarding":true,"primaryApiKey":"你的密钥"}'
比如大龙给你的密钥是sk-ant-abc123xyz,那你输入的就是:
```
Set-Content -Path "$env:USERPROFILE\.claude.json" -Value '{"hasCompletedOnboarding":true,"primaryApiKey":"sk-ant-abc123xyz"}'
```
按回车后不会有任何提示,这是正常的。
1. 打开一个新的 PowerShell 窗口
2. 输入以下命令,按回车:
echo $env:ANTHROPIC_BASE_URL
如果显示 https://api.ctok.ai,说明中转服务器地址配置成功 ✅
3. 再输入:
echo $env:ANTHROPIC_AUTH_TOKEN
如果显示你的密钥,说明 API Key 配置成功 ✅
• 如果什么都没显示,说明配置没生效。一定要关掉旧的 PowerShell,开一个新的再验证。
• 检查变量名是否拼写正确:ANTHROPIC_BASE_URL(全部大写,用下划线连接)
• 检查中转地址是否正确:https://api.ctok.ai(注意是 https 开头,结尾没有斜杠)
• 如果还是不行,截图发给大龙
💡 这一步不需要科学上网,因为你已经配置了国内中转服务器。
1. 在 PowerShell 中输入:
claude
2. 按回车后,Claude Code 会启动。
首次启动时,Claude Code 会显示一个安全提示,问你是否信任当前文件夹:
Quick safety check: Is this a project you created or one you trust?
> 1. Yes, I trust this folder
2. No, exit
用方向键选择 1. Yes, I trust this folder,然后按回车。
📸 截图示例:首次启动时的信任文件夹提示
接下来 Claude Code 会检测到你配置的 API Key,显示以下提示:
ANTHROPIC_AUTH_TOKEN: sk-ant-...(你的密钥)
Do you want to use this API key?
> 1. Yes
2. No (recommended)
⚠️ 注意:默认选中的是第2个 No,但我们要选第1个 Yes! 用方向键 ↑ 切换到1. Yes,然后按回车。
如果不小心选了 No,不用慌,退出后重新执行第4步的 4.2(写入配置文件的那条命令),然后再输入 claude 启动即可。
📸 截图示例:确认使用 API Key 的提示(注意要选 Yes)
如果你看到 Claude 的欢迎界面(显示版本号和 API Usage Billing),说明已经连接成功了。
试着输入一句话测试:
你好
如果 Claude 回复了你,恭喜!Claude Code 命令行工具安装配置全部完成 🎉
输入以下命令退出 Claude:
/exit
• 如果提示 Not logged in · Please run /login:说明你在上一步不小心选了 No。先输入 /exit 退出 Claude,然后在 PowerShell 中重新执行第4步的 4.2(Set-Content 那条命令),再输入 claude 重新启动即可
• 如果提示 Unable to connect to Anthropic services:说明第4步的 .claude.json 配置文件没有写入成功,回到第4步的 4.2 重新执行
• 如果提示 API Key 相关的错误,回到第4步检查 ANTHROPIC_AUTH_TOKEN 是否配置正确
• 如果提示网络错误或连接失败,回到第4步检查 ANTHROPIC_BASE_URL 是否配置正确(应该是 https://api.ctok.ai)
• 如果提示 not recognized,回到第3步重新安装
Obsidian 是一款笔记软件,也是我们课程中使用的知识库工具。这一步教你怎么在 Obsidian 里面使用 Claude。
1. 打开浏览器,访问 Obsidian 官网:https://obsidian.md
2. 点击 "Download" 下载 Windows 版本
3. 双击下载的 .exe 文件,按提示完成安装
4. 在开始菜单中搜索 "Obsidian",打开它
1. 打开 Obsidian
2. 如果是第一次使用,选择 "Create new vault"(创建新仓库),给它起个名字,比如 我的AI知识库
3. 如果你已经有知识库,选择 "Open folder as vault"(打开文件夹作为仓库)
1. 点击 Obsidian 左下角的 设置图标(齿轮 ⚙️)
2. 在左侧菜单中选择 "Community plugins"(第三方插件/社区插件)
3. 如果看到 "Restricted mode"(安全模式/受限模式) 的提示,点击 "Turn on community plugins"(开启社区插件),然后在弹窗中点确认
💡 这一步只需要做一次,以后不用再开。
Claudian 是一个开源的 Obsidian 插件,它把 Claude Code 嵌入到 Obsidian 里面,让你可以在笔记软件中直接跟 AI 对话、读写文件、管理知识库。
我们直接让 Claude 帮你安装这个插件。
操作步骤:
1. 打开 PowerShell,启动 Claude(如果第5步退出了,重新输入 claude 启动)
2. 复制下面这段话,粘贴给 Claude,按回车:
帮我安装 Obsidian 的 Claudian 插件。
步骤:
1. 找到我的 Obsidian 知识库
2. 去 https://github.com/YishenTu/claudian/releases/latest 下载 main.js、manifest.json、styles.css 这三个文件
3. 在知识库的 .obsidian/plugins/claudian/ 文件夹里放这三个文件
如果有多个知识库,每个都装上。
3. Claude 执行过程中会弹出确认提示,一路选 Yes 即可。完成后输入 /exit 退出。
启用插件:
1. 回到 Obsidian
2. 打开 设置 → Community plugins(第三方插件/社区插件)
3. 点击右上角的 刷新按钮(🔄),刷新插件列表
4. 在列表中找到 "Claudian",打开右边的开关启用它
配置插件(重要!):
1. 在 Obsidian 设置中,找到左侧菜单的 "Claudian"(在 Community plugins 下面)
2. 在 "自定义变量" 或 "环境" 区域,输入以下两行:
ANTHROPIC_AUTH_TOKEN="你的API密钥"
ANTHROPIC_BASE_URL="https://api.ctok.ai"
把你的API密钥替换成大龙私信给你的密钥(和第4步配置的是同一个密钥)
3. 点击保存或关闭设置
启用插件后,你会在 Obsidian 左侧边栏看到一个 Claudian 的图标。点击它,会打开一个聊天侧边栏。
在对话框中输入:
你好
如果 Claude 正常回复了,说明 Obsidian + Claudian 插件配置成功 ✅
Q:提示 "Claude CLI not found" 或 "spawn claude ENOENT"?
说明插件找不到你在第3步安装的 Claude Code。解决方法:
1. 先在 PowerShell 中输入 where.exe claude,记下显示的路径(比如 C:\Users\你的用户名\AppData\Local\Claude\claude.exe)
2. 在 Obsidian 中打开 设置 → Claudian → Advanced(高级)
3. 在 "Claude CLI path" 中填入刚才记下的路径
⚠️ 注意:不要使用.cmd结尾的路径,使用.exe或cli.js的路径。
Q:Claude 没有回复或报错?
• 检查第4步的环境变量是否配置正确
• 尝试重启 Obsidian
提前联系大龙,上课当天早点到,现场帮你装。
如果你走到了这里,说明你已经成功安装了 Claude Code。现在你可以:
• 在 PowerShell 里直接跟 Claude 对话(输入 claude 启动)
• 在 Obsidian 里用 Claude 帮你管理知识库、整理笔记、生成内容
💡 日常使用提醒:因为我们使用了国内中转服务器,日常使用 Claude 不需要翻墙,直接打开就能用。
如果安装过程中遇到任何问题,或者有任何疑问,欢迎随时联系我。
扫描下方二维码添加微信