目录一、目的二、安装2.1 前置环境检查2.2 确认环境后运行全局安装2.3 安装配置2.4 配置Claude Code使用国内大模型2.4.1、手动配置2.4.2 使用bash命令配置(硅基流动大模型)2.5、配置cc switch三、如何使用Claude Code3.1 Claude Code使用方式3.2 基本用法3.3 Claude 常用命令四、常见问题五、文章总结一、目的之前主要使用国内的Trae来开发有使用过Claude的模型但一直没太系统性的使用Claude Code。这次在准备学习和了解的过程中发现网络中很多对于Claude的安装、使用以及安装过程中的问题没有太过细致的讲解因此这里把自己的使用过程记录一下。二、安装Claude Code 基于 Node.js 开发需要完整的 Node.js 运行环境。2.1 前置环境检查node -v npm -vps:建议 Node.js 版本在 18.0 或以上。2.2 确认环境后运行全局安装npm install -g anthropic-ai/claude-code初次启动与授权在任意项目根目录输入claude并回车。首次运行会提示身份验证自动在浏览器中打开 Anthropic Console 登录页面完成授权后接收鉴权令牌PS:国内安装可能会报错可以在Json中绕过验证。怀疑是CC故意留的后门即满足美国政府要求又可以获得其他地区客户得使用2.3 安装配置初次登录进去绕过验证后会出现如下得界面总结内容是否信任当前文件夹下得项目是否允许cc管理该文件夹内容翻译快速安全检查这是您自己创建的项目还是您信任的项目就像您自己的代码、一个广为人知的开源项目或者您团队的作品如果还没有的话先花点时间查看一下这个文件夹里的内容吧。Claude code在这里能够读取、编辑和执行文件。选择Yes即可2.4 配置Claude Code使用国内大模型若未登录Claude Code或未配置大模型则Claude Code在使用时会提示:Not logged in · Run /login可以通过以下步骤进行配置2.4.1、手动配置1.修改配置文件找到配置文件 settings.json如果不存在就新建一个。Windows: C:\Users\你的用户名\.claude\settings.jsonmacOS / Linux: ~/.claude/settings.json2.添加环境变量配置打开文件粘贴以下内容并替换其中的USER_API_KEY 、YOUR_MODEL和 YOUR_API_BASE_URL为你的实际信息。{ env: { ANTHROPIC_AUTH_TOKEN: USER_API_KEY, ANTHROPIC_BASE_URL: YOUR_API_BASE_URL, ANTHROPIC_MODEL:YOUR_MODEL, API_TIMEOUT_MS: 3000000 } }ps:我这里使用的是硅基流动下的GLM-5.1模型 硅基流动官网3.验证效果保存文件关闭当前终端新开一个终端窗口再次输入 claude 命令。2.4.2 使用bash命令配置(硅基流动大模型)1、在终端运行以下命令bash -c $(curl -fsSL https://sf-maas-uat-prod.oss-cn-shanghai.aliyuncs.com/sample/ccsf_v260130.sh)2、提示输入 API Key 时粘贴你的 SiliconFlow API Key3、提示选择模型时使用方向键选择要在 Claude Code 中使用的模型或选择自定义从模型广场复制粘贴想用的模型名称4、根据提示复制相应命令并重启终端运行应用配置5、执行 claude 命令进入 Claude Code 并使用PS在window上自动化命令用管理员权限启动若无效可使用手动配置方案。2.5、配置cc switch是跨平台的可视化 Claude Code 配置统一管理工具通过图形界面接管终端的 API 路由调度.是Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes Agent 的全方位管理工具。系统要求WindowsWindows 10 及以上macOSmacOS 12 (Monterey) 及以上LinuxUbuntu 22.04 / Debian 11 / Fedora 34 等主流发行版不同版本可以参看github上代码库进行安装这里只演示在window环境下得安装过程。https://github.com/farion1231/cc-switch/blob/main/README_ZH.md1、下载最新安装包不方便科学上网可以通过百度网盘访问链接: https://pan.baidu.com/s/1BFn4j58D0wyHMzxCH8pDWg 提取码: nbns2、运行cc-switch得msi文件执行下一步3、选择程序安装目录4、点击Install开始安装PS配置完成后重新打开终端输入claude并下达指令。终端操作界面保持原样但上下文数据已被路由到配置的第三方模型进行处理。三、如何使用Claude Code3.1 Claude Code使用方式ClaudeCode支持在以下环境下使用Desktop(官方客户端)、Terminal(终端)、IDE(如VS Code)、Web and IOS、Slack团队协作工具类似钉钉、企业微信等PSClaude Code Desktop若在Window上运行需要Claude requires Windows 10 version 2004 or later (build19041). Current build: 17763.3.2 基本用法1、交互式Shell模式最主要的工作流。Claude Code 接管终端窗口提供持续的、对话式的操作界面。#在终端命令窗口中进入某个文件夹(不要再C盘系统文件中) cd your-project #执行claude命令 claude交互逻辑输入自然语言需求如帮我在 src 目录下新建一个 utils 文件夹并在里面写一个处理日期格式化的函数。Claude Code 会保留上一步的上下文记忆后续输入增加对闰年的判断逻辑会直接在刚才生成的文件基础上修改。退出方式输入/quit、/exit或连续按两次Ctrl C。2、单次命令执行模式不需要进入持续对话窗口直接在系统标准终端提示符下使用 -pprompt参数claude -p 检查目录下的 README.md 文件修正拼写错误完成保存。任务执行完毕后打印简短报告并自动退出终端控制权交还。适合编写自动化 Shell 脚本或处理不需要前后文记忆的独立小任务。3、代码 Diff 确认机制只要 Claude Code 决定对源代码文件进行修改都会触发代码差异确认机制。终端屏幕上输出彩色文本差异对比视图红色文本行首 - 号— 即将被删除或修改的旧代码绿色文本行首 号— 即将新增或替换写入硬盘的新代码白色/无色文本— 不需要变动的上下文参照代码YYes — 同意单次操作确认当前这个文件修改正确后保存。仅代表授权当前这一次操作后续修改仍会逐一询问。Y shifttabYes, allow all — 允许本会话所有编辑处理大规模重构时前几次修改审查确认后选择此选项。当前对话会话内所有后续编辑自动获得放行不再逐一弹窗。NNo — 拒绝修改硬盘文件不会发生任何改变。智能体会停止当前修改流程等待补充说明原因并重新制定执行计划。3.3 Claude 常用命令在交互式 Shell 模式下输入以斜杠 /开头的系统级命令用于管理智能体的底层行为、上下文状态以及运行成本。/init项目初始化与规约生成扫描当前项目关键文件package.json、.csproj等理解编程语言、框架版本和测试工具。自动生成CLAUDE.md文件记录架构说明、构建命令和代码格式化规范。/model运行时动态切换模型不退出当前会话直接在终端中切换底层大语言模型。修改简单任务切换到 Haiku 降低成本遇到需要严密逻辑推演的 Bug 时切换到 Opus。/plan开启规划模式面对复杂指令时强制要求在编写任何代码前先在终端输出带数字编号的步骤执行清单。用户确认执行计划后才开始逐块生成代码。/compact记忆压缩调用大语言模型对当前冗长历史记录进行核心状态提取生成简短摘要文本随后彻底删除冗长逐字对话历史。恢复极速响应状态。/clear清除当前会话记忆完全抹除当前交互会话中的所有记忆上下文。准备开始下一个完全不相关的工作时强烈建议执行防止带入上一个任务的逻辑限制。/cost实时成本与耗时统计打印结构化统计面板输入 Token 数量、输出 Token 数量、总执行耗时、基于当前模型单价计算的精确预估美金花销。四、常见问题初始化时国内提示不可用Unable to connect to Anthropic servicesFailed to connect to api.anthropic.com: ERR_BAD_REQUESTPlease 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解决方法-跳过强制引导流程这是社区里最普遍、最直接的解决方法。原理是修改 Claude Code 的一个本地配置文件告诉它“已经完成过首次设置了”从而跳过会引发错误的那一步。1、找到配置文件在你的用户主目录下找到 .claude.json 这个文件。默认路径如下Windows: C:\Users\你的用户名\.claude.jsonmacOS / Linux: ~/.claude.json2、修改配置文件用任意文本编辑器如记事本、VS Code打开它在文件末尾的大括号 } 前添加或修改以下内容hasCompletedOnboarding: true修改后整个文件的结构看起来会像这样注意上一行末尾要加上英文逗号,{ installMethod: native, autoUpdates: false, // ... 其他原有配置项 hasCompletedOnboarding: true }添加时请务必检查 JSON 的语法格式确保引号、逗号都正确。3、验证效果保存文件后关闭当前终端新开一个终端窗口再次输入 claude 命令。如果成功你应该能直接进入 Claude Code 的交互界面而不再看到之前的错误提示。五、文章总结Claude Code 是 Anthropic 官方推出的命令行原生AI 助手。与 GitHub Copilot 等建议者定位的 IDE 插件不同Claude Code 是一个系统级的独立执行者。但是工具虽然好用但作为开发者好的编程基础才能更好帮助你去熟练运用工具。
