找回密码
 立即注册
首页 业界区 业界 [Agent/AI编程] Claude Code 使用指南

[Agent/AI编程] Claude Code 使用指南

乃阕饯 前天 01:40
0 序


  • 近期实在是刷到太多 Manus / OpenManus / Cursor / Codex / Gemini / Claude Code / OpenCode / Moltblot(OpenClaw/Clawd) 的 AI 编程Agent的文章、短视频了。
  • 但是很多文章对被 Anthropic 屏蔽的国内用户如何安装 Claude Code并正常使用如何集成第三方大模型API(如:硅基流动等)到 Claude Code如何基于VSCode使用ClaudeCode,并没有讲得很透彻。
不少教程文档,暗藏私货————间接要求购买ClaudeCode镜像站服务、或者售卖 FQ 服务。
显然,这对于笔者而言,是不适用的。


  • 此外,安装、使用过程中遇到的一些头痛的问题,也在 FAQ 章节悉数整理,并提供了解决方案。
  • 通过本文一篇文档,即可一网打尽,快速上手 Claude Code!
1 概述:Claude Code

产品定位:它是什么?解决了什么问题?


  • Claude Code 是 Anthropic 推出的终端 AI 编码助手,核心理念是"住在终端里"。
它能够帮助开发者编写代码、调试程序、重构代码、解释复杂逻辑,大大提升编程效率。
它能理解项目结构、编辑代码、执行命令、管理 Git,虽然支持 IDE 集成,但本质是【命令行驱动】的工具。
其还推出有VSCode插件等多种终端形态,将强大的Claude AI助手直接集成到您的开发环境中。


  • Claude Code 的定位:
不是AI聊天工具,而是在【本地代码仓库】中执行高权限、【可上下文感知】的工程任务。
Claude Code 与在聊天窗口里写几段代码不同,它理解你的整个项目,能直接读取你的文件、运行测试并根据反馈修改代码。
Claude Code 不是一个代码生成器,而是一个能【读项目】、【懂上下文】、【遵守约束】的【 AI 编程搭档】。
  1. 它不是网页里的聊天框,而是直接在你的终端(Terminal)里运行,可以:  读取你整个项目的代码  理解文件之间的关系  直接修改代码文件  执行你的指令并给出建议
复制代码


  • Claude Code 是 一款面向 AI 编程场景的Agent(智能体工具),不是 Chat(聊天工具)


  • 能力角度看,Claude Code 主要具备三点特征:


  • 上下文感知:不仅理解单个文件,而是理解整个项目结构
  • 工程化导向:关注可维护性、规范、测试,而不是一次性代码
  • 可定制行为:通过 Skills(技能包)让 AI 遵守你的规则


  • 开源版本的替代品(OpenCode)
您可以参考这篇文章: https://www.kevnu.com/zh/posts/opencode-in-depth-technical-analysis-of-open-source-ai-programming-agents


  • 关于 Claude Agent Skills
您可以参考这篇文章: https://www.kevnu.com/zh/posts/claude-agent-skills-deep-dive-a-new-paradigm-for-expanding-ai-agent-capabilities
Claude Code 能做什么?

Claude Code 的核心能力可以归纳为这几点:


  • 1、代码理解与解释
我们可以问它:

  • 这个函数是干什么的?
  • 为什么这里会报错?
  • 这段代码的性能瓶颈在哪?
  • 它会结合你的项目上下文给出解释。


  • 2、多文件上下文分析
不同于简单的代码补全工具,Claude Code 能理解:

  • 这个函数在哪些地方被调用了
  • 这个模块依赖了哪些其他文件
  • 整个项目的架构是怎样的


  • 3、工程级代码修改
我们可以说:

  • 把所有用 var 的地方改成 let
  • 把这个函数拆成三个小函数
  • 给所有接口加上错误处理
  • 它会帮你实际修改代码,而不只是给建议。


  • 4、通过 Skills(技能包)扩展能力
Skills 是 Claude Code 最强大的地方——我们可以教它你的编码习惯和团队规范,让它按我们的方式工作。
比如:

  • 我们团队要求所有函数都加注释
  • API 响应必须符合特定格式
  • 测试用例要覆盖边界情况
  • 你可以把这些要求写成 Skills,Claude Code 就会自动遵守。
