从入门到进阶：Claude Code安装配置与国内模型实践指南

安装

Claude Code 的安装过程非常简便。

对于 macOS 用户，执行以下任意一条命令即可完成安装：

# Native Install
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew
brew install claude-code

# NPM
npm install -g @anthropic-ai/claude-code

对于 Windows 用户，同样可以选择以下任一方式安装：

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

# NPM
npm install -g @anthropic-ai/claude-code

安装完成后，可以通过输入 claude --version 来验证安装是否成功：

> claude --version
2.0.73 (Claude Code)

如需升级到最新版本，只需执行一条简单的命令：

# 升级到最新版本
claude update

登录

进入你的工作目录，执行 claude 命令即可启动 Claude Code。在使用前，需要登录并配置相应的大模型服务商账号。

使用 Anthropic 账号登录

如果你拥有 Claude.ai 或 Claude Console 账号，启动后按照命令行提示的步骤完成登录即可。不过，Anthropic 对国内用户支持有限，普通用户申请账号存在门槛。幸运的是，我们有许多优秀的国内替代方案。

配置 GLM（智谱AI）

智谱AI是国内主流的大模型服务商之一。你可以访问其控制台申请账号并获取 API 密钥。

获取密钥后，需要编辑 ~/.claude/settings.json 配置文件，将 ANTHROPIC_AUTH_TOKEN 的值替换为你自己的 API 密钥，并指定正确的 API 端点：

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "你自己的 GLM 智谱 API 密钥",
        "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
        "API_TIMEOUT_MS": "3000000",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
    }
}

配置完成后，执行 claude 命令即可启动 Claude Code。初次启动时，会看到欢迎界面，敲击回车即可进入交互模式。Claude Code 默认将当前执行的目录作为工作目录，在使用 VS Code 插件时，则以项目根目录为准。

其他国内模型与编程套餐

直接使用 API Key 按 Token 计费可能不够经济，多家国内厂商推出了针对编程场景的优惠套餐：

• 智谱AI GLM Coding Plan：提供较大的折扣，是目前最流行的 Anthropic 平替方案之一。
• Kimi K2：月之暗面推出的编程模型，在 Kimi 官网点击“编码”即可升级套餐。
• MiniMax：同样提供了性价比较高的编程套餐。
• 火山引擎方舟 Coding Plan：字节跳动旗下的服务，首月价格优惠，主要提供 Doubao-Seed-Code 及 DeepSeek V3.2 等模型。

对于非专业开发者，选择各家最基础的套餐档位通常已足够使用。每家服务商都会在套餐页面提供详细的配置说明，最复杂的操作也不过是修改一次配置文件，上手门槛很低。对于云原生和AI应用的开发而言，这些国内模型是可靠的选择。

使用 VS Code 插件

尽管命令行功能强大，但更多开发者习惯在熟悉的编辑器环境中工作。在 VS Code 中使用 Claude Code 插件，可以获得更直观的可视化交互体验。

打开 VS Code，在扩展市场中搜索并安装由 Anthropic 官方发布的 “Claude Code” 插件。安装成功后，在任意文件的顶部都可以看到 Claude Code 的小图标，点击即可打开插件侧边栏。在输入框中，你可以直接向 Claude Code 下达各种开发指令。

Claude Code 的四种权限模式

Claude Code 提供了四种不同的权限模式，每种模式的行为和安全性各不相同，合理的运维与配置至关重要。

default（默认模式）

在此模式下，Claude Code 会按照正常的权限检查机制运行，根据文件系统权限和环境配置来决定是否允许执行操作。

plan（计划模式）

Claude Code 只能使用只读工具，并且在执行任何操作前会显示详细的计划，供用户审阅。

acceptEdits（自动编辑模式）

文件编辑和文件系统操作会自动获得批准并执行，无需用户逐个确认。

bypassPermissions（绕过权限模式）

这是一个功能强大但需极度谨慎使用的模式。在此模式下，所有工具都将在无提示的情况下运行，绕过了所有权限检查。曾有用户分享因开启此模式，导致 Claude Code 在夜间任务中误删整个目录的案例。强烈不建议初学者开启此模式。

你可以在 VS Code 插件的设置中选择前三种模式。如需开启 bypassPermissions 模式，需在设置中搜索 claude code，并勾选 Allow Dangerously Skip Permissions 选项，之后才能在对话框中切换到该模式。

CLAUDE.md 项目配置文件

在项目根目录下创建 CLAUDE.md 文件是一个好习惯。你可以在这个文件中描述项目结构、使用的技术栈以及对 AI 的特定要求。一个清晰的 CLAUDE.md 能显著提升 Claude Code 的工作效率和准确性。不过，随着模型能力的进化，现在很多新项目即使不编写此文件，AI 也能较好地理解上下文并高效工作。

Claude Code 生态工具推荐

围绕 Claude Code，社区涌现出一些优秀的增强工具，进一步扩展了其能力。

CCR（Claude Code Router）

这款工具允许你为不同的任务配置和切换不同的模型。例如，可以让模型A负责思考，模型B进行网络搜索，模型C执行代码修改。你可以在其 GitHub 仓库找到详细的安装与配置信息。

opcode

opcode 是一个图形化的 Claude Code 管理界面，功能包括管理会话、创建自定义代理、修改配置以及跟踪使用情况等。对于喜欢可视化操作和集中管理的用户来说是一个不错的选择。

Claude Code Usage 插件

这是一个 VS Code 插件，用于统计你在编辑器中使用 Claude Code 的用量。安装后，你可以方便地查看调用次数、费用趋势等数据，有助于管理开发成本。

Claude Code 及其人工智能编程生态非常庞大，不断有新的工具和插件出现。然而，引入过多工具也会带来复杂性和学习成本。如果你的 AI 辅助编程流程已经顺畅高效，不妨先将重心放在核心开发上，按需逐步探索这些增强工具。