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

千千寰宇2026-02-01 1:08

0 序

  • 近期实在是刷到太多 Cursor / Codex / Gemini / Claude Code / OpenCode / Moltblot(OpenClaw/Clawd) 的 AI 编程Agent的文章、短视频了。
  • 但是很多文章对国内用户如何安装 Claude Code 、如何集成第三方大模型API（如：硅基流动等）到 Claude Code 、如何基于VSCode使用ClaudeCode，并没有讲得很透彻。

不少教程文档，暗藏私货------------间接要求购买ClaudeCode镜像站服务、或者售卖 FQ 服务。

显然，这对于笔者而言，是不适用的。

1 概述：Claude Code

  • Claude Code 是 Anthropic 推出的终端 AI 编码助手,核心理念是"住在终端里"。

它能够帮助开发者编写代码、调试程序、重构代码、解释复杂逻辑，大大提升编程效率。

它能理解项目结构、编辑代码、执行命令、管理 Git,虽然支持 IDE 集成,但本质是命令行驱动的工具。

其还推出有VSCode插件等多种终端形态，将强大的Claude 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

2 安装篇

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

  • Claude Code 支持的终端形态：
  • Web 版

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

  • 桌面版
  • 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

前置步骤：注册第三方大模型供应商的账户、并获取API KEY

  • 硅基流动

近期在搞活动，注册即送代金券。

  • 百炼

  • DeepSeek

  • GLM

  • ...

CLI 命令版：NPM 安装方式（推荐）

安装 NodeJs / Npm

  • 安装 Nodejs / NPM
  • 验证

CMD / Git-Bash / Powershell

shell 复制代码 
C:\Users\Xxx> node --version
v20.11.1

C:\Users\Xxx> npm --version
10.2.4

C:\Users\Xxx> npm config get prefix
D:\Program_Files\nodejs\node-v20.11.1-win-x64

基于 npm 安装 Claude Code

  • 基于 npm 安装 Claude Code
shell 复制代码 
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

  • 查看安装情况
shell 复制代码 
$ npm list -g
D:\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

she;; 复制代码 
curl -fsSL https://claude.ai/install.sh | bash

Windows

  • Windows PowerShell
shell 复制代码 
irm https://claude.ai/install.ps1 | iex
  • Windows CMD:
shell 复制代码 
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

CLI命令版：验证/启动/使用

查验版本

Git-Bash 环境下为例:

shell 复制代码 
$ claude --version
2.1.20 (Claude Code)

$ ls ~/.claude
config.json  debug/  ide/  projects/  skills/  statsig/  telemetry/  todos/

$ vim ~/.claude.json

powershell: notepad $env:USERPROFILE\.claude.json

健康检查

shell 复制代码 
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 章节

shell 复制代码 
# 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的环境变量

shell 复制代码 
ANTHROPIC_AUTH_TOKEN  你的API Key
ANTHROPIC_BASE_URL    https://api.siliconflow.cn/
ANTHROPIC_MODEL       moonshotai/Kimi-K2-Instruct
  • 设置环境变量的方法
shell 复制代码 
//方法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"
    }
  }

注意： 永久设置后需要【重启终端】才能生效。推荐使用永久配置方式。

  • 查验环境变量的方法
shell 复制代码 
//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。

shell 复制代码 
//如下方式可实现在 Git-Bash 中配置环境变量 （但Git-Bash 无法成功启动 Claude，忽略即可）
> vi ~/.bash_profile
# generated by Git for Windows
test -f ~/.profile && . ~/.profile
test -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

复制代码 
/exit

Visual Studio Code 中使用 Claude Code

  • 推荐文献

Step1 安装 Claude Code 扩展插件

  • 打开 VS Code，搜索并安装插件: Claude Code for VS Code
  • 补充安装方式：命令行安装
shell 复制代码 
# 安装 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 格式的空文件

如果先前以创建，则可忽略此步骤

shell 复制代码 
> 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启动
shell 复制代码 
D:\Program\CCSwitch\
  • 开始配置大模型供应商
  • 以硅基流动为例:
txt 复制代码 
请求地址： 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
json 复制代码 
    , ...
    "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 指南初始化项目
  • /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 ...