Claude Code 不能做什么?


  • Claude Code 不擅长的事情:


  • 不能替你做技术决策的最终判断
  • 不能保证生成代码 100% 无 Bug
  • 不能理解你没有明确说明的业务语义
  • 不适合在你完全不理解的情况下【全自动接管】项目
  • 一个成熟的使用心态是:让 Claude Code 提供高质量候选方案,而不是【绝对正确答案】。
Claude Code 的核心价值


  • Claude Code 的核心理念:【协作】,而不是【替代】
Claude Code 并不是在追求把开发者踢出局,它的设计理念非常明确:


  • 人负责:目标、约束、判断、审美
  • AI 负责:执行、分析、对比、重复劳动
对编程新手: 降低学习门槛


  • 如果你是新手,最痛苦的可能是:


  • 看不懂别人的代码
  • 不知道为什么报错
  • 不知道好代码长什么样


  • Claude Code 可以:


  • 用人话解释代码: 这段代码的意思是先检查用户是否登录,如果没登录就跳转到登录页
  • 帮你 Debug: 这里报错是因为变量名拼错了,应该是 username 不是 usrname
  • 教你写更好的代码: 这个函数太长了,可以拆成三个小函数,分别负责验证、处理、返回
对独立开发者: 提升开发效率


  • 如果你是独立开发者,你可能:


  • 一个人负责前后端
  • 没人帮你 Code Review
  • 需要快速试错和迭代


  • Claude Code 可以:


  • 帮你快速理解第三方库的用法
  • 自动生成测试用例
  • 帮你重构混乱的代码
对团队: 统一规范,降低协作成本


  • 如果你在团队工作,你可能遇到:


  • 每个人代码风格不一样
  • 新人上手慢,老是问重复问题
  • Code Review 花时间


  • Claude Code 可以:


  • 通过 Skills 统一团队规范(所有人用同一套规则)
  • 帮新人快速理解项目
  • 在提交前自动检查代码质量
Claude Code 适合哪些人?适用场景?


  • 建议以下几类人可以尝试 Claude Code:


  • 编程新手
    想学编程但总是卡在看不懂代码
    需要一个随时解答问题的老师


  • 独立开发者 / 创业者
    一个人做项目,需要快速试错
    想把时间花在核心功能上,不想在琐碎问题上卡住


  • 后端 / 前端 / 全栈工程师
    想提升开发效率
    想学习更好的代码写法
    需要快速理解复杂项目


  • 技术负责人 / 架构师
    想用 AI 辅助团队规范落地
    想降低新人培养成本


  • 不适合的场景
你完全不想学编程,只想输入需求自动出项目(AI 还做不到)
你的工作涉及高度敏感代码,不能使用外部 AI 服务
Claude Code vs 其他 AI 编程工具

你可能还听说过 ChatGPT、Cursor、GitHub Copilot,它们和 Claude Code 有什么不同?


  • Claude Code vs ChatGPT
维度ChatGPTClaude Code使用方式网页聊天命令行工具代码理解需要手动粘贴自动读取整个项目文件修改给建议,你手动改可以直接修改文件适合场景问问题、学概念真实项目开发

  • Claude Code vs Cursor / Copilot
维度Cursor / CopilotClaude Code 、 VSCode+通义灵码/CC等Agent插件工作方式编辑器内自动补全命令行对话式适合场景写代码时实时提示理解、重构、架构级修改学习成本低,开箱即用中,需要学习指令

  • 简单总结:


  • Copilot/Cursor:边写边补全,像智能输入法
  • Claude Code:对话式协作,像高级搭档
  • ChatGPT:通用助手,像顾问
  • Claude Code 的优势:


  • 对整个项目的理解能力更强


  • 可以通过 Skills 定制行为
  • 更适合理解旧代码大规模重构等场景


  • Claude Code 的局限:


  • 不如 Copilot 那样无感(需要主动调用)
  • 学习曲线稍高
2 安装篇


https://code.claude.com/docs/zh-CN/desktop


  • Claude Code 支持的终端形态:


  • Web 版
https://code.claude.com/docs/zh-CN/claude-code-on-the-web


  • 桌面版
目前 Claude Code 的桌面版也发布了,下载地址: https://claude.com/download


  • Chrome 扩展程序(测试版)
  • VsCode 插件版
https://code.claude.com/docs/zh-CN/vs-code


  • JetBrains IDEs
  • Github Actions with Claude Code
  • GitLab CI/CD
  • Slack with Claude Code


  • Claude Code (CLI版 / VSCode插件版)vs. 网页版 Claude
