AI コーディングアシスタント: Claude Code & Codex

AI コーディングアシスタント: Claude Code & Codex#

AI コーディングアシスタントは、ターミナル（またはエディタ）に常駐し、プロジェクトのファイルを読み、会話であなたを助けるプログラムです。やりたいことを平易な言葉で伝えると、コードを説明し、ファイルを書き・編集し、コマンドを実行することさえできます — すべてあなたのレビューのもとで。qc-rs 初学者にとって、これは緩やかな入口です。「このスクリプトは何をする？」、「この分子を最適化して Mulliken 電荷を表示するスクリプトを書いて」、 *「なぜこの計算は失敗した？」*と尋ねれば、プロジェクトを理解した具体的な答えが返ってきます。

この章では、人気のある 2 つ — Claude Code（Anthropic）と Codex CLI（OpenAI）— を紹介します。任意のツールで、qc-rs に必須ではありません。（本マニュアル自体も Claude Code で起草されました — git 履歴に Co-Authored-By: Claude が見えます。）

注釈

アカウントと費用どちらもアカウントが必要で、有料サービスです（サブスクリプションまたは従量制 API 利用）。頼る前に、現行の価格と公式セットアップ文書 — リンクは下記 — を確認してください。

qc-rs 初学者にとって何ができるか#

コードとエラーの説明 — トレースバックを貼るか、ファイルを指して意味を尋ねる。
小さなスクリプトを書く — 「水分子を作り、B3LYP を実行し、双極子モーメントを表示して」。
コードベースを案内 — 大きなリポジトリで「SCF の収束閾値はどこで設定されている？」。
テストやドキュメントの下書き — あなたがレビューして磨く初版。

これらはアシスタントであってオラクルではありません。生成物は必ず読み、git で作業を管理して、いつでも元に戻せるようにしましょう。

どう動くか#

どちらもターミナルでエージェントループを回します:要求を読み、関連ファイルを見て、行動（回答・編集・シェルコマンド）を提案し、あなたの許可のもとで実行し、繰り返します。知っておく価値のある 2 点:

プロジェクト自身の指示を読む。 このリポジトリはコーディング規約を書いた AGENTS.md（と CLAUDE.md）、マニュアル用の docs/user/CLAUDE.md を同梱しています。アシスタントはこれらを自動で読み込むので、提案は最初からプロジェクトの規則に従います。
行動の前に尋ねる。 既定では、ファイル編集やコマンド実行の前に確認を求めます。承認・編集・拒否ができます。緩めたり厳しくしたりもできます（権限モード）が、初学者は確認を有効のままにし、提案された行動を毎回読んでください。

典型的なセッション#

リポジトリ内での短いやり取りはこんな感じです:

$ claude
> ベンゼンの HOMO–LUMO ギャップを B3LYP/def2-SVP で計算し eV で表示するスクリプトを書いて。

  （アシスタントが新規ファイル gap.py を提案し、作成の許可を求める）   [y] 承認

> 実行して。

  （`python gap.py` を実行し、出力を表示し、その数値を説明）

> 値が大きすぎる — Hartree–Fock vs B3LYP で妥当？

  （HF がギャップを過大評価する理由を説明し、汎関数の切り替えを提案）

あなたは常に主導権を握ります:ファイルを承認し、実行を承認し、科学を判断します。

Claude Code#

インストール — ネイティブインストーラが最も簡単です。Node.js 不要で自動更新もします:

curl -fsSL https://claude.ai/install.sh | bash      # macOS / Linux / WSL

（npm からも入れられます — npm install -g @anthropic-ai/claude-code、Node.js 18+ 必要 — が、ネイティブインストーラならそれを避けられます。npm install は sudo で実行せず、権限エラーが出たら nvm などのユーザーごとの Node 管理ツールを。）Windows など現行の選択肢は公式の Claude Code セットアップ文書を参照。

実行は qc-rs のチェックアウト内で:

cd ~/path/to/qc_rs
claude

初回実行で認証（Claude サブスクリプションまたは Anthropic API キー）を案内されます。あとはやりたいことを入力するだけ。qc-rs 風のプロンプト例:

> docs/user のクイックスタートが何をしているか、手順ごとに説明して。
> ベンゼンを B3LYP/def2-SVP で最適化し、C–C 結合長を報告するスクリプトを書いて。
> この SCF が収束しなかった — どの収束オプションを試せる？

Claude Code はシェルコマンドを実行しファイルを編集できます。操作の前に確認を求め、各変更をあなたがレビューします。

Codex CLI#

OpenAI の Codex CLI も同様です。インストール — ネイティブインストーラ（macOS/Linux）も Node.js 不要:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

（または npm から:npm install -g @openai/codex、Node.js 18+。）

チェックアウトから実行して認証:

cd ~/path/to/qc_rs
codex           # ChatGPT アカウントでサインイン、または OpenAI API キーを設定

現行のセットアップ詳細は公式の Codex CLI 文書を参照。

うまく使うために#

git ブランチで作業する。 差分を確認し、不要なものを破棄できるように（プロジェクト文書の貢献ワークフロー参照）。
実行前にレビューする。 これらはシェルコマンドを実行しファイルを変更できます。特に削除・インストール・ push を伴うものは、提案された操作を先に読むこと。
具体的に。 「ピリジンの HOMO–LUMO ギャップを ωB97X-D/def2-TZVP で計算し eV で表示して」は「化学をやって」より良い。ファイルや関数を名前で指す。
科学を検証する。 アシスタントは qc-rs スクリプトを書けますが、化学の責任はあなたにあります — 手法・基底・結果が妥当かを確認しましょう（本マニュアルの残りは、それを学ぶためのものです）。

アシスタントに qc-rs をセットアップさせる#

これらのツールはコマンドを実行できるので、優れた最初の使い道はビルドそのものです。新しいマシンで qc-rs をビルドするとは make setup と make install を実行し、環境固有の細部を正しく整えること — まさにアシスタントが得意な面倒な雑務です。前提（git、uv と Python、Rust、BLAS/LAPACK、必要なら MPI。次章で扱います）が入っていれば、リポジトリをクローンし、アシスタントで開いてこう頼みます:

make setup と make install で qc-rs をビルドして、ビルド設定をこのマシンのプロファイルに保存して。

アシスタントはマシンを検出し、make setup（プロファイルと .vscode・ビルド設定を生成）を実行し、 make install（maturin ビルド）を実行し、import qc を確認します。これはしばしば qc-rs をビルドする最も簡単な方法です — ただし太字の前提に注意:前提（uv, Python, Rust, BLAS, MPI）は既に入っている必要があります — アシスタントがビルドするのは qc-rs であってシステムのツールチェーンではありません。

次は qc-rs をインストールしましょう — 手で、あるいはアシスタントで — インストールとビルドで。

インストールコマンドの出典:Claude Code setup · Codex CLI。ツールは速く変わります — 現行の方法は公式文書を優先してください。