从零搭建你的终端 AI 编程助手
← 返回首页Claude Code 是 Anthropic 推出的命令行 AI 编程工具。它运行在终端里，能读懂你的项目代码，直接帮你改文件、跑命令、排查问题——不需要切到浏览器，也不需要装 IDE 插件。
这篇指南覆盖 Windows 和 macOS / Linux 两种平台，从安装到配置模型，一步一步来。
macOS 和 Linux 自带 Unix 终端，这一步直接跳过，看第二步。
Claude Code 的命令行工具基于 Unix 环境开发。Windows 自带的 cmd 和 PowerShell 用的是另一套命令语法，直接跑会出错。装上 Git for Windows 之后，你的电脑就有了一个兼容的 Bash 环境，后续安装才能正常进行。
安装过程：下载 → 双击运行 → 一路 Next → Finish。所有设置保持默认就行。
不确定自己电脑是什么架构？右键"此电脑" → "属性"，看"系统类型"一栏：显示"64 位"选 64-bit，显示"ARM"选 ARM64。需要 32 位版本请去 Git 官网。
打开终端，复制下面一行命令，回车，等它自己跑完。
打开 PowerShell（不需要管理员权限），粘贴运行：
备用官方原版：irm https://claude.ai/install.ps1 | iex（需科学上网）
打开 终端，粘贴运行：
备用官方原版：curl -fsSL https://claude.ai/install.sh | sh（需科学上网）
脚本会从 Google 服务器拉取 200MB+ 的安装包。下载速度看网络，快则两分钟，慢则十几分钟。卡住了也别关窗口，让它继续跑就行。
安装完成不代表立即可用，你的系统得知道 claude 这个程序藏在哪。
1. 开始菜单搜索 "环境变量" → 点击 "编辑系统环境变量"
2. 窗口右下角点 "环境变量"
3. 在系统变量列表里找到 Path，双击它
4. 点击 "新建"，把下面这个路径粘贴进去：
记得替换"你的用户名"。不确定的话，打开 C:\Users\ 看一眼目录名就知道了。
5. 全部点"确定"保存，关掉终端重新打开，输入 claude --version 验证。
macOS 和 Linux 的安装脚本通常会自己把 PATH 写上。你可以先验证：关掉当前终端，新开一个，输 claude --version。有版本号输出就说明 OK，跳过这一步。
如果提示 "command not found"，说明没自动配上，手动加一行：
加到 ~/.zshrc（macOS）或 ~/.bashrc（Linux），然后 source ~/.zshrc 让它生效。
程序就位了，但它现在还不会工作——大模型才是 Claude Code 的大脑。你有两条路可以选。
直接终端里输入 claude，首次运行会自动弹浏览器让你登录 Anthropic 账号。登完回终端就能用。前提是你的网络能直连 Anthropic 服务。
cc-switch 是一个开源小工具，它的作用是把 Claude Code 的后端模型切换成你自己买的 API——比如智谱 GLM、DeepSeek、MiniMax、Kimi 等等。不用科学上网，按用量付费，性价比更高。
新版本发布时请关注 GitHub Releases 获取更新。
1. 打开 cc-switch → 点击 "添加渠道"
2. 选平台（比如 DeepSeek）→ 填入你在该平台申请的 API Key
3. 填模型名称（如 deepseek-chat 或 glm-4-plus）
4. 点 "启用" 让渠道生效
5. 终端输入 claude，现在它背后跑的就是你刚配的模型了
会启动只是第一步。下面这些技巧能让你的效率翻倍，少踩坑。
Claude Code 是按目录工作的——你在哪个目录启动它，它就能看到那个目录下的所有文件。所以养成习惯：先 cd 到项目根目录，再输入 claude。
快捷操作：Windows 在文件夹地址栏直接敲 cmd 回车就能在当前目录打开终端；macOS 可以把文件夹直接拖进终端图标，路径自动填好。
在项目根目录放一个 CLAUDE.md 文件，Claude Code 每次启动都会自动读它。你可以在这里告诉它：
• 这个项目是干嘛的
• 用了什么技术栈、什么版本
• 代码风格有什么讲究
• 哪些文件/目录不要碰
• 测试用什么命令跑
这个文件写得越具体，AI 给出的建议就越贴切。很多老用户觉得这是 Claude Code 最被低估的功能——花 10 分钟认真写一份 CLAUDE.md，后面每次对话都能受益。
不知道怎么写？在项目目录启动 claude 后输入 /init，它会自动扫描项目结构帮你生成一份初稿。
Claude Code 有能力改文件、执行命令，这意味着你得知道怎么控制它。几个实用设置：
• /permissions — 打开权限面板，可以细粒度控制允许哪些操作（读文件、写文件、跑命令等），按需调整安全级别。
• 不想每次都弹出确认窗口？在项目目录的 .claude/settings.json 里配置 allow 规则，比如允许 npm test、允许读 src 目录。
• 对于你不确定的操作，保持"需要确认"模式；对于日常高频的只读操作（比如 git status），可以放心放开。
• /resume — 接上之前的对话。它会列出当前目录下所有历史会话，选一个就能无缝继续。
• /context — 查看当前上下文窗口用了多少。快到上限的时候 Claude Code 会预警，你也可以主动检查。
• /compact — 手动触发压缩。它会保留当前任务的进展状态，把前面冗长的对话精简掉。频繁压缩会让早期细节模糊，但总比直接截断好。
建议：做完一个子任务就主动 compact 一次，比等它自动压缩更可控。
• /review — 让 AI 审查你当前的代码变更，给出 PR 级别的 review 意见。
• /init — 扫描当前项目，生成 CLAUDE.md 项目说明书。
• /memory — 打开 Claude Code 的持久化记忆。存一些关于你个人的偏好，之后每次对话都会自动加载。
• /doctor — 排查 Claude Code 本身的安装或配置问题。
• /add-dir — 把外部目录加进当前工作区，让 AI 能同时看到多个项目。
1. 需求说清楚，别太笼统。 与其说"帮我改一下登录"，不如说"在 login.ts 里，当用户输入错误密码时，加一个 3 次失败后锁定 30 秒的逻辑"。信息给得越具体，AI 越不需要来回追问。
2. 善用截图。 Claude Code 支持你把截图拖进终端（或粘贴图片路径），它能看懂图片内容。UI 布局有问题？截图让它分析，比纯文字描述快得多。
3. 小步快跑。 别一次让它改 10 个文件。一个功能拆成几个小步骤，每次改完跑一下测试确认没问题，再继续下一步。返工率低很多。
4. 先 Plan 后执行。 复杂任务可以让它"先写一个计划给我看看，确认了再动手"。在 CLAUDE.md 里配置好这个偏好，它会自动这样做。