特性Claude 网页版 / AppClaude Code (CLI)交互方式复制粘贴代码到对话框直接在终端通过指令操作文件访问手动上传文件自动读取/搜索整个工程目录执行能力仅生成文本执行 Shell 命令、运行测试、创建文件上下文感知有限的对话上下文深度感知项目结构和 Git 历史
打个比方:

  • Claude(网页版) 就像一个顾问/实习生/助理,你把代码截图或复制给他,他给你建议,但你得自己动手改。
  • Claude Code 就像一个坐在你旁边的搭档,他能看到你的整个项目,帮你改代码,甚至帮你写测试、重构函数。


  • 三种常见终端方式的对比
方式适合人群优点缺点Web 端完全新手无需安装,打开就用功能相对有限CLI(命令行)有一定基础的开发者功能完整,集成度高需要熟悉命令行IDE/编辑器集成(VS Code / Cursor 等)日常开发无缝融入工作流依赖插件和环境配置


  • 如果你是完全新手,先用 Web 端 https://claude.ai/ 试试手感
  • 如果你想真正用于开发,直接学 CLI(命令行)
  • 如果你已经熟练使用,再考虑IDE/编辑器集成
前置步骤:注册第三方大模型供应商的账户、并获取API KEY


  • 硅基流动


  • [AI/GPT] 硅基流动(SiliconFlow) : AI大模型时代的基础设施(Model API as Service) - 博客园/千千寰宇
  • https://account.siliconflow.cn/
  • https://cloud.siliconflow.cn/
近期在搞活动,注册即送代金券。


  • 百炼
  • DeepSeek
  • GLM
  • ...
CLI 命令版:NPM 安装方式(推荐)

安装 NodeJs / Npm


  • 安装 Nodejs / NPM


  • nodejs version >= 18
  • 安装部署 - NodeJs 教程(1)入门篇 - 博客园/千千寰宇


  • 验证
CMD / Git-Bash / Powershell
  1. C:\Users\Xxx> node --versionv20.11.1C:\Users\Xxx> npm --version10.2.4C:\Users\Xxx> npm config get prefixD:\Program_Files\nodejs\node-v20.11.1-win-x64
复制代码
基于 npm 安装 Claude Code


  • 基于 npm 安装 Claude Code
  1. npm install -g @anthropic-ai/claude-code或: npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
复制代码
卸载命令: npm uninstall -g @anthropic-ai/claude-code


  • 查看安装情况
  1. $ npm list -gD:\Program_Files\nodejs\node-v20.11.1-win-x64+-- @anthropic-ai/claude-agent-sdk@0.2.19+-- @anthropic-ai/claude-code@2.1.19...
复制代码
CLI命令版:原生安装脚本方式

macOS / Linux / WSL
  1. curl -fsSL https://claude.ai/install.sh | bash
复制代码
Windows


  • Windows PowerShell
  1. irm https://claude.ai/install.ps1 | iex
复制代码

  • Windows CMD:
  1. curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
复制代码
CLI命令版:验证/启动/使用

查验版本

Git-Bash 环境下为例:
  1. $ claude --version2.1.20 (Claude Code)$ ls ~/.claudeconfig.json  debug/  ide/  projects/  skills/  statsig/  telemetry/  todos/$ vim ~/.claude.json
复制代码
powershell: notepad $env:USERPROFILE\.claude.json
健康检查
  1. C:\Users\Xxx> claude doctor Checking installation status…                                                                                                                                                                Diagnostics └ Currently running: unknown (2.1.20) └ Path: D:\Program_Files\nodejs\node-v20.11.1-win-x64\node.exe └ Invoked: D:\Program_Files\nodejs\node-v20.11.1-win-x64\node_modules\@anthropic-ai\claude-code\cli.js └ Config install method: unknown └ Search: OK (vendor) Updates └ Auto-updates: enabled └ Auto-update channel: latest └rStabletversion:n2.1.7…                                                                                                                                                                     └ Latest version: 2.1.20 Press Enter to continue…   
复制代码
注: Git-Bash 环境下执行 export CLAUDE_DISABLE_RAW_MODE=1 && claude doctor,亲测无效,忽略即可。
(指定文件夹下)启动 Claude Code


  • 启动 Claude Code
注:基于claude命令启动时报不支持的国家/地区: Claude Code might not be available in your country. Check supported countries ... 问题,参见 FAQ 章节
  1. # cd /path/to/your/project# claude
复制代码

看到版本信息或进入交互提示符,说明安装成功。
输入1 即进入 Claude Code;反之,输入2 或 Esc 即退出 Claude 并会退到命令行窗口
假定输入1

