Claude Code 接入指南 & 详细指令教程
环境要求
- 操作系统: Windows 10/11, macOS 10.15+, Ubuntu 20.04+ 或 Debian 10+
- Node.js: v18以上版本
- Git: https://git-scm.com/downloads/
如果你遇到 Claude Code 官方验证问题过不去,
推荐改用 Qwen Code 配置 Claude 4 模型使用
Qwen Code 文档 >>> https://doc.dmxapi.cn/qwen-coder.html
安装 Node.js
Windows
bash
# 下载安装 Node.js
# 验证版本
node --version
Ubuntu/Debian
bash
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs
# 查看版本 验证安装成功
node --version
macOS
bash
sudo xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node
# 查看版本 验证安装成功
node --version
安装 Claude Code
bash
# windows 建议在 管理员权限PowerShell 里使用
npm install -g @anthropic-ai/claude-code
# 查看版本 验证安装成功
claude --version
使用说明
获取配置信息
- Auth Token: 在
www.DMXAPI.cn
令牌页面获取 (以sk-
开头) - API 地址:
https://www.dmxapi.cn
临时运行
设置 Key 和 BaseUrl
Linux命令
bash
# 设置 Key 和 BaseUrl
export ANTHROPIC_AUTH_TOKEN=sk-...
export ANTHROPIC_BASE_URL=https://www.dmxapi.cn
# 自定义模型(选用)
export ANTHROPIC_MODEL="你目标模型"
export ANTHROPIC_SMALL_FAST_MODEL="你目标模型"
# 启动 claude code
claude
Windows命令
bash
# 设置 Key 和 BaseUrl
$env:ANTHROPIC_API_KEY="sk-..."
$env:ANTHROPIC_BASE_URL="https://www.dmxapi.cn"
# 启动 claude code
claude
永久配置
windows下可以直接手动设置环境变量
启动 Claude Code
首先需要到你的项目目录
bash
cd C:\AI开发\claudecode\your-project-folder
终端直接输入claude 启动 Claude code
bash
claude
启动验证流程:
开全局梯子!
启动 Claude Code 后,系统将跳转至验证页面账号要求:需使用 Claude 官网账号登录,免费账号即可完成授权(无需付费),如无账号,请先注册免费账户。
授权步骤:登录claude官网成功后,复制系统生成的授权码,将授权码粘贴回 Claude Code 进行验证。
完成设置:验证通过后,系统将自动获取:自定义 Key 和 BaseUrl 地址。 然后就是下面的样子啦。
- 开始使用:纯聊天的方式,和 claude code 在项目目录里构建你需要的代码和应用。
重要提示
使用 Opus 模型时:请将 CLAUDE_CODE_MAX_OUTPUT_TOKENS
设置为 32000
,以确保最佳性能。
重启 Claude Code:修改配置后,请重启 Claude Code 以使配置生效。
在 Claude code 用其他模型的路由方法
https://github.com/musistudio/claude-code-router/blob/main/README_zh.md
Claude 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>
- 解决:开全局梯子,换欧美、日本节点。
完整文档参考
- 官方文档: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
获取最新功能和安全补丁。