Claude Code 完全使用指南：从安装配置到高效编程实战

2026年，AI编程助手正在成为开发者工作流中的标配工具。

Anthropic旗下的Claude Code作为一款终端原生的AI编程助手，凭借其强大的项目级理解能力和自然的交互方式，正在改变开发者编写、调试和维护代码的方式。但对于国内开发者而言，如何稳定、高效地使用这一工具，仍然是一个需要解决的问题。

本文将从零开始，详细介绍Claude Code的安装配置、核心功能使用技巧，以及如何通过数眼智能实现国内直连，让AI编程助手真正融入你的日常开发流程。

一、Claude Code是什么？

Claude Code是Anthropic推出的终端原生AI编程工具，基于Claude 4系列模型，无需切换IDE或聊天窗口，直接在终端中实现代码生成、调试、项目导航和自动化任务处理。

核心能力：

• 项目级全局视野：支持200k超长上下文，可理解整个代码库的结构与逻辑
• 自然语言交互：直接用中文描述需求，AI自动规划方案并编写代码
• 实操能力：可直接编辑文件、运行命令、创建Git提交
• 跨平台支持：Windows（需WSL）、macOS、Linux均可使用

二、系统要求与前置准备

2.1 环境要求

• Node.js：18.0或更高版本
• 操作系统：macOS、Linux，或Windows（需安装WSL或Git for Windows）
• Git：Windows用户需提前安装

2.2 获取数眼智能API凭证

通过数眼智能接入Claude Code，可以解决国内直连、支付结算、成本控制三大问题。

1. 注册登录数眼智能平台（国内站：shuyanai.com）
2. 进入「控制台」→「AI模型」→「API KEY」，点击「添加令牌」
3. 创建成功后，你会得到一个以sk-开头的密钥

三、安装Claude Code

3.1 方式一：npm全局安装（推荐）

# 全局安装最新稳定版
npm install -g @anthropic-ai/claude-code

# 验证安装成功
claude --version

3.2 方式二：原生安装脚本（无需Node.js）

macOS/Linux/WSL：

# 稳定版
curl -fsSL https://claude.ai/install.sh | bash

# 最新版
curl -fsSL https://claude.ai/install.sh | bash -s latest

Windows PowerShell：

# 稳定版
irm https://claude.ai/install.ps1 | iex

# 最新版
& ((scriptblock)::Create((irm https://claude.ai/install.ps1))) latest

3.3 验证安装

claude --version
# 应显示版本号，如 claude-code/2.1.2

四、配置数眼智能接入

4.1 环境变量配置（临时生效）

macOS/Linux：

# 进入项目目录
cd your-project-folder

# 配置环境变量
export ANTHROPIC_AUTH_TOKEN=sk-你的密钥
export ANTHROPIC_BASE_URL=https://platform.shuyanai.com

# 启动Claude Code
claude

Windows PowerShell：

cd your-project-folder
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的密钥"
$env:ANTHROPIC_BASE_URL = "https://platform.shuyanai.com"
claude

Windows CMD：

cd your-project-folder
set ANTHROPIC_AUTH_TOKEN=sk-你的密钥
set ANTHROPIC_BASE_URL=https://platform.shuyanai.com
claude

4.2 永久配置（通过settings.json）

创建配置文件 ~/.claude/settings.json（Windows路径：C:\Users\用户名\.claude\settings.json）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "ANTHROPIC_BASE_URL": "https://platform.shuyanai.com"
  }
}

同时创建 ~/.claude.json（Windows路径：C:\Users\用户名\.claude.json）：

{
  "hasCompletedOnboarding": true
}

该配置可避免启动时报错"Unable to connect to Anthropic services"。

4.3 VS Code插件配置

1. 在VS Code扩展市场中搜索并安装 Claude Code for VS Code
2. 创建配置文件 ~/.claude/config.json（Mac）或 C:\Users\用户名\.claude\config.json（Windows）：

{
  "primaryApiKey": "self"
}

3. 打开VS Code设置（Ctrl+,），搜索"Claude Code: Environment Variables"，点击"Edit in settings.json"，添加：

"claude-code.environmentVariables": [
  {
    "name": "ANTHROPIC_AUTH_TOKEN",
    "value": "sk-你的密钥"
  },
  {
    "name": "ANTHROPIC_BASE_URL",
    "value": "https://platform.shuyanai.com"
  }
]

保存后重启VS Code，点击右上角图标即可使用。

五、Claude Code核心使用指南

5.1 首次启动与初始化

# 进入项目目录
cd your-project

# 启动Claude Code
claude

首次启动会进行交互式配置：

1. 选择主题配色（直接回车使用默认）
2. 确认安全须知（回车）
3. 选择终端配置（推荐使用默认）
4. 信任工作目录（选择yes）

启动后，输入/status确认模型、Base URL、API Key配置是否正确。

5.2 基础命令格式

命令格式	说明	示例
claude	启动交互模式	claude
claude "任务"	运行一次性任务	claude "fix the build error"
claude -p "查询"	运行查询后退出	claude -p "explain this function"
claude -c	继续最近的对话	claude -c
claude commit	自动创建Git提交	claude commit

5.3 交互模式常用命令

基础命令：

• /clear - 清除对话历史
• /help - 显示可用命令
• exit 或 Ctrl+C - 退出Claude Code

内置斜杠命令：

命令	说明
/status	查看账户和系统状态
/model <模型名>	切换模型
/init	使用CLAUDE.md初始化项目
/compact	压缩对话历史，释放上下文窗口
/plan	进入规划模式，仅分析不修改代码
/review	请求代码审查
/cost	显示令牌使用统计
/config	查看/修改配置
/permissions	查看或更新权限
/mcp	管理MCP服务器连接

六、高效使用技巧

6.1 上下文管理

Claude Code支持200k超长上下文，但合理管理上下文能显著提升效率并节省Token。

最佳实践：

• 定期清理：使用/clear定期重置对话，防止旧上下文干扰新任务
• 主动压缩：使用/compact命令让Claude总结关键决策，保留核心记忆
• 文件引用：提问时使用@引用文件，如write a test for @auth.py，避免无效扫描
• 子代理：对于大规模任务，让Claude启动子代理执行，完成后返回精炼结论

6.2 先计划，再执行

对于复杂任务，推荐使用Plan模式：

• 启用方式：连续按两次Shift + Tab进入Plan Mode
• 或使用命令：/plan
• 作用：仅分析和讨论方案，不实际修改文件，降低试错成本

6.3 权限模式切换（Shift+Tab）

• 普通模式（默认）：所有操作需手动确认，适合新手
• 自动接受模式：自动执行所有操作，效率最高（信任场景使用）
• Plan模式：先生成详细开发计划，确认后再执行（复杂项目推荐）

6.4 高效交互技巧

• 多行输入：Shift+Enter或\+Enter换行输入复杂需求
• Bash模式：前缀!直接执行终端命令，如! git status
• 历史命令：Ctrl+R搜索历史命令
• 清屏：Ctrl+L
• 打断：ESC中断当前操作
• 撤销操作：连续按两次ESC打开"时光机"菜单，可回滚代码或对话

6.5 项目知识沉淀：CLAUDE.md

运行/init命令，在项目根目录生成CLAUDE.md文件，用于记录：

• 构建命令
• 代码规范
• 项目架构
• 数据库结构

每次启动Claude Code时会自动加载该文件，无需重复解释项目背景。

6.6 模型切换

• 启动时切换：claude --model <模型名称>
• 会话中切换：输入/model <模型名称>

通过数眼智能接入，可使用的模型包括DeepSeek-V3.2、Kimi-K2.5、GLM-4.7等高性价比模型。

七、高级功能配置

7.1 MCP扩展：连接外部工具

通过MCP协议集成Google Drive、Figma、Jira等外部服务。配置文件位置：~/.config/claude/settings.json

{
  "mcp_servers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@model-context-protocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx"
      }
    }
  }
}