登录与授权


  • 首次运行 claude 会提示登录,支持3种方式:


  • 个人/团队/企业用户: 使用 Claude.ai 账户交互式登录
Claude account with subscription · Pro, Max, Team, or Enterprise


  • API 用户: 使用 Anthropic API Key 授权
Anthropic Console account · API usage billing


  • 第三方平台 (国内用户,推荐选项)
3rd-party platform · Amazon Bedrock, Microsoft Foundry, or Vertex AI
凭据保存在 ~/.config/claude,后续可通过 /login 命令重新登录或切换账户。

登录方法1:配置大模型API的环境变量
  1. ANTHROPIC_AUTH_TOKEN  你的API KeyANTHROPIC_BASE_URL    https://api.siliconflow.cn/ANTHROPIC_MODEL       moonshotai/Kimi-K2-Instruct
复制代码



  • 设置环境变量的方法
  1. //方法1 图形化界面配置此电脑” -> 选择 “属性” -> “高级系统设置” -> “系统属性” 窗口中点击 “环境变量” -> 点击 “新建” -> 配置变量及其值//方法2 powershell (永久设置)[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxx", "User")[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.siliconflow.cn/", "User")//方法3 cmd 设置 (永久设置)setx ANTHROPIC_AUTH_TOKEN "sk-xxx"setx ANTHROPIC_BASE_URL "https://api.whatai.cc"//方法4 通过settings.json 设置 (找到 settings.json 文件,如果没有请创建)C:\Users\{user}\.claude\settings.json或 vim ~/.claude/settings.json{    "env": {      "ANTHROPIC_MODEL": "claude-sonnet-4-20250514",      "ANTHROPIC_SMALL_FAST_MODEL": "claude-sonnet-4-20250514",      "ANTHROPIC_BASE_URL": "https://api.whatai.cc",      "ANTHROPIC_AUTH_TOKEN": "sk-XXXXXXXX"    }  }
复制代码
注意: 永久设置后需要【重启终端】才能生效。推荐使用永久配置方式。


  • 查验环境变量的方法
  1. //windows 环境下echo %ANTHROPIC_AUTH_TOKEN%echo %ANTHROPIC_BASE_URL%echo %ANTHROPIC_MODEL%//git-bash 环境下env | grep -i ANTHROPIC
复制代码

配置完成后,即可通过: Windows CMD / Windows Powershell 窗口以 cluade 命令启动。
注: Windows Git-Bash 无法成功启动 Claude。
  1. //如下方式可实现在 Git-Bash 中配置环境变量 (但Git-Bash 无法成功启动 Claude,忽略即可)> vi ~/.bash_profile# generated by Git for Windowstest -f ~/.profile && . ~/.profiletest -f ~/.bashrc && . ~/.bashrc> vi ~/.bashrc        export ANTHROPIC_AUTH_TOKEN="sk-xxxxxx37t3edsbdskbk3rfsfdfs"        export ANTHROPIC_BASE_URL="https://api.siliconflow.cn/"        export ANTHROPIC_MODEL="zai-org/GLM-4.6"> source ~/.bashrc
复制代码

基本使用


  • 可直接提问
例如: "使用Python脚本抓取近10年的中国GDP数据"
...
退出 Claude Code
  1. /exit
复制代码

Visual Studio Code 中使用 Claude Code


  • 推荐文献


  • Visual Studio Code 中使用 Claude Code - CSDN
  • vscode配置Claude Code(使用智谱API) - CSDN
Step1 安装 Claude Code 扩展插件


  • 打开 VS Code,搜索并安装插件: Claude Code for VS Code


  • 补充安装方式:命令行安装
  1. # 安装 VSCode 扩展code --install-extension anthropic.claude-code
复制代码

  • 补充安装方式:手动下载安装


  • 访问 VSCode Marketplace
  • 点击 "Download Extension" 下载 .vsix 文件
  • 在VSCode中使用命令面板 (Ctrl+Shift+P 或 Cmd+Shift+P)
  • 输入 "Extensions: Install from VSIX"
  • 选择下载的文件进行安装
Step2 安装/启用第三方工具:CC-Switch

CC-Switch 的作用:
通过【代理】本地电脑中 ClaudeCode/Codex/Gemini Agent 软件对【大模型供应商】(如:硅基流动)的API请求,解决(尤其是 VSCode 中的 Cluade Code 插件与这些第三方大模型供应商)二者之间无法直接兼容使用的问题。


  • 创建/编辑 ~/.cluade/setting.json 一个 JSON 格式的空文件
