Claude Code · 保姆级安装
给「电脑小白 / AI 新手」的保姆级引导

Claude Code
装进你
自己的电脑

不用懂编程。跟着下面三步,复制 → 粘贴 → 回车,你就能拥有一个住在电脑里、能帮你动手干活的 AI 助手。

开源仓库 github.com/EricArcha/claude-code-oneclick
CC
Why Claude Code

为什么是 Claude Code

01

它能直接动手

网页版 AI 只能聊天,你得来回复制粘贴。Claude Code 直接读写你电脑里的文件、帮你跑命令。

02

它会自己干多步

不是一问一答,而是能连续完成一整件任务的「智能体」:自己查、自己改、自己验证。

03

它可换、可扩展

后台 API 随你换,还能装联网搜索、飞书等插件。比封闭的网页产品自由得多。

「网页 AI 像隔着玻璃指挥;Claude Code 是请进门,帮你动手。」

Before you start · 30 秒预备课

先学会「打开终端」

下面每一步,都是把一行命令复制进一个叫「终端」的小窗口、再按回车。终端就是让你用文字给电脑下指令的地方——它不会咬人,照着做就行。先按你的系统把它打开:

macOS —— 叫「终端 / Terminal」

按住 ⌘ Command 再按 空格,弹出搜索框,输入「终端」或「terminal」,回车。一个小窗口就打开了。

Windows —— 用「PowerShell」

按键盘左下角 ⊞ Win 键(窗户图标),直接输入「powershell」,点出现的「Windows PowerShell」打开即可。

怎么运行命令?点命令框右上角「复制」→ 切到终端窗口粘贴(按 ⌘ V)→ 按 回车。就这么简单。
怎么运行命令?点命令框右上角「复制」→ 切到 PowerShell 窗口粘贴(点右键,或按 Ctrl V)→ 按 回车。就这么简单。
?
听过 cmd(命令提示符)吗?它也是个命令窗口,但本引导的命令请统一用 PowerShell,更顺、更少坑。
Step 0 · Health check

先做个「体检」 推荐先跑

一条命令,看看你的电脑已装好哪些、还差哪些。已完成的步骤可直接跳过。

终端 · macOS
三步全部完成时,体检会送你一个小彩蛋 🎉
Your progress

核心进度:0 / 3

0 / 3
1

安装最新版 Claude Code

一行命令搞定。原生安装版以后会自动更新,无需手动升级。

终端 · macOS
装完后关闭并重新打开终端,输入 claude --version 能看到版本号就成功了。
装不上?点这里看备选方案(需要 Node.js 18+)
终端 · npm
2

配置你自己的 API

选服务商还是自定义?脚本会列出常见服务商列表,一键选好只输 Key —— 地址和模型名自动填完。

终端 · macOS
脚本会把地址、模型名和密钥安全写进 ~/.claude/settings.json,不动你其他设置;密钥不回显。想换服务商?再运行一次就行。
3

给它装上「联网搜索」

让 Claude Code 能查最新资料。两家免费服务,配一个或都配都行。

终端 · macOS

Tavily —— 实时网页检索

适合「查最新 / 找事实」。免费每月 1000 次、免信用卡。

注册 app.tavily.com →

Exa —— 语义搜索

按「意思」找相似内容与研究资料,适合「做研究」。新号送 $10 额度。

注册 dashboard.exa.ai →
!
官网打不开拿不到 Key?别卡在这——先跳过,本地备份说明在 docs/tavily.mddocs/exa.md,回头再配。

YOU ARE A
CC GENIUS!

三步全部完成,你的 Claude Code 已经满血上线。打开终端输入 claude,开始你的第一段对话吧!

Optional · Power-ups

可选 · 进阶增强

4
可选

安装飞书 CLI

把飞书的文档、表格、日历等接进 Claude Code,优化工作流。需要 Node.js。

终端 · macOS
5
可选 · 进阶

安装 cc-switch

一个图形界面 App,方便在多个后台 API 间一键切换、统一管理插件。

终端 · macOS