快速上手
5 分钟学会 Claude Code 的核心用法
需要 API Key？ 前往注册 →端点与 Base URL →
本页目录
⚡ 还没接入？一条命令完成全部配置：
curl -fsSL https://qcode.cc/install/claude-code.sh | bash（Windows：irm https://qcode.cc/install/claude-code.ps1 | iex）。详见 一键配置脚本。还没有 Key？先 选方案并拿 Key：任何方案的 Key 用法都一样，下面的步骤不受影响。
完成安装和环境变量配置后，让我们用 5 分钟掌握 Claude Code 的核心用法。
启动 Claude Code¶
在终端中进入你的项目目录，然后运行：
cd /path/to/your/project
claude
你会看到 Claude Code 的交互界面，现在可以开始对话了。
核心交互方式¶
1. 理解代码¶
> 这个项目的架构是怎样的？
> 解释一下 src/auth/login.ts 的工作原理
> 找出所有调用数据库的地方
2. 生成代码¶
> 写一个用户注册的 API 端点
> 为 UserService 类添加单元测试
> 创建一个 React 登录表单组件
3. 编辑现有代码¶
> 重构 utils.js，提高代码可读性
> 修复 handleSubmit 函数中的内存泄漏
> 给所有公共函数添加 TypeScript 类型
4. 调试问题¶
> 为什么用户登录后会被重定向到 404？
> 分析这个报错：TypeError: Cannot read property 'id' of undefined
> 检查 API 响应慢的原因
5. Git 操作¶
> 查看我修改了哪些文件
> 帮我提交这些更改，写一个好的 commit message
> 创建一个 PR 描述
使用 @ 引用文件¶
使用 @ 符号可以精确引用特定文件，让 Claude 直接读取内容：
> 查看 @src/components/Header.tsx 并优化性能
> 对比 @src/v1/api.js 和 @src/v2/api.js 的区别
> 根据 @package.json 分析项目依赖
技巧：输入 @ 后按 Tab 键可以自动补全文件路径。
管道输入¶
可以将其他命令的输出传递给 Claude Code 进行分析：
# 解释 git 变更
git diff | claude "解释这些代码更改"
# 分析日志错误
cat error.log | claude "分析这些错误并提供解决方案"
# 审查 PR 变更
gh pr diff 123 | claude "审查这个 PR 的代码质量"
常用斜杠命令¶
在会话中使用 / 开头的命令：
| 命令 | 说明 |
|---|---|
/help |
显示帮助信息和所有可用命令 |
/clear |
清空当前对话历史 |
/compact |
压缩对话历史以节省 token |
/model |
查看或切换模型（如 opus、sonnet） |
/memory |
编辑项目记忆文件 CLAUDE.md |
/init |
自动生成项目配置文件 |
| 直接说「提交这些更改」 | 让 Claude 查看改动、生成 commit message 并提交（/commit 需要自己或插件提供的自定义命令或技能，不是内置命令） |
/review |
代码审查 |
/cost |
查看当前会话费用和 token 用量 |
/doctor |
诊断配置问题 |
/config |
打开设置配置 |
/mcp |
管理 MCP 服务器连接 |
/loop |
自主循环执行任务 |
/bug |
报告问题 |
键盘快捷键¶
| 快捷键 | 功能 |
|---|---|
Tab |
自动补全文件路径 |
Esc |
中断当前输出 |
Ctrl+C |
取消当前操作 |
↑ / ↓ |
浏览历史命令 |
初始化项目配置¶
首次使用时，运行 /init 让 Claude 自动分析项目并生成配置：
> /init
这会创建 CLAUDE.md 文件，包含：
-
项目技术栈和架构说明
-
常用构建和测试命令
-
代码风格规范
-
项目特定的约定
CLAUDE.md 的作用：每次启动 Claude Code 时会自动读取这个文件，让 AI 更好地理解你的项目上下文。
实战示例¶
示例 1：添加新功能¶
> 我需要添加一个用户头像上传功能，要求：
1. 支持 JPG/PNG 格式
2. 图片大小限制 2MB
3. 上传后自动裁剪为 200x200
4. 存储到 S3
示例 2：修复 Bug¶
> 用户反馈：点击"保存"按钮后页面卡住
> 请帮我排查 @src/pages/EditProfile.tsx 中的问题
示例 3：代码审查¶
> /review
> 重点关注安全性问题和性能瓶颈
示例 4：智能提交¶
> 帮我提交这些更改，并写好 commit message
Claude 会自动：
-
分析所有变更
-
生成规范的 commit message
-
完成提交
高效使用技巧¶
-
明确意图：描述清楚你想要什么，包括约束条件
-
分步执行：复杂任务拆分成小步骤
-
及时中断：输出不符合预期时立即按
Esc -
善用引用：用
@指定文件避免 AI 猜测 -
保持上下文：同一会话中 Claude 会记住之前的对话
关键配置项说明¶
快速上手只需要记住四个位置，其余按需再看：
| 配置 | 作用 | 位置 |
|---|---|---|
ANTHROPIC_BASE_URL |
指向 QCode，填 https://api.qcode.cc/api（大陆可用 https://asia.qcode.cc/api），末尾不带斜杠 |
环境变量，或 ~/.claude/settings.json 的 env 块 |
ANTHROPIC_AUTH_TOKEN |
你的 cr_ 开头的 QCode 密钥 |
同上 |
/model |
在会话里查看、切换模型，如 claude-sonnet-5 |
会话内命令 |
CLAUDE.md |
项目说明，每次启动自动读取 | 项目根目录，由 /init 生成 |
会话管理：几条官方命令¶
截至 2026-10-15，据 Claude Code 官方文档：
/usage显示会话费用和用量，/cost是它的别名；claude --continue接着当前目录最近一次会话，claude --resume列出会话供你选择，会话内也可用/resume；- 想先看方案、不让它改文件，按
Shift+Tab循环切换权限模式，状态栏出现⏸ plan mode on即进入计划模式，批准计划前不会有编辑。
常见报错与排查¶
| 现象 | 常见原因 | 处理 |
|---|---|---|
401 / Invalid API key |
密钥错、带空格，或环境里残留旧的 ANTHROPIC_API_KEY 抢了认证 |
env \| grep -i anthropic 查残留变量，清掉后重开终端 |
402 / insufficient_quota |
额度用完（日额度、总额度或周限额），Key 本身没问题 | 看响应里的 code：日额度北京时间 0 点重置，可买加油包；详见 错误码参考 |
| 404 | Base URL 多写了 /v1 或末尾带了斜杠 |
改回 https://api.qcode.cc/api |
model_not_available_on_endpoint |
在 Claude Code 里选了 GPT 型号 | Claude Code 走 Anthropic 接口，只能用 Claude 系与国产模型；GPT 请用 Codex |
回复变慢、报 E015 / 429 |
对话太长，上下文接近上限 | 先 /compact，不行就重启会话，详见 上下文管理 |
| 完全连不上 | 网络或系统代理变量干扰 | 换 asia.qcode.cc，再看 故障排查 第 6 条 |
不确定问题出在哪一层时，先按 接入点与 API 格式 第 5 节用 curl 打一遍：返回 400 或 401 说明路径是通的。
常见问题¶
装好之后怎么确认请求真的走了 QCode？¶
在 probe.qcode.cc 输入你的 API Key，能看到刚才请求的模型和 token；看不到就说明请求没有到达 QCode，回头检查环境变量。
在哪里看这次花了多少？¶
会话内用 /usage（或 /cost）看当前会话的用量；账户层面的消耗以 QCode 控制台为准，QCode 按 token 计费，各模型单价见 qcode.cc/models。
关掉终端后，上次的对话还能接着聊吗？¶
可以。在同一项目目录运行 claude --continue 接上最近一次会话，或用 claude --resume 从列表里选。
第一次用，该选哪个模型？¶
日常编码先用 claude-sonnet-5，复杂任务再用 /model 切到更强的型号；对比见 模型选择。
想用 GPT 或国产模型怎么办？¶
Claude Code 本身走 Anthropic 接口，国产模型可以直接选；GPT 系请用 Codex CLI，配置见 Codex 完整教程。
下一步¶
恭喜你已经掌握了 Claude Code 的核心用法！接下来：
开始使用 QCode
一把 API Key 同时用于 Claude Code、Codex 等工具；按 token 计费，各模型单价见 qcode.cc/models