如果先前以创建,则可忽略此步骤
  1. > notepad C:\Users\Johnny\.claude\setting.json{}
复制代码

  • CC-Switch 安装包下载
https://github.com/farion1231/cc-switch/releases/tag/v3.9.1
github 访问不便的可下载: https://wwbbj.lanzout.com/iAqC63g3yhze
CC-Switch-v3.9.1-Windows-Portable.zip


  • 下载完后解压、点击cc-switch.exe启动
  1. D:\Program\CCSwitch\
复制代码

  • 开始配置大模型供应商



  • 以硅基流动为例:
  1. 请求地址: https://api.siliconflow.cn官网链接: https://cloud.siliconflow.cn/模型: (自己去官网选择自己想用的)    例如:  zai-org/GLM-4.6 ; deepseek-ai/DeepSeek-V3.2 ; ...
复制代码

  • 选择启用 CC-Switch
启用后,将通过 CC-Switch 代理

注意事项:启用 CC-Switch 时,会与原先配置的 Claude Code 环境变量(ANTHROPIC_AUTH_TOKEN/ANTHROPIC_BASE_URL/ANTHROPIC_MODEL)产生冲突,其将要求删除之。


  • 此时,再打开 VSCode / 或 Claude Code CLI 即可使用了

编辑 Claude Code 插件的设置文件(settings.json) 【此步骤废止】


  • 为设置 Claude Code 插件——编辑 settings.json

C:\Users\Xxx\AppData\Roaming\Code\User\settings.json



  • 编辑配置文件 settings.json
  1.     , ...    "claudeCode.environmentVariables": [        {             "name" : "ANTHROPIC_BASE_URL"            , "value": "https://api.siliconflow.cn/"         }        , {             "name" : "ANTHROPIC_AUTH_TOKEN"            , "value": "你的 API-Key"         }    ],    "claudeCode.disableLoginPrompt": true
复制代码


3 Slash 命令


  • 本节汇总 Claude Code 的内置命令与自定义命令要点。
  • 内置命令: 用于控制会话、查看状态、导出、调试等,使用频率高,应记住常用几条
  • 自定义命令: 通过 Markdown 文件定义,支持参数、bash 执行、文件引用和权限控制,适合把常用模板固化为命令
Claude Code 内置常用命令


  • claude - 启动交互模式
  • claude "task" - 运行一次性任务
  • claude commit - 创建 Git 提交


  • /add-dir: 添加额外的工作目录
  • /agents: 管理自定义子代理(AI subagents)
  • /bashes: 列出/管理后台 bash 任务
  • /bug: 上报 bug(会把对话发送到 Anthropic)
  • /clear: 清空会话历史(清空对话内容,重新启动)
  • /compact [instructions]: 压缩会话上下文,可带聚焦指令
  • /config: 打开设置界面(Config 选项卡)
  • /context: 以彩色网格方式可视化当前上下文使用情况
  • /cost: 显示 token 使用统计
  • /doctor: 检查 Claude Code 安装健康状况
  • /exit: 退出 REPL
  • /export [filename]: 导出当前会话到文件或剪贴板
  • /help: 获取帮助列表和用法
  • /hooks: 管理与工具事件相关的 hook 配置
  • /ide: 管理 IDE 集成并显示状态
  • /init: 用 CLAUDE.md 指南初始化项目(解析项目,为项目生成或更新文档CLAUDE.md)
  • /install-github-app: 为仓库设置 Claude GitHub Actions
  • /login、/logout: 切换或退出 Anthropic 账户
  • /mcp: 管理 MCP 服务器连接和 OAuth 授权
  • /memory: 编辑 CLAUDE.md 的记忆文件
  • /model: 选择或切换 AI 模型
  • /output-style [style]: 设置输出风格
  • /permissions: 查看或更新权限规则
  • /plugin: 管理 Claude Code 插件
  • /pr-comments: 查看 PR 评论
  • /privacy-settings: 查看/更新隐私设置
  • /release-notes: 查看发布说明
  • /resume: 恢复会话
  • /review: 请求代码审查
  • /rewind: 回退会话或代码状态
  • /sandbox: 启用受限的 sandboxed bash(文件系统与网络隔离)
  • /security-review: 对当前分支的待定更改执行安全审查
  • /status: 打开状态界面(显示版本、模型、账户和连通性)
  • /statusline: 设置状态行 UI
  • /terminal-setup: 为 iTerm2 / VSCode 安装 Shift+Enter 换行快捷键
  • /todos: 列出当前 todo 项
  • /usage: 显示订阅计划使用限额和速率限制状态
  • /vim: 进入 vim 模式(交替插入/命令模式)
