Skip to content

Claude Code 接入指南 & 详细指令教程

环境要求

如果你遇到 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启动后

启动 Claude Code

首先需要到你的项目目录

bash
cd C:\AI开发\claudecode\your-project-folder

终端直接输入claude 启动 Claude code

bash
claude
  1. 启动验证流程: 开全局梯子! 启动 Claude Code 后,系统将跳转至验证页面

  2. 账号要求:需使用 Claude 官网账号登录,免费账号即可完成授权(无需付费),如无账号,请先注册免费账户。

  3. 授权步骤:登录claude官网成功后,复制系统生成的授权码,将授权码粘贴回 Claude Code 进行验证。

  4. 完成设置:验证通过后,系统将自动获取:自定义 Key 和 BaseUrl 地址。 然后就是下面的样子啦。

Claude启动后

  1. 开始使用:纯聊天的方式,和 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 命令、安装依赖
  • 文件修改(每次会话需批准):编辑、创建、删除文件

危险命令拦截

  • 默认禁止:curlwgetsudorm -rf 等高危命令
  • 白名单模式:可通过 /permissions 配置允许的操作类型

安全最佳实践

  • 定期检查 /cost 避免意外高消耗
  • 使用 /compact 清理敏感信息
  • 在生产环境避免 --dangerously-skip-permissions 参数

六、实用技巧

1. 成本控制

  • 压缩对话:使用 /compact 压缩上下文
  • 精确指令:明确文件路径(如 "修复 src/utils/logger.ts")减少 Token 消耗
  • 分步执行:复杂任务分解为多个小步骤

2. 提高效率

  • 项目模板:使用 /init 建立项目规范和常用命令
  • 批处理"批量更新所有组件的 TypeScript 类型"
  • 自动化 Gitclaude 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>
  • 解决:开全局梯子,换欧美、日本节点。

完整文档参考

💡 提示:Claude Code 持续更新中,建议定期运行 claude update 获取最新功能和安全补丁。

一个 Key 用全球大模型