Claude Code 教程：从安装到第一次会话

一句话答案：安装 Claude Code → 设两个环境变量（ANTHROPIC_BASE_URL + ANTHROPIC_API_KEY）→ 终端输入 claude → /init 生成 CLAUDE.md → 在计划模式下确认改动 → 让它跑测试。全程分钟级。

这篇教程带你走完第一次会话。我们用的是 Claude 无限卡：拿到卡密后在兑换页换成 API Key，再通过 CC Switch 一键导入，或直接用环境变量配置。

第一步：安装 Claude Code

Claude Code 支持 macOS、Linux 与 Windows（PowerShell 或 Git Bash），推荐用官方一键脚本，不依赖 Node.js：

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

装完后输入 claude --version 确认能识别命令；Windows 提示找不到命令就关掉终端重新打开，让 PATH 生效。

第二步：拿到 API Key 并接入

Claude 无限卡的流程是「发卡站买卡密 → 兑换页换额度与 Key → 配置工具接入」。拿到 Key 后设两个环境变量：

export ANTHROPIC_BASE_URL=https://你的网关地址
export ANTHROPIC_API_KEY=你的_Key

结论先行：ANTHROPIC_BASE_URL 填网关根地址，不要加 /v1。SDK 会自己拼接 /v1/messages，多加一层会 404。OpenAI 兼容端点（Cursor、Cline 等）才需要带 /v1。

推荐用 CC Switch 一键导入（使用教程 有完整步骤）：复制兑换页的一键导入链接，在 CC Switch 里点导入，自动填好 Base URL、Key 与推荐模型。

第三步：生成 CLAUDE.md

进入项目目录启动会话：

cd 你的项目
claude
/init

/init 会扫描仓库并起草 CLAUDE.md：怎么构建、怎么测试、代码约定、哪些文件不能动。这个文件会被每次会话自动带上，相当于项目的系统提示词。生成后花一分钟检查，把错误的命令或约定改掉，比后面反复纠正省事。

第四步：在计划模式下确认改动

第一次让它动手前，按 Shift+Tab 切到计划模式（Plan Mode），描述你的任务。它会先调查、给出方案，等你确认后才动手。确认后它会改文件、跑命令，你可以随时打断。

第五步：让它跑测试与验证

改动完成后直接说「跑一下测试」「跑构建」，它会执行命令并把结果读回来。如果失败，它会根据报错继续修，直到通过或问你怎么办。

环境变量冲突的坑

最常见的「明明填对了却连不上」：旧的 ANTHROPIC_BASE_URL 或 ANTHROPIC_API_KEY 还在系统环境变量里，新值没生效。排查顺序：新开一个终端 → echo $ANTHROPIC_BASE_URL 看是不是旧值 → 检查 ~/.zshrc、~/.bashrc、PowerShell 配置文件里有没有残留。Windows 上「用户环境变量」和「系统环境变量」是两处，都要看。

常见问题

提示找不到 claude 命令？

重开终端让 PATH 生效；仍不行就运行 npm config get prefix（npm 安装时）把输出目录下的 bin 加进 PATH，或改用一键脚本。

第一次启动卡住？

多是网络问题。确认能访问网关域名，公司网络或代理先放行。

/init 生成的 CLAUDE.md 不对怎么办？

直接编辑它，改成你项目的真实构建、测试命令与约定。它就是一个普通 markdown 文件。

配置好了但报 401？

Key 错了或没生效。重新从兑换页复制 Key，确认环境变量里是新值，再重启 Claude Code。

相关阅读

• 使用教程：五步从卡密到跑起来，含 CC Switch 一键导入
• 接入与模型：Claude Code、VS Code、Cursor 的接入方式
• Claude Code 计划模式怎么用：四种权限模式的区别
• 常见问题：限速与退款规则