连接本地开发环境
配置 Claude Code 访问本地项目文件
概述
Claude Code 需要连接本地开发环境才能访问和修改代码文件。本节介绍如何完成连接配置。
连接步骤
VS Code 中连接
- 打开 VS Code
- 打开项目文件夹(文件 → 打开文件夹)
- 点击左侧 Claude Code 图标
- 首次使用时,点击授权按钮允许访问
- 授权成功后显示项目文件结构
命令行中连接
# 进入项目目录
cd /path/to/your/project
# 启动 Claude Code
claude chat首次使用时输入 y 允许访问当前目录。
权限设置
文件系统权限
| 权限 | 说明 |
|---|---|
| 读取 | 读取项目文件和目录结构 |
| 写入 | 修改和创建项目文件 |
| 执行 | 运行测试和构建命令 |
权限管理原则
- 最小权限:只请求必要的权限
- 用户确认:修改文件操作需用户确认
- 可撤销:随时可撤销授权
安全边界
Claude Code 在安全边界内运行:
- 不访问项目文件夹外的文件
- 不执行危险的系统命令
- 所有操作有详细日志记录
工作目录配置
设置默认工作目录
VS Code:
- 打开设置
- 搜索 "Claude Code"
- 找到 "Default Workspace" 设置
- 输入常用项目目录路径
命令行:
claude config set default-workspace /path/to/your/project切换工作目录
# 切换目录
claude cd /path/to/your/project
# 查看当前目录
claude ls