连接本地开发环境

配置 Claude Code 访问本地项目文件

概述

Claude Code 需要连接本地开发环境才能访问和修改代码文件。本节介绍如何完成连接配置。

连接步骤

VS Code 中连接

  1. 打开 VS Code
  2. 打开项目文件夹(文件 → 打开文件夹
  3. 点击左侧 Claude Code 图标
  4. 首次使用时,点击授权按钮允许访问
  5. 授权成功后显示项目文件结构

命令行中连接

# 进入项目目录
cd /path/to/your/project

# 启动 Claude Code
claude chat

首次使用时输入 y 允许访问当前目录。

权限设置

文件系统权限

权限说明
读取读取项目文件和目录结构
写入修改和创建项目文件
执行运行测试和构建命令

权限管理原则

  • 最小权限:只请求必要的权限
  • 用户确认:修改文件操作需用户确认
  • 可撤销:随时可撤销授权

安全边界

Claude Code 在安全边界内运行:

  • 不访问项目文件夹外的文件
  • 不执行危险的系统命令
  • 所有操作有详细日志记录

工作目录配置

设置默认工作目录

VS Code:

  1. 打开设置
  2. 搜索 "Claude Code"
  3. 找到 "Default Workspace" 设置
  4. 输入常用项目目录路径

命令行:

claude config set default-workspace /path/to/your/project

切换工作目录

# 切换目录
claude cd /path/to/your/project

# 查看当前目录
claude ls

On this page