G FAQ for Claude Code

Q: 基于claude命令启动时报不支持的国家/地区: Claude Code might not be available in your country. Check supported countries ...


  • 问题描述
基于claude命令启动时,报不支持的国家/地区: Claude Code might not be available in your country. Check supported countries ...
  1. C:\Users\Johnny> claudeUnable 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-countri
复制代码
  1. Welcome to Claude Code v2.1.20…………………………………………………………………………………………………………………………………………………………                                                                             *                                       █████▓▓░                                 *         ███▓░     ░░            ░░░░░░                        ███▓░    ░░░   ░░░░░░░░░░                      ███▓░   ░░░░░░░░░░░░░░░░░░░    *                ██▓░░      ▓                                             ░▓▓███▓▓░ *                                 ░░░░                                 ░░░░░░░░                               ░░░░░░░░░░░░░░░░       █████████                                        *      ██▄█████▄██                        *       █████████      *…………………█ █   █ █………………………………………………………………………………………………………………                                                                                  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
复制代码

  • 原因分析
国内第一次使用claude code的新手,都遇到过这样的报错。而成为了使用claude code的第一道门槛
想要解决其实十分简单,只需要在 claude code 配置文件加上一行配置即可绕过地区限制(即修改 ~/.claude.json 文件),下面开始教你如何配置。


  • 解决方法

  • 首先你要知道你的用户主目录 ,即"C:\Users\你的用户名",配置文件默认会在这个目录下,然后找到.claude.json文件。
  1. //powershell | git-bashvim ~/.claude.json
复制代码

  • 打开.claude.json文件,可使用vscode、notepad++、记事本等文本编辑器,打开后会出现类似的配置样式,加上选中区域的字段。
别忘了给上一行加个,逗号
  1. "hasCompletedOnboarding": true
复制代码


  • 重启 ClaudeCode,大功告成!
  1. claude
复制代码

输入1 即进入 Claude Code;反之,输入2 或 Esc 即退出 Claude 并会退到命令行窗口
Q: 基于Windows的PowerShell运行claude命令时,报:npm : 无法加载文件 D:\...\nodejs\claude.ps1,因为在此系统上禁止运行脚本。...


  • 问题描述
  1. Windows PowerShell版权所有 (C) Microsoft Corporation。保留所有权利。尝试新的跨平台 PowerShell https://aka.ms/pscore6PS C:\Users\Xxx\Desktop\55156966> claudeclaude : 无法加载文件 D:\Program_Files\nodejs\node-v20.11.1-win-x64\claude.ps1,因为在此系统上禁止运行脚本。有关详细信息,请参阅 https:/go.microsoft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。所在位置 行:1 字符: 1+ claude+ ~~~~~~    + CategoryInfo          : SecurityError: (:) [],PSSecurityException    + FullyQualifiedErrorId : UnauthorizedAccess
复制代码

  • 解决方法


  • 在终端输入get-ExecutionPolicy查看执行策略/权限;
  1. PS C:\Users\Xxx\Desktop\55156966> get-ExecutionPolicyRestricted
复制代码
输出Restricted(受限制的);


  • 终端输入Set-ExecutionPolicy -Scope CurrentUser命令给用户赋予权限;
  • 输入RemoteSigned;
  1. PS C:\Users\Xxx\Desktop\55156966> Set-ExecutionPolicy -Scope CurrentUser位于命令管道位置 1 的 cmdlet Set-ExecutionPolicy请为以下参数提供值:ExecutionPolicy: RemoteSigned执行策略更改执行策略可帮助你防止执行不信任的脚本。更改执行策略可能会产生安全风险,如 https:/go.microsoft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies 帮助主题所述。是否要更改执行策略?[Y] 是(Y)  [A] 全是(A)  [N] 否(N)  [L] 全否(L)  [S] 暂停(S)  [?] 帮助 (默认值为“N”): Y
复制代码


  • 终端输入get-ExecutionPolicy查看一下权限,显示RemoteSigned就可以了。
  1. PS C:\Users\Johnny\Desktop\55156966> get-ExecutionPolicyRemoteSigned
复制代码
Q: 基于 Git-Bash 安装 Claude Code 需配置CLAUDE_CODE_GIT_BASH_PATH环境变量?

