Claude Code 接入指南 & 详细指令教程
在开始之前，请先安装并验证以下基础环境：
- Node.js（含
npm），推荐v18+：https://nodejs.org/ - Git（建议
v2.40+）：https://git-scm.com/
验证安装是否成功：
bash
node -v
npm -v
git --version第一步：安装 Claude Code
bash
# windows 建议在 管理员权限PowerShell 里使用
npm install -g @anthropic-ai/claude-code
# 查看版本 验证安装成功
claude --version第二步：使用cc switch配置claude code
请前往 cc_switch 查看详细配置说明。
cc switch优点
可以切换其他模型！
图像化配置，无需手动设置环境变量！
传统方法永久配置（不推荐，因为cc switch更方便）
windows下可以直接手动设置环境变量
配置好之后需要重启电脑！
启动 Claude Code
终端直接输入claude 启动 Claude code
bash
claudeClaude Code 命令使用指南
一、基础命令
1. 启动与认证
- 安装：
npm install -g @anthropic-ai/claude-code - 启动交互模式：
claude - 带初始提示启动：
claude "解释这个项目" - 非交互模式（单次查询）：
claude -p "分析这个函数" - 认证：首次启动会提示 OAuth 认证，需有效 Anthropic 账户。
2. 项目初始化
- 生成项目说明文件：
/init（创建CLAUDE.md，记录项目规范、常用命令等）。
二、斜杠命令（Slash Commands）
| 命令 | 功能 | 示例 |
|---|---|---|
/help | 查看帮助文档 | /help |
/clear | 清除当前会话历史 | /clear |
/compact | 压缩对话内容以节省 Token | /compact |
/cost | 查看当前会话 Token 消耗 | /cost |
/bug | 上报问题给 Anthropic | /bug 遇到权限错误 |
/review | 请求代码审查 | /review src/utils/logger.ts |
/model | 切换模型（如 Sonnet/Opus） | /model opus |
/test | 运行测试套件 | /test auth |
/init | 生成项目配置文件 | /init |
/memory | 编辑记忆文件 | /memory |
/vim | 启用 Vim 模式编辑 | /vim |
/permissions | 管理权限设置 | /permissions allow "Bash(git:*)" |
三、文件操作命令
1. 编辑与查看
- 读取文件：直接在对话中提及文件路径，如
"查看 src/config.js" - 编辑文件：
"修改 package.json 添加新依赖" - 批量操作：
"重构所有 .ts 文件中的类型定义"
2. 项目管理
- 创建文件：
"创建 utils/helper.js 工具函数" - 重命名/移动：
"将 old-name.js 重命名为 new-name.js" - 删除清理：
"删除未使用的依赖和文件"
四、高级功能
1. MCP（Model Context Protocol）服务器
- 添加文件系统服务器：
claude mcp add filesystem -- /path/to/server - 管理服务器：
claude mcp list（查看配置）
2. IDE 集成与插件
- VS Code 扩展：支持直接在编辑器中调用 Claude Code
- 终端增强：可配置自定义快捷键和别名
- Git 钩子：自动化提交信息生成和代码检查
五、权限与安全
权限层级
- 只读操作（自动批准）：查看文件、分析代码
- 命令执行（需逐次批准）：如 Bash 命令、安装依赖
- 文件修改（每次会话需批准）：编辑、创建、删除文件
危险命令拦截
- 默认禁止：
curl、wget、sudo、rm -rf等高危命令 - 白名单模式：可通过
/permissions配置允许的操作类型
安全最佳实践
- 定期检查
/cost避免意外高消耗 - 使用
/compact清理敏感信息 - 在生产环境避免
--dangerously-skip-permissions参数
六、实用技巧
1. 成本控制
- 压缩对话：使用
/compact压缩上下文 - 精确指令：明确文件路径（如
"修复 src/utils/logger.ts"）减少 Token 消耗 - 分步执行：复杂任务分解为多个小步骤
2. 提高效率
- 项目模板：使用
/init建立项目规范和常用命令 - 批处理：
"批量更新所有组件的 TypeScript 类型" - 自动化 Git：
claude commit自动生成符合规范的提交信息
3. 中文支持
- 设置中文输出：
/claude config set language zh-CN（Beta 功能） - 中英混合：支持中文指令操作英文代码库
七、典型工作流示例
1. 新项目启动
bash
cd my-new-project
claude "/init" # 生成项目指南
claude "分析项目结构并创建开发规范"2. 日常开发
bash
claude "实现用户认证功能"
claude "添加单元测试"
claude "/review" # 代码审查
claude commit # 自动提交3. 调试与优化
bash
claude "分析这个性能问题" # 粘贴日志或截图
claude "优化数据库查询"
claude "/test" # 运行测试验证4. 重构与维护
bash
claude "重构这个组件以提高复用性"
claude "更新依赖包并修复兼容性问题"
claude "生成 API 文档"八、常见问题与故障排除
1. 权限问题
- 现象：命令执行被阻止
- 解决：使用
/permissions allow或检查系统权限
2. Token 消耗过快
- 现象：对话很快达到上下文限制
- 解决：定期使用
/compact或/clear清理上下文
3. 模型响应慢
- 现象：等待时间过长
- 解决：切换到更快的模型
/model sonnet
4. 认证失效
- 现象：API 调用失败
- 解决：重新运行认证流程或检查环境变量
5. Claude Code might not be available in your country.
- 现象：显示下面提示
╭──────────────────────────╮
│ ✻ Welcome to Claude Code │
╰──────────────────────────╯
Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST
Please check your internet connection and network settings.
Note: Claude Code might not be available in your country. Check supported countries at
https://anthropic.com/supported-countries
PS C:\Users\claudecode>方法1：开全局梯子，换欧美、日本节点。
方法2：参考《windows设置Claude code使用代理+别名启动+给予完全权限》 https://blog.csdn.net/weixin_41967600/article/details/150566971
完整文档参考
- 官方文档：https://docs.anthropic.com/zh-CN/docs/claude-code/overview
- GitHub 仓库：https://github.com/anthropics/claude-code
- 社区讨论：https://github.com/anthropics/claude-code/discussions
- 问题反馈：https://github.com/anthropics/claude-code/issues
💡 提示：Claude Code 持续更新中，建议定期运行
claude update获取最新功能和安全补丁。