cmd 复制代码 
C:\Users\Johnny> claude
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-countri
log 复制代码 
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 文件），下面开始教你如何配置。

  • 解决方法
  1. 首先你要知道你的用户主目录 ，即"C:\Users\你的用户名"，配置文件默认会在这个目录下，然后找到.claude.json文件。
powershell 复制代码 
//powershell | git-bash
vim ~/.claude.json
  1. 打开.claude.json文件，可使用vscode、notepad++、记事本等文本编辑器，打开后会出现类似的配置样式，加上选中区域的字段。

别忘了给上一行加个,逗号

shell 复制代码 
"hasCompletedOnboarding": true
  1. 重启 ClaudeCode，大功告成！
shell 复制代码 
claude

输入1 即进入 Claude Code；反之，输入2 或 Esc 即退出 Claude 并会退到命令行窗口

Q: 基于Windows的PowerShell运行claude命令时，报：npm : 无法加载文件 D:\...\nodejs\claude.ps1，因为在此系统上禁止运行脚本。...

  • 问题描述

    Windows PowerShell
    版权所有 (C) Microsoft Corporation。保留所有权利。

    尝试新的跨平台 PowerShell https://aka.ms/pscore6

    PS C:\Users\Xxx\Desktop\55156966> claude
    claude : 无法加载文件 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查看执行策略/权限；
shell 复制代码 
PS C:\Users\Xxx\Desktop\55156966> get-ExecutionPolicy
Restricted

输出Restricted(受限制的)；

  • 终端输入Set-ExecutionPolicy -Scope CurrentUser命令给用户赋予权限；
  • 输入RemoteSigned；
shell 复制代码 
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就可以了。
shell 复制代码 
PS C:\Users\Johnny\Desktop\55156966> get-ExecutionPolicy
RemoteSigned

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

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

如何选择适合你的镜像站？

特性 XSimpleChat 蓝鲸 AI GPTokk
稳定性 ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐ ⭐⭐⭐⭐⭐
响应速度 极快 快 快
界面体验 优秀 优秀 良好
中文优化 良好 优秀 良好
多模型支持 是 是 是
API 支持 是 否 是
团队功能 是 否 是
免费试用 有 有 有
价格 中等 实惠 中等
推荐指数 ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐ ⭐⭐⭐⭐

X 参考文献

shell 复制代码 
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，如果尝试让它在磁盘中查找文件，很容易因为缺少 cgypath 导致 Claude 进程出错

在VSCode终端使用npm命令时，出现报错信息

json 复制代码 
find ~ -name "*claude*" -type f -name "*.json" 2>/dev/null

vi ~/.claude.json
    "hasCompletedOnboarding": true,  // 这是你新增的行，末尾要加逗号

有一些教程里，教你在~/.claude/config.json中添加primaryApiKey配置项，我的教程里没有用到config.json这文件，通常出现在一些"非官方/第三方/旧版本 "的绕路教程 里，目的是让客户端/插件在没有完成登录流程时先"有个东西可写" ，避免一直卡在引导或报"缺 key"的分支判断。填什么都行 ，本质上说明：它并不是一个真实可用的 API Key ，而更像是某些实现里的【占位字段】。我们已经通过setting.json的env配置，就不需要这个文件。

shell 复制代码 
"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"
相关推荐
千千寰宇4 个月前
[Nacos/Docker/MCP] Nacos 3.x : 为 AI MCP 而生
ai/aigc/gpt-agent应用·软件通用方案-配置中心/注册中心(nacos)
千千寰宇1 年前
[AI/GPT/综述] AI Agent的设计模式综述
ai/aigc/gpt-agent应用·ai/aigc/gpt-概念/理论/综述
热门推荐
01GitHub 镜像站点02Clawdbot 中文汉化版 接入微信、飞书03OpenCode 入门教程：介绍 · 安装 · 配置第三方 API (如 Claude)042026数学建模美赛题目特点与选题建议，常用四大模型汇总052026美赛A题智能手机电池续航时间预测的连续时间数学模型06UV安装并设置国内源07在Trae中使用Pencil MCP08Claude Code Skills 实用使用手册09Linux下V2Ray安装配置指南10一种新的LCA算法