此问题可忽略,没有多少意义
Claude Code on Windows requires git-bash (https://git-scm.com/downloads/win). If installed but not in PATH, set environment variable pointing to your bash.exe, similar to: CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe
  1. $ claudeCLAUDE_CODE_GIT_BASH_PATH=D:\Program Files(x86)\Git\Git\bin\bash.exe
复制代码

  • Windows Git-Bash
如果后续需通过 Git-Bash 来启动/使用 Cluade Code,则需: 设置环境变量 CLAUDE_CODE_GIT_BASH_PATH 为 bash.exe 的路径。(可选)
Q: 为什么必须走/推荐用 大模型 API 集成的方式?


  • 上下文感知:它能直接读取你的整个项目结构,不再需要你手动上传文件。
  • 自主编辑(Agentic):配合 Cline 等插件,它不仅能写代码,还能直接运行终端、创建文件、修复 Bug,甚至根据报错自我修正。
  • 隐私与成本:API 按 Token 计费,比订阅制更灵活,且数据隐私性通常优于网页免费版。
Y 推荐文献


  • Claude Code


  • Claude Code 设置 - Claude Code
  • https://code.claude.com/docs/zh-CN/overview#native-install-recommended


  • CC-Switch
专为多环境 Claude 用户打造的配置管理工具,支持一键在不同的 API Key 或供应商之间快速切换,告别频繁手动修改配置文件的繁琐。


  • https://github.com/farion1231/cc-switch/releases/tag/v3.10.3


  • claude-auto-resume
专为长耗时任务设计的守护脚本,能够自动检测并恢复因网络波动或超时而中断的 Claude 对话,实现真正的 “无人值守” 式编程。


  • https://github.com/terryso/claude-auto-resume/tree/develop


  • BMAD-METHOD
BMAD 是一个全流程的 AI 敏捷开发 解决方案,它集结了 12 位虚拟专家组成智能团队,通过自适应的结构化工作流,引导你完成从构思到部署的专家级交付。


  • 官方仓库 https://github.com/bmad-code-org/BMAD-METHOD
更多关于 BMAD 的内容,有网友专门写了一篇文章 https://itho.cn/vibecoding/573.html


  • ralph-claude-code
自动重复叫 Claude Code 干活的工具,直到活干完或出问题为止。


  • https://github.com/frankbria/ralph-claude-code


  • skillsmp
一个收集查找 claude skill 的站
https://skillsmp.com/


  • lmarena
查看各类模型排名
https://lmarena.ai/zh/leaderboard


  • 第三方模型


  • 智谱AI : https://open.bigmodel.cn/
export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic


  • 硅基流动 : https://cloud.siliconflow.cn/
export ANTHROPIC_BASE_URL=https://api.siliconflow.cn/


  • 第三方文档


  • https://blog.techfetch.dev/blog/2025/09/17/claude-code-third-party-vendor-usage-guide-in-depth-analysis-best-practices/
  • Claude Code 使用指南:从官方配置到接入第三方模型 - kevnu.com 【推荐/参考】//todo


  • Claude 中文版使用指南:2025年最先进的 Claude 4.5 模型 - Github 2026-01-26
  • Claude Code 教程 - 菜鸟教程 //todo
  • Claude Code API密钥完全指南:配置、获取与最佳实践(2025版) - cursor-ide.com


  • Claude 第三方镜像站
对比维度Claude 官方 (Anthropic)Claude中文版 (Claude镜像站)访问门槛极高(需专用网络环境)零门槛(国内直连,即点即用)账号风险高(IP变动极易封号)无风险(微信/邮箱注册,稳定不封)中文能力优秀,但偶有翻译腔卓越(针对中文语境特定优化)模型权限免费版限制多,升级困难全模型解锁(含 Claude 4/3.5 全系列)功能扩展单一聊天窗口集成写作、PPT生成、数据分析等工具


  • Claude 国内使用完整指南:3个稳定镜像站推荐(2025最新) - claude-chinese.com
如何选择适合你的镜像站?
特性XSimpleChat蓝鲸 AIGPTokk稳定性⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐响应速度极快快快界面体验优秀优秀良好中文优化良好优秀良好多模型支持是是是API 支持是否是团队功能是否是免费试用有有有价格中等实惠中等推荐指数⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐X 参考文献


  • Claude Code 支持原生 Windows 免WSL安装教程,附踩坑经历 - Zhihu 【推荐】
  • Visual Studio Code 中使用 Claude Code - CSDN 【推荐】 2025.11.29
  • Claude Code VSCode 插件完整安装使用教程 - 掘金 【推荐】 2025.11.13
  • https://github.com/vadimdemedes/ink/#israwmodesupported
  • 开发工具&平台:Claude Code - 硅基流动 2025.11.17


  • 本文档安装方式仅适用于 Mac 及 Linux用户
  • Claude Code & 硅基流动,老金突然使用自由了! - Zhihu
  1. export ANTHROPIC_BASE_URL="https://api.siliconflow.cn/"export ANTHROPIC_MODEL="moonshotai/Kimi-K2-Instruct-0905"    # 可以自行修改所需模型export ANTHROPIC_API_KEY="YOUR_SiliconFlow_API_KEY"    # 请替换 API Key
复制代码
目前 Claude Code 并不支持添加多个自定义模型(Custom Model),可手动配置/选择并更新 ANTHROPIC_MODEL 环境变量的方式切换模型


  • 解决 Windows 下 Claude 通过 cmd/powershell 运行出错失去响应的问题 - 博客园
Windows 下在终端中运行 Claude,如果尝试让它在磁盘中查找文件,很容易因为缺少 cgypath 导致 Claude 进程出错



  • npm : 无法加载文件 D:...\nodejs\npm.ps1,因为在此系统上禁止运行脚本 - CSDN
在VSCode终端使用npm命令时,出现报错信息


  • 【2025最新教程】Claude Code国内使用_保姆级新手安装使用教程_最强AI编程工具 - 博客园 //todo
  • 免登录!免安装ClI,Claude Code插件接入API使用教程 - Zhihu //todo
  • Claude Code & 硅基流动,老金突然使用自由了! - Zhihu 【参考】
  • Claude Code 支持原生 Windows 免WSL安装教程,附踩坑经历 - Zhihu //todo
  • 如何正确使用Claude Code官方vscode插件,告别命令行 - Bilibili //todo
  • vscode + claude code = 打造自己的专属AI IDE - Bilibili //todo
  • (25年12月)claude code报错:might not be available in your country - CSDN
  1. find ~ -name "*claude*" -type f -name "*.json" 2>/dev/nullvi ~/.claude.json    "hasCompletedOnboarding": true,  // 这是你新增的行,末尾要加逗号
复制代码

  • Claude Code 从 0 到 1 全攻略:MCP / SubAgent / Agent Skill / Hook / 图片 / 上下文处理/ 后台任务 - Bilibili //todo
  • vscode中claude插件接入硅基流动api - CSDN 【参考/推荐】 2026.1.14
  • Claude Code Windows 安装与配置全流程:国内可用(硅基流动/DeepSeek)避坑指南 - 博客园 【推荐】
有一些教程里,教你在~/.claude/config.json中添加primaryApiKey配置项,我的教程里没有用到config.json这文件,通常出现在一些"非官方/第三方/旧版本"的绕路教程里,目的是让客户端/插件在没有完成登录流程时先"有个东西可写",避免一直卡在引导或报"缺 key"的分支判断。填什么都行,本质上说明:它并不是一个真实可用的 API Key,而更像是某些实现里的【占位字段】。我们已经通过setting.json的env配置,就不需要这个文件。
  1. "ANTHROPIC_AUTH_TOKEN": "你自己的APIKEY","ANTHROPIC_BASE_URL": "https://api.siliconflow.cn/","API_TIMEOUT_MS": "3000000","ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-ai/DeepSeek-V3.2","ANTHROPIC_DEFAULT_OPUS_MODEL": "Pro/deepseek-ai/DeepSeek-R1","ANTHROPIC_DEFAULT_HAIKU_MODEL": "Pro/zai-org/GLM-4.7"
复制代码

  • VibeCoding 实战:Claude Code + GLM4.7 全能手册 - itho.cn 【推荐】
CC-Switch / ...
    本文作者:        千千寰宇   
    本文链接:         https://www.cnblogs.com/johnnyzen   
    关于博文:评论和私信会在第一时间回复,或直接私信我。   
    版权声明:本博客所有文章除特别声明外,均采用 BY-NC-SA     许可协议。转载请注明出处!
    日常交流:大数据与软件开发-QQ交流群: 774386015        【入群二维码】参见左下角。您的支持、鼓励是博主技术写作的重要动力!   

来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!

相关推荐

您需要登录后才可以回帖 登录 | 立即注册