HoRain云--Claude Code 入门教程

📅 2026/7/6 14:21:29
HoRain云--Claude Code 入门教程
Claude Code 是 Anthropic 官方 CLI 级智能体工具。Claude Code 定位不是聊天而是 在本地代码仓库中执行高权限、可上下文感知的工程任务。Claude Code 是 Agent不是 Chat。详细教程参见Claude Code 教程 | 菜鸟教程核心能力直接读取整个项目目录理解真实代码结构执行多文件修改严格遵循指令而非对话取悦安装配置MacOS/Linux:curl -fsSL https://claude.ai/install.sh | bashHomebrew (MacOS):brew install --cask claude-codeWindows:irm https://claude.ai/install.ps1 | iexNPM:使用 npm 安装 请确保你的系统的安装了 Node.js版本需在 v18 或更高。npm install -g anthropic-ai/claude-code接下来就可以开始进入你创建的项目目录开始使用 Claude Codecd your-project claude登录您的账户使用 claude 命令启动交互式会话时您需要登录claude # 首次使用时会提示您登录 /login # 按照提示使用您的账户登录如果你可以正常使用 Anthropic 的账号就可以开始使用如果没有国内可以使用 DeepSeek 或 GLM 等。DeepSeek 接入 Claude Code安装 Claude Code 后我们在终端中设置以下环境变量export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN你的 DeepSeek API Key export ANTHROPIC_MODELdeepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flash export CLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flash export CLAUDE_CODE_EFFORT_LEVELmax参数说明CLAUDE_CODE_EFFORT_LEVEL思考深度可选 low / medium / maxANTHROPIC_MODEL指定使用 deepseek-v4-pro[1m] 模型CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1禁用非必要流量然后进入项目目录执行 claude 命令即可开始使用了。cd my-project claude参考文档Anthropic API | DeepSeek API Docs阿里百炼接入 Claude Code阿里云百炼的通义千问系列模型支持 Anthropic API 兼容接口通过修改以下参数即可在 Claude Code 中调用通义千问系列模型。ANTHROPIC_API_KEY或 ANTHROPIC_AUTH_TOKEN替换为百炼 API Key申请地址https://bailian.console.aliyun.com/cn-beijing/?tabmodel#/api-key。ANTHROPIC_BASE_URL替换为百炼的兼容端点地址 https://dashscope.aliyuncs.com/apps/anthropic。模型名称替换为百炼支持的模型名称例如 qwen3-max、qwen3-coder-plus等macOS/Linux创建并打开配置文件 ~/.claude/settings.json。~ 代表用户主目录如果 .claude 目录不存在需要先行创建可在终端执行 mkdir -p ~/.claude 来创建。编辑配置文件vim ~/.claude/settings.json将 YOUR_API_KEY 替换为专属 API Key。{ env: { ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_BASE_URL: https://dashscope.aliyuncs.com/apps/anthropic, ANTHROPIC_MODEL: qwen3-coder-plus } }重新打开一个新的终端使环境变量配置生效。Windows在 CMD 中运行以下命令设置环境变量setx ANTHROPIC_AUTH_TOKEN YOUR_API_KEY setx ANTHROPIC_BASE_URL https://dashscope.aliyuncs.com/apps/anthropic setx ANTHROPIC_MODEL qwen3-coder-plus用套餐专属 API Key 替换 YOUR_API_KEY。打开一个新的 CMD 窗口运行以下命令检查环境变量是否生效。echo %ANTHROPIC_AUTH_TOKEN% echo %ANTHROPIC_BASE_URL% echo %ANTHROPIC_MODEL%在 PowerShell 中运行以下命令设置环境变量# 用套餐专属 API Key 替换 YOUR_API_KEY [Environment]::SetEnvironmentVariable(ANTHROPIC_AUTH_TOKEN, YOUR_API_KEY, [EnvironmentVariableTarget]::User) [Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL, https://dashscope.aliyuncs.com/apps/anthropic, [EnvironmentVariableTarget]::User) [Environment]::SetEnvironmentVariable(ANTHROPIC_MODEL, qwen3-coder-plus, [EnvironmentVariableTarget]::User)打开一个新的 PowerShell 窗口运行以下命令检查环境变量是否生效。echo $env:ANTHROPIC_AUTH_TOKEN echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_MODEL在 Claude Code 中接入通义千问系列模型对话期间执行 /model 模型名称 命令切换模型。/model qwen3-coder-plus也可以在项目根目录创建 .claude/settings.json 文件中并写入模型配置信息永久配置。{ env: { ANTHROPIC_MODEL: qwen3-coder-plus, ANTHROPIC_SMALL_FAST_MODEL: qwen-flash } }启动 Claude可以看到配置信息智谱大模型接入 Claude Code这部分我们使用 ~/.claude/settings.json 文件来配置大模型开始前需要到官方平台获取 API keyGLM Coding Plan。编辑或新增 Claude Code 配置文件 ~/.claude/settings.json 新增或修改里面的 env 字段# 注意替换里面的your_zhipu_api_key 为您上一步获取到的 API Key { env: { ANTHROPIC_AUTH_TOKEN: your_zhipu_api_key, ANTHROPIC_BASE_URL: https://open.bigmodel.cn/api/anthropic, API_TIMEOUT_MS: 3000000, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1 } }运行 claude 启动 Claude Code输入 /status 确认模型状态如果不是可以输入 /config 来切换模型。大模型一多配置起来就麻烦可以使用第三方工具 CC Switch 可以帮我们轻松管理这几个热门工具的 API 配置GitHub - farion1231/cc-switch: A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI Hermes Agent. Only official website: ccswitch.io · GitHubWindows / macOS / Linux 全支持。各平台安装包下载地址https://github.com/farion1231/cc-switch/releases。VS Code 安装 Claude Code如果不喜欢使用 Claude Code 的命令行模型我们可以在 VS Code 编辑器中安装 Claude Code。打开 VS Code进入扩展市场搜索Claude Code安装安装完成后点击右上角 Claude Code 图标即可进入 Claude Code 页面这样有账号的可以使用 /login 登录也可以在对话框输入 /config 进入设置勾选 Disable Login Prompt 配置来关闭登录页面:相关命令参考Claude Code 内置命令列表命令说明/add-dir添加额外的工作目录/agents管理专用 AI 子代理/bashes列出和管理后台任务/bug报告 bug(将对话发送给 Anthropic)/clear清除对话历史/compact [指令]压缩对话,可选择性添加重点指令/config打开设置界面(配置选项卡)/context以彩色网格可视化当前上下文使用情况/cost显示 token 使用统计/doctor检查 Claude Code 安装健康状况/exit退出 REPL/export [文件名]导出当前对话到文件或剪贴板/help获取使用帮助,显示所有可用命令/hooks管理工具事件的钩子配置/ide管理 IDE 集成并显示状态/init使用 CLAUDE.md 指南初始化项目/install-github-app为仓库设置 Claude GitHub Actions/login切换 Anthropic 账户/logout从 Anthropic 账户登出/mcp管理 MCP 服务器连接和 OAuth 认证/memory编辑 CLAUDE.md 记忆文件/model选择或更改 AI 模型/output-style [样式]直接设置输出样式或从选择菜单中选择/permissions查看或更新权限/plugin管理 Claude Code 插件/pr-comments查看 PR 评论/privacy-settings查看和更新隐私设置/release-notes查看发布说明/resume恢复对话/review请求代码审查/rewind回退对话和/或代码/sandbox启用沙盒 bash 工具,具有文件系统和网络隔离/security-review对当前分支的待处理更改进行安全审查/status打开设置界面(状态选项卡),显示版本、模型、账户和连接状态/statusline设置 Claude Code 的状态行 UI/terminal-setup安装 ShiftEnter 换行键绑定(仅限 iTerm2 和 VSCode)/todos列出当前待办事项/usage显示计划使用限制和速率限制状态(仅订阅计划)/vim进入 vim 模式,交替插入和命令模式自定义命令类型命令类型位置说明项目命令.claude/commands/存储在仓库中,与团队共享个人命令~/.claude/commands/跨所有项目可用插件命令插件的commands/目录通过插件市场分发MCP 命令由 MCP 服务器提供格式:/mcp__服务器名__提示名Shell 命令(非会话中)命令说明claude启动 Claude Code 交互式会话claude -p 查询非交互模式,打印结果后退出claude --dangerously-skip-permissions跳过所有权限检查(危险模式)claude --debug启用调试模式claude --mcp-debugMCP 调试模式claude mcp add添加 MCP 服务器claude mcp list列出已配置的 MCP 服务器claude mcp remove移除 MCP 服务器特殊功能自定义命令支持:$ARGUMENTS- 捕获所有参数$1, $2, $3...- 访问单个位置参数文件名- 引用文件内容!命令- 执行 bash 命令并包含输出命令前置元数据(Frontmatter):allowed-tools- 命令可使用的工具列表argument-hint- 参数提示说明description- 命令简短描述model- 指定模型disable-model-invocation- 防止 SlashCommand 工具调用更多相关信息可以通过/help查看完整的可用命令列表(包括您自定义的命令)。相关资源开源地址https://github.com/anthropics/claude-code官方文档概述 - Claude Code DocsDeepSeek Anthropic APIAnthropic API | DeepSeek API Docs智谱大模型接入 Claude CodeClaude Code - 智谱AI开放文档