配置完成后，Claude Code可调用联网搜索、读取网页内容等能力。

7.2 Hooks：自动化守护

Hooks是在Claude工作流特定生命周期节点自动运行的本地脚本，确保关键操作100%执行。

配置方式：

• 运行/hooks进行交互式配置
• 或直接编辑~/.claude/settings.json
• 或让Claude帮你编写，如："编写一个在每次文件编辑后运行eslint的hook"

7.3 Skills系统

Skills是给Claude Code安装的"技能包"，支持直接编写Hooks配置、独立上下文（Forked Context）和热重载。

调用方式：输入/自动补全，选择对应Skill即可。

八、常见问题排查

问题现象	可能原因	解决方案
"Invalid API Key · Please run /login"	环境变量未生效	检查变量名是否正确，重启终端
显示"offline"状态	Claude Code检测Google网络状态	不影响正常使用
请求"fetch failed"	网络环境不稳定	使用代理或重试
API报错	转发代理不稳定	Ctrl+C终止对话后重试
402报错"No Active Subscription"	账户积分不足	联系数眼智能商务
Node版本过低	需要Node 18+	nvm install 18切换版本
命令未找到	npm全局路径未加入PATH	export PATH=$PATH:$(npm bin -g)

九、数眼Switch：一键配置工具（推荐）

对于希望简化配置流程的用户，数眼智能提供数眼Switch可视化配置工具，预装在官方云服务器镜像中，可实现：

• 一键配置：OpenClaw与Claude Code的完整配置，无需手动修改JSON文件
• 模型动态切换：在聊天界面通过/model 别名命令实时切换模型
• IM平台集成：内置企业微信、飞书、钉钉、QQ的配置模板，一键接入
• MCP联网能力：内置联网搜索MCP，让AI能获取实时信息

部署优势：云服务器部署可实现7×24小时在线，API Key与个人电脑隔离，降低本地泄露风险。

十、最佳实践总结

1. 上下文管理：定期使用/clear和/compact，善用文件引用@
2. 复杂任务：先用/plan分析方案，确认后再执行
3. 权限配置：高频操作场景使用通配符权限，减少确认弹窗
4. 知识沉淀：为每个项目维护CLAUDE.md，记录规范与架构
5. 工具扩展：通过MCP接入外部服务，通过Hooks实现自动化
6. 成本控制：在数眼智能控制台实时监控Token消耗，合理切换模型

通过数眼智能接入Claude Code，国内开发者可享受稳定直连、人民币支付、成本优化三大便利，让AI编程助手真正融入日常开发流程。

---

数眼智能 | 让全球AI能力，为中国开发者所用