Claude Code远程执行需用本地配置:先确认安装(claude --version),再用scp/rsync/手动方式将本地~/.claude.json传至远程同路径,或通过--config指定项目内配置文件,后者优先级最高且完全忽略全局配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想让Claude Code在远程服务器上执行任务时,读取你本地电脑里写好的配置文件,而不是用服务器默认的空配置或残留配置。
确认远程环境是否已安装Claude Code
登录远程服务器后,先运行 claude --version。如果提示 command not found,说明未安装,需先执行安装命令——macOS/Linux用 curl -fsSL https://claude.ai/install | sh,Ubuntu/Debian则用 curl -fsSL https://claude.ai/install | sudo sh。
安装完成后不要立刻启动,先检查配置路径:ls ~/.claude.json。若返回 “No such file”,说明是全新安装,没有冲突配置,可以安全覆盖。
把本地配置文件传到远程服务器
方法一:用 scp 直接推送(推荐)
在你本地终端执行:scp ~/.claude.json user@remote-server:~/.claude.json。这一步会覆盖远程服务器上的同名文件,【务必确认远程 ~/.claude.json 不含正在使用的生产密钥】。
方法二:用 rsync 同步(适合后续频繁更新)rsync -avz ~/.claude.json user@remote-server:~/.claude.json。它比 scp 多一层校验,传输失败时会报错,不会静默写入损坏文件。
记录结构化的Claude Code轨迹、影子git diff,并在代理行为需要法医级调试而非临时转录审查时回放分支。
方法三:手动复制粘贴(仅限极小配置)
用 cat ~/.claude.json 查看内容 → 全选复制 → 登录远程服务器 → 执行 vim ~/.claude.json → 粘贴并保存。注意:必须确保 JSON 格式合法,少一个逗号就会导致 claude 启动失败且无明确报错。
强制Claude Code加载指定配置文件
默认情况下,Claude Code 只读 ~/.claude.json。但远程任务常需切换配置,比如用不同 API Key 对应不同环境。这时要显式指定:
第一步:把配置文件放到项目目录下,命名为 .claude.local.json;
第二步:进入该项目目录,运行 claude --config .claude.local.json;
第三步:验证是否生效——输入 /status,查看输出中的 Config path 是否指向你刚传的文件。
注意:如果同时存在 ~/.claude.json 和 --config 指定的文件,Claude Code 会**完全忽略前者**,只认后者。这个行为不可逆,除非删掉 --config 参数重新启动。

















