启动 Claude Code：按这 4 步走
开始前：先完成上面的准备事项：安装 CC Switch → 创建 API Key → 导入到 CCS。完成后，再按下面步骤启动 Claude Code。
- 打开终端。
- 复制 Claude Code 官方安装命令，粘贴到终端，按回车。
- 进入你想让 AI 帮忙的项目文件夹。
- 运行启动命令，复制本页第一个任务模板测试。
第一步：终端是什么？
终端就是电脑里的“命令输入框”。本页命令不是让你写代码，只是把官方安装器或启动指令复制进去。
macOS
按 Command + 空格，输入「终端」或 Terminal，回车打开。
Windows
普通方式：按 Windows 键，搜索「PowerShell」或「终端 / Windows Terminal」，回车打开。
如果教程要求 WSL2：打开「Ubuntu」这个应用，再在里面复制命令。不会区分的话，先按普通方式尝试；不行再切换 WSL2。
第二步：安装 Claude Code
官方现在推荐安装脚本或系统安装器，NPM 安装已经标注为 Deprecated（不推荐）。
macOS / Linux 官方推荐
curl -fsSL https://claude.ai/install.sh | bash
macOS / Linux：Homebrew 方式
brew install --cask claude-code
Windows PowerShell 官方推荐
irm https://claude.ai/install.ps1 | iex
Windows：WinGet 方式
winget install Anthropic.ClaudeCode
不要优先用 npm install
官方 README 已经写明 NPM 安装方式 Deprecated。除非你知道自己在做什么，否则优先使用上面的官方安装脚本。
官方 README 已经写明 NPM 安装方式 Deprecated。除非你知道自己在做什么，否则优先使用上面的官方安装脚本。
不要下载 Source code.zip
GitHub 的 Source code 是源码，不是给小白直接双击安装的软件。
GitHub 的 Source code 是源码，不是给小白直接双击安装的软件。
第三步：接入 fululai API
Claude Code 接入 fululai 本质上就是让它知道：API Key、服务地址、模型名。
方式 A：推荐用 CC Switch
- 在 fululai API Key 页面点击「导入到 CCS」。
- 打开 CC Switch，确认 fululai 供应商已导入。
- 选择/激活 fululai。
- 关闭当前终端，重新打开，再输入
claude。
方式 B：高级用户手动环境变量
如果你的 fululai Claude Code 兼容入口要求手动配置，可把下面命令里的 sk-你的Key 换成自己的 Key。不同终端/系统保存方式不同，新手优先用 CC Switch。
export ANTHROPIC_BASE_URL="https://api.fululai.cn"
export ANTHROPIC_API_KEY="sk-你的Key"
export ANTHROPIC_MODEL="claude-sonnet-4-6"
claude
说明：Claude Code 走的是 Anthropic 风格配置，和很多 OpenAI 兼容工具不完全一样。如果手动方式不生效，优先回到 CC Switch 或回到 CC Switch 检查当前激活的供应商。
安全提醒：API Key 不要发群里、不要截图外泄。页面里的
sk-你的Key 只是占位符。第四步：打开项目文件夹并启动 Claude Code
Claude Code 最适合在“项目文件夹”里运行。比如你有一个网站项目，就先进入那个文件夹。
项目文件夹是什么？
就是放代码/网页/配置文件的文件夹。Claude Code 会读取这个文件夹里的内容，帮你理解和修改。
就是放代码/网页/配置文件的文件夹。Claude Code 会读取这个文件夹里的内容，帮你理解和修改。
如果你已经在项目文件夹里
claude
如果你还不知道怎么进入文件夹
可以先把项目文件夹拖进终端窗口，终端会自动出现路径。也可以先把项目放到桌面，按示例路径尝试。
cd 你的项目文件夹路径
claude
第五步：复制第一个任务模板测试
第一次不要让它直接大改代码，先让它只分析：
请先不要修改任何文件。请用小白能听懂的话检查当前项目结构，告诉我：1）这个项目可能是做什么的；2）主要文件夹分别是什么；3）如果我要做一个小改动，应该先从哪里开始。
通过标准：如果它能说清楚项目结构，说明安装、启动和模型连接基本正常。之后再让它修 Bug、改页面、写功能。
常见问题：看到这些不要慌
| 问题/报错 | 是什么意思 | 怎么解决 |
|---|---|---|
| claude: command not found | Claude Code 没装好，或终端没刷新。 | 关闭终端重新打开；仍不行就重新运行安装命令。 |
| 401 / Unauthorized | API Key 不对、没填或复制多了空格。 | 回 fululai 控制台重新复制 Key，再导入/配置。 |
| 余额不足 | fululai 账号没有可用余额。 | 去充值页小额充值后再试。 |
| model not found | 模型名不匹配。 | 先用 claude-sonnet-4-6 或 CC Switch 推荐模型测试。 |
| 连接失败 / timeout | 网络、代理或 Base URL 配置问题。 | 确认 CC Switch 已激活 fululai；手动配置时确认地址没有写错。 |
| 一直让登录 Claude | 它可能还在走官方账号登录流程，没有读取 fululai 配置。 | 重启终端，检查 CC Switch 是否激活；必要时重新导入 CCS 并重启终端。 |
| 它要修改文件，我怕出错 | Claude Code 可以改文件，所以第一次要限制它。 | 先用“不要修改任何文件，只分析”的任